# GitNexus 开发前影响计划

- 功能编号：FEAT-MO-005
- 总体风险：中。新增结构边界本身独立，但共享响应 DTO 有 24 个上游影响项，必须保持旧接口字段和 `source=tdx` 行为兼容。

## 直接与间接影响

### `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 | 需要 | 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 测试和完整功能档案 |