4.7 KiB
4.7 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/需求拆解/ - 代销平台 API 契约：
docs/项目框架设计/接口契约-代销平台API-v0.1.md（canonical 路径 · 命名 · Agent 迁移表） - 行情 Phase B（草案）：
docs/项目框架设计/接口契约-代销平台API-v0.2-行情扩展草案.md·docs/项目框架设计/C-05-行情数据源选型对比.md - 表结构 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；里程碑 tagconvert-m1已打并推送远程（指向收官提交292770f，ls-remote 校验）；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：AL-09 已集成（宿主 TraceMiddleware + 模块 audit/trace + auth/chat/risk/simulate）
app/api/auth.py # Mock 登录；JWT 统一走 auth_service.issue_dev_token
app/api/auth_adapter.py # S2 接缝：module_auth_from_host（宿主 AuthContext → 模块 AuthContext）
app/api/chat.py # 对话：POST "" + sessions 三端点（B）+ POST /stream SSE（C）
app/api/deps.py # 模块鉴权工厂（Bearer 优先，dev debug 头兜底）+ 归属断言
app/gateway/ # 宿主 Wave 0 鉴权四件套（与 deps 双栈并存；模块禁止 import）
app/service/auth_service.py # Auth SDK：JWT 验签/吊销/签发
app/config/settings.py # 双库 + risk_* 阈值 + JWT（issuer/audience 统一）
app/repository/core_ro.py # Core 只读 + check_suitability（R-02）
scripts/core/reset.ps1 # 本地灌 Core 模拟库
当前分支： merger（顾问合并：integrate/advisor-agent）· 测试基线： python -m pytest → 926 passed, 65 failed, 1 skipped（merger 回归 896 passed 不含 test_sprint*）· Redis： Docker 6380 · 前端： cd web && npm run build/test · 顾问： docs/项目框架设计/理财顾问Agent-合并说明.md
技术选型硬阀门见 MEMORY 第 3、7 节。Cursor 以 .cursor/rules/project-memory.mdc 为准。