34 lines
2.5 KiB
Markdown
34 lines
2.5 KiB
Markdown
# AKTools 超短行情补充数据源开发总结
|
||
|
||
- 功能编号：FEAT-DS-001
|
||
- 状态：in_review
|
||
- 发布状态：unreleased
|
||
|
||
## 原始开发需求
|
||
|
||
在内网环境使用已经运行的 AKTools，补充 TDX 不提供的超短行情数据。
|
||
|
||
## 需求与范围变化
|
||
|
||
V1 采用 AKTools 外部服务直连，不新增 Python 服务和 Docker；暂不接入全市场现货接口，因为该接口本地验证返回 HTTP 500。
|
||
|
||
## 实际完成需求
|
||
|
||
已完成 AKTools 配置校验、固定接口 Client、中文字段 Mapper、短线情绪与规则结论 DTO/Service/Controller、OpenAPI 生成契约、Vue Axios API、Composable 状态、短线情绪面板和开发/生产环境模板。页面通过独立状态展示正常、部分、延迟、不可用和空数据，不阻塞 TDX 模块。
|
||
|
||
## 修复缺陷
|
||
|
||
修复了短线情绪面板缺失导致的前端测试导入失败，并补齐页面未消费短线结论响应的问题；同时修复页面接线遗漏造成的 `shortTermConclusion` 未定义告警。补充修复 MySQL 健康检查因 `mysql2` 的 `timezone` 选项不会设置服务端会话时区而误判不可用的问题：健康检查现在在同一连接上显式执行 `SET SESSION time_zone = '+08:00'`，完成元数据校验后始终释放连接。未发现 TDX 回归。
|
||
|
||
## 未完成与延期项
|
||
|
||
炸板率严格口径、资金净流入、盘中新闻、历史快照和生产授权评估不属于 V1。
|
||
|
||
## 关键提交
|
||
|
||
关键提交：`6e8a051 feat(FEAT-DS-001): 接入AKTools超短行情补充数据源`、`61283c5 docs(FEAT-DS-001): 完成AKTools治理追溯`、`1398804 style(FEAT-DS-001): 统一超短行情代码格式`、`358004f docs(FEAT-DS-001): 更新最终GitNexus基线`、`9ff6646 fix(FEAT-DS-001): 修正MySQL健康检查会话时区`，均已推送 `origin/main`。
|
||
|
||
## 验证证据
|
||
|
||
Schema 基线与校验通过（`v0.0.10 captured_empty`）；开发前 GitNexus 风险 LOW，页面改动前对 `useMarketOverview` 影响分析为 LOW；后端 15 个测试文件 80 个测试通过，前端 8 个测试文件 23 个测试通过，Web typecheck 通过，`pnpm verify` 全量门禁通过且 Playwright 4 个测试通过。健康接口真实验证返回 HTTP 200，MySQL 为 5.7.42 / `a_share_analysis_dev` / `+08:00`。安全边界包括回环地址白名单、固定接口、超时、响应体上限、JSON 校验和错误脱敏；三个上游请求并行，单请求超时 10 秒，MySQL 健康查询使用连接级 finally 释放，当前性能证据为本机定向测试，不代表生产容量。
|