feat(FEAT-MO-004): 实现指数板块详情分析页

2026-08-25 00:16:43 +08:00
parent f8f4da93dc
commit 0131f863b6
32 changed files with 2262 additions and 8 deletions
@@ -0,0 +1,28 @@
+# GitNexus 开发前基线
+
+- 功能编号：FEAT-MO-004
+- 记录时间：2026年8月24日 GMT+8 23:37:42
+- 分支：main
+- 基线提交：f8f4da93dc8f
+
+## 工作区
+
+```text
+?? "SRMS3.6.0\345\270\270\350\247\201\351\227\256\351\242\230\346\265\213\350\257\204\351\242\230.2csv"
+?? docs/features/FEAT-MO-004-index-sector-detail/
+?? docs/superpowers/plans/2026-08-24-index-sector-detail.md
+```
+
+## GitNexus 状态
+
+```text
+Repository: /Users/citrons/Documents/Codex/2026-08-12/wo-x/a-share-analysis
+Indexed: 8/24/2026, 11:37:41 PM
+Indexed commit: f8f4da9
+Current commit: f8f4da9
+Status: ✅ up-to-date
+```
+
+## 后续人工分析
+
+在修改代码前，将 GitNexus query、context、impact 的结论写入 `gitnexus/impact-plan.md`。高风险结果必须先获得用户确认。
@@ -0,0 +1,37 @@
+# GitNexus 开发前影响计划
+
+- 功能编号：FEAT-MO-004
+- 总体风险：MEDIUM（既有概览服务扩展会触及 Controller、模块、服务测试和 OpenAPI 导出；无 HIGH/CRITICAL）
+
+## 直接与间接影响
+
+### 查询与上下文
+
+- GitNexus 仓库：`a-share-analysis`，开发前索引与 `f8f4da9` 一致且 up-to-date。
+- 影响目标：`MarketOverviewController`、`MarketOverviewService`、`createTdxClient`、`createAppRouter`。
+- `MarketOverviewController` upstream：3 个直接文件消费者（概览 E2E、OpenAPI 导出、模块注册），总影响 7 个文件，风险 LOW。
+- `MarketOverviewService` upstream：5 个直接文件消费者（概览 E2E、服务测试、OpenAPI 导出、Controller、模块），总影响 9 个文件，风险 MEDIUM。
+- `createTdxClient` upstream：TDX Client 单元测试 1 个直接消费者，风险 LOW；详情复用其稳定 `request<T>()` 边界，不修改协议实现。
+- `createAppRouter` upstream：`App.test.ts` 1 个直接消费者，风险 LOW；新增路由需要补充路由测试和根路径回归。
+- `MarketOverviewPage` 未被索引为符号，按文件级人工检查确认只消费概览 composable 和两个选择事件；新增导航不改变概览请求契约。
+- 执行流：详情是新增只读 HTTP 流程；既有首页五个概览流程仅通过模块注册和共享 TDX Client 间接关联，需回归验证。
+
+## 跨模块同步修改
+
+| 范围 | 判断 | 同步动作 |
+| --- | --- | --- |
+| HTTP/OpenAPI | 需要 | 新增两个详情路由、DTO、生成 OpenAPI 并校验 |
+| Web API | 需要 | 新增详情 Axios 文件与类型适配 |
+| 消息契约 | 不需要 | 只读同步请求，不产生消息 |
+| 数据库/Redis | 不需要 | 不持久化、不缓存，且不触碰生产库 |
+| API 进程 | 需要 | 注册详情 Controller/Service，复用已校验 TDX Client |
+| Scheduler/Worker | 不需要 | 无异步任务或定时采集 |
+| 配置/部署 | 不需要 | 继续使用现有 TDX 配置和内网隧道，不新增环境变量 |
+| 测试 | 需要 | Mapper、Service、HTTP、Web 路由/状态、视觉和全量门禁 |
+| 文档 | 需要 | 功能档案、TDX 探测、开发总结、Review、QA、GitNexus 前后对比 |
+
+### 设计决策
+
+1. 不扩展首页接口大对象，详情接口独立，降低既有消费者的契约风险。
+2. 不修改 `createTdxClient`，只复用其超时、响应体上限和错误脱敏；分时能力未验证时明确返回不可用。
+3. 指数和板块共享页面外壳与 K 线点类型，但保留各自白名单和业务摘要映射。