docs(FEAT-DS-001): 设计 AKTools 超短补充数据源

2026-08-24 20:43:14 +08:00
parent 0d0d1eea45
commit 81c48af8cc
20 changed files with 514 additions and 0 deletions
@@ -0,0 +1,31 @@
+# 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 秒。