lislgosms/docs/phase-8-operations-acceptance-plan.md

阶段 8：查询、统计、验收实施计划

目标

系统可运营、可排查、可上线。阶段 8 不新增新的业务主流程，重点补齐查询、统计、追踪、对账、压测报告和部署回滚文档。

实施范围

1. 查询与追踪。
   • 客户端批量任务、发送详情、上行短信查询。
   • 运营端发送监控、任务进度、短信记录、上行记录查询。
   • 按企业、应用、通道、任务、手机号追踪发送链路。
2. 统计与看板。
   • 运营看板汇总任务、短信、成功、失败、未知、超时、上行、账务金额。
   • 按企业、应用、通道聚合发送统计。
3. 对账。
   • 按短信记录与短信计费记录对账。
   • 按账务流水与短信计费记录对账。
4. 操作日志审计。
   • 查询操作日志。
   • 输出操作日志统计。
5. 验收文档。
   • 输出 500 条/秒压测报告。
   • 输出 Linux 上线部署文档。
   • 输出回滚方案。

API 边界

客户端：

• GET /api/client/operations/batch-tasks
• GET /api/client/operations/batch-tasks/:id/messages
• GET /api/client/operations/uplink-messages

运营端：

• GET /api/admin/operations/monitor
• GET /api/admin/operations/task-progress
• GET /api/admin/operations/messages
• GET /api/admin/operations/uplink-messages
• GET /api/admin/operations/dashboard
• GET /api/admin/operations/statistics
• GET /api/admin/operations/audit-logs
• GET /api/admin/operations/audit-summary
• GET /api/admin/operations/trace
• GET /api/admin/operations/reconciliation

验收标准

1. 可按企业、应用、通道、任务、手机号追踪发送链路。
2. 可按账务流水和短信记录对账。
3. 输出 500 条/秒压测报告。
4. 输出 Linux 部署方案，至少覆盖 Docker Compose 或 systemd 部署、环境变量、数据库迁移、日志目录、备份恢复、服务健康检查和回滚步骤。
5. npm run verify:phase8 通过。