From be44d569a4650d0d06347d58f1d4b532a54e9a92 Mon Sep 17 00:00:00 2001 From: YUAN Date: Mon, 7 Sep 2026 00:01:52 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E4=BA=A4=E6=8E=A5=E6=96=87=E6=A1=A3=20?= =?UTF-8?q?B8=20=E5=90=8E=E5=85=A8=E9=9D=A2=E5=90=8C=E6=AD=A5=E2=80=94?= =?UTF-8?q?=E2=80=94MEMORY=20=E8=BF=9B=E5=BA=A6/B7=C2=B7B8=20=E5=A4=8D?= =?UTF-8?q?=E5=AE=A1=E9=97=AD=E7=8E=AF/196=20=E7=BB=BF/bootstrap=20?= =?UTF-8?q?=E6=9C=AC=E6=9C=BA=E5=B0=B1=E4=BD=8D=E6=B3=A8=E8=AE=B0,=20FLOW?= =?UTF-8?q?=20=C2=A70=20=E8=A1=A5=E6=9C=AC=E6=9C=BA=E7=8A=B6=E6=80=81?= =?UTF-8?q?=E4=B8=8E=E5=B7=B2=E7=9F=A5=E5=9D=91(mysql.exe=20=E8=B7=AF?= =?UTF-8?q?=E5=BE=84/reset.ps1=20=E4=BA=A4=E4=BA=92=E5=8D=A1=E6=AD=BB),=20?= =?UTF-8?q?TODO=20=E8=BF=9B=E8=A1=8C=E4=B8=AD=E6=94=B9=20B9a?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/memory/FLOW.md | 6 +++++- docs/memory/MEMORY.md | 6 ++++-- docs/memory/TODO.md | 5 ++++- 3 files changed, 13 insertions(+), 4 deletions(-) diff --git a/docs/memory/FLOW.md b/docs/memory/FLOW.md index 5d1fde8..ba28620 100644 --- a/docs/memory/FLOW.md +++ b/docs/memory/FLOW.md @@ -48,7 +48,11 @@ RBAC 联调账号：scripts/dev/rbac-seed-reference.md Client → Gateway(JWT/RBAC) → api/chat → agent_service(LangGraph) → Tools → 存储 → 响应 + audit_log ``` -当前：**风控事件线已集成**（交易网关 → 规则引擎 → 预警/AML/L3 → 4 API，`main.py` 路由挂载 + trace 中间件 + lifespan 完成，B1~B7，180 测试绿）；对话链路待 T-01/T-07。 +当前：**风控事件线已集成 + 测试基建完成**（交易网关 → 规则引擎 → 预警/AML/L3 → 4 API，`main.py` 路由挂载 + trace 中间件 + lifespan 完成，B1~B8；B8 = conftest 演示数据校验 + 集成测试 A-1~A-5/A-7/A-9 + `tests/_ddl.py` DDL 单一事实源；B7/B8 均经独立 AI 评审闭环，196 测试绿）；剩 B9a 脚本 → B9b 演示走查；对话链路待 T-01/T-07。 + +**本机已就位状态（2026-09-06 · 已完成上述 ①~⑤，无需重做）：** `.env` 已配置（学习项目，`MYSQL_PASSWORD=123456`；NEO4J/DEEPSEEK 留空暂不影响风控）；`jinrong_core` + `jinrong_agent` 已灌库（28 客户 / AML 名单 8 条 / 演示测评已刷新 / 归属同步 28 行）；`python -m pytest` 196 绿（集成测试真连本机 MySQL；未灌库的机器自动 skip 集成模块，单测不受影响）。 + +**本机已知坑：** `mysql.exe` 不在 PATH（位于 `C:\Program Files\MySQL\MySQL Server 8.0\bin`）；`reset.ps1` 的交互式 `-p` 在自动化执行时会卡死——脚本化重灌用 `MYSQL_PWD` 环境变量传密码（交互执行不受影响，不把密码写进仓库脚本）。 ------ diff --git a/docs/memory/MEMORY.md b/docs/memory/MEMORY.md index 820135c..5d48cfa 100644 --- a/docs/memory/MEMORY.md +++ b/docs/memory/MEMORY.md @@ -9,7 +9,7 @@ **项目是什么：** 金融四 Agent（客户财富 / 代理人 / 数据分析 / 风控）共用数据层与合规底座；**不**互调 LLM，跨 Agent 走 L1/L2/L3 画像与预警表。 -**当前进度：** 需求与表设计已定 · **风控模块已落地 B1~B8**（规则/预警聚合/L3/AML/引擎/交易网关/鉴权+4 API/适当性校验/main 集成+挂账①~⑦/**B8 conftest+集成测试**，B7 复审闭环，**196 测试绿**）· 剩 **B9a 脚本 → B9b 演示走查** · **JWT(T-01) / 审计中间件(T-02) / LangGraph 对话线(T-07) 未做**（chat/knowledge/admin 仍空壳）。**开发在分支 `feature/risk`（未合入 main）。** +**当前进度：** 需求与表设计已定 · **风控模块已落地 B1~B8**（规则/预警聚合/L3/AML/引擎/交易网关/鉴权+4 API/适当性校验/main 集成+挂账①~⑦/**B8 conftest+集成测试**，B7/B8 均经独立 AI 评审闭环，**196 测试绿**）· 剩 **B9a 脚本 → B9b 演示走查** · **JWT(T-01) / 审计中间件(T-02) / LangGraph 对话线(T-07) 未做**（chat/knowledge/admin 仍空壳）。**开发在分支 `feature/risk`（未合入 main）。** **仓库地图：** @@ -46,9 +46,11 @@ 5. mysql … < scripts/agent/seed-aml-list.sql # AML 名单种子 （风控演示：scripts/demo/prepare_risk_demo.sql，reset 后重跑） 6. python scripts/sync/sync_advisor_rel.py && python scripts/sync/sync_neo4j.py -7. uvicorn app.main:app --reload → GET /health；python -m pytest（180 绿） +7. uvicorn app.main:app --reload → GET /health；python -m pytest（196 绿） ``` +> **本机（2026-09-06）①~⑤已执行、`.env` 已配置，勿重做**；本机状态与已知坑（mysql.exe 路径 / reset.ps1 交互式 -p）见 `FLOW.md` §0 尾注。 + **下一步开发（见 TODO）：** 风控 B9a 演示/运维脚本（subscribe_alerts.py / rebuild_alerts.py）→ B9b 演示走查（含 B6/B7 挂账核查单）；随后 Wave 0 T-01 JWT / T-02 审计中间件 / T-06 / T-07 LangGraph。 **禁止（改代码前必记）：** Core 正式 C1~C5 不可被画像覆盖 · 审计表只 INSERT · 代理人草稿不外发 · 仅 R-02 可阻断交易 · 四 Agent 不互调 LLM。 diff --git a/docs/memory/TODO.md b/docs/memory/TODO.md index d19f1b2..1f12d6e 100644 --- a/docs/memory/TODO.md +++ b/docs/memory/TODO.md @@ -5,10 +5,13 @@ ## 进行中 -- [ ] Wave 0 共用底座 — 验收：F-01~F-03 + agent 库灌库 + JWT 可联调 +- [ ] 风控 **B9a 演示/运维脚本**：`scripts/demo/subscribe_alerts.py`（订阅演示）+ `scripts/demo/rebuild_alerts.py`（按 trade_id 幂等重放补偿）——验收：手工执行验证；B9b 走查前先处理核查单⑥（B8 复审 P2-1 演示库耦合前置断言） ## 待办（推荐顺序） +- [ ] 风控 **B9b 演示链路走查**（reset → demo SQL → Swagger 过 A-1~A-5/A-7~A-9 + 核查单①~⑥） +- [ ] 风控 M2 收尾：MEMORY/TODO 状态复核（开发计划 M4 前置） + - [ ] T-01 Auth SDK / JWT 中间件（对照 `02-JWT-RBAC鉴权手册.md`） - [ ] T-02 audit_log 中间件 + trace_id 贯通 - [ ] T-05 本机执行 `reset.ps1` + `01-mysql-共用底座.sql` + sync 脚本验收