# AKTools 超短行情补充数据源 PRD

- 功能编号：FEAT-DS-001
- PRD 版本：0.1
- 状态：design_approved
- 日期：2026-08-24

## 背景与问题

TDX 已提供指数、市场宽度、板块和成交额，但不能覆盖涨停池、炸板池、昨日涨停表现等超短情绪指标。AKTools 已在本机内网环境运行，并验证了相关 HTTP 接口。

## 目标用户与场景

个人用户在盘中或收盘后查看超短情绪，不进行交易下单。V1 仅支持本机或受控内网访问，AKTools 只作为 Nest API 的内部补充数据源。

## 产品目标

- 在市场概览中提供结构化超短情绪数据。
- 显示涨停数量、最高连板、连板梯队、炸板数量和昨日涨停表现。
- 所有结论都能追溯到 AKShare 数据字段、交易日期和数据状态。
- AKTools 不可用时不影响 TDX 核心市场概览。

## 非目标

- 不实现交易建议、买卖信号、目标价或仓位建议。
- 不直接暴露 AKTools 的通用接口给前端或公网。
- 不在 V1 计算未经确认口径的炸板率、资金净流入或新闻情绪评分。
- 不启用 MySQL、Redis、RocketMQ 或历史快照存储。

## 功能需求

| 编号 | 优先级 | 需求 | 可观察结果 |
|---|---|---|---|
| FR-001 | P0 | 读取涨停池 | 展示涨停数量、最高连板和连板梯队。 |
| FR-002 | P0 | 读取炸板池 | 展示炸板数量和可用的炸板次数摘要。 |
| FR-003 | P0 | 读取昨日涨停池 | 展示今日平均涨跌幅及上涨、下跌、持平数量。 |
| FR-004 | P0 | 生成规则结论 | 结论必须携带依据、交易日期和状态。 |
| FR-005 | P0 | 独立降级 | AKTools 超时或异常时，短线模块显示 unavailable，TDX 模块继续可用。 |
| FR-006 | P1 | 内网边界 | AKTools 地址只来自服务端固定配置，默认回环地址。 |

## 数据与口径

V1 调用 `stock_zt_pool_em`、`stock_zt_pool_zbgc_em`、`stock_zt_pool_previous_em`。AKTools 返回的中文字段只在 Adapter 内解析，领域 DTO 使用稳定英文属性。

- 涨停数量：涨停池有效记录数。
- 最高连板：有效 `连板数` 的最大值。
- 连板梯队：按 `连板数` 分组计数。
- 炸板数量：炸板池有效记录数；不直接推导炸板率。
- 昨日涨停表现：昨日涨停池有效 `涨跌幅` 的算术平均，以及正、负、零数量。
- 封板资金：仅作为原始统计摘要展示，单位转换为亿元并标明来源，不解释为主力净流入。

## 状态与异常

响应统一使用 `fresh`、`delayed`、`partial`、`unavailable`。交易日不等于上海当前日期时标记 `delayed`；字段缺失或部分接口失败时标记 `partial`；连接失败、超时、HTTP 5xx 或响应格式错误时标记 `unavailable`。

## 安全与合规

AKTools 仅绑定 `127.0.0.1:8080`。Nest 不接受客户端传入上游 URL，不记录原始载荷，不向前端透传上游异常。AKShare 及其上游数据的授权和再分发边界在正式对外部署前另行评估。

## 性能目标

三个 AKTools 请求并行执行，单请求超时目标 10 秒，短线接口正常响应目标 P95 小于 12 秒。V1 不引入缓存，避免陈旧数据和缓存击穿复杂度。

## 验收标准

- 有效交易日数据可生成短线情绪 DTO 和规则结论。
- 任一 AKTools 接口失败不会导致 TDX 市场概览接口失败。
- OpenAPI、前端 API 和页面状态与后端 DTO 一致。
- API 地址固定为本机内网配置，仓库不包含真实凭据和机器地址。