docs: 推 P1-1~4 给 workbuddy 修消息优化遗留

This commit is contained in:
Simon
2026-06-14 21:43:35 +08:00
parent ddebbe61a5
commit 4c65307e0c
2 changed files with 188 additions and 4 deletions
+38 -4
View File
@@ -704,10 +704,10 @@ location /api/ {
| 编号 | 状态 | 编号 | 状态 |
|------|------|------|------|
| CR-5 (P0-1) | ✅ | H-12 (P1-1) | ⚠️ |
| CR-6 (P0-2) | ✅ | H-13 (P1-2) | ⚠️ |
| CR-7 (P0-3) | ✅ | H-14 (P1-3) | ⚠️ |
| CR-8 (P0-4) | ✅ | H-15 (P1-4) | ⚠️ |
| CR-5 (P0-1) | ✅ | H-12 (P1-1) | 🔄 |
| CR-6 (P0-2) | ✅ | H-13 (P1-2) | 🔄 |
| CR-7 (P0-3) | ✅ | H-14 (P1-3) | 🔄 |
| CR-8 (P0-4) | ✅ | H-15 (P1-4) | 🔄 |
| CR-9 (P0-5) | ✅ | M-13 (P2-2) | ⚠️ |
| CR-10 (P0-6) | ✅ | M-14 (P2-3) | ⚠️ |
| | | M-15 (P2-1) | ✅(捎带)|
@@ -768,3 +768,37 @@ location /api/ {
| P0-#3 Mock login | 🟢 完成 |
| P0-#4 WS token | 🟡 遗留 1+2 |
| P0-#5 坐席密码 | 🟡 遗留 3+4+5 |
---
## 第十一节: 2026-06-14 P1 消息优化推送(2 轮)
**来源**: 6-14 workbuddy 消息优化推送遗留 4 P1
**主报告**: `docs/评审报告/workbuddy-2026-06-14-消息优化.md` 9.3 节
**workbuddy 任务清单**: `.workbuddy/memory/2026-06-14-任务-修P1消息.md`
**任务编号**: #23
### 11.1 4 P1 项
| 编号 | 严重度 | 内容 | 状态 |
|---|---|---|---|
| H-12 (P1-1) | 🟡 | upload 路径在容器本地,容器重建即丢失 → 改 volume mount | 🔄 |
| H-13 (P1-2) | 🟡 | SQL 迁移未走 Alembic → 生成 `add message status` 迁移 | 🔄 |
| H-14 (P1-3) | 🟡 | docker-compose backend healthcheck 用 curl → 改 Python 一行 | 🔄 |
| H-15 (P1-4) | 🟡 | ws_manager 没实现"消息状态广播" → 实现 `broadcast_message_status()` | 🔄 |
### 11.2 评审教训(防 workbuddy 再犯)
1. **依赖 docker volume 部署前要先建 host 目录** —— `scripts/deploy.sh` 需加创建逻辑
2. **alembic autogenerate 需人工 review** —— 自动生成的不一定对(可能漏 index / 加了不想要的)
3. **backend 精简镜像没 curl 是已知坑** —— 用 Python 一行替代
4. **文档承诺的 WS 广播必须实做** —— 否则前端靠轮询兜底,实时性不够
### 11.3 第十一节状态速查
| 编号 | 状态 |
|---|---|
| H-12 (P1-1) upload 路径 | 🔄 评审闭环中 |
| H-13 (P1-2) Alembic 迁移 | 🔄 评审闭环中 |
| H-14 (P1-3) healthcheck | 🔄 评审闭环中 |
| H-15 (P1-4) ws 状态广播 | 🔄 评审闭环中 |