# 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 秒。