xinghuo/group_xinghuo_jinrong
1
0
Fork 0
Code Issues Pull Requests 2 Actions Packages Projects Releases Wiki Activity
Files
973bf1b8343f8f5872c1ac79666c31ad29f0ab61
group_xinghuo_jinrong/docs/项目管理/02-项目开发计划.md
T
zhanghongyu_0626 7d854e03ff Add project management documentation for JinRong financial project 
- Introduced three key documents:
  - **01-每日会议纪要模板与流程.md**: A template for daily meeting minutes and processes.
  - **02-项目开发计划.md**: A project-level development plan outlining the project timeline, team roles, and dependencies.
  - **03-表设计文档.md**: A readable table design document serving as a dictionary for understanding database structures and relationships.
- Created a README.md to index project management documents and their purposes.
- Enhanced documentation to support a 5-person full-stack novice team in project execution and collaboration.
2026-09-07 20:04:53 +08:00

17 KiB
Raw Blame History

项目开发计划（项目级）

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

0. 一句话定位

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

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

1. 双视角说明：Wave vs Phase

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

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

关系：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）

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 Day67（9/1213 周末）可选

  • 仅当周五 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 已完成项

  • FastAPI 骨架 + /health + settings 双库配置
  • core_ro.py（Core 只读 + check_suitability）+ suitability.py（R-02 log 映射）
  • Core 模拟库 scripts/core/* + reset.ps1（33 客户 / 14 产品 / KYC / C×R 矩阵 / AML）
  • sync_advisor_rel.py + sync_neo4j.py
  • JWT/RBAC 中间件、审计落库、trace_id、Mock 登录、统一 /api/chat、LangGraph echo 骨架、输入防护（9 个测试通过）
  • Core 模拟库 + agent 库已灌库
  • Milvus/Neo4j 已灌基础数据
  • 需求拆解、表设计、技术选型、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 每日同步、阻塞显形
03-表设计文档.md 表字段、谁写谁读查阅
../memory/REQUIREMENTS.md 场景编号验收对照
../memory/FRAMEWORK.md 模块实现状态表
../memory/FLOW.md 端到端链路、bootstrap
../memory/TODO.md 当前待办与责任人
../需求拆解/业务场景优先级清单.md P0 场景全表
Reference in New Issue View Git Blame Copy Permalink