# 项目开发计划（项目级）

> 路径：`docs/项目管理/02-项目开发计划.md`
> 范围：**只做项目级计划**。每个 Agent 模块的详细计划（接口字段、Tool 拆分、单测用例）由各负责人自己定，本文不替他们写。
> 关联：[01-每日会议纪要模板与流程.md](./01-每日会议纪要模板与流程.md) · [03-表设计文档.md](./03-表设计文档.md) · [../memory/REQUIREMENTS.md](../memory/REQUIREMENTS.md) · [../memory/FRAMEWORK.md](../memory/FRAMEWORK.md)

---

## 0. 一句话定位

5 人全栈新手团队，**垂直切 + 依赖解锁 + Phase 当验收门**：每人抱一个 Agent 从底座到演示一管到底，靠依赖链决定谁先动，靠周五 Demo 卡验收。

| 维度 | 取值 |
| --- | --- |
| 项目周期 | 2026-09-07（周一）~ 2026-10-10（周五），约 5 周 |
| 团队规模 | 5 人（P1~P5），全栈新手 |
| 里程碑 | M0 启动 → M1~M5 对应 Phase 1~5 |
| 验收节奏 | 每周五 Demo + 答辩在第 5 周末 |
| 当前日期 | 2026-09-07（本计划制定日） |

---

## 1. 双视角说明：Wave vs Phase

本项目用两套视角看进度，**不要混用**：

| 视角 | 含义 | 用来回答 |
| --- | --- | --- |
| **Wave（交付批次）** | 按依赖链把工作切成 4 批：Wave 0 底座 → Wave 1 内部 Agent → Wave 2 风控 → Wave 3 客户 | 「先建什么再建什么」的依赖顺序 |
| **Phase（周里程碑）** | 按周切 5 个里程碑 M1~M5，对应需求文档 Phase 1~5 | 「这周全队验收什么」的时间门 |

**关系**：Wave 决定 **谁先动**，Phase 决定 **何时验收**。同一周内不同人可能在做不同 Wave 的事，只要本周验收门能过即可。

| Phase（周） | 全队验收门 | 主导 Wave |
| --- | --- | --- |
| M0（第1周前2天） | 启动对齐：环境、契约、bootstrap | Wave 0 收尾 |
| M1（第1周） | 骨架 + 客服能问答 | Wave 0 + Wave 1 客服 |
| M2（第2周） | 画像/风评 + NL2SQL 能查数 | Wave 1 分析 + 画像 |
| M3（第3周） | 图谱 + 投顾能推荐 | Wave 1 投顾 |
| M4（第4周） | 风控预警 + 记忆/置信度闭环 | Wave 2 风控 |
| M5（第5周） | 四 Agent 联调 + 演示 + 答辩 | Wave 3 客户 + 联调 |

---

## 2. 团队分工（垂直切）

| 成员 | 垂直域(Owner) | 主责 | 对应场景 |
| --- | --- | --- | --- |
| P1 平台集成 | 平台 & 联调 | FastAPI 骨架、JWT/RBAC、审计、统一 /api/chat、LangGraph 骨架、Pub/Sub、SSE、端到端联调、前端壳 | F-01~F-04 |
| P2 客服知识 | 智能客服线 | RAG 知识库 + 客服 Agent + 短期记忆 + Streamlit/React 客户端 | C-01~C-05、A-02 |
| P3 画像风控 | 画像风控线 | 画像研判 + 风评/适当性 + 风控 Agent(20 规则) + 中期记忆 + 置信度 + Gradio 风控端 | R-01~R-03、画像 L1/L3 |
| P4 数据分析 | 分析线 | NL2SQL + 数据分析 Agent + Schema 注入/安全校验 + analytics_query_log | D-01~D-04 |
| P5 图谱投顾 | 投顾线 | Neo4j 图谱 + GraphRAG + 投顾 Agent + 长期记忆 + 投顾端 | 投顾、图谱、A-01 |

---

## 3. 依赖关系（L0→L3）

```mermaid
graph TD
    L0[L0 平台底座 P1: JWT/RBAC/审计/chat路由/LangGraph骨架/DeepSeek client]
    L1[L1 数据层 P1+P3: Core RO封装Tool/画像表/适当性契约]
    L2C[L2 客服 Agent P2: RAG+客服]
    L2A[L2 代理人 Agent P2+P5: RAG+画像L2]
    L2D[L2 数据分析 Agent P4: NL2SQL]
    L2R[L2 风控 Agent P3: 预警+适当性]
    L2I[L2 投顾 Agent P5: GraphRAG]
    L3[L3 联调 P1: 四Agent统一入口+SSE+前端+演示]
    L0 --> L1
    L1 --> L2C
    L1 --> L2A
    L1 --> L2D
    L1 --> L2R
    L1 --> L2I
    L2C --> L3
    L2A --> L3
    L2D --> L3
    L2R --> L3
    L2I --> L3
```

**依赖解锁条件（硬门）：**

| 解锁点 | 含义 | 解锁了谁 |
| --- | --- | --- |
| P1 JWT 中间件 + Mock 登录 | 能签发 customer/staff/service 三类 token | P2/P3/P4/P5 全员 |
| P1 /api/chat 路由 + LangGraph 骨架 | 四 Agent 有统一入口和编排框架 | P2/P3/P4/P5 全员 |
| P1 DeepSeek client 封装 | 四 Agent 共用一个 LLM 调用层 | P2/P3/P4/P5 全员 |
| P1 Core RO 封装为 Tool 节点 | 持仓/流水/适当性能被 Agent 调用 | P2/P3/P4/P5 |
| P3 画像 L1 写入接口 | 客户偏好能落库 | P2(读)、P5(读)、P3(写) |
| P3 R-02 适当性落 log | 阻断可审计 | P2(客户匹配说明)、P5(投顾) |
| P5 Neo4j 同步脚本跑通 | 关系图可用 | P5 投顾、P3 R-02 辅助 |

---

## 4. 第 1 周（M0+M1）天级计划

> 新手团队，第 1 周写到天。日期以 2026-09-07（周一）为 Day1。

### 4.1 Day1（9/7 周一）M0 启动对齐

| 时段 | 全队 | P1 | P2 | P3 | P4 | P5 |
| --- | --- | --- | --- | --- | --- | --- |
| 上午 | 全员读 MEMORY §0 + REQUIREMENTS + 02-项目开发计划 | 定接口契约初稿 | 列 kb_product_rules 入库清单 | 列画像 L1 字段 + R-02 联调点 | 列 NL2SQL Schema 白名单 | 列投顾 Cypher 清单 |
| 下午 | 全员本机跑 scripts/dev/bootstrap.ps1 | 兜底排查环境问题 | 拉 Ollama bge-m3 模型 | 验证 core_ro.check_suitability | 验证 Core 表可读 | 验证 Neo4j 图同步 |
| 验收 | /health 200 + jinrong_core 33 客户 + jinrong_agent 11 表 + Neo4j 图 | — | bge-m3 1024 维 | check_suitability(CUST-4002) 返回 forbidden | SELECT core_customer COUNT | Neo4j 节点数 > 0 |

### 4.2 Day2（9/8 周二）接口契约评审

| 成员 | 今日交付 | 对应场景 |
| --- | --- | --- |
| P1 | /api/chat 请求体契约定稿（X-Agent-Type + X-Trace-Id + session_id + message + Authorization） | F-01 |
| P2 | milvus_tool.py 连接封装 + kb_product_rules 首批 5 产品切块入库 | C-02 |
| P3 | 画像 L1 写入接口字段清单 + 单测用例草稿 | 画像 |
| P4 | NL2SQL Tool 节点骨架（未接真 LLM） | D-01 |
| P5 | 投顾 Cypher Tool 节点骨架 | 投顾 |

验收：契约文档全员签字；kb_product_rules 可检索。

### 4.3 Day3（9/9 周三）M1 启动 · 骨架 + 客服

| 成员 | 今日交付 | 对应场景 |
| --- | --- | --- |
| P1 | JWT 中间件（HS256 dev）+ Mock 登录 + audit_log + trace_id 贯通 + LangGraph agent_service 骨架 + DeepSeek client | F-01/F-02/C-01 |
| P2 | 客服 RAG Tool 接入 LangGraph（CUST-9527 问基金费率 → Milvus → 带源返回） | C-02 |
| P3 | 画像 L1 写入接口 + 单测（CUST-DEMO-A 写 style_tags） | 画像 |
| P4 | NL2SQL 接 DeepSeek 真实 Key，D-01 Demo | D-01 |
| P5 | 投顾 Tool 接入 LangGraph（A-01 客户概况） | A-01 |

### 4.4 Day4（9/10 周四）闭环打磨

| 成员 | 今日交付 |
| --- | --- |
| P1 | /api/chat 最小闭环（echo + 真 LLM）+ 前端 web/ init（Vite + AntD + HashRouter） |
| P2 | 客服 Agent 多轮对话 + 短期记忆（Redis sess 窗口）+ C-01 持仓问答 |
| P3 | R-02 风控 service 落 log 联调（CUST-4002 C1 买 R4 → 阻断 + audit） |
| P4 | analytics_query_log 留痕 + D-02 产品查数 + D-03 预警台账只读 |
| P5 | 投顾 GraphRAG 推荐查询（Neo4j + Milvus 联合） |

### 4.5 Day5（9/11 周五）M1 Demo 验收

**全队目标**：骨架 + 客服能问答。

Demo 脚本（P1 主持）：
1. curl Mock 登录拿 CUST-9527 token
2. curl /api/chat 问「我的持仓」→ 客服 Agent 返回 C-01 答案
3. curl /api/chat 问「某基金费率」→ RAG 带源返回
4. 越权演示：用 CUST-9527 token 查 CUST-10001 → 403 + audit_log
5. R-02 演示：CUST-4002 买 R4 → blocked + risk_suitability_log
6. D-01 演示：「统计 C2 客户数」→ NL2SQL + 留痕
7. 投顾演示：A-01 客户概况 Cypher

**降级方案**：若 web/ 未就绪，用 curl + Postman；若 DeepSeek 未接，用 echo + Mock 答案。

### 4.6 Day6~7（9/12~13 周末）可选

- 仅当周五 Demo 未过验收门才加班；否则休息或自学。
- P1 整理周报 + 更新 TODO。

---

## 5. 第 2 周（M2）画像/风评 + NL2SQL

### 5.1 全队目标（验收门）

- 画像 L1/L2/L3 读写闭环，CUST-DEMO-A~E 五个示范客户画像就绪
- NL2SQL 能查客户/产品/预警三类数（D-01~D-04），analytics_query_log 留痕
- R-02 适当性阻断端到端可演示

### 5.2 垂直并行任务表

| 成员 | 本周主任务 | 依赖解锁条件 |
| --- | --- | --- |
| P1 | SSE 推送 + Pub/Sub（risk:pub:alert）+ 前端 chat 组件 + 联调支持 | 上周骨架已就绪 |
| P2 | 客服 Agent 接 L1 画像读 + C-04 亏损阈值提醒（customer_threshold_config） | P3 L1 接口 |
| P3 | 画像 L1/L2/L3 完整读写 + R-01 大额预警（CUST-3001 单笔≥50万）+ R-03 AML 名单 | P1 audit、Core RO |
| P4 | NL2SQL D-01~D-04 全打通 + Schema 注入 + 只读 SQL 安全校验 | P1 DeepSeek client |
| P5 | 投顾 Agent 接 L1/L2 画像读 + GraphRAG 推荐（Neo4j + Milvus） | P3 画像接口、P1 Milvus |

### 5.3 周五 Demo 验收点

- CUST-DEMO-A 画像 L1 写入 + 代理人 STAFF-10086 读 L2
- D-01「C2 客户有多少」、D-02「某产品销售规模」、D-03「预警未处理数」
- R-01 CUST-3001 大额预警单生成 + Pub/Sub 推送
- R-02 CUST-4002 阻断 + risk_suitability_log + audit_log

---

## 6. 第 3 周（M3）图谱 + 投顾

### 6.1 全队目标

- Neo4j 图谱完整（Customer/Product/Advisor/RiskGrade + HOLDS/ASSIGNED_TO/REQUIRES_MIN_RISK）
- 投顾 Agent 能做 GraphRAG 推荐（C-11 匹配说明，非营销话术）
- 代理人助手 Agent A-01~A-05 闭环

### 6.2 垂直并行任务表

| 成员 | 本周主任务 |
| --- | --- |
| P1 | 前端四 Agent 入口（HashRouter 多入口）+ 统一错误处理 + 联调 |
| P2 | 代理人助手 A-02 产品规则 RAG + A-03 话术草稿（advisor_draft，不外发）+ A-04 业务流程 |
| P3 | 风控 Agent R-01/R-03 完善 + L3 监测画像 + 置信度 |
| P4 | D-05 交叉问数 + 报表解读 + 免责声明 |
| P5 | 投顾 GraphRAG 推荐（Neo4j Cypher + Milvus 产品库）+ C-11 匹配说明 + 长期记忆 |

### 6.3 周五 Demo 验收点

- 投顾：CUST-DEMO-A 问「适合我的产品」→ GraphRAG 返回匹配说明（带适当性 R-02 校验）
- 代理人：STAFF-10086 查 CUST-DEMO-A 概况 + 生成话术草稿（review_status=pending）
- 越权：STAFF-10086 查非名下客户 → 403

---

## 7. 第 4 周（M4）风控预警 + 记忆/置信度闭环

### 7.1 全队目标

- 风控 20 规则上线（R-01/R-02/R-03 + 频繁交易/模式识别）
- 记忆分层闭环：短期(Redis) ↔ 权威(MySQL) ↔ 知识(Milvus) ↔ 关系(Neo4j)
- 置信度机制：风控预警、画像研判带置信度

### 7.2 垂直并行任务表

| 成员 | 本周主任务 |
| --- | --- |
| P1 | SSE 完整推送 + 前端风控工作台 + 联调 |
| P2 | 客服 C-07 风格测评 + C-08 资金比例偏离提醒 |
| P3 | 风控 20 规则 + L3 监测评分 + 置信度 + Gradio 风控端 |
| P4 | 数据分析对外输出免责声明 + 留痕审计完整性 |
| P5 | 投顾长期记忆 + 置信度 + 投顾端打磨 |

### 7.3 周五 Demo 验收点

- 风控：CUST-3001 大额 + 频繁交易 + AML 名单命中三场景
- 置信度：预警单带 risk_score + 画像 L3 带 score_dimensions
- 记忆：Redis 挂掉后从 MySQL 恢复上下文演示

---

## 8. 第 5 周（M5）四 Agent 联调 + 演示 + 答辩

### 8.1 全队目标

- 四 Agent 通过统一 /api/chat 入口可切换演示
- 端到端联调通过，越权、审计、适当性阻断全场景可复现
- 答辩材料齐备（PPT、Demo 脚本、API 文档、架构图）

### 8.2 垂直并行任务表

| 成员 | 本周主任务 |
| --- | --- |
| P1 | 端到端联调总指挥 + PPT 架构页 + API 文档（FastAPI 自动生成）+ 部署兜底 |
| P2 | 客户端 Demo 脚本（C-01~C-05 全场景）+ 客服端打磨 |
| P3 | 风控端 Demo 脚本（R-01~R-03 全场景）+ Gradio 风控端打磨 |
| P4 | 数据分析 Demo 脚本（D-01~D-04）+ 留痕审计抽检演示 |
| P5 | 投顾端 Demo 脚本（GraphRAG 推荐 + C-11 匹配说明）+ 架构图 |

### 8.3 答辩准备清单

| 交付物 | 责任人 | 截止 |
| --- | --- | --- |
| PPT（项目背景、架构、四 Agent 演示、合规亮点、踩坑） | P1 主 + 全员供稿 | 10/9 |
| Demo 脚本（按角色分 4 段，每段 3~5 分钟） | P2/P3/P4/P5 各自 | 10/8 |
| API 文档（FastAPI /docs 导出 + 关键接口说明） | P1 | 10/9 |
| 架构图（Mermaid 或 draw.io，含数据流、依赖链、合规边界） | P1+P5 | 10/9 |
| 答辩问答预案（合规、适当性、记忆分层、性能） | P3 主 + 全员 | 10/10 |

### 8.4 最终答辩验收门

- 四 Agent 各跑 1 个 P0 闭环场景，无 500 错误
- 越权 403 + audit_log 可还原（F-01/F-02）
- R-02 适当性阻断可演示（CUST-4002）
- 数据分析只读 + 留痕（D-04）
- 代理人草稿不外发（A-03 review_status=pending）
- 记忆分层：Redis 挂掉可恢复

---

## 9. 风险与缓解

| 风险 | 影响 | 缓解措施 | 责任人 |
| --- | --- | --- | --- |
| P1 是瓶颈（同时做 JWT/LangGraph/DeepSeek/前端） | 全员停摆 | P2 协助 RBAC 单测；P3 协助 audit 中间件；DeepSeek client 优先做一次复用 | P1 |
| P5 等画像 API 才能做投顾 | 投顾延后 | P5 先做 Neo4j 图谱 + Cypher Tool，画像接口一就绪立即接入 | P5/P3 |
| 接口不统一（各 Agent 自定义请求体） | 联调爆炸 | Day2 强制契约评审，P1 拥有契约最终决定权 | P1 |
| DeepSeek API Key 未及时配置 | 四 Agent 只能跑 echo | Day1 当晚必须配上，P1 兜底 | P1 |
| 前端 web/ 未 init | Demo 降级 | 降级方案：curl + Postman；P1 Day4 必须 init | P1 |
| Milvus Lite 与 Standalone 数据不互通 | 答辩环境切换失败 | 答辩前在 Standalone 重灌一次；日常用 Lite | P2/P5 |
| 新手对 LangGraph 不熟 | 进度慢 | P1 先出 echo 骨架示例，其他人照抄 | P1 |
| Core 模拟库种子不够演示 | Demo 场景缺数据 | CUST-DEMO-A~E + CUST-4001/4002/3001 已覆盖关键场景 | P3 |
| 审计表被误 UPDATE | 合规红线 | 代码层禁止 UPDATE/DELETE 审计表；单测加只 INSERT 断言 | P1/P3 |

---

## 10. 验收标准对照（REQUIREMENTS 编号）

| Wave | 场景 ID | 验收内容 | 主责 | 验收周 |
| --- | --- | --- | --- | --- |
| Wave 0 | F-01 | JWT+RBAC+归属，越权 403+audit | P1 | M1 |
| Wave 0 | F-02 | trace_id 可还原全链路 | P1 | M1 |
| Wave 0 | F-03 | input_guard_log 拦截 | P1 | M1 |
| Wave 0 | F-04 | Core 只读，Repository 只 SELECT | P1+P3 | M1 |
| Wave 1 | D-01~D-04 | NL2SQL 查数 + 留痕 | P4 | M2 |
| Wave 1 | A-01~A-05 | 代理人画像/规则/草稿/流程/巡检 | P2+P5 | M3 |
| Wave 2 | R-01 | 大额预警 pending_review | P3 | M2/M4 |
| Wave 2 | R-02 | 适当性阻断 + log | P3 | M1/M2 |
| Wave 2 | R-03 | AML 命中通知 | P3 | M2/M4 |
| Wave 3 | C-01~C-05 | 客户持仓/产品/规则/阈值/净值 | P2 | M5 |
| Wave 3 | C-07 | 风格测评 + 适当性 | P2 | M4 |
| Wave 3 | C-11 | 匹配说明（非营销） | P2+P5 | M3/M5 |

> 详细场景描述见 `docs/memory/REQUIREMENTS.md` 与 `docs/需求拆解/业务场景优先级清单.md`。

---

## 11. 当前状态快照（2026-09-07）

### 11.1 Wave 0 已完成项

- [x] FastAPI 骨架 + /health + settings 双库配置
- [x] core_ro.py（Core 只读 + check_suitability）+ suitability.py（R-02 log 映射）
- [x] Core 模拟库 scripts/core/* + reset.ps1（33 客户 / 14 产品 / KYC / C×R 矩阵 / AML）
- [x] sync_advisor_rel.py + sync_neo4j.py
- [x] JWT/RBAC 中间件、审计落库、trace_id、Mock 登录、统一 /api/chat、LangGraph echo 骨架、输入防护（9 个测试通过）
- [x] Core 模拟库 + agent 库已灌库
- [x] Milvus/Neo4j 已灌基础数据
- [x] 需求拆解、表设计、技术选型、JWT 手册、画像/适当性文档

### 11.2 Wave 0 待完成项

- [ ] DeepSeek 真 LLM 接入（client 封装）
- [ ] 前端 web/ init
- [ ] agent 专用 5 表灌库验收（02-mysql-agent专用.sql）
- [ ] kb_product_rules 首批产品入库
- [ ] /api/chat 真实闭环（echo → 真 LLM）
- [ ] R-02 风控 service 落 log 联调

### 11.3 关键待办（见 TODO.md）

- T-01 Auth SDK / JWT 中间件（已实现，待真 LLM 联调）
- T-06 挂载 app.api 路由到 main.py；chat 最小闭环
- T-07 LangGraph agent_service StateGraph 骨架 + DeepSeek
- T-04 Core RO 封装为 Tool 节点；A-01 归属校验
- T-31 R-02 风控 service 落 log
- T-21 Milvus Lite + kb_product_rules 首批入库
- 前端 React 多 Agent 入口

---

## 12. 关联文档

| 文档 | 用途 |
| --- | --- |
| [01-每日会议纪要模板与流程.md](./01-每日会议纪要模板与流程.md) | 每日同步、阻塞显形 |
| [03-表设计文档.md](./03-表设计文档.md) | 表字段、谁写谁读查阅 |
| [../memory/REQUIREMENTS.md](../memory/REQUIREMENTS.md) | 场景编号验收对照 |
| [../memory/FRAMEWORK.md](../memory/FRAMEWORK.md) | 模块实现状态表 |
| [../memory/FLOW.md](../memory/FLOW.md) | 端到端链路、bootstrap |
| [../memory/TODO.md](../memory/TODO.md) | 当前待办与责任人 |
| [../需求拆解/业务场景优先级清单.md](../需求拆解/业务场景优先级清单.md) | P0 场景全表 |