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.
This commit is contained in:
2026-09-14 00:18:31 +08:00
parent f856ab4aa6
commit 9e1a9b2a7e
18 changed files with 378 additions and 40 deletions
+21 -26
View File
@@ -16,7 +16,7 @@
| 团队规模 | 5 人(P1~P5),全栈新手 |
| 里程碑 | M0 启动 → M1~M5 对应 Phase 1~5 |
| 验收节奏 | 每周五 Demo + 答辩在第 5 周末 |
| 当前日期 | 2026-09-07(本计划制定日) |
| 0 | 当前日期 | 2026-09-13(§11 快照已更新 · 答辩周) |
---
@@ -314,37 +314,32 @@ Demo 脚本(P1 主持):
---
## 11. 当前状态快照(2026-09-07)
## 11. 当前状态快照(2026-09-13 · 答辩周)
### 11.1 Wave 0 已完成项
> 开发自用细节见 [`docs/memory/MEMORY.md`](../memory/MEMORY.md) §0 · 答辩提交摘要见 [`docs/答辩/提交物料/02-开发计划.md`](../答辩/提交物料/02-开发计划.md)
- [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.1 已交付(可 Demo)
### 11.2 Wave 0 待完成项
- [x] Wave 0:JWT/RBAC · 审计/trace · Core 只读 · 输入防护 · Mock 登录 · `/api/ready`
- [x] Wave 1:问数 NL2SQL + 模板/缓存/analyze · 顾问 `/api/advisor-agent/*` 接缝
- [x] Wave 2:风控 R-01~R-05 · 模拟网关 · **基金转换 T+1**(受理/确认分离)
- [x] Wave 3:客服 LangGraph + RAG · 选购清单 · **客户交易中心/行情快捷交易**
- [x] 代销平台 API v0.1 + 前端四角色 `web/` 主链路
- [x] 答辩材料:`docs/答辩/`(稿 · SOP · 幻灯片 · **提交物料 6 项**)
- [ ] DeepSeek 真 LLM 接入(client 封装)
- [ ] 前端 web/ init
- [ ] agent 专用 5 表灌库验收(02-mysql-agent专用.sql)
- [ ] kb_product_rules 首批产品入库
- [ ] /api/chat 真实闭环(echo → 真 LLM)
- [ ] R-02 风控 service 落 log 联调
### 11.2 进行中 / 答辩不展开
### 11.3 关键待办(见 TODO.md)
- [ ] `merger` 工作区多批功能 **待你确认后 commit**(客户交易 · 字体栈 · E2E 证据)
- [ ] 顾问 `test_sprint*` 集成与陈旧 DDL 期望(F-α · 转 sqlite 后暴露)
- [ ] 全量 `pytest` **非幂等**(F-η)—— 不以单次 passed 数作唯一门闸
- [ ] 登录 `/api/auth/login` 的 **`app_env` 生产门禁**(P0 方向② · 已拍板答辩后部署前再修)
- [ ] 「网点办理」文案 vs 无理财师交易 API(F-β 记账 · 答辩口径:一期线下未实现)
- 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 入口
### 11.3 关键文档入口
- 待办:[`docs/memory/TODO.md`](../memory/TODO.md)
- 端到端证据:[`docs/memory/tests/`](../memory/tests/)(CT-001 · AN-003 · AD-001 · RK-001 · XC-001)
- Bootstrap:[`docs/memory/FLOW.md`](../memory/FLOW.md) §0
---
+19 -1
View File
@@ -321,7 +321,25 @@
| 用途 | 客户持仓(份额、成本、市值、盈亏) |
| 关键字段 | `customer_id` · `product_id` · `qty` · `cost_amount` · `market_value` · `pnl_pct` · `as_of` |
| 关键查询 | C-01 持仓问答;A-01 客户概况 |
| 关联 | ← `core_customer` · `core_product` |
| 关联 | ← `core_customer` · `core_product` · **`core_share_lot`(FIFO 批次;申赎/转换确认后网关同步快照 qty)** |
| 2026-09-13 | 模拟申赎经 `trade_gateway` 维护批次并 **UPSERT `core_holding`**;读侧另有 `list_holdings_from_lots_gap` 补偿历史只写 lot 的演示态 |
### 3.8a `core_share_lot` · 份额批次(FIFO)
| 项 | 内容 |
| --- | --- |
| 用途 | 申赎/转换按批次扣减与追溯(赎回费按持有天数分档) |
| 关键字段 | `lot_id` · `remain_qty` · `nav` · `confirmed_at` |
| 谁写 | 模拟网关写侧(subscribe/redeem/convert 确认段) |
| 关联 | 与 `core_holding` 快照一致化;转换见 `core_convert_lot_detail` |
### 3.8b `core_convert_request` · 基金转换受理单(T+1)
| 项 | 内容 |
| --- | --- |
| 用途 | T 日**受理**(不扣份额);T+1 **确认**扣批/写流水 |
| 关键字段 | `convert_group_id` · `client_request_id`(幂等)· `status` · `accept_date` / 确认日 |
| 深读 | [`架构设计-基金转换交易.md`](../项目框架设计/架构设计-基金转换交易.md) |
### 3.9 `core_trade` · 交易流水(含 AML 字段)
+2 -1
View File
@@ -14,7 +14,8 @@
| 2 | [02-项目开发计划.md](./02-项目开发计划.md) | 项目级 5 周计划:Wave×Phase 双视角、依赖链、周验收门、第1周天级、风险、答辩准备 | 每周初、里程碑评审 |
| 3 | [03-表设计文档.md](./03-表设计文档.md) | 给人看的表设计字典:MySQL双库/Redis/Neo4j/Milvus 分层、谁写谁读、关键字段中文释义、建表顺序 | 写代码查表、联调对字段 |
| 4 | [04-从需求到公共API开发方法.md](./04-从需求到公共API开发方法.md) | **方法论文档**:需求→矩阵→存储→Service→API→Agent 主线、分批策略、统筹分工、Phase A 接口清单 | 搭公共底座/API 前;新人 onboarding |
| 5 | [../项目框架设计/接口契约-代销平台API-v0.1.md](../项目框架设计/接口契约-代销平台API-v0.1.md) | **代销平台 REST 契约**:业务域路由、命名规范、v0.1 端点、Agent 合并迁移表 | 写平台 API / Review Agent 重复接口 |
| 5 | [../项目框架设计/接口契约-代销平台API-v0.1.md](../项目框架设计/接口契约-代销平台API-v0.1.md) | **代销平台 REST 契约** | 写平台 API / Review Agent 重复接口 |
| — | [../答辩/提交物料/README.md](../答辩/提交物料/README.md) | **答辩文本 6 项提交索引**(对照客户清单) | 打包答辩 ZIP |
| 6 | [../项目框架设计/C-05-行情数据源选型对比.md](../项目框架设计/C-05-行情数据源选型对比.md) | **C-05 净值/行情数据源**:P0 种子 vs Phase B 第三方 sync vs 生产 Wind/Choice | 答辩、发群、Phase B 拍板 |
| 7 | [../项目框架设计/接口契约-代销平台API-v0.2-行情扩展草案.md](../项目框架设计/接口契约-代销平台API-v0.2-行情扩展草案.md) | **v0.2 草案**:`nav-snapshot` · `sync_market_nav` · 前端/Agent 契约 | 做产品行情页 Phase B、后端 sync |
+60
View File
@@ -0,0 +1,60 @@
# 每日会议纪要 · 2026-09-13
## ① 基本信息
| 项 | 内容 |
| --- | --- |
| 日期 | 2026-09-13(周六 · 答辩准备日) |
| 里程碑 | M5 演示与答辩材料收口 |
| 主持人 | 项目组统筹 |
| 参会人 | 全员(垂直负责人) |
| 缺席人 | 无 |
## ② 昨日完成
| 成员 | 完成事项(对照场景编号) | 状态 |
| --- | --- | --- |
| 平台 | 客户线 CT-001 缺陷修复(P0 鉴权 / P1 自助适当性 / L1 幂等)+ E2E 复跑取证 | 🟢 |
| 平台 | 第五轮 E2E:问数/理财师/风控/横切 HTTP 包 + 8 支浏览器脚本收仓 | 🟢 |
| 前端 | 客户交易中心 · 行情快捷交易 · Inter/Radix 设计栈(待 commit) | 🟡 |
| 测试 | sprint 单测写真库根因修复(F-ε);陈旧 `/api/v1` 登录迁移 | 🟢 |
## ③ 今日计划
| 成员 | 今日交付(最小可验证单元) | 对应场景 |
| --- | --- | --- |
| 全员 | 对照客户《答辩所需文本交付物清单》整理 6 项文本 + PPT 导出 PDF | 答辩 |
| 平台 | `prepare_all.ps1` + `restart-dev.ps1` 答辩前 60 分钟自检 | F-01~F-04 |
| 主讲 | 答辩稿 + DEMO-SOP 全流程预演一遍(≤15 分钟) | 四 Agent Demo |
## ④ 阻塞问题
| 成员 | 阻塞描述 | 状态 |
| --- | --- | --- |
| 演示 | [Redis 未起] Blocked by [会话/问数缓存] → 解锁了 [CT11 序号续槽对照轮] | 可选(答辩不强制停 Redis) |
| 文案 | [「网点办理」引导] Blocked by [无理财师侧交易 API] → 已拍板答辩口径为「一期线下未实现」 | 已记录 |
## ⑤ 任务调整
| 调整项 | 从谁 | 到谁 | 原因 |
| --- | --- | --- | --- |
| convert 单测 28 条红 | 改业务放行 | **只改测试前提(F-β 选 A)** | C3×R4 自助阻断为设计意图,非缺陷 |
| 答辩 PPT | 重画架构 | **沿用 HTML 幻灯片 + 打印 PDF** | 与 SOP/知识点清单同步维护 |
## ⑥ 决议
| 决议 | 责任人 | 截止时间 |
| --- | --- | --- |
| 文本交付 6 项以 `docs/答辩/提交物料/` 为提交索引 | 文档 | 2026-09-13 |
| 上台不口播 pytest/E2E 失败数;工程细节放知识点 §八 | 主讲 | 答辩前 |
| 必答题「Vibe Coding 坑与经验」写入答辩稿 §10 | 主讲 | 2026-09-13 |
## ⑦ 风险提示
- 演示库若未 `reset.ps1`,持仓快照与批次和可能不一致(B1)—— Demo 用前后差值叙事,不对评委报绝对数。
- `pytest` 全量非幂等(F-η),答辩前自检以 **Demo 功能测试 P0** 为准,不以单次 pytest 数为唯一门闸。
## ⑧ 下次会议
- 时间:答辩当日 Demo 前 60 分钟(见 `docs/答辩/README.md`)
- 预计重点:`DEMO-功能测试流程.md` P0 项 + 四角色账号登录