Files

T

zhanghongyu_0626 9e1a9b2a7e docs: Update MEMORY and TODO files for clarity and accuracy in project deliverables

- Revised MEMORY.md to correct the status of kb_product_rules, clarifying that it has not been populated in the vector database as previously stated.
- Enhanced TODO.md with detailed descriptions of completed tasks and their corresponding documentation paths for better tracking of project deliverables.
- Added new files for daily meeting minutes, development plans, table design documents, API documentation, presentation materials, and requirements documentation, ensuring all necessary materials are indexed and easily accessible for the upcoming defense.
- Updated README files to reflect the latest changes and provide a comprehensive overview of submission materials for the defense, aligning with client requirements.

2026-09-14 00:18:31 +08:00

17 KiB

Raw Permalink 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 启动 → M1~~M5 对应 Phase 1~~5
验收节奏	每周五 Demo + 答辩在第 5 周末
0	当前日期

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）

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 主持）：

curl Mock 登录拿 CUST-9527 token
curl /api/chat 问「我的持仓」→ 客服 Agent 返回 C-01 答案
curl /api/chat 问「某基金费率」→ RAG 带源返回
越权演示：用 CUST-9527 token 查 CUST-10001 → 403 + audit_log
R-02 演示：CUST-4002 买 R4 → blocked + risk_suitability_log
D-01 演示：「统计 C2 客户数」→ NL2SQL + 留痕
投顾演示：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-13 · 答辩周）

开发自用细节见 docs/memory/MEMORY.md §0 · 答辩提交摘要见 docs/答辩/提交物料/02-开发计划.md

11.1 已交付（可 Demo）

Wave 0：JWT/RBAC · 审计/trace · Core 只读 · 输入防护 · Mock 登录 · /api/ready
Wave 1：问数 NL2SQL + 模板/缓存/analyze · 顾问 /api/advisor-agent/* 接缝
Wave 2：风控 R-01～R-05 · 模拟网关 · 基金转换 T+1（受理/确认分离）
Wave 3：客服 LangGraph + RAG · 选购清单 · 客户交易中心/行情快捷交易
代销平台 API v0.1 + 前端四角色 web/ 主链路
答辩材料：docs/答辩/（稿 · SOP · 幻灯片 · 提交物料 6 项）

11.2 进行中 / 答辩不展开

merger 工作区多批功能 待你确认后 commit（客户交易 · 字体栈 · E2E 证据）
顾问 test_sprint* 集成与陈旧 DDL 期望（F-α · 转 sqlite 后暴露）
全量 pytest 非幂等（F-η）—— 不以单次 passed 数作唯一门闸
登录 /api/auth/login 的 app_env 生产门禁（P0 方向② · 已拍板答辩后部署前再修）
「网点办理」文案 vs 无理财师交易 API（F-β 记账 · 答辩口径：一期线下未实现）

11.3 关键文档入口

待办：docs/memory/TODO.md
端到端证据：docs/memory/tests/（CT-001 · AN-003 · AD-001 · RK-001 · XC-001）
Bootstrap：docs/memory/FLOW.md §0

12. 关联文档

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

17 KiB Raw Permalink Blame History Unescape Escape