GaoYiYuan_0626
8c226f0c6d
背景：远端 main 新提交 3995cb4（09-07 17:20，交接文档漏记）为 Wave 0 鉴权/ chat/防护平行实现，与已完工 T-01/T-02/T-03/T-06 同名不同路径；试合并实测 20 文件冲突（原记 9 个），另有 13 个 main 新增文件不报冲突会静默并入。 拍板：风控 Agent 按独立封装模块自治，与宿主耦合收敛到 4 个接缝。 1. 《风控Agent模块边界与合并接缝标注》入库存档：A~D 四类文件归属表； 4 接缝（S1 挂载点 main.py / S2 AuthContext / S3 settings / S4 引擎工厂）； 20 冲突文件逐个裁决（core_ro、model/suitability、conftest、02-seed-base 以模块版为准；chat/main/settings/agent_service 等公共层以 main 为主）； 三处硬伤处置：issuer 不一致改为适配器映射不统一、STAFF-90001 必保、 main infer_roles 未知 actor 默认 analyst（fail-open）记宿主侧 P1。 2. app/api/auth_adapter.py：S2 接缝适配器预制件（当前未接线，AL-09 接入）。 鸭子类型读宿主 ctx 故不依赖宿主文件；sub→actor_id、trace_id→contextvar、 perm_matches 兼容宿主 `前缀:*` 通配；缺主体即 HostAuthAdapterError， fail-closed 不静默降级。 3. tests/test_module_boundary.py：边界防呆 4 类断言——模块私有文件存在、 禁止跨层 import 宿主私有实现（gateway.*/config.database/middleware.*/ utils.input_guard/model.schemas）、AuthContext 契约完整（actor_id 与 has_role 多参）、settings 私有字段与 AGENT_TYPES 四值不漂移。 4. tests/test_auth_adapter.py：适配器 11 例（映射/回退/fail-closed/trace 绑定/通配）。 基线：406 → 436 全绿（演示库已按演练 SOP §2 重灌：AML 8 条 / 演示 7 行 / sync 33 rows）。
JinRong · 金融四 Agent 智能管家
四个 Agent（客户财富 / 代理人助手 / 数据分析 / 风控监测）共用统一数据层与合规底座。
文档
| 目录 | 内容 |
|---|---|
| docs/memory/MEMORY.md | 项目记忆入口（新 Agent 读 §0 交接清单） |
| docs/PRD/ | 风控监测 Agent PRD（v1.1）+ 风控规则表 |
| docs/项目框架设计/ | 表设计、技术选型、JWT 手册、开发计划、实现方案 |
| 交接文档.md | 最新进度速览（本地保留，不入库） |
后端结构
app/
├── api/ # 路由：chat、risk、simulate、knowledge、admin + audit_middleware、deps
├── service/ # Agent 编排、风控服务（risk/*）、RAG、记忆、鉴权、输入防护
├── tool/ # Core 只读 Tool、知识库 kb_tools、解析/Embedding/Milvus
├── gateway/ # 模拟交易网关（唯一可写 core_trade）
├── model/ # Pydantic + ORM
├── repository/ # core_ro（Core 只读）、risk_repository、session_repository
├── config/ # settings、database
├── utils/
└── main.py
环境要求
- Python 3.13+（pytest 依赖装在系统 Python）、MySQL 8.0、Redis 8、Neo4j Desktop、Ollama（bge-m3）
- Windows 原生部署（见技术选型文档）
快速启动
cp .env.example .env
pip install -r requirements.txt
# 首次：灌 Core 模拟库与同步 — 见 docs/memory/FLOW.md §0
uvicorn app.main:app --reload
python -m pytest # 406 用例
健康检查：GET http://127.0.0.1:8000/health
前端
React 19 + Vite 7 + Ant Design 5（待 init web/ 目录）。