28 lines
1.9 KiB
Markdown
28 lines
1.9 KiB
Markdown
# GitNexus 开发前影响计划
|
|
|
|
- 功能编号：FEAT-DS-001
|
|
- 总体风险：LOW
|
|
|
|
## 直接与间接影响
|
|
|
|
GitNexus query 以“市场概览 超短行情总结 指数 板块 宽度 资金趋势”为目标执行，未发现现有超短执行流；结果主要定位到市场概览文档、测试和 `MarketOverviewService`。
|
|
|
|
`MarketOverviewService` context：直接消费者为市场概览 Controller、Module、OpenAPI 导出和测试；现有方法为指数、摘要、宽度、板块和成交额趋势，不包含 AKTools 数据。
|
|
|
|
`MarketOverviewService` upstream impact：影响 5 个关联对象，直接关联 3 个，风险 LOW，受影响执行流 0，受影响模块 0。结论是新增 AKTools 适配器和独立短线接口，不改写现有 TDX 方法，避免扩大现有概览方法的调用面。
|
|
|
|
## 跨模块同步修改
|
|
|
|
| 范围 | 判断 | 处置 |
|
|
|---|---|---|
|
|
| HTTP/OpenAPI | 需要同步 | 新增短线情绪和短线结论 DTO、Controller 路由并重新生成契约。 |
|
|
| Web API | 需要同步 | 新增 `web/src/api/market-overview/index.ts` 的业务请求和短线页面状态。 |
|
|
| 消息契约 | 不修改 | V1 为按需读取，不发布行情事件。 |
|
|
| 数据库 | 不修改 | 不持久化 AKTools 响应，不读取生产库。 |
|
|
| Redis | 不修改 | 暂不缓存，避免在数据口径未稳定时引入一致性问题。 |
|
|
| API 进程 | 需要同步 | Nest API 增加固定内网 AKTools 客户端和超时降级。 |
|
|
| Scheduler/Worker | 不修改 | V1 无采集任务、重试队列或历史快照任务。 |
|
|
| 配置部署 | 需要同步 | 增加可选 `AKTOOLS_ENABLED`、`AKTOOLS_BASE_URL`、`AKTOOLS_TIMEOUT_MS` 模板和文档。 |
|
|
| 测试 | 需要同步 | 增加客户端、映射、Service、OpenAPI、Web 状态和 E2E 覆盖。 |
|
|
| 文档 | 需要同步 | 更新架构、开发环境、功能档案和 AKTools 内网运行说明。 |
|