diff --git a/docs/memory/ENVIRONMENT.md b/docs/memory/ENVIRONMENT.md index c163b23..f825e37 100644 --- a/docs/memory/ENVIRONMENT.md +++ b/docs/memory/ENVIRONMENT.md @@ -25,14 +25,14 @@ - **内部分析**:SQL 或 IT 导表。 - **风控**:事后/T+1 发现异常;适当性靠交易前规则;AML 批处理或人工。 -Agent **尚未上线**;后端为脚手架 + 模拟数据,无生产接入。 +Agent **尚未上线**;后端风控事件线已实现(`feature/risk` 分支,B1~B7),其余 Agent 仍为脚手架;无生产接入。 ------ ## 3. 主路径(现状 → 模拟后) 1. 开户/测评 → Core(模拟:`core_customer` + `core_customer_risk`)写 L0 -2. 交易 → Core 流水(模拟:`core_trade`);交易前适当性(R-02 待实现) +2. 交易 → Core 流水(模拟:`core_trade`);交易前适当性 R-02 **已实现**(模拟网关 `app/gateway/` + `service/suitability.py`,唯一阻断点) 3. 同步 → `sync_advisor_rel.py` 写入 agent 库 `customer_advisor_rel`;`sync_neo4j.py` 灌关系图 4. 代理人服务 → 查 Core RO + 口头沟通(L2 画像表待业务实现) 5. 风控 → 规则/人工台账;合规事后抽检 diff --git a/docs/memory/MEMORY.md b/docs/memory/MEMORY.md index 8de59fd..6e17e15 100644 --- a/docs/memory/MEMORY.md +++ b/docs/memory/MEMORY.md @@ -9,7 +9,7 @@ **项目是什么:** 金融四 Agent(客户财富 / 代理人 / 数据分析 / 风控)共用数据层与合规底座;**不**互调 LLM,跨 Agent 走 L1/L2/L3 画像与预警表。 -**当前进度:** 需求与表设计已定 · **风控模块已落地 B1~B7**(规则/预警聚合/L3/AML/引擎/交易网关/鉴权+4 API/适当性校验/**main 集成+挂账①~⑦**,**180 测试绿**)· 剩 **B8 conftest+集成测试 → B9a 脚本 → B9b 演示走查** · **JWT(T-01) / 审计中间件(T-02) / LangGraph 对话线(T-07) 未做**(chat/knowledge/admin 仍空壳)。 +**当前进度:** 需求与表设计已定 · **风控模块已落地 B1~B7**(规则/预警聚合/L3/AML/引擎/交易网关/鉴权+4 API/适当性校验/**main 集成+挂账①~⑦**,**180 测试绿**)· 剩 **B8 conftest+集成测试 → B9a 脚本 → B9b 演示走查** · **JWT(T-01) / 审计中间件(T-02) / LangGraph 对话线(T-07) 未做**(chat/knowledge/admin 仍空壳)。**开发在分支 `feature/risk`(未合入 main)。** **仓库地图:** @@ -35,16 +35,18 @@ | `docs/项目框架设计/Core模拟底座/` | 已定 | 无真实 Core 时的 L0 方案 | | `web/` | **不存在** | 前端 React 待 init | -**本地 bootstrap(首次):** +**本地 bootstrap(首次):** 完整步骤与前置说明见 `FLOW.md` §0(权威),速览: ```text -1. cp .env.example .env → 填 MYSQL_PASSWORD、NEO4J、DEEPSEEK_API_KEY +1. cp .env.example .env → 填 MYSQL_PASSWORD、NEO4J_PASSWORD、DEEPSEEK_API_KEY 2. pip install -r requirements.txt -3. .\scripts\core\reset.ps1 # 建 jinrong_core + 种子 -4. mysql … < 表设计/01-mysql-共用底座.sql # jinrong_agent(若未建) -5. python scripts/sync/sync_advisor_rel.py -6. python scripts/sync/sync_neo4j.py -7. uvicorn app.main:app --reload # GET /health +3. .\scripts\core\reset.ps1 # 建 jinrong_core 模拟库 + 种子 +4. mysql … < 01-mysql-共用底座.sql # jinrong_agent 共用 11 表 + mysql … < 02-mysql-agent专用.sql # 风控四表 + risk_aml_list +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 绿) ``` **下一步开发(见 TODO):** 风控 B8 conftest+集成测试(A-1~A-5/A-7~A-9 + trace 一致性 + sqlite DDL 收敛)→ B9a 演示/运维脚本 → B9b 演示走查;随后 Wave 0 T-01 JWT / T-02 审计中间件 / T-06 / T-07 LangGraph。 @@ -137,6 +139,10 @@ RBAC 联调账号:scripts/dev/rbac-seed-reference.md | `docs/memory/FLOW.md` | 端到端链路 + 本地 bootstrap | | `docs/memory/ENVIRONMENT.md` | As-Is 业务环境与 Core 模拟说明 | | `docs/memory/TODO.md` | 当前待办与已完成 | +| `docs/PRD/PRD-风控监测Agent.md` | 风控 PRD v1.0(已冻结;FR-1~FR-7 + §8 验收表) | +| `docs/PRD/附-风控规则表.md` | RISK-001~005 / SUIT-001~008 / AML 规则权威 | +| `docs/项目框架设计/开发计划-风控模块.md` | 风控分阶段计划(阶段 A/B/C + 挂账登记)**B8 前必读** | +| `docs/项目框架设计/架构设计-风控模块.md` | 风控模块架构(§3.1 编排 / §5 service 职责) | | `docs/需求拆解/` | 业务原文(场景、矩阵、合规) | | `docs/项目框架设计/` | 表结构、JWT 手册、Core 模拟、技术版本 | | `docs/业务记忆管理/` | Redis 短期 vs MySQL/Milvus/Neo4j 权威记忆 | @@ -157,6 +163,6 @@ RBAC 联调账号:scripts/dev/rbac-seed-reference.md 2. 改动属于 api / service / tool / repository 哪一层? 3. 是否需 customer_id 归属与 JWT RBAC? 4. Core 是模拟库只读还是 agent 库读写? -5. 如何验证?(health / SQL / sync 脚本 / 对照 REQUIREMENTS 验收列) +5. 如何验证?(`python -m pytest` 全量(当前 180 绿)· uvicorn 启动 + /health · SQL / sync 脚本 · 对照 REQUIREMENTS 验收列) 大任务:FRAMEWORK/FLOW 与实现状态不符时先更新 memory 再编码(用户确认跳过除外)。