feat(FEAT-MO-005): 建立市场结构数据映射边界
This commit is contained in:
@@ -1,12 +1,36 @@
|
||||
# GitNexus 开发前影响计划
|
||||
|
||||
- 功能编号:FEAT-MO-005
|
||||
- 总体风险:低。新增独立 Node 探针和功能档案,不修改既有函数、类、方法、HTTP 路由或运行时配置。
|
||||
- 总体风险:中。新增结构边界本身独立,但共享响应 DTO 有 24 个上游影响项,必须保持旧接口字段和 `source=tdx` 行为兼容。
|
||||
|
||||
## 直接与间接影响
|
||||
|
||||
执行 `gitnexus_impact({ target: "market-structure-capability", direction: "upstream", minConfidence: 0.8 })`:目标尚未在索引中,返回零消费者与 `UNKNOWN`。这是新增符号的预编辑预期,等价于当前无直接调用者;本任务不触碰既有符号,因此无既有执行流受影响。
|
||||
### `MarketOverviewMetaDto`(MEDIUM)
|
||||
|
||||
- 直接影响 12 项:现有 summary、indices、breadth、sectors、funds 响应 DTO,TDX mapper、详情 DTO/mapper、controller 和 service。
|
||||
- 间接影响 12 项:概览和详情 e2e、OpenAPI 导出、模块注册及相关测试。
|
||||
- 决策:新增数据源联合类型时只扩展 `source` 的允许值,不改变既有 TDX 响应结构;所有旧测试必须继续通过。
|
||||
|
||||
### `MarketOverviewService`(MEDIUM)
|
||||
|
||||
- 直接影响 7 项:概览 e2e、服务测试、OpenAPI 导出、模块/controller 和详情服务引用。
|
||||
- 间接影响 6 项:API 入口和进程冒烟测试。
|
||||
- 决策:新结构服务独立注入,不重写现有 `MarketOverviewService` 的业务流程;仅在模块注册层增加 provider/controller。
|
||||
|
||||
### `createAktoolsClient`(LOW)
|
||||
|
||||
- 直接影响 1 项:现有 AKTools client 测试。
|
||||
- 决策:不扩展短线 client 的固定端点,新增 `AktoolsStructureClient`,避免行业/资金接口与短线情绪接口耦合。
|
||||
|
||||
GitNexus `query("市场概览 板块排行 资金流入流出 成交额趋势 TDX AKTools")` 定位到现有概览流程、TDX mapper 和 AKTools 模块;本任务后续只新增 structure 领域文件,不改变已验证的短线流程。
|
||||
|
||||
## 跨模块同步修改
|
||||
|
||||
HTTP/OpenAPI、Web API、消息契约、数据库、Redis、API、Scheduler、Worker、配置部署均不修改。新增 Node 测试、探针与功能档案;后续若将任何源接入 Nest API,必须重新进行该目标的符号级影响分析。
|
||||
| 范围 | 判断 | 说明 |
|
||||
| --- | --- | --- |
|
||||
| HTTP/OpenAPI | 需要 | Tasks 3–5 新增三个独立只读路由,Task 6 重新生成契约 |
|
||||
| Web API/前端 | 需要 | Task 6 添加 Axios API 和 composable 状态,Task 7 添加面板 |
|
||||
| 消息契约、数据库、Redis、Scheduler、Worker | 不需要 | 本切片只读请求,无持久化、缓存和异步任务 |
|
||||
| API 模块注册 | 需要 | `market-overview.module.ts` 增加结构 controller/provider |
|
||||
| 配置部署 | 不需要 | 复用已存在的本机 TDX/AKTools 配置,不新增凭据或地址 |
|
||||
| 测试与文档 | 需要 | 新增 mapper/service/API/UI/E2E 测试和完整功能档案 |
|
||||
|
||||
Reference in New Issue
Block a user