2.5 KiB
2.5 KiB
GitNexus 开发前影响计划
- 功能编号：FEAT-MO-004
- 总体风险：MEDIUM（既有概览服务扩展会触及 Controller、模块、服务测试和 OpenAPI 导出；无 HIGH/CRITICAL）
直接与间接影响
查询与上下文
- GitNexus 仓库：
a-share-analysis，开发前索引与f8f4da9一致且 up-to-date。 - 影响目标：
MarketOverviewController、MarketOverviewService、createTdxClient、createAppRouter。 MarketOverviewControllerupstream：3 个直接文件消费者（概览 E2E、OpenAPI 导出、模块注册），总影响 7 个文件，风险 LOW。MarketOverviewServiceupstream：5 个直接文件消费者（概览 E2E、服务测试、OpenAPI 导出、Controller、模块），总影响 9 个文件，风险 MEDIUM。createTdxClientupstream：TDX Client 单元测试 1 个直接消费者，风险 LOW；详情复用其稳定request<T>()边界，不修改协议实现。createAppRouterupstream：App.test.ts1 个直接消费者，风险 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 前后对比 |
设计决策
- 不扩展首页接口大对象，详情接口独立，降低既有消费者的契约风险。
- 不修改
createTdxClient，只复用其超时、响应体上限和错误脱敏；分时能力未验证时明确返回不可用。 - 指数和板块共享页面外壳与 K 线点类型，但保留各自白名单和业务摘要映射。