feat(FEAT-MO-001): 接入TDX市场宽度板块与成交额趋势

This commit is contained in:
2026-08-18 17:37:36 +08:00
parent 82619489a9
commit ff8ada8316
21 changed files with 616 additions and 69 deletions
@@ -1,22 +1,24 @@
# FEAT-MO-001 TDX 只读冒烟报告
- 验证时间:2026-08-18 13:04 CST
- 网络场景:外出 Tailscale + SSH 隧道
- 验证时间:2026-08-18 17:21 CST
- 网络场景:本机回环桥接(TDX 服务可达)
- 本机业务入口:`127.0.0.1:17710`
- 请求方式:HTTP POST JSON
- 请求类型:单只公开行情 K 线只读请求
- API 入口:`127.0.0.1:3000/api/v1/market-overview`
- 请求方式:HTTP GET(业务 API)及桥接层 HTTP POST JSON
- 请求类型:市场宽度、一级行业板块、成交额趋势只读请求
- 原始载荷:未保存
## 结果
- HTTP 请求成功。
- TDX 业务 `ErrorId` 为 `0`。
- 返回字段完整性满足当前协议基线。
- 响应包含:股票代码键、K 线日期、开盘价、最高价、最低价、收盘价、成交额、成交量、复权因子和分页元数据。
- 未调用交易、账户、自选、写入或批量接口。
- 三条业务接口均返回 HTTP `200`,响应状态均为 `fresh`,`source` 均为 `tdx`。
- `/breadth`:成功汇总上证、深证和北证指数快照中的 `UpHome`、`DownHome`;`unchanged` 返回 `null`,未进行总数推算。
- `/sectors`:成功读取一级行业目录并批量获取日行情,按涨跌幅排序返回前 8 项。
- `/funds`:成功汇总三个交易所指数日行情 `Amount`,按万元转换为亿元并计算较前一交易日变化;该指标展示为“成交额趋势”,不宣称主力净流入。
- 端到端耗时:市场宽度约 `0.11s`,一级行业约 `0.27s`,成交额趋势约 `0.12s`(单次本机冒烟,不代表生产 SLA)。
- 未调用交易、账户、自选、写入接口;未保存真实行情原始载荷。
## 脱敏与限制
- 报告不保存真实价格、成交量、家庭网络地址、Tailscale 地址、SSH 用户、密钥或完整响应。
- 本报告只证明当前开发机到 TDX 的只读协议可达,不证明 7×24 生产采集、商业再分发授权或所有板块/资金方法已经可用。
- 后续接口实现必须继续以小批量只读请求验证板块、宽度和资金字段,并在映射测试中固定字段口径。
- 本报告只证明当前开发机到 TDX 的只读接口和本次映射可达,不证明 7×24 生产采集、商业再分发授权、主力净流入口径或盘中新闻接口已经可用。
- 主力净流入和盘中新闻继续保留为补充数据源需求;后续接入必须单独记录来源、权限、口径和数据质量。