3.9 KiB
3.9 KiB
Agent
⚡ 需要接手/开工，先读项目根「交接文档.md」 —— 三线合并版唯一交接入口：
§0 公共层（铁律 / 环境 / 已知坑 / 禁止事项）· §A 风控模块主线 · §B 基金转换（convert）线 · §C 架构改进线。
（该文件在 .gitignore 内、不入库，是给 AI 接手用的本地文件；docs/交接文档-*.md 两份为历史留档，内容已过期，勿读。）
无上下文时先读 docs/memory/MEMORY.md §0 交接清单（5 分钟了解仓库地图、bootstrap、禁止项、下一步）。
阅读顺序
| 顺序 | 文件 | 何时 |
|---|---|---|
| 1 | docs/memory/MEMORY.md |
每次任务 |
| 2 | docs/memory/TODO.md |
取当前待办 |
| 3 | docs/memory/REQUIREMENTS.md |
对照场景 ID（F/C/A/D/R） |
| 4 | docs/memory/FRAMEWORK.md |
分层、选型、实现状态表 |
| 5 | docs/memory/FLOW.md |
端到端链路 + §0 bootstrap |
| 6 | docs/memory/ENVIRONMENT.md |
As-Is；Core 为模拟库 |
原文与深度文档
- 业务需求：
docs/需求拆解/ - 表结构 SQL：
docs/项目框架设计/表设计/ - 技术选型 / JWT：
docs/项目框架设计/技术选型和版本/ - Core 模拟底座：
docs/项目框架设计/Core模拟底座/ - 业务记忆分层：
docs/业务记忆管理/业务记忆管理手册.md - 基金转换线（✅ 全流程收官 2026-09-12 · T+1 受理/确认分离模型 · AIcoding 六步全部完成）：第 5 步 T-1 ~ T-17 全部完成 + 第 6 步集成测试 ✅ 通过（集成测试零代码改动五步全过：按 SOP 重灌双库（DoD 断言全 PASS 含 ⑨a/⑩/⑫）→ 全量 849 passed / 8 skipped 零失败 → CONVERT_STRESS=1 7/7（T-15 争批用例加入）→ 真库 verify 套件 9/9 退出码 0：accept 43 / confirm 103 / engine 39 / api 89 / compensate 56 / apply 30 / lots 20 / tools 14 / seed 全 PASS → 残留检查零命中 + 收尾重灌恢复干净演示态；验收 31 紧池重测 = 受理 50/50 + 串行确认 50/50 = 100%、验收 18 性能重测端到端 P50 78.8 / P95 94.8 ms（< 2s 余量约 20 倍）；执行记录 = 开发计划 §10 +
docs/memory/2026-09-12.md；README 已更新（2026-09-12：最新更新章节 + 前端已留接口契约）；分支已于 2026-09-12 用户授权推送远程（以git ls-remote为准），合并 main 由合并执行人负责）；开工入口交接文档.md§B（§B.11 下一条立项指引 = 最新状态）·docs/PRD/PRD-基金转换交易.md（v1.1）·docs/项目框架设计/架构设计-基金转换交易.md（v2.1）·docs/项目框架设计/开发计划-基金转换交易.md（v2.0 · T-1~T-17 逐任务改法 + DoD + §10 集成测试记录） - 架构改进线（✅ 2026-09-10 已结项，无待办）：开工入口
交接文档.md§C - 风控模块主线：
交接文档.md§A
代码入口
app/main.py # FastAPI：路由挂载 + trace/audit 中间件 + lifespan（风控 4 API + /api/simulate + /api/chat 四端点已挂载）
app/api/chat.py # 对话：POST ""（同步）+ GET /sessions + GET /sessions/{id}/messages + POST /sessions/{id}/close（方案 B）+ POST /stream（SSE 流式，方案 C）
app/api/deps.py # 鉴权工厂（T-01 JWT：Bearer 优先，dev debug 头兜底）+ 归属断言
app/service/auth_service.py # Auth SDK：JWT 验签/吊销（T-01）；签发 CLI scripts/dev/issue_dev_token.py
app/service/agent_service.py # LangGraph StateGraph 骨架 + DeepSeek（T-07）
app/config/settings.py # 双库 jinrong_agent + jinrong_core + risk_* 阈值 + JWT 配置
app/repository/core_ro.py # Core 只读（已实现）
scripts/core/reset.ps1 # 本地灌 Core 模拟库
技术选型硬阀门见 MEMORY 第 3、7 节。Cursor 以 .cursor/rules/project-memory.mdc 为准。