docs(FEAT-MO-005): 完善市场结构功能追溯档案

2026-08-25 02:38:06 +08:00
parent 64a9f2e866
commit 21393ef451
11 changed files with 223 additions and 1 deletions
@@ -0,0 +1,52 @@
+# 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 条刷新流程，已完成回归覆盖。