Files
pyquantdata/src/pyquantdata/serve/state.py
T
openbot d37c697bbe M1 最小闭环:CLI + FastAPI 网关 + SQL 闸 + 100% 覆盖率验收链
- CLI:init/serve/update/query/export/status(typer + rich),单写者锁三元判活
- 存储:DuckDB schema migrations(14 表 + 8 联邦视图,语句元组逐条执行)
- ETL:A股证券/日历/日K,整区替换幂等;日历全年补全(calendar 语义唯一)
- 网关:POST /v1/query(线程池 + interrupt 超时 504)、/v1/export、meta/stats/state、healthz/ready
- 安全:SQL 闸 sqlglot fail-closed(文件/网络表函数默认拒)、非 loopback 空 token 拒启、导出路径双判
- 验收:254 测试全绿、1265 语句 100% 覆盖、[CI] 真起服验收链、smoke_m1.py 交付自检
- 文档:设计文档 v0.7(圆桌 45 条采纳 + 3 条实施校准),README 重写
- 发布:release.yml Trusted Publishing(OIDC 免密钥),action refs 已核验
2026-09-24 09:06:47 +08:00

65 lines
2.5 KiB
Python

"""市场状态机纯函数(设计 §10.2 的 M1 简版:日历 + 时段推导,无网络依赖)。
纯本地确定性推导:is_trading_day 由 calendar 表提供;时段规则表内置。
StateEngine 完整事件机(迁移推流)在 M2 接入 serve 调度器。
"""
from __future__ import annotations
from dataclasses import dataclass
MARKET_TZ: dict[str, str] = {
"cn": "Asia/Shanghai",
"us": "America/New_York",
"hk": "Asia/Hong_Kong",
}
# (开, 收) 本地时间,24h 制;M1 不含美股盘前盘后(可扩展)
SESSIONS: dict[str, tuple[tuple[str, str], ...]] = {
"cn": (("09:30", "11:30"), ("13:00", "15:00")),
"hk": (("09:30", "12:00"), ("13:00", "16:00")),
"us": (("09:30", "16:00"),),
}
_AUCTION_START = "09:15" # A股集合竞价
_MORNING_OPEN = "09:30"
@dataclass(slots=True)
class MarketState:
market: str
state: str # CLOSED / PRE_OPEN_AUCTION / OPEN / LUNCH_BREAK
session_tz: str
reason: str
next_at: str | None = None # 本地时间 "HH:MM"
def _hhmm(s: str) -> int:
"""'HH:MM' → HHMM 整数(与 market_state 入参口径一致,如 '09:30' → 930)。"""
h, m = s.split(":")
return int(h) * 100 + int(m)
def market_state(market: str, now_local_hhmm: int, *, is_trading_day: bool) -> MarketState:
"""给定交易所本地 ``HHMM`` 整数(如 930、1301)与是否交易日,确定性推导状态。
参数化时间点便于测试全部边界(开盘/午休/收盘/竞价/节假日)。
"""
tz = MARKET_TZ.get(market, "Asia/Shanghai")
if market not in SESSIONS:
raise KeyError(f"未知市场:{market}")
if not is_trading_day:
return MarketState(market, "CLOSED", tz, "non_trading_day")
sessions = SESSIONS[market]
if market == "cn" and _hhmm(_AUCTION_START) <= now_local_hhmm < _hhmm(_MORNING_OPEN):
return MarketState(market, "PRE_OPEN_AUCTION", tz, "session_rule", _MORNING_OPEN)
for open_s, close_s in sessions:
if _hhmm(open_s) <= now_local_hhmm < _hhmm(close_s):
return MarketState(market, "OPEN", tz, "session_rule", close_s)
# 午休:第一段收后到第二段开前(单段市场无午休)
first_close = _hhmm(sessions[0][1])
second_open = _hhmm(sessions[1][0]) if len(sessions) > 1 else None
if second_open is not None and first_close <= now_local_hhmm < second_open:
return MarketState(market, "LUNCH_BREAK", tz, "session_rule", sessions[1][0])
return MarketState(market, "CLOSED", tz, "session_rule", sessions[0][0])