wecom_it_smart_desk/docs/10-项目管理/任务说明书/任务说明书-78-P0-1-workers改回1.md

任务说明书 — P0-1 生产 workers=2 改回 1（修复 WS 推送丢 50%）

版本: v1.0 | 日期: 2026-07-17

---

📋 基本信息

项目	内容
任务名称	P0-1 生产 backend workers=2 改回 1，恢复 WS 单 worker 铁律
任务ID	#78
优先级	🔴 P0
类型	部署优化 / Bug修复
状态	待开始
负责人	宋献
创建日期	2026-07-17
计划完成日期	2026-07-18

---

📥 输入项来源

问题证据

来源	说明
docker-compose.yml	主文件已 --workers 1 ✅
docker-compose-override.yml:4	覆盖为 --workers 2 ❌（compose 自动合并 override）
deploy-server/docker-compose.yml:115	--workers 2 ❌
deploy-server/docker-compose-green.yml:46	--workers 2 ❌
backend/app/tasks/h5_ai_task.py:10-14	头注释自述：ws_manager 进程内单例，多 worker 时 broadcast 静默丢失约 50%

技术文档

来源文档	相关章节	说明
docs/12-重构记录/00-v4.0重构总方案.md	§三 批次 1 P0-1	方案出处
docs/12-重构记录/01-问题验证清单.md	C2	问题证据
docs/09-部署运维/DEPLOY-GUIDE.md	§4.3 铁律 1	部署铁律

---

📤 输出成果要求

交付物清单

#	交付物	类型	说明
1	docker-compose-override.yml	配置	删除整个文件（或改 --workers 1），推荐删除
2	deploy-server/docker-compose.yml	配置	L115 --workers 2 → --workers 1
3	deploy-server/docker-compose-green.yml	配置	L46 --workers 2 → --workers 1
4	backend/app/main.py	代码	lifespan 启动日志打印醒目提示「WS 推送要求单 worker」+ /health 响应暴露 pid

代码要求

• 仅配置变更 + main.py 增加 2 行日志，零业务逻辑变更
• 服务器部署用 jms_ops.py 上传 compose 文件后 docker compose up -d backend

文档要求

• 更新 docs/12-重构记录/README.md §三 状态看板（#78 → 已完成）
• 填写 docs/12-重构记录/02-批次1-P0执行记录.md

---

🔧 验证方式

功能验证

验证项	验证方法	预期结果
compose 合并后 workers	服务器执行 docker compose -f docker-compose.yml -f docker-compose-override.yml config 2>/dev/null | grep workers（或仅主文件 config）	输出 workers: 1 或 --workers 1
容器进程数	docker exec wecom_it_backend ps aux | grep uvicorn	仅 1 个 worker 进程
WS 到达率	H5 + 坐席端各发 10 条消息	AI 回复 100% 到达（20/20）
/health 暴露 pid	curl https://itsupport.servyou.com.cn/api/health	响应含 pid 字段

---

✅ 完成标准

• override 文件已删除（或 workers=1），deploy-server 两份已改
• 服务器 backend 重启，docker compose config 验证 workers=1
• 双端 20 条消息全部到达
• 状态看板已更新

---

📊 工作分解

子任务	预估工时	状态
本地修改 override + deploy-server 两份 compose	15min	⬜
上传服务器 + 重启 backend + config 验证	20min	⬜
main.py 增加启动提示 + /health pid	15min	⬜
双端 20 条消息到达率验证	20min	⬜

---

📞 依赖与阻塞

依赖	说明	状态
无	独立任务，可最先执行	—

停机影响：backend 重启约 3-5 秒，WS 断连自动重连，无感知。

---

📈 变更记录

日期	变更内容	变更人
2026-07-17	创建任务	宋献