Files
group_xinghuo_jinrong/docs/项目管理/01-每日会议纪要模板与流程.md
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

348 lines
16 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 每日会议纪要模板与流程
> 路径:`docs/项目管理/01-每日会议纪要模板与流程.md`
> 适用:JinRong 金融四 Agent 项目 · 5 人全栈新手团队
> 关联:[02-项目开发计划.md](./02-项目开发计划.md) · [03-表设计文档.md](./03-表设计文档.md) · [../memory/MEMORY.md](../memory/MEMORY.md) §0 交接清单
---
## 1. 会议目的
每天组内至少开一次站会式同步,三件事必须做完:
1. **评审需求** —— 对照 `docs/memory/REQUIREMENTS.md` 的场景编号(F/C/A/D/R),确认当天要推进的是哪几条,避免做偏。
2. **评估进度** —— 对照 `docs/项目管理/02-项目开发计划.md` 的本周验收门,看每个人是「绿 / 黄 / 红」。
3. **任务分配调整** —— 谁卡住了、谁提前完成了、依赖解锁了没,当场把活儿从一个人调到另一个人。
> 一句话原则:**会短、事清、阻塞显形**。会议不是汇报表演,是「让阻塞在 24 小时内被看见」。
---
## 2. 会议形式建议
| 项 | 建议 | 说明 |
| --- | --- | --- |
| 频次 | **每天 1 次**(周一至周五),必要时周末加一次 | 项目 5 周,节奏紧;新人多,每天对齐成本低 |
| 时长 | **15~20 分钟**,最长不超过 30 分钟 | 超时说明议题没拆细,转线下讨论 |
| 形式 | **线下为主**,远程可腾讯会议 | 新手团队面对面更易暴露问题 |
| 主持 | **统筹(P1 平台集成)** | P1 同时是平台 Owner,最清楚依赖链;如 P1 请假由 P3 代理主持 |
| 时间 | 建议每天 **10:00** 或 **17:30** | 避开早高峰调试和午休 |
| 必到 | P1~P5 全员 | 缺席须提前在群里请假并指定代理人 |
| 产出 | 一份当日纪要(本模板) | 主持人写,当天 18:00 前提交 `docs/项目管理/纪要/` |
> 主持人的核心动作不是「念稿」,而是 **盯依赖**:谁 Blocked by 谁、解锁了谁、是否影响周五 Demo。
---
## 3. 纪要模板(Markdown 表格)
每份纪要包含以下 8 个固定小节,顺序不要换:
| 小节 | 内容 | 谁填 |
| --- | --- | --- |
| ① 基本信息 | 日期、参会人、缺席人、主持人 | 主持人 |
| ② 昨日完成 | 每人一句话,对照场景编号 | 各成员 |
| ③ 今日计划 | 每人今天要交付的最小可验证单元 | 各成员 |
| ④ 阻塞问题 | **必须写「Blocked by 谁 / 解锁了谁」** | 各成员 |
| ⑤ 任务调整 | 「从谁调到谁、为什么」 | 主持人 |
| ⑥ 决议 | 当天拍板的事项 + 责任人 + 截止时间 | 主持人 |
| ⑦ 风险提示 | 影响周五 Demo 或里程碑的事项 | 主持人 |
| ⑧ 下次会议 | 时间、预计重点 | 主持人 |
---
## 4. 「阻塞问题」怎么写(关键)
本项目是 **垂直切 + 依赖解锁** 模式(见 [02-项目开发计划.md](./02-项目开发计划.md) §依赖关系),所以阻塞必须显式标注 **上下游**:
> 格式:`[我的任务] Blocked by [谁/什么] → 解锁了 [谁/什么]`
**正例:**
- `P5 投顾 Agent 接 check_suitability` Blocked by `P1 未挂载 /api/chat 路由` → 解锁了 `P5 的 R-02 落库联调`
- `P2 客服 RAG 检索` Blocked by `P1 Milvus Lite 连接配置未定` → 解锁了 `P2 的 C-02 产品规则问答`
**反例(不要这么写):**
- 不要「接口还没好」 —— 谁的接口?什么接口?
- 不要「等平台」 —— 等平台哪个人?哪一块?
- 不要「有点卡」 —— 卡在哪?影响谁?
---
## 5. 「任务调整」怎么写
调整必须写明 **三要素**:从谁 → 到谁 → 为什么。原因要能对应到依赖链或风险:
| 调整类型 | 示例写法 |
| --- | --- |
| 依赖解锁后前移 | `P4 NL2SQL Schema 注入` 从 P4 调到 P1+P4 配对,因为 P1 已挂好 chat 路由,需 P1 配合注入 Schema |
| 阻塞下沉 | `P5 GraphRAG 推荐查询` 从 P5 调到 P3 协助,因为 P3 画像 API 未就绪,P5 等 L1 接口 |
| 瓶颈分流 | `P1 JWT 中间件` 保留 P1 主写,P2 协助写 RBAC 单测,因为 P1 同时要做 LangGraph 骨架是瓶颈 |
| 风险对冲 | `P5 Neo4j 同步` 从 P5 调到 P1 兜底,因为 P5 周 3 才能开始,影响周五 Demo |
> 调整后必须同步更新 `docs/memory/TODO.md` 的责任人,并在群里 @ 到人。
---
## 6. 空白模板(复制即用)
> 以下用四个反引号 ` ```` ` 包裹,方便整段复制(避免和本文档的三反引号冲突)。
````
# 每日会议纪要 · {{YYYY-MM-DD}}
## ① 基本信息
| 项 | 内容 |
| --- | --- |
| 日期 | {{YYYY-MM-DD}}(周{{X}}) |
| 里程碑 | M{{n}} · 第 {{n}} 周 · Day {{n}} |
| 主持人 | {{P1}} |
| 参会人 | P1 / P2 / P3 / P4 / P5 |
| 缺席人 | {{无 / 姓名-原因-代理人}} |
## ② 昨日完成
| 成员 | 完成事项(对照场景编号) | 状态 |
| --- | --- | --- |
| P1 | {{如:挂载 /api/chat 路由 + SessionGuard}} | 🟢/🟡/🔴 |
| P2 | {{如:kb_product_rules 首批 5 产品入库}} | 🟢/🟡/🔴 |
| P3 | {{如:画像 L1 写入接口 + 单测}} | 🟢/🟡/🔴 |
| P4 | {{如:NL2SQL Schema 注入骨架}} | 🟢/🟡/🔴 |
| P5 | {{如:Neo4j 同步脚本跑通}} | 🟢/🟡/🔴 |
## ③ 今日计划
| 成员 | 今日交付(最小可验证单元) | 对应场景 |
| --- | --- | --- |
| P1 | {{}} | F-0X |
| P2 | {{}} | C-0X / A-0X |
| P3 | {{}} | R-0X / 画像 |
| P4 | {{}} | D-0X |
| P5 | {{}} | 投顾 / 图谱 |
## ④ 阻塞问题
| 成员 | 阻塞描述(Blocked by … → 解锁了 …) | 状态 |
| --- | --- | --- |
| {{Pn}} | {{[我的任务] Blocked by [谁/什么] → 解锁了 [谁/什么]}} | 待解/已解 |
## ⑤ 任务调整
| 调整项 | 从谁 | 到谁 | 原因 |
| --- | --- | --- | --- |
| {{任务名}} | {{Pn}} | {{Pm}} | {{依赖/瓶颈/风险}} |
## ⑥ 决议
| 决议 | 责任人 | 截止时间 |
| --- | --- | --- |
| {{}} | {{}} | {{YYYY-MM-DD HH:MM}} |
## ⑦ 风险提示
- {{影响周五 Demo 或里程碑的事项,没有写「无」}}
## ⑧ 下次会议
- 时间:{{YYYY-MM-DD HH:MM}}
- 预计重点:{{}}
````
> 状态图例:🟢 已完成且验收通过 · 🟡 完成但未验收/有遗留 · 🔴 未完成或阻塞
---
## 7. 示例纪要 · 前 3 天
> 以下三份贴合本项目实际,可直接当样板参考。场景编号、客户号、员工号均来自 `docs/memory/REQUIREMENTS.md` 与 Core 模拟库种子(`CUST-9527`、`STAFF-10086`、`CUST-DEMO-A` 等)。
### 7.1 示例 · M0 Day1(启动对齐,2026-09-07 周一)
````
# 每日会议纪要 · 2026-09-07
## ① 基本信息
| 项 | 内容 |
| --- | --- |
| 日期 | 2026-09-07(周一) |
| 里程碑 | M0 启动对齐 · 第 1 周 · Day 1 |
| 主持人 | P1(统筹/平台集成) |
| 参会人 | P1 / P2 / P3 / P4 / P5 |
| 缺席人 | 无 |
## ② 昨日完成
| 成员 | 完成事项(对照场景编号) | 状态 |
| --- | --- | --- |
| P1 | (9/5 已完成)FastAPI 骨架 + /health + settings 双库配置 + core_ro + suitability 映射 | 🟢 |
| P2 | (9/5 已完成)需求拆解 + 用户故事 Review | 🟢 |
| P3 | (9/7 已完成)Core 模拟库对齐客户手册(33 客户/14 产品)+ risk_suitability_log P0 字段 | 🟢 |
| P4 | (9/7 已完成)画像 L1/L2/L3 框架文档 06 + 业务记忆管理手册 | 🟢 |
| P5 | (9/5 已完成)Neo4j 同步脚本 sync_neo4j.py + sync_advisor_rel.py | 🟢 |
## ③ 今日计划
| 成员 | 今日交付(最小可验证单元) | 对应场景 |
| --- | --- | --- |
| P1 | 全员环境对齐:本机跑 scripts/dev/bootstrap.ps1,确认 jinrong_core 33 客户 + jinrong_agent 11 表 + Neo4j 图就绪;定接口契约初稿 | F-01/F-02 |
| P2 | 通读 05-多Agent共用底座清单 + 03-milvus-collections,列 kb_product_rules 首批入库清单(5 产品) | C-02/A-02 |
| P3 | 通读 06 画像 + 07 适当性,列画像 L1 写入接口字段清单 + R-02 落库联调点 | R-02/画像 |
| P4 | 通读 02-JWT-RBAC鉴权手册 + 数据交互矩阵,列 NL2SQL Schema 注入字段白名单 | D-01~D-04 |
| P5 | 通读 04-neo4j-model,列投顾 Agent 的 Cypher 查询清单(C-01 持仓、A-01 概况、R-02 适当性) | 投顾 |
## ④ 阻塞问题
| 成员 | 阻塞描述 | 状态 |
| --- | --- | --- |
| P2 | [kb_product_rules 入库] Blocked by [Ollama bge-m3 模型未拉取] → 解锁了 [P2 的 C-02 RAG 检索] | 待解 |
| P5 | [Neo4j 投顾 Cypher] Blocked by [P1 未定 X-Agent-Type 与 chat 请求体契约] → 解锁了 [P5 的投顾 Tool 节点] | 待解 |
## ⑤ 任务调整
| 调整项 | 从谁 | 到谁 | 原因 |
| --- | --- | --- | --- |
| 接口契约初稿 | P1 独写 | P1 主写 + P2/P3/P4/P5 各提 1 条需求 | 垂直切模式下契约是全员依赖,需共同评审 |
## ⑥ 决议
| 决议 | 责任人 | 截止时间 |
| --- | --- | --- |
| 统一 /api/chat 请求体契约(含 X-Agent-Type、X-Trace-Id、session_id、message) | P1 | 2026-09-08 12:00 |
| Ollama bge-m3 拉取并验证 1024 维 | P2 | 2026-09-08 18:00 |
| 全员本机 bootstrap 跑通并截图 /health | 全员 | 2026-09-08 18:00 |
## ⑦ 风险提示
- DeepSeek 真 LLM 尚未接入,本周若不接,M1「客服能问答」只能跑 echo 骨架,周五 Demo 风险高
- 前端 web/ 未 init,M1 Demo 可能只能用 curl/Postman 演示
## ⑧ 下次会议
- 时间:2026-09-08 10:00
- 预计重点:接口契约评审 + bootstrap 验收 + DeepSeek 接入方案
````
### 7.2 示例 · M0 Day2(接口契约评审,2026-09-08 周二)
````
# 每日会议纪要 · 2026-09-08
## ① 基本信息
| 项 | 内容 |
| --- | --- |
| 日期 | 2026-09-08(周二) |
| 里程碑 | M0 启动对齐 · 第 1 周 · Day 2 |
| 主持人 | P1 |
| 参会人 | P1 / P2 / P3 / P4 / P5 |
| 缺席人 | 无 |
## ② 昨日完成
| 成员 | 完成事项 | 状态 |
| --- | --- | --- |
| P1 | 全员 bootstrap 跑通;/api/chat 请求体契约初稿(X-Agent-Type + X-Trace-Id + session_id + message) | 🟢 |
| P2 | Ollama bge-m3 拉取成功,1024 维验证通过;kb_product_rules 首批 5 产品清单(含 CUST-DEMO-A 持有的) | 🟢 |
| P3 | 画像 L1 写入字段清单 + R-02 落库联调点(check_suitability → build_suitability_log_row) | 🟢 |
| P4 | NL2SQL Schema 白名单初稿(core_customer / core_holding / core_trade / risk_alert) | 🟢 |
| P5 | 投顾 Cypher 清单(HOLDS / ASSIGNED_TO / REQUIRES_MIN_RISK) | 🟡(等契约定稿) |
## ③ 今日计划
| 成员 | 今日交付 | 对应场景 |
| --- | --- | --- |
| P1 | JWT 中间件骨架(RS256 验签 + RBAC guard + AuthContext 注入)+ Mock 登录端点(签发 STAFF-10086/CUST-9527 token) | F-01 |
| P2 | Milvus Lite 连接封装 milvus_tool.py + kb_product_rules 首批 5 产品切块入库 | C-02 |
| P3 | 画像 L1 写入接口 + 单测(CUST-DEMO-A 写 style_tags)+ R-02 风控 service 骨架 | R-02 |
| P4 | NL2SQL LangGraph Tool 节点骨架(DeepSeek 生成 SQL + 白名单校验 + 只读执行) | D-01 |
| P5 | Neo4j 投顾 Tool 节点骨架(Cypher 执行 + 结果结构化) | 投顾 |
## ④ 阻塞问题
| 成员 | 阻塞描述 | 状态 |
| --- | --- | --- |
| P3 | [R-02 风控 service 落 log] Blocked by [P1 JWT 中间件未挂,service 账号 token 无法签发] → 解锁了 [R-02 端到端联调] | 待解 |
| P4 | [NL2SQL 真实生成] Blocked by [DeepSeek API Key 未配置] → 解锁了 [D-01 人话查数 Demo] | 待解 |
| P5 | [投顾 Tool 接入 chat] Blocked by [P1 LangGraph agent_service 骨架未起] → 解锁了 [P5 投顾端到端] | 待解 |
## ⑤ 任务调整
| 调整项 | 从谁 | 到谁 | 原因 |
| --- | --- | --- | --- |
| DeepSeek 接入 | P4 独做 | P1 主做 + P4 协助 | P1 同时要起 LangGraph 骨架,DeepSeek client 封装归 P1 一次做,四 Agent 复用,避免重复 |
| R-02 落 log 单测 | P3 独做 | P3 主写 + P1 提供 service token 签发 Mock | P1 掌握 JWT,需配合签发 svc-trade-suitability token |
## ⑥ 决议
| 决议 | 责任人 | 截止时间 |
| --- | --- | --- |
| JWT 用 RS256,dev 环境先用 HS256 + 固定 secret(与生产物理隔离) | P1 | 2026-09-09 12:00 |
| DeepSeek client 封装到 app/service/llm_client.py,四 Agent 共用 | P1 | 2026-09-09 18:00 |
| 画像 L1 写入必须带 version 乐观锁,写 risk_suitability_log.profile_l1_version | P3 | 2026-09-09 18:00 |
## ⑦ 风险提示
- P1 同时承担 JWT、LangGraph 骨架、DeepSeek client 三件事,是本周瓶颈,若 P1 卡住全员停摆;建议 P2 协助写 RBAC 单测分流
## ⑧ 下次会议
- 时间:2026-09-09 10:00
- 预计重点:JWT 单测验收 + LangGraph echo 跑通 + DeepSeek 接入验证
````
### 7.3 示例 · M1 Day1(客服能问答启动,2026-09-09 周三)
````
# 每日会议纪要 · 2026-09-09
## ① 基本信息
| 项 | 内容 |
| --- | --- |
| 日期 | 2026-09-09(周三) |
| 里程碑 | M1 = Phase 1 · 第 1 周 · Day 3(M1 启动日) |
| 主持人 | P1 |
| 参会人 | P1 / P2 / P3 / P4 / P5 |
| 缺席人 | 无 |
## ② 昨日完成
| 成员 | 完成事项 | 状态 |
| --- | --- | --- |
| P1 | JWT 中间件(HS256 dev)+ Mock 登录签发 STAFF-10086/CUST-9527 token + audit_log 中间件 + trace_id 贯通 | 🟢 |
| P2 | milvus_tool.py 连接封装 + kb_product_rules 首批 5 产品切块入库(bge-m3 1024 维) | 🟢 |
| P3 | 画像 L1 写入接口 + 单测(CUST-DEMO-A 写 style_tags,version 递增)通过 | 🟢 |
| P4 | NL2SQL Tool 节点骨架(DeepSeek 生成 + 白名单校验,未接真实 Key) | 🟡 |
| P5 | 投顾 Cypher Tool 节点骨架(Neo4j 执行 HOLDS 查询返回结构化) | 🟡 |
## ③ 今日计划
| 成员 | 今日交付 | 对应场景 |
| --- | --- | --- |
| P1 | LangGraph agent_service StateGraph 骨架 + DeepSeek client 接入 + /api/chat 最小闭环(echo + 真实 LLM) | F-0X/C-01 |
| P2 | 客服 Agent RAG Tool 节点接入 LangGraph(CUST-9527 问「某基金费率」→ Milvus 检索 → 带源返回) | C-02 |
| P3 | R-02 风控 service 落 log 联调(CUST-4002 C1 买 R4 → check_suitability → build_suitability_log_row → INSERT + audit) | R-02 |
| P4 | NL2SQL 接 DeepSeek 真实 Key,D-01 客户查数 Demo(「统计 C2 客户有多少」)+ analytics_query_log 留痕 | D-01 |
| P5 | 投顾 Agent 接入 LangGraph(A-01 客户概况 Cypher + 持仓事实) | A-01 |
## ④ 阻塞问题
| 成员 | 阻塞描述 | 状态 |
| --- | --- | --- |
| P2 | [客服 RAG 接入 LangGraph] Blocked by [P1 LangGraph agent_service 骨架未起] → 解锁了 [P2 客服端到端] | 待解(预计今日午前) |
| P3 | [R-02 service token] Blocked by [P1 service 账号 token 签发未做] → 解锁了 [R-02 阻断联调] | 待解 |
| 全员 | [前端 Demo] Blocked by [web/ 未 init] → 解锁了 [周五可视化 Demo] | 待解(P1 兜底或降级 curl 演示) |
## ⑤ 任务调整
| 调整项 | 从谁 | 到谁 | 原因 |
| --- | --- | --- | --- |
| web/ 前端 init | P1 兼 | P1 主 + P2 协助(P2 RAG 已先行) | P1 是瓶颈,P2 RAG 入库已完成可分流前端壳 |
| R-02 service token | P1 签发 | P3 写 Mock + P1 配合 | P3 掌握业务,P1 出 token 工具 |
## ⑥ 决议
| 决议 | 责任人 | 截止时间 |
| --- | --- | --- |
| LangGraph agent_service 骨架今日 18:00 前可跑通 echo + 真 LLM | P1 | 2026-09-09 18:00 |
| R-02 用 CUST-4002(C1 持 R4)做阻断联调样例,结果写 risk_suitability_log + audit_log | P3 | 2026-09-10 18:00 |
| 周五 Demo 降级方案:若 web/ 未就绪,用 curl + Postman 演示四 Agent 最小闭环 | P1 | 2026-09-12 |
## ⑦ 风险提示
- 周五 Demo 验收门是「骨架 + 客服能问答」,目前客服 RAG 依赖 LangGraph 骨架,今日若 P1 未起骨架,P2 全天停摆,连锁影响周五 Demo
- DeepSeek 真实 Key 今日必须配上,否则四 Agent 都只能跑 echo
## ⑧ 下次会议
- 时间:2026-09-10 10:00
- 预计重点:LangGraph 骨架验收 + 客服 RAG 闭环 + R-02 落 log 联调
````
---
## 8. 纪要归档约定
- 每日纪要存:`docs/项目管理/纪要/YYYY-MM-DD.md`
- 周末由 P1 汇总一份「周报」放 `docs/项目管理/周报/YYYY-WW.md`,对照 `02-项目开发计划.md` 的本周验收门打勾
- 纪要保留到答辩后 2 周,便于复盘和答辩问答引用
## 9. 关联文档
| 文档 | 用途 |
| --- | --- |
| [02-项目开发计划.md](./02-项目开发计划.md) | 对照本周验收门、依赖链 |
| [03-表设计文档.md](./03-表设计文档.md) | 接口字段、表关联查阅 |
| [../memory/REQUIREMENTS.md](../memory/REQUIREMENTS.md) | 场景编号 F/C/A/D/R 对照 |
| [../memory/TODO.md](../memory/TODO.md) | 任务责任人同步 |
| [../memory/MEMORY.md](../memory/MEMORY.md) §0 | 禁止项、交接清单 |