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,22 @@
+# FEAT-MO-005 实施计划
+
+## 目标
+
+在综合概览保留现有指数、市场宽度、板块概览、量能和短线情绪的基础上，增加行业/题材/板块排行、资金流向和全天成交额趋势，并让每个模块独立处理 `fresh`、`delayed`、`partial`、`unavailable`。
+
+## 已执行步骤
+
+1. 完成 TDX/AKTools 能力探针和脱敏记录。
+2. 建立市场结构领域类型、映射和 AKTools 固定端点客户端。
+3. 增加三个独立 Nest API 路由并生成 OpenAPI 契约。
+4. 接入 Web Axios API 分域和 composable 独立状态。
+5. 实现三个 Vue 面板、分类切换、轻量 SVG 趋势图和响应式样式。
+6. 完成服务端注入回归、组件测试、全量构建、E2E 和视觉检查。
+
+## 约束与回退
+
+不新增数据库、Redis、RocketMQ 或异步任务；不保存原始行情载荷；AKTools 未启用时页面展示不可用状态。若上游字段口径不明确，保持 `null`/`unavailable`，禁止从涨跌或成交额推导资金流。
+
+## 安全策略与性能目标
+
+复用既有服务端来源白名单、Axios 边界和脱敏错误。前端仅消费 Nest API，不接触 TDX/AKTools 地址或凭据。列表请求限制为 Top 100，排序和 SVG 点计算为线性复杂度，组件不引入新运行时依赖。剩余风险是免费上游在交易时段的稳定性和延迟尚未完成生产级验证。