2.1 KiB
FEAT-MO-004 指数与板块详情分析页开发总结
- 功能编号：FEAT-MO-004
- 状态：in_review
- 发布状态：unreleased
原始开发需求
市场综合概览中的指数、板块点击后进入详细分析页，使用 TDX 真实数据展示行情和 K 线，支持后续复盘查看。
需求与范围变化
已确认首版同时覆盖指数和一级行业板块，但拆成共享外壳下的两个数据切片。TDX 能力探测发现三个分时候选方法均返回协议错误，因此首版只发布日 K 线，分时明确标记不可用。未扩大到成分股、资金流、新闻、AI、用户体系或交易操作。
实际完成需求
新增指数和板块详情 API、DTO、TDX 日 K 线映射、代码/参数白名单、统一数据状态和错误脱敏；新增 Vue 详情路由、Axios API、事实摘要、轻量 SVG K 线和响应式布局；概览指数与板块入口已接通真实导航；OpenAPI 和前端生成契约已同步。
修复缺陷
实现期间修复了板块目录记录字段与内部定义字段名不一致导致详情不可用的问题；修复了前端详情页在接口异步完成前测试读取旧加载状态的问题；修复了 Web 严格类型下可空涨跌幅的显示类型错误；补充了详情模块注册到 OpenAPI 导出入口，避免契约遗漏。
未完成与延期项
分时数据延期，等待 TDX 提供可验证协议；成分股排名、资金净流入、盘中新闻、AI 结论、数据库/Redis/RocketMQ 持久化和公网采集代理另立功能。当前详情页仍依赖开发机 TDX 隧道，不作为公网生产采集方案。
关键提交
0131f86 feat(FEAT-MO-004): 实现指数板块详情分析页，已推送项目 Gitea 分支 codex/feat-mo-004-index-sector-detail。
验证证据
TDX 脱敏能力报告记录日 K 线和一级行业目录通过、分时候选失败；GitNexus 开发前风险为 MEDIUM，开发后检测到预期 API 模块注册、OpenAPI、路由和概览导航影响；自动化、构建、视觉和移动端证据见 test-plan.md、qa/test-results.md、qa/visual-qa.md。