# 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 条刷新流程，已完成回归覆盖。