1.6 KiB
1.6 KiB
AKTools 超短行情补充数据源设计
状态：已获用户确认，待实现
目标
在内网环境把已运行的 AKTools 作为 AKShare 补充数据源，提供 TDX 未覆盖的超短行情指标，不改变现有 TDX 市场概览链路。
方案
Nest API 增加固定的 AKTools Client 和领域 Mapper，按业务接口调用三个已验证的 AKTools endpoint。前端只访问 Nest，不访问 AKTools。V1 不新增 Python 服务、Docker、数据库、Redis 或 RocketMQ。
数据接口
stock_zt_pool_em：涨停池、封板资金、连板数和行业。stock_zt_pool_zbgc_em：炸板池和炸板次数。stock_zt_pool_previous_em：昨日涨停股今日表现和昨日连板数。
Nest 对外提供 /api/v1/market-overview/short-term/emotion 和 /api/v1/market-overview/short-term/conclusion，不透传 AKTools 通用路由。
规则口径
只使用通过类型、日期和数值校验的记录。V1 输出涨停数量、最高连板、梯队分布、炸板数量、昨日涨停平均涨跌幅和涨跌分布；不计算未经确认口径的炸板率，不把封板资金解释为主力净流入。
状态与降级
接口响应使用 fresh、delayed、partial、unavailable。AKTools 失败只影响短线模块；TDX 模块继续工作。每次响应包含 snapshotId、asOf、tradeDate、source 和 warnings。
安全与性能
AKTools 默认绑定 127.0.0.1:8080。Nest 只读取服务端配置，拒绝客户端 URL，设置 10 秒超时、响应大小限制和脱敏错误。三个上游请求并行执行，短线接口 P95 目标小于 12 秒。