feat(FEAT-DS-001): 接入AKTools超短行情补充数据源

2026-08-24 21:40:22 +08:00
parent 81c48af8cc
commit 6e8a05114e
42 changed files with 1449 additions and 36 deletions
@@ -10,19 +10,19 @@

 ## 发现

-当前尚未进入代码 Review；实现完成后记录按严重级别排序的问题和处置。
+已完成实现 Review：未发现阻断项。Client 只允许三个固定 AKTools 路径，Service 用 `Promise.allSettled` 做模块级降级，DTO 不透传中文原始字段；Web 只通过 Axios API 文件访问 Nest。发现页面接线遗漏 `shortTermConclusion` 未解构，已在测试失败后修复。

 ## 测试缺口

-需要覆盖上游 5xx、超时、部分接口失败、字段漂移、日期延迟和窄屏状态。
+上游 5xx、超时、部分接口失败、字段非法、响应大小、不可用状态和窄屏布局已有定向覆盖；交易日期延迟口径和 AKShare 字段漂移仍需后续真实交易日联调。

 ## 安全与残余风险

-检查固定内网地址、请求参数边界、错误脱敏、日志载荷和前端构建产物；AKShare 授权和上游稳定性是残余风险。
+固定地址白名单、日期参数校验、固定接口、超时、响应体上限、JSON 结构校验和错误脱敏均已检查；未发现凭据或原始载荷进入前端。残余风险为 AKShare 授权、上游限流/字段变更和生产多机访问控制，故生产默认关闭。

 ## 性能与资源影响

-检查并行请求、超时、响应大小和不引入缓存的边界；不得把本地单次测试宣传为生产容量证明。
+三个请求并行，10 秒超时，2 MiB 响应上限，不引入缓存和消息链路；测试证据仅证明行为和边界，不构成生产容量证明。

 ## GitNexus 与同步修改

@@ -34,4 +34,4 @@

 ## 最终结论

-当前阶段：pending
+最终结论：passed
@@ -6,16 +6,16 @@

 ## 不符合项与处置

-当前没有代码不符合项；实现阶段若发现问题，必须在发布前修复并记录。
+逐项检查通过：功能档案、中文注释、OpenAPI 生成契约、Axios API 边界、固定数据源 Adapter、模块级降级、环境模板和未提交凭据约束均符合规范。实现期间发现的页面接线遗漏已修复并由前端全量测试复验。

 ## 安全、性能与架构检查

-必须确认 AKTools 仅作为外部内网 Adapter，未新增 Docker、生产数据库连接、消息链路或前端直连；同时检查超时、响应上限和降级。
+确认 AKTools 仅作为外部内网 Adapter，未新增 Docker、Python 服务、生产数据库连接、Redis/RocketMQ 消息链路或前端直连；超时、响应上限、并行请求和降级均有实现与测试证据。生产启用的授权、访问控制和容量评估仍是明确前置条件。

 ## GitNexus 与开发总结检查

-必须确认开发前后索引、影响计划、变更检测、开发总结、测试结果和 Review 记录完整。
+开发前后 GitNexus 报告、影响计划、变更检测、开发总结、测试结果、视觉 QA、Review 和回退说明均已补齐；`governance:finish` 及最终提交前再次执行变更检测。

 ## 最终结论

-当前阶段：pending
+最终结论：passed