go-sms 分阶段落地实施计划
【文档状态】⛔ 已废止(2026-09 被 80 工作日日历取代;10 人团队资源假设与单人现实脱节)
仅作历史归档;阶段门禁思想由七件套门禁协议继承。
实施总体原则
- 环环相扣:每个阶段的输出是下个阶段的输入,验收不通过则阻塞后续开发
- MVP优先:P0功能优先落地,确保核心链路可运行
- 每日站会:15分钟同步进度与阻塞
- 每周迭代评审:展示可工作软件,收集反馈
- 自动化测试:单元测试覆盖率≥80%,集成测试覆盖核心链路
第0阶段:基础环境准备(第1-2周)
目标:完成开发、测试、预发布三套环境搭建,所有基础设施就绪
任务清单
| 序号 |
任务 |
责任人 |
工时 |
依赖 |
| 0.1 |
申请云资源(或物理机):计算节点、存储、网络 |
运维 |
2天 |
无 |
| 0.2 |
部署Kubernetes集群(3主节点+5工作节点) |
运维 |
2天 |
0.1 |
| 0.3 |
部署MySQL 8.0 MGR集群(1主2从) |
DBA |
1天 |
0.2 |
| 0.4 |
部署Redis Cluster(6节点,3主3从) |
DBA |
1天 |
0.2 |
| 0.5 |
部署Kafka 3节点集群 + 创建核心Topic |
运维 |
1天 |
0.2 |
| 0.6 |
部署ClickHouse集群(2分片×2副本) |
DBA |
1天 |
0.2 |
| 0.7 |
部署ETCD 3节点集群 |
运维 |
1天 |
0.2 |
| 0.8 |
部署MinIO对象存储 |
运维 |
0.5天 |
0.2 |
| 0.9 |
部署Prometheus + Grafana监控体系 |
运维 |
1天 |
0.2 |
| 0.10 |
部署ELK/EFK日志平台 |
运维 |
1天 |
0.2 |
| 0.11 |
搭建GitLab CI/CD流水线基础 |
运维 |
1天 |
0.2 |
| 0.12 |
初始化项目代码仓库 + 分支策略设定 |
后端TL |
0.5天 |
无 |
| 0.13 |
编写docker-compose本地开发环境 |
后端TL |
1天 |
无 |
验收标准
| 编号 |
验收项 |
验收方法 |
通过条件 |
| A-0.1 |
所有中间件健康运行 |
kubectl get pods -n middleware 全部Running |
所有Pod状态为Running,无重启 |
| A-0.2 |
MySQL主从同步正常 |
执行 SHOW SLAVE STATUS |
Seconds_Behind_Master < 1s |
| A-0.3 |
Redis集群节点全部在线 |
redis-cli cluster nodes |
所有节点状态为connected |
| A-0.4 |
Kafka Topic创建成功 |
kafka-topics.sh --list |
包含 sms-submit sms-report sms-up stats 四个Topic |
| A-0.5 |
ClickHouse表创建成功 |
执行 SHOW TABLES |
返回 sms_down_details 和 sms_up_records |
| A-0.6 |
监控面板可访问 |
浏览器访问Grafana |
显示基础系统指标(CPU/内存/磁盘) |
| A-0.7 |
日志可正常采集 |
查询ES索引 |
有系统日志写入 |
| A-0.8 |
CI/CD Pipeline可执行 |
触发一次空跑Pipeline |
绿色通过 |
| A-0.9 |
本地开发环境可启动 |
docker-compose up |
所有容器正常启动无报错 |
| A-0.10 |
代码结构规范 |
执行 go mod tidy && go build ./... |
编译通过无错误 |
阶段输出物
阻塞条件
- 任一中间件无法正常启动 → 阻塞
- CI/CD Pipeline无法运行 → 阻塞
- 本地开发环境无法一键启动 → 阻塞
第1阶段:核心数据模型与公共组件(第3-4周)
目标:完成所有数据模型定义、公共组件库、配置管理、日志/监控埋点,为业务开发奠定基础
任务清单
| 序号 |
任务 |
责任人 |
工时 |
依赖 |
| 1.1 |
设计并实现MySQL全部表结构(账号/通道/路由/余额/结算等36张表) |
后端高级 |
3天 |
0.2 |
| 1.2 |
编写GORM Entity模型 + 基础DAO层 |
后端高级 |
2天 |
1.1 |
| 1.3 |
实现Viper配置管理(支持YAML+环境变量+ETCD热加载) |
后端中级 |
2天 |
0.2 |
| 1.4 |
实现Zap结构化日志 + Lumberjack切割 |
后端中级 |
1天 |
1.3 |
| 1.5 |
实现Prometheus指标埋点(Counter/Gauge/Histogram) |
后端中级 |
1.5天 |
1.3 |
| 1.6 |
实现OpenTelemetry链路追踪中间件 |
后端高级 |
2天 |
1.3 |
| 1.7 |
实现Redis缓存客户端封装(支持单机/集群/哨兵) |
后端中级 |
1.5天 |
0.4 |
| 1.8 |
实现Kafka生产者/消费者封装(Sarama + 重试/死信) |
后端高级 |
2天 |
0.5 |
| 1.9 |
实现雪花ID生成器(支持多Worker自动注册) |
后端中级 |
1天 |
0.7 |
| 1.10 |
实现Redis分布式锁(Lua脚本 + 自动续期) |
后端中级 |
1.5天 |
0.4 |
| 1.11 |
实现Gin统一响应封装 + 错误码体系(UT:xxxx) |
后端中级 |
1天 |
1.3 |
| 1.12 |
实现JWT鉴权中间件 + 权限校验(Casbin集成) |
后端高级 |
2天 |
1.1 |
| 1.13 |
实现参数校验器(go-playground/validator + 自定义校验) |
后端中级 |
1天 |
1.3 |
| 1.14 |
实现数据库迁移工具(gormigrate + 版本管理) |
后端中级 |
1天 |
1.1 |
| 1.15 |
编写公共工具函数库(加密/脱敏/手机号校验/内容过滤) |
后端中级 |
2天 |
1.3 |
验收标准
| 编号 |
验收项 |
验收方法 |
通过条件 |
| A-1.1 |
所有表结构创建成功 |
连接MySQL执行 SHOW TABLES |
返回36张表 |
| A-1.2 |
GORM AutoMigrate正常运行 |
执行 go run cmd/migrate/main.go |
无报错,表结构符合设计 |
| A-1.3 |
配置支持从ETCD热加载 |
修改ETCD配置 → 观察应用日志 |
10秒内日志显示配置已更新 |
| A-1.4 |
日志输出符合规范(JSON格式) |
查看日志文件 |
每行均为有效JSON,包含timestamp/level/msg/fields |
| A-1.5 |
Prometheus指标暴露正常 |
访问 /metrics 端点 |
返回有效的Prometheus格式指标 |
| A-1.6 |
链路追踪正常上报Jaeger |
发起测试请求 → 查看Jaeger UI |
可查看到完整Trace链条 |
| A-1.7 |
Redis缓存读写正常 |
执行单元测试 go test ./pkg/cache/... |
全部通过 |
| A-1.8 |
Kafka生产消费正常 |
执行单元测试 go test ./pkg/queue/... |
全部通过,可生产消费消息 |
| A-1.9 |
ID生成器无碰撞 |
并发生成100万ID |
无重复ID |
| A-1.10 |
分布式锁可正常获取释放 |
执行单元测试 go test ./pkg/lock/... |
全部通过,无死锁 |
| A-1.11 |
所有错误码有对应中文描述 |
调用 GetErrorDesc("UT:0006") |
返回"黑名单" |
| A-1.12 |
JWT鉴权正常 |
携带有效/无效Token访问受保护接口 |
有效Token通过,无效返回401 |
| A-1.13 |
参数校验生效 |
提交非法参数(如空手机号) |
返回明确的校验错误 |
| A-1.14 |
数据库迁移可升级/回滚 |
执行 migrate up 和 migrate down |
版本号正确变更 |
| A-1.15 |
工具函数单元测试覆盖率≥90% |
go test -cover ./pkg/util/... |
覆盖率≥90% |
阶段输出物
阻塞条件
- 任何基础组件(Redis/Kafka/MySQL)连接失败 → 阻塞
- 配置热加载不生效 → 阻塞
- 分布式锁存在死锁风险 → 阻塞
- 单元测试覆盖率<80% → 阻塞
第2阶段:账号与权限体系(第5-6周)
目标:完成多级账号开户、权限管理、充值与余额管理,建立完整的用户身份体系
任务清单
| 序号 |
任务 |
责任人 |
工时 |
依赖 |
| 2.1 |
账号CRUD接口(创建/查询/修改/启用禁用/删除) |
后端中级 |
2天 |
1.1 |
| 2.2 |
账号多协议接入配置(CMPP/SMPP/HTTP/Web) |
后端高级 |
2天 |
2.1 |
| 2.3 |
账号多业务开通(国内短信/国际短信/视频/CSP/空号/短链) |
后端中级 |
1.5天 |
2.1 |
| 2.4 |
IP白名单绑定与校验 |
后端中级 |
1天 |
2.1 |
| 2.5 |
账号审核模式配置(免审/手动/自动) |
后端中级 |
1天 |
2.1 |
| 2.6 |
角色权限管理(RBAC + 页面级 + 二级权限) |
后端高级 |
3天 |
1.12 |
| 2.7 |
用户登录/登出(密码加密bcrypt + JWT) |
后端中级 |
1.5天 |
1.12 |
| 2.8 |
余额查询与充值接口(单个/批量) |
后端中级 |
2天 |
1.1 |
| 2.9 |
余额预警配置(阈值+微信/短信通知) |
后端高级 |
2天 |
2.8 |
| 2.10 |
账号切换上级/批量配置/标星功能 |
后端中级 |
1.5天 |
2.1 |
| 2.11 |
账号导出(仅admin) |
后端中级 |
1天 |
2.1 |
| 2.12 |
实名认证信息记录与审核 |
后端中级 |
1.5天 |
2.1 |
| 2.13 |
账号服务团队绑定 |
后端初级 |
1天 |
2.1 |
| 2.14 |
统一登录审计日志记录 |
后端中级 |
1.5天 |
1.15 |
验收标准
| 编号 |
验收项 |
验收方法 |
通过条件 |
| A-2.1 |
可正常创建各类账号 |
API调用创建HTTP/CMPP/SMPP/Web账号 |
4种协议账号均创建成功 |
| A-2.2 |
开通业务线准确 |
为账号开通短信/视频/CSP/空号/短链 |
各业务线独立生效 |
| A-2.3 |
IP白名单生效 |
非白名单IP调用接口 |
返回403拒绝访问 |
| A-2.4 |
审核模式切换生效 |
切换账号审核模式后提交短信 |
按模式执行对应审核策略 |
| A-2.5 |
角色权限正确隔离 |
客服角色无法访问大屏 |
返回403 |
| A-2.6 |
二级权限控制生效 |
无充值权限账号尝试充值 |
返回权限错误 |
| A-2.7 |
登录流程正常 |
正确密码登录返回JWT,错误密码锁定 |
JWT有效且含正确claims |
| A-2.8 |
充值后余额正确增加 |
充值100元,查询余额 |
余额增加100元 |
| A-2.9 |
余额预警正常触发 |
余额低于阈值 |
微信/短信通知发送成功 |
| A-2.10 |
账号删除条件限制 |
尝试删除有发送记录的账号 |
返回错误提示"账号有发送记录,不可删除" |
| A-2.11 |
导出账号仅admin |
admin可导出,非admin无法导出 |
权限校验生效 |
| A-2.12 |
实名认证审核流程完整 |
提交实名 → 审核通过 → 账号状态更新 |
状态流转正确 |
| A-2.13 |
登录审计记录完整 |
查询审计日志 |
包含登录账号/IP/时间/结果 |
阶段输出物
阻塞条件
- 任何账号创建失败 → 阻塞
- 权限校验绕过漏洞 → 阻塞
- 充值后余额计算错误 → 阻塞
第3阶段:通道管理与路由引擎(第7-8周)
目标:完成通道接入(CMPP/HTTP/SGIP/SMPP)、通道组管理、四步路由引擎
任务清单
| 序号 |
任务 |
责任人 |
工时 |
依赖 |
| 3.1 |
CMPP协议栈实现(连接/登录/提交/Deliver/ActiveTest) |
后端高级 |
4天 |
1.1 |
| 3.2 |
HTTP通道适配器(调用上游HTTP API) |
后端中级 |
2天 |
3.1 |
| 3.3 |
SGIP协议栈实现 |
后端高级 |
3天 |
3.1 |
| 3.4 |
SMPP协议栈实现(Bind/Submit/Deliver/EnquireLink) |
后端高级 |
3天 |
3.1 |
| 3.5 |
通道连接池管理(连接复用/心跳/断线重连) |
后端高级 |
2天 |
3.1 |
| 3.6 |
通道CRUD接口 + 通道测试工具 |
后端中级 |
2天 |
3.1 |
| 3.7 |
通道拦截配置(频次/日限/夜间管控/地区/黑关键字/签名) |
后端高级 |
2天 |
3.6 |
| 3.8 |
通道组管理(创建/启停/绑定通道) |
后端中级 |
1.5天 |
3.6 |
| 3.9 |
四步路由引擎实现 |
后端高级 |
4天 |
3.8 |
| 3.10 |
导流策略(关键字/账号维度指定通道) |
后端高级 |
2天 |
3.9 |
| 3.11 |
通道价格时间线管理(分时单价) |
后端中级 |
2天 |
3.6 |
| 3.12 |
通道估算余额计算(校正余额-成功数-未知数,2小时刷新) |
后端中级 |
1.5天 |
3.11 |
| 3.13 |
通道告警配置(异常检测/微信推送) |
后端中级 |
2天 |
3.6 |
| 3.14 |
通道通讯实时监控(2秒刷新) |
后端高级 |
2天 |
3.6 |
| 3.15 |
通道日志记录(CMPP用户/通道日志,5天内) |
后端中级 |
1.5天 |
3.1 |
验收标准
| 编号 |
验收项 |
验收方法 |
通过条件 |
| A-3.1 |
CMPP连接建立成功 |
连接模拟运营商CMPP服务端 |
登录成功,心跳正常 |
| A-3.2 |
CMPP消息提交成功 |
通过CMPP提交一条短信 |
收到Submit_Resp,MsgID非空 |
| A-3.3 |
HTTP通道调用成功 |
配置HTTP通道,发送请求 |
收到200响应,返回上游MsgID |
| A-3.4 |
SGIP/SMPP通道正常 |
同CMPP测试 |
绑定成功,消息收发正常 |
| A-3.5 |
连接池断线重连 |
手动断开通道连接 |
30秒内自动重连成功 |
| A-3.6 |
通道测试工具通过 |
使用测试工具发送测试短信 |
通道返回成功 |
| A-3.7 |
日限拦截生效 |
配置日限10条,发送第11条 |
返回UT:0023(发送限制) |
| A-3.8 |
通道组权重分发正确 |
配置A:B=7:3,发送100条 |
A≈70条,B≈30条,误差<5 |
| A-3.9 |
优先通道命中 |
配置关键字"测试"走优先通道 |
含"测试"内容走指定通道 |
| A-3.10 |
分时单价生效 |
配置8:00-18:00单价0.05,其他0.06 |
不同时间扣费正确 |
| A-3.11 |
通道估算余额准确 |
连续发送后查询估算余额 |
估算余额≈实际可用余额 |
| A-3.12 |
通道告警触发 |
模拟通道异常 |
微信告警通知发送成功 |
| A-3.13 |
实时通讯曲线刷新 |
访问监控页面 |
每2秒数据更新 |
| A-3.14 |
通道日志完整 |
查询某通道日志 |
包含连接/提交/回执完整记录 |
阶段输出物
阻塞条件
- CMPP协议无法正常通信 → 阻塞(核心通道)
- 路由引擎分发逻辑错误 → 阻塞
- 通道连接池存在泄漏 → 阻塞
第4阶段:消息发送主链路(第9-10周)
目标:完成群发/个性/定时/文件短信发送全流程,含审核、拦截、路由、提交通道
任务清单
| 序号 |
任务 |
责任人 |
工时 |
依赖 |
| 4.1 |
发送接口统一模型设计(SubmitRequest/Response) |
后端高级 |
1天 |
2.1 |
| 4.2 |
模板体系实现(模板CRUD + 变量匹配 + 占位符替换) |
后端高级 |
2天 |
4.1 |
| 4.3 |
黑名单三级检测(本地/API/第三方通道) |
后端高级 |
2天 |
3.9 |
| 4.4 |
黑白关键字/频次/签名/退订/地区/时间管控拦截器 |
后端高级 |
3天 |
3.9 |
| 4.5 |
审核工作流(免审/手动/自动 + 48h超时失败) |
后端高级 |
3天 |
2.5 |
| 4.6 |
群发短信业务逻辑(同内容批量) |
后端中级 |
2天 |
4.1 |
| 4.7 |
个性短信业务逻辑(号码+内容变量逐条) |
后端中级 |
2天 |
4.1 |
| 4.8 |
定时短信(定时任务管理 + 批量重置) |
后端中级 |
2天 |
4.6 |
| 4.9 |
文件短信(TXT/Excel/CSV解析 + 异步发送) |
后端中级 |
2天 |
4.6 |
| 4.10 |
HTTP API提交接口(含签名校验/回执绑定/上行绑定) |
后端中级 |
2天 |
4.1 |
| 4.11 |
CMPP客户接入提交(企业代码/扩展码/通道号校验) |
后端高级 |
2天 |
4.1 |
| 4.12 |
CMPP合包发送(聚合提交降低HTTP通道压力) |
后端高级 |
2天 |
4.11 |
| 4.13 |
上行码号分配(精确/前缀匹配 + 账号归属) |
后端中级 |
1.5天 |
4.1 |
| 4.14 |
发送批次记录生成 + 批次状态统计 |
后端中级 |
2天 |
4.6 |
| 4.15 |
Kafka生产者写入(消息入队) |
后端中级 |
1天 |
1.8 |
验收标准
| 编号 |
验收项 |
验收方法 |
通过条件 |
| A-4.1 |
群发短信正常提交 |
通过API提交100条短信 |
返回批次ID,全部进入审核/发送流程 |
| A-4.2 |
个性短信逐条内容 |
提交3条不同内容个性短信 |
每条内容与提交一致 |
| A-4.3 |
模板匹配生效 |
使用报备模板发送 |
自动匹配模板,免审通过 |
| A-4.4 |
模板变量替换正确 |
模板{%姓名%}替换为实际值 |
替换后内容正确 |
| A-4.5 |
黑名单拦截命中 |
手机号在黑名单中 |
返回UT:0006 |
| A-4.6 |
频次拦截命中 |
同号码1分钟内发送2条(配置1条/分钟) |
第2条返回UT:0016 |
| A-4.7 |
签名校验生效 |
内容无签名 |
返回UT:0013 |
| A-4.8 |
退订标识校验 |
内容无"拒收请回复R" |
返回UT:0014 |
| A-4.9 |
地区拦截生效 |
手机号属于屏蔽省份 |
返回UT:0009 |
| A-4.10 |
营销时间管控生效 |
非营销时间段提交 |
返回时间管控失败 |
| A-4.11 |
自动审核通过 |
提交内容无敏感词 |
状态为审核通过,进入路由 |
| A-4.12 |
手动审核 |
提交敏感内容 |
状态为待审核,管理员可见 |
| A-4.13 |
48h超时审核自动失败 |
待审核消息48小时未处理 |
状态变为审核失败 |
| A-4.14 |
定时短信定时发送 |
设置2小时后发送 |
2小时后准确发送 |
| A-4.15 |
文件短信解析正确 |
上传含1000条号码的Excel |
全部解析成功,逐条发送 |
| A-4.16 |
CMPP客户提交通道号校验 |
提交通道号不匹配 |
返回UT:0012 |
| A-4.17 |
CMPP合包生效 |
大批量提交触发合包 |
有效减少HTTP调用次数 |
| A-4.18 |
上行码号分配正确 |
回复码号匹配账号 |
上行记录归属正确账号 |
| A-4.19 |
Kafka消息入队成功 |
发送后检查Topic |
消息存在于sms-submit Topic |
| A-4.20 |
入口吞吐达标 |
5000 TPS持续5min压测(Day50) |
P99<50ms;超限请求返回429;MySQL无同步写入 |
| A-4.21 |
下发限速零超速 |
满载下发对照通道speed=3000 |
峰值≥3000 TPS且无超速拒绝;零失败零断链(对照Day39基线:256窗口均值2263/峰值3203) |
| A-4.22 |
背压三级水位联动 |
5000入/3000出打5min |
lag>10万触发L1告警;L2入口收紧至Σ(通道speed);停止打压后lag收敛 |
阶段输出物
阻塞条件
- 任何发送方式(群发/个性/定时)无法正常提交 → 阻塞
- 模板匹配不准确 → 阻塞
- 审核流程状态流转错误 → 阻塞
- Kafka消息未正确入队 → 阻塞
第5阶段:回执/上行与记录查询(第11-12周)
目标:完成回执接收处理、上行消息处理、下行记录/明细/历史查询
任务清单
| 序号 |
任务 |
责任人 |
工时 |
依赖 |
| 5.1 |
Kafka消费者服务(消费回执/上行消息) |
后端高级 |
2天 |
4.15 |
| 5.2 |
回执处理引擎(状态归一化 DELIVRD/FAILURE/UNKNOWN) |
后端高级 |
2天 |
5.1 |
| 5.3 |
计费确认/退款逻辑(预扣→实扣/回退) |
后端高级 |
3天 |
2.8, 5.2 |
| 5.4 |
回执重推机制(支持30天内手动重推) |
后端中级 |
2天 |
5.2 |
| 5.5 |
手动配对状态(4种方式处理3h外无状态短信) |
后端高级 |
2天 |
5.2 |
| 5.6 |
上行消息处理(接收/匹配/归属分配) |
后端中级 |
2天 |
5.1 |
| 5.7 |
上行自动拉黑(回复"拒收"等规则可配) |
后端中级 |
1.5天 |
5.6 |
| 5.8 |
HTTP回调推送(回执绑定地址+上行绑定地址) |
后端中级 |
2天 |
5.2, 5.6 |
| 5.9 |
CMPP回执推送(Deliver) |
后端高级 |
2天 |
5.2 |
| 5.10 |
下行记录(批次级,5天热数据) |
后端中级 |
2天 |
4.14 |
| 5.11 |
下行明细(号码级,5天热数据) |
后端中级 |
2天 |
5.10 |
| 5.12 |
历史记录/明细(全量查询,ClickHouse) |
后端高级 |
3天 |
0.6 |
| 5.13 |
上行记录(15天匹配窗口) |
后端中级 |
2天 |
5.6 |
| 5.14 |
定时记录管理(定时任务取消/重置时间) |
后端中级 |
1.5天 |
4.8 |
| 5.15 |
明细异步下载(下载中心 + 权限控制) |
后端中级 |
2天 |
5.12 |
| 5.16 |
视频记录体系(下行/明细/上行/定时,同短信模型) |
后端中级 |
2天 |
5.10 |
验收标准
| 编号 |
验收项 |
验收方法 |
通过条件 |
| A-5.1 |
回执消费正常 |
模拟通道发送回执到Kafka |
消费者正确处理,状态更新 |
| A-5.2 |
DELIVRD计费确认 |
回执为DELIVRD |
预扣金额转为实扣,余额正确减少 |
| A-5.3 |
FAILURE退款 |
回执为FAILURE |
预扣金额退回,余额恢复 |
| A-5.4 |
UNKNOWN状态处理 |
72小时无回执 |
状态变为UNKNOWN,冻结释放 |
| A-5.5 |
回执重推成功 |
手动触发30天内回执重推 |
客户收到重推回执 |
| A-5.6 |
手动配对生效 |
对3h外无状态短信执行配对 |
状态更新为指定状态 |
| A-5.7 |
上行消息归属正确 |
上行码号匹配到账号 |
上行记录归属正确账号 |
| A-5.8 |
上行"拒收"自动拉黑 |
回复"拒收R" |
手机号加入黑名单 |
| A-5.9 |
HTTP回调正常 |
配置回执回调地址 |
回调接口收到回执JSON |
| A-5.10 |
CMPP Deliver推送 |
客户为CMPP协议 |
通过CMPP连接推送Deliver |
| A-5.11 |
下行记录5天内可查 |
查询今日发送批次 |
返回正确批次列表 |
| A-5.12 |
历史数据可查 |
查询90天前发送记录 |
从ClickHouse返回正确数据 |
| A-5.13 |
上行15天匹配 |
上行匹配15天内发送数据 |
匹配成功或归admin |
| A-5.14 |
定时任务取消 |
取消待发送定时任务 |
任务不再执行 |
| A-5.15 |
明细异步下载 |
发起下载任务 → 下载文件 |
文件内容与查询结果一致 |
| A-5.16 |
视频记录独立 |
查询视频短信记录 |
与短信记录隔离正确 |
阶段输出物
阻塞条件
- 回执无法正常匹配消息ID → 阻塞
- 计费确认/退款计算错误 → 阻塞(资金安全)
- 历史数据查询超时(>3秒)→ 阻塞
第6阶段:统计与计费结算(第13-14周)
目标:完成多维统计、上下家结算、利润分析、充值/消耗日志
任务清单
| 序号 |
任务 |
责任人 |
工时 |
依赖 |
| 6.1 |
统计事件消费者(消费Kafka统计事件 → 写入ClickHouse) |
后端高级 |
2天 |
0.6 |
| 6.2 |
多维统计(时间/用户/地区/运营商/签名/状态码/回执速率) |
后端高级 |
3天 |
6.1 |
| 6.3 |
统计定时补算(偶数整点刷新/昨日7/13/17点补算) |
后端中级 |
2天 |
6.2 |
| 6.4 |
用户使用统计API + 前端图表 |
后端中级 |
2天 |
6.3 |
| 6.5 |
通道使用统计API + 前端图表 |
后端中级 |
2天 |
6.3 |
| 6.6 |
下家结算(月度账单/明细导出) |
后端高级 |
2.5天 |
5.3 |
| 6.7 |
上家结算(账单/明细/结账记录/单价追加) |
后端高级 |
2.5天 |
5.3 |
| 6.8 |
利润分析(用户利润+下级利润+通道利润) |
后端高级 |
2天 |
6.6, 6.7 |
| 6.9 |
消耗日志(按账号/业务/天记录) |
后端中级 |
1.5天 |
5.3 |
| 6.10 |
充值日志(充值记录+付款审核确认) |
后端中级 |
1.5天 |
2.8 |
| 6.11 |
结算报表导出(XLS格式) |
后端中级 |
1天 |
6.6 |
| 6.12 |
主页工作台(今日用量/发送类型/数据分析) |
后端高级 |
2天 |
6.3 |
验收标准
| 编号 |
验收项 |
验收方法 |
通过条件 |
| A-6.1 |
统计事件实时写入 |
发送消息后查看ClickHouse |
5秒内在统计表可见新数据 |
| A-6.2 |
时间维度统计准确 |
查询今日/本月/自定义时间范围 |
数据与发送记录一致 |
| A-6.3 |
用户维度统计准确 |
查询指定账号发送量 |
数据准确 |
| A-6.4 |
地区/运营商统计准确 |
查询某省/某运营商发送量 |
与号码库匹配 |
| A-6.5 |
偶数整点刷新生效 |
14:00查看统计 |
数据更新到最新 |
| A-6.6 |
昨日补算生效 |
7:00查看昨日统计 |
数据完整 |
| A-6.7 |
下家账单金额正确 |
生成某客户月度账单 |
金额=成功条数×单价 |
| A-6.8 |
上家结算金额正确 |
生成上家对账单 |
金额=成功条数×通道成本单价 |
| A-6.9 |
利润计算正确 |
查询某时间段利润 |
利润=下家收入-上家成本 |
| A-6.10 |
消耗日志完整 |
查询某账号某天消耗 |
包含所有发送消耗 |
| A-6.11 |
充值日志可追溯 |
查询充值记录 |
包含充值时间/金额/操作人 |
| A-6.12 |
主页工作台数据实时 |
访问主页 |
今日用量/图表正常显示 |
阶段输出物
阻塞条件