group_xinghuo_jinrong/AGENTS.md

# 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/需求拆解/`
- 表结构 SQL：`docs/项目框架设计/表设计/`
- 技术选型 / JWT：`docs/项目框架设计/技术选型和版本/`
- Core 模拟底座：`docs/项目框架设计/Core模拟底座/`
- 业务记忆分层：`docs/业务记忆管理/业务记忆管理手册.md`
- **基金转换线（第 5 步 todo 开发进行中 · T+1 受理/确认分离模型）**：**T-1 ~ T-8 ✅ / T-9 ~ T-17 ⬜**（当前基线 **829 passed / 10 skipped** 实测；真库 T-6 `verify_convert_accept.py` **37/37**、T-7 `verify_convert_confirm.py` **83/83**、T-8 `verify_convert_engine.py` **39/39**，退出码均 0；下一步 **T-9** = api 层：redeem 份额申报 + 撤单/确认/查询接口 + 网关分派）；开工入口 **`交接文档.md` §B**（§B.11 下一条立项指引 = 最新状态）· `docs/PRD/PRD-基金转换交易.md`（**v1.1**）· `docs/项目框架设计/架构设计-基金转换交易.md`（**v2.1**）· `docs/项目框架设计/开发计划-基金转换交易.md`（**v2.0** · T-1~T-17 逐任务改法 + DoD）
- **架构改进线（✅ 2026-09-10 已结项，无待办）**：开工入口 **`交接文档.md` §C**
- **风控模块主线**：**`交接文档.md` §A**

## 代码入口

```text
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` 为准。