group_xinghuo_jinrong/docs/memory/TODO.md

# TODO

> 大任务开始时更新；完成一步打钩并验证后再往下。  
> **新 Agent：** 先看 `MEMORY.md` §0 交接清单，再从此处取下一项。

## 进行中

- [ ] 风控 M2 收尾：MEMORY/TODO 状态复核（开发计划 M4 前置）——B1~B9b 已全部完成（M2 tag 已打），复核边界文字对齐后转 Wave 0

## 待办（推荐顺序）

- [ ] T-01 Auth SDK / JWT 中间件（对照 `02-JWT-RBAC鉴权手册.md`）
- [ ] T-02 audit_log 中间件 + trace_id 贯通
- [ ] T-05 本机执行 `reset.ps1` + `01-mysql-共用底座.sql` + sync 脚本验收
- [ ] T-06 挂载 `app.api` 路由到 `main.py`；chat 最小闭环
- [ ] T-07 LangGraph `agent_service` StateGraph 骨架 + DeepSeek
- [ ] T-04 Core RO 封装为 Tool 节点；A-01 归属校验
- [ ] T-21 Milvus Lite + kb_product_rules 首批入库
- [ ] 前端 React 多 Agent 入口（HashRouter，`web/` init）

### 风控模块（PRD v1.0 已冻结 · `docs/PRD/PRD-风控监测Agent.md`，事件驱动线不依赖 T-07 可先行）

- [ ] T-30 风控事件线：`app/gateway/` 交易网关 + `service/risk/` 规则引擎（RISK-001~005）+ 预警单聚合 + L3 最小写入 + `risk:pub:alert` 推送 + AML（含 `risk_aml_list` 种子）+ 演示数据脚本验收 A-1~A-5/A-9 —— **进度（2026-09-06）：B1 规则纯函数 / B2 预警服务 / B3 L3 写入（risk_score 一期不写）/ B4 AML+引擎编排 / B5 交易网关 / B6 鉴权+4 API+处置编排 / B7 main 集成（路由挂载 + trace 中间件 + lifespan 启动期 debug 校验；挂账①锁公共化 ②L3 缓存 DEL ③死代码 ④统一错误体 ⑤启动校验 ⑥引擎工厂 ⑦处置原子事务均落地；⑧ input_guard_log 双写仍随 T-02）均完成并经独立 AI 评审闭环（B7 复审有条件通过→P1-1 dispose 已修闭环；183 测试绿；P2/P3 已登记开发计划 B7/B8/B9b/T-02）；**B8 已完成（2026-09-06）：conftest（演示数据校验/幂等代跑 prepare_risk_demo/TRD-TEST- teardown + L3 快照还原）+ 集成测试 11 例（A-1~A-5/A-7/A-9 + trace 一致性 + 审计 JSON）+ sqlite DDL 单一事实源 `_ddl.py`（10 文件收敛，localtime 时区收敛 B5 P3-4）+ L3 DEL 行为断言（P2-1）+ locks 文案（P3-2）；B8 复审有条件通过→P1-1 conftest skip 路径炸收集已修闭环（故障注入验证），P2-1 演示库耦合前置断言挂 B9b 核查单⑥**；**B9a 已完成（2026-09-07）：`scripts/demo/subscribe_alerts.py`（risk:pub:alert 订阅演示：连接自检/--duration/心跳）+ `rebuild_alerts.py`（按 trade_id 幂等重放：`find_alerts_by_trade` 以 payload LIKE 查已入单（含 aml/已处置单）防重复出单与重复 append；engine_error 中断笔 skip 时 warning 提示人工核对；core_ro 新增只读 `get_trade_by_id`）+ tests/test_demo_scripts.py 8 例；真库手工验证通过（rebuilt→skipped→missing exit1；订阅端到端收到假消息+真交易推送且 trace 贯通；中间态警示路径复验），验证现场已清理；独立 AI 评审有条件通过→P2-1 中间态警示/P2-2 非首笔幂等用例已闭环**；**B9b 已完成（2026-09-07）：前置代码三件（①预警类 API 固定 disclaimer ②scan_all 幂等防护 `find_recent_aml_alert`+`skipped_existing` ③核查单⑥集成测试前置断言 A-1/A-3/A-4 清洁检查+A-5 按 trade_id 定位），208 绿；演示 SOP `docs/项目框架设计/演示SOP-风控模块.md`；真服务走查（uvicorn+真库）A-1~A-5/A-7/A-9+核查单①②④⑤ 全 PASS（11/11，A-6 归 M3），核查单⑥防护现场复现验证；走查演示数据按 SOP 保留、pytest 集成前需重灌；M2 达成打 tag risk-m2（M1 未打 tag 留痕）——核查单①~⑥ 全部收口，风控阶段 B 完结**；**B9b 复审有条件通过→闭环（2026-09-07）：P2-1 SOP 交互重灌补 DROP agent / P2-2 补做 T-31 名下 P2-8 手工 SQL 对照收口 / P2-3 走查范围与 11/11 口径统一；P3 落地：A-4/A-9 COUNT 当日窗、已处置单幂等用例、suitability/check 阻断响应补 G-08 两要素、记忆文档数字同步；留痕：scan_all 幂等读后写无锁（演示场景可接受，批量时接 run_locked），209 绿**
- [ ] T-31 `service/suitability.py` 公共校验（SUIT-001~008）+ `POST /api/risk/suitability/check` + 单测验收 A-8 —— **代码已完成（A1~A4 · 77 测试绿；B6 起该 API 带鉴权+直调审计；B9b 复审补 G-08 两要素 advice/notice）；MySQL 手工 SQL 对照（阶段 A 评审 P2-8）已于 2026-09-07 收口：4 组演示组合真库 SQL 推导与函数判定逐项一致（登记演示 SOP 核查单附行）**
- [ ] T-32 预警台账与人工处置 API（`GET /alerts`、`POST /handle`，risk_officer/compliance 权限）+ 对话线（依赖 T-01/T-03/T-07）验收 A-6/A-7 —— **API 部分已由 B6 覆盖并复审通过（A-7/A-9 用例绿）；对话线仍依赖 T-01/T-03/T-07**

## 已完成

- [x] 2026-09-05 init 项目记忆目录 + `app/` 脚手架（api/service/tool/model/config/utils）
- [x] 2026-09-05 需求拆解文档（业务场景/矩阵/合规）
- [x] 2026-09-05 表设计 + 技术选型 + JWT 手册
- [x] 2026-09-05 Core 模拟库 `scripts/core/*` + `reset.ps1` + 文档
- [x] 2026-09-05 `core_ro.py` + `settings.mysql_core_database` + sync 脚本
- [x] 2026-09-05 Agent 编排依赖改为 LangGraph（requirements.txt）
- [x] 2026-09-05 memory 文件夹更新（新 Agent 交接清单）