GaoYiYuan_0626
497cee289f
背景：交接文档的定位是「给 AI 接手用的入口」，此前三份分散（项目根 交接文档.md
+ docs/交接文档-基金转换.md + docs/交接文档-架构改进.md），且 docs/ 两份停留在旧版
（v1.0 / v1.1，不含 T-0~T-2b、609 passed、D20 实施等进度），新会话极易被误导。
改动：
- 三份合并为项目根 交接文档.md v3.0（545 行 = §0 公共层 + §A 风控主线 + §B 基金转换线
+ §C 架构改进线）；该文件在 .gitignore:47 内，按用户要求不入库（交接文档只留本地）
- 全仓指向统一到 交接文档.md §A/§B/§C：AGENTS.md（含顶部新增「接手先读交接文档.md」）、
docs/memory/{MEMORY,TODO,FRAMEWORK,ITERATION}、PRD-架构改进与稳定性加固、
开发计划-架构改进、TODO-架构改进、开发计划-基金转换交易
- 两份 docs/交接文档-*.md 加「已废弃（2026-09-10）· 勿读」横幅并指向新入口，
保留作历史留档（不删除）
- 记录事故：对 docs/ 下中文名文件使用 git rm 会静默抹除整个 docs/ 目录（复现 2 次、
退出码 0），已零损失恢复；纪律写入 交接文档.md §0.4 与工作区记忆
无代码改动；pytest 609 passed / 3 skipped。
2.9 KiB
2.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 - 基金转换线（第 5 步进行中 · T-0/T-0b/T-1/T-2/T-2b 已完成 · 下一步 T-3）：开工入口
交接文档.md§B ·docs/PRD/PRD-基金转换交易.md（v0.9.1）·docs/项目框架设计/架构设计-基金转换交易.md（v1.0）·docs/项目框架设计/开发计划-基金转换交易.md（v1.0 · T-0~T-13 逐任务改法 + DoD） - 架构改进线（✅ 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 为准。