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 释放，当前性能证据为本机定向测试，不代表生产容量。

2.5 KiB Raw Permalink Blame History Unescape Escape