docs(FEAT-DS-001): 设计 AKTools 超短补充数据源

2026-08-24 20:43:14 +08:00
parent 0d0d1eea45
commit 81c48af8cc
20 changed files with 514 additions and 0 deletions
@@ -0,0 +1,37 @@
+# 代码 Review
+
+## 审查范围
+
+设计阶段审查目标为 AKTools Client、Mapper、短线 Service、DTO、Controller、Web API、配置和测试。
+
+## PRD 与设计符合性
+
+实现后检查只接入三个已验证接口，保持 TDX 独立，且不把原始 AKTools 字段直接暴露给前端。
+
+## 发现
+
+当前尚未进入代码 Review；实现完成后记录按严重级别排序的问题和处置。
+
+## 测试缺口
+
+需要覆盖上游 5xx、超时、部分接口失败、字段漂移、日期延迟和窄屏状态。
+
+## 安全与残余风险
+
+检查固定内网地址、请求参数边界、错误脱敏、日志载荷和前端构建产物；AKShare 授权和上游稳定性是残余风险。
+
+## 性能与资源影响
+
+检查并行请求、超时、响应大小和不引入缓存的边界；不得把本地单次测试宣传为生产容量证明。
+
+## GitNexus 与同步修改
+
+实现后核对变更检测结果只覆盖计划中的短线链路和文档。
+
+## 修复与复审
+
+发现问题后记录修复提交和复审证据。
+
+## 最终结论
+
+当前阶段：pending
@@ -0,0 +1,21 @@
+# 开发规范符合性 Review
+
+## 检查结果
+
+设计阶段已检查功能档案、Schema/GitNexus 前置流程、TDX 与 AKTools 边界及源码部署约束；代码实现后进行逐项复核。
+
+## 不符合项与处置
+
+当前没有代码不符合项；实现阶段若发现问题，必须在发布前修复并记录。
+
+## 安全、性能与架构检查
+
+必须确认 AKTools 仅作为外部内网 Adapter，未新增 Docker、生产数据库连接、消息链路或前端直连；同时检查超时、响应上限和降级。
+
+## GitNexus 与开发总结检查
+
+必须确认开发前后索引、影响计划、变更检测、开发总结、测试结果和 Review 记录完整。
+
+## 最终结论
+
+当前阶段：pending