3.5 KiB
3.5 KiB
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 地址固定为本机内网配置，仓库不包含真实凭据和机器地址。