51 lines
4.7 KiB
Markdown
51 lines
4.7 KiB
Markdown
# Agent
|
||
|
||
**⚡ 需要接手/开工，先读项目根「[交接文档.md](交接文档.md)」** —— 三线合并版**唯一交接入口**：
|
||
**§0 公共层**（铁律 / 环境 / 已知坑 / 禁止事项）· **§A 风控模块主线** · **§B 基金转换（convert）线** · **§C 架构改进线**。
|
||
（该文件在 `.gitignore` 内、不入库，是**给 AI 接手用的本地文件**；`docs/交接文档-*.md` 两份为**历史留档，内容已过期，勿读**。）
|
||
|
||
**无上下文时先读** [docs/memory/MEMORY.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`；**里程碑 tag `convert-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**
|
||
|
||
## 代码入口
|
||
|
||
```text
|
||
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` 为准。
|