a-share-analysis/docs/features/FEAT-MO-005-market-structure-turnover/development-summary.md

FEAT-MO-005 开发总结

• 功能编号：FEAT-MO-005
• 日期：2026-08-25
• 发布状态：未发布，当前分支已推送 Gitea

原始开发需求

综合概览需要覆盖全部板块、题材和行业的涨跌幅排行、资金流入/流出排行，以及全天成交额趋势图；用户可点击进入详细分析，分时 K 线不作为本轮首页重点。

需求与范围变化

• 根据数据源探针结果，行业/题材/资金流保留固定 AKTools 适配，但当前不可用时必须保守降级。
• 独立 API 继续按模块拆分，没有把整个首屏合并成一个聚合接口。
• 板块分类未验证独立上游端点，因此保留切换入口但返回 unavailable。
• 没有引入数据库、Redis、RocketMQ、AI 或用户体系。

实际完成需求

需求	状态	结果
行业/题材/板块强弱排行	已完成	新增 SectorRankingPanel，支持分类、涨跌/成交额排序和详情事件。
资金流向排行	已完成	新增 CapitalFlowPanel，只展示上游明示净额，缺失值显示未提供。
全天成交额趋势	已完成	新增 TurnoverTrendPanel，支持累计亿元和 SVG 趋势线。
前端分类真实刷新	已完成	composable 分类切换会重新请求对应 API。
既有模块兼容	已完成	指数、宽度、板块概览、量能和短线情绪均保留。

修复缺陷

E2E 首次运行发现 MarketStructureController 未使用显式 Nest 服务注入，三个新路由因此返回 400。已增加 @Inject(MarketStructureService)，服务端回归测试和 E2E 均通过。

未完成与延期项

AKTools 交易时段实时性、行业/题材/资金流生产稳定性和独立板块数据源仍待验证；本轮不承诺实时生产数据。详情页 K 线和 AI 分析不在本功能范围。

关键提交

提交	内容	推送
50b5266..b6a9f40	数据源探针、领域映射和契约	已推送
8174f3f..ad40fff	三路结构与成交额 API	已推送
b95b9e5	Web 数据层	已推送
64a9f2e	首屏面板、响应式样式、注入修复	已推送

验证证据

• Web：14 个 Vitest 文件、39 个测试；类型检查通过。
• Server：21 个 Vitest 文件、110 个测试及 Node 冒烟通过。
• 根级 lint、Prettier、typecheck、test、build 通过；lint 仅有既有 Vue 风格 warning，无 error。
• Playwright：桌面和 390px 移动视口共 4 项通过，无横向溢出和运行时错误。
• 1440px/390px 截图已检查；AKTools 不可用状态展示符合降级设计。
• GitNexus 提交前检测：中风险，10 文件/47 符号/1 条刷新流程，已完成回归覆盖。