任务说明书：消息推送策略优化与超时提醒
版本: v1.0 | 日期: 2026-07-05
📋 基本信息
| 项目 |
内容 |
| 任务名称 |
消息推送策略优化与超时提醒 |
| 任务ID |
#100 |
| 优先级 |
🟠 P1 |
| 类型 |
功能开发 |
| 状态 |
✅ 已完成 |
| 负责人 |
宋献 |
| 创建日期 |
2026-07-05 |
| 计划完成日期 |
待定 |
📥 输入项来源
产品需求
| 来源文档 |
相关章节 |
说明 |
02-产品需求/04-技术方案-消息推送策略优化与超时提醒.md |
全文 |
技术方案文档 |
技术架构
| 来源文档 |
相关章节 |
说明 |
backend/app/api/messages.py |
send_message 函数 |
现有消息发送逻辑 |
backend/app/models/conversation.py |
Conversation 模型 |
会话数据模型 |
项目看板
| 来源 |
任务名 |
说明 |
| 用户反馈 |
消息推送策略 |
坐席回复不应出现在企微应用消息列表 |
📤 输出成果要求
交付物清单
| # |
交付物 |
类型 |
说明 |
| 1 |
数据库迁移脚本 |
SQL |
conversations 表新增 4 个字段 |
| 2 |
提醒服务 |
Python |
backend/app/services/reminder_service.py |
| 3 |
定时任务 |
Python |
backend/app/tasks/reminder_task.py |
| 4 |
消息发送逻辑修改 |
Python |
移除企微 API 调用，仅走 WebSocket |
| 5 |
部署验证 |
- |
生产环境测试通过 |
代码要求
- 遵循项目代码规范
- 所有新增代码通过 Pylint 检查
- 单元测试覆盖新增逻辑
文档要求
🔧 验证方式
功能验证
| 验证项 |
验证方法 |
预期结果 |
| 坐席发送消息 |
坐席回复用户消息 |
仅出现在 H5 页面，不出现在企微应用消息 |
| 超时提醒 |
坐席回复后等待 3 分钟 |
收到企微提醒消息 |
| 提醒只发一次 |
再次等待 3 分钟 |
不再收到提醒 |
| 待关闭状态 |
坐席回复后等待 10 分钟 |
会话状态变为 pending_close |
安全验证
| 验证项 |
验证方法 |
预期结果 |
| 权限控制 |
非坐席无法触发 |
仅坐席回复触发逻辑 |
✅ 完成标准
验收条件
产出确认
📊 工作分解
子任务
| 子任务 |
负责人 |
预估工时 |
状态 |
| T1. 数据库迁移 |
宋献 |
0.5h |
待开始 |
| T2. 消息发送逻辑修改 |
宋献 |
0.5h |
待开始 |
| T3. 新建提醒服务 |
宋献 |
1h |
待开始 |
| T4. 新建定时任务 |
宋献 |
1h |
待开始 |
| T5. 定时任务注册 |
宋献 |
0.5h |
待开始 |
| T6. 部署测试 |
宋献 |
1h |
待开始 |
总计：约 4.5 小时
📞 依赖与阻塞
前置依赖
阻塞因素
📈 变更记录
| 日期 |
变更内容 |
变更人 |
说明 |
| 2026-07-05 |
创建任务 |
宋献 |
初始版本 |
📎 附件
- 技术方案：
docs/03-技术架构/02-技术方案/技术方案-消息推送策略优化与超时提醒.md
Simon