- 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.
16 KiB
16 KiB
每日会议纪要模板与流程
路径:
docs/项目管理/01-每日会议纪要模板与流程.md适用:JinRong 金融四 Agent 项目 · 5 人全栈新手团队 关联:02-项目开发计划.md · 03-表设计文档.md · ../memory/MEMORY.md §0 交接清单
1. 会议目的
每天组内至少开一次站会式同步,三件事必须做完:
- 评审需求 —— 对照
docs/memory/REQUIREMENTS.md的场景编号(F/C/A/D/R),确认当天要推进的是哪几条,避免做偏。 - 评估进度 —— 对照
docs/项目管理/02-项目开发计划.md的本周验收门,看每个人是「绿 / 黄 / 红」。 - 任务分配调整 —— 谁卡住了、谁提前完成了、依赖解锁了没,当场把活儿从一个人调到另一个人。
一句话原则:会短、事清、阻塞显形。会议不是汇报表演,是「让阻塞在 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 §依赖关系),所以阻塞必须显式标注 上下游:
格式:
[我的任务] Blocked by [谁/什么] → 解锁了 [谁/什么]
正例:
P5 投顾 Agent 接 check_suitabilityBlocked byP1 未挂载 /api/chat 路由→ 解锁了P5 的 R-02 落库联调P2 客服 RAG 检索Blocked byP1 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 | 对照本周验收门、依赖链 |
| 03-表设计文档.md | 接口字段、表关联查阅 |
| ../memory/REQUIREMENTS.md | 场景编号 F/C/A/D/R 对照 |
| ../memory/TODO.md | 任务责任人同步 |
| ../memory/MEMORY.md §0 | 禁止项、交接清单 |