Files
go-sms-V2/memory-bank/docs/Go-sms-开发计划.md
T

35 KiB
Raw Blame History

Go-sms 开发计划

【文档状态】⛔ 已废止(实际推进 Day 1-71,2026-09-29 终止;10 人团队假设同实施计划) 仅作历史归档;承上启下门禁清单思想由七件套继承。

本计划基于《分阶段落地实施计划》逐层拆解,按工作日(人天)精确到天,为每位Go开发工程师提供清晰的每日行动指南。
核心原则:每项任务产出必须可独立验证,前序任务验收不通过,后续任务不得启动,确保“环环相扣,承上启下”。


一、总体开发纪律与规范

规范项 具体要求
代码分支 main(生产)← release(预发布)← develop(开发主分支)← feature/xxx(功能分支)
Merge Request 必须包含:自测报告截图、接口变更说明、数据库变更脚本;至少1名Senior Approve
单元测试 核心业务逻辑覆盖率 ≥ 80%;go test -race -cover 必须全部通过
集成测试 每阶段结束后执行全链路集成测试(Postman/Newman或Go tests with -tags=integration)
代码规范 严格执行 go fmt、go vet、golangci-lint(配置revive规则集)
每日站会 9:30准时开始,每人1分钟:昨天完成 + 今天计划 + 阻塞点

二、第0阶段:基础环境准备(第1~2周,共10个工作日)

目标:所有基础设施就绪,CI/CD跑通,本地一键启动开发环境。

第1周(Day 1 ~ Day 5)

工作日 开发任务(Go程序员视角) 产出物 验收标准
Day 1 ① 编写Dockerfile(基于golang:1.22-alpine,多阶段构建)
② 编写docker-compose.dev.yaml(包含:MySQL 8.0、Redis 7.0、Kafka(KRaft)、ETCD、MinIO、ClickHouse)
③ 编写Makefile(make up / make down / make logs)
Dockerfile,docker-compose.dev.yaml,Makefile 执行make up后,6个容器全部healthy;make down完全清理
Day 2 ① 初始化go.mod(module hwsms)
② 创建标准项目骨架:cmd/、internal/、pkg/、api/、configs/、scripts/、deployments/
③ 编写configs/config.dev.yaml(数据库、Redis、Kafka等DSN占位)
④ 实现internal/config/loader.go(Viper加载YAML + 环境变量覆盖)
项目完整骨架,go.mod/go.sum,config.dev.yaml go mod tidy无报错;go build ./...编译通过
Day 3 ① 对接运维,获取K8s Namespace(hwsms-dev/hwsms-prod)
② 编写deployments/base/deployment.yaml(通用模板)
③ 编写deployments/base/service.yaml(ClusterIP + NodePort)
④ 编写deployments/base/configmap.yaml(环境变量注入)
K8s资源YAML文件 在Dev环境执行kubectl apply -f deployments/base/,Pod能Running(哪怕业务未完成,基础镜像起得来)
Day 4 ① 编写.gitlab-ci.yml(Stage:test → build → deploy-dev)
② 在cmd/server/main.go中写入健康检查/health端点(Gin框架最小实现)
③ 实现internal/middleware/health.go(返回{"status":"ok"})
CI/CD流水线配置,健康检查路由 Push代码触发CI,test阶段运行go test ./...通过,build阶段生成镜像,deploy-dev成功更新Pod;访问/health返回200
Day 5 ① 实现internal/pkg/logger/logger.go(基于zap + lumberjack,JSON格式)
② 实现internal/middleware/logger.go(Gin请求日志,记录trace_id、latency、status)
③ 集成go.uber.org/zap,并写入/var/log/hwsms/app.log
日志组件 发起测试请求,控制台和文件均输出结构化JSON日志;包含trace_id字段

第2周(Day 6 ~ Day 10)

工作日 开发任务(Go程序员视角) 产出物 验收标准
Day 6 ① 实现internal/pkg/redis/client.go(go-redis/v9,支持Cluster模式)
② 实现internal/pkg/redis/lock.go(分布式锁,Lua脚本 + 自动续期watchdog)
③ 编写单元测试redis_test.go(使用miniredis模拟)
Redis客户端封装、分布式锁 单元测试通过;在开发环境执行set/get和Lock/Unlock成功
Day 7 ① 实现internal/pkg/queue/producer.go(Sarama异步生产者,重试+死信)
② 实现internal/pkg/queue/consumer.go(消费者组,手动提交offset)
③ 定义Topic常量:TopicSubmit、TopicReport、TopicUp、TopicStats
Kafka封装 生产者发送消息成功;消费者接收并打印消息;无ErrOutOfBrokers
Day 8 ① 实现internal/util/snowflake.go(基于sony/sonyflake或自研,WorkerID从ETCD获取)
② 实现internal/util/validator.go(手机号、模板变量、内容长度校验)
③ 实现internal/util/crypto.go(AES-GCM加密/解密,用于API密钥)
工具函数库 go test -cover ./internal/util/... 覆盖率≥ 90%;Snowflake并发测试无ID冲突
Day 9 ① 实现internal/middleware/ratelimit.go(基于Redis + 令牌桶的分布式限流)
② 实现internal/middleware/auth.go(JWT解析 + Casbin权限校验接口预留)
③ 实现internal/middleware/tracer.go(OpenTelemetry + Jaeger上报)
全套Gin中间件 限流中间件在触发阈值时返回429;Auth中间件对无效Token返回401;Jaeger UI能查看到Trace
Day 10 ① 阶段0全链路回归:重启全部容器,执行go test -tags=integration ./test/e2e/...
② 完善README.md(含环境变量清单、本地启动步骤)
③ 编写scripts/init_mysql.sql(基础库表暂空,仅创建database)
④ 阶段0验收评审
阶段0交付物清单 所有A-0.x验收项全部通过;阻塞条件无遗留

⚠️ 阻塞规则:若Day 10 E2E测试失败,全体暂停,优先排查基础设施连接问题,直至通过方可进入第1阶段。


三、第1阶段:核心数据模型与公共组件(第3~4周,共10个工作日)

第3周(Day 11 ~ Day 15)

工作日 开发任务(Go程序员视角) 产出物 验收标准
Day 11 ① 编写完整scripts/init_schema.sql(36张表DDL,含索引、外键约束)
② 生成GORM Entity:internal/model/entity/account.go、channel.go、route_rule.go、message.go等
③ 实现基础DAO接口:Create、Update、GetByID、List、Delete(软删除)
SQL脚本,Entity代码,BaseDAO 在测试库执行SQL无语法错误;AutoMigrate能生成表结构
Day 12 ① 实现internal/config/etcd_watcher.go(监听/config/hwsms/*,变更触发Viper热更新)
② 实现internal/app/app.go(启动器:加载配置→连接DB/Redis/Kafka→注册路由→启动HTTP Server)
③ 优雅停机实现(http.Server.Shutdown + 清理Kafka producer)
配置热更新、应用启动器 修改ETCD配置,10s内应用日志输出"config reloaded";kill -SIGTERM后等待现有请求完成再退出
Day 13 ① 实现internal/pkg/metrics/prometheus.go(注册Counter、Gauge、HistogramVec)
② 实现internal/middleware/metrics.go(请求数、耗时、错误率埋点)
③ 暴露/metrics端点
监控指标 访问/metrics,能看到http_requests_total、http_request_duration_seconds等指标
Day 14 ① 编写数据库迁移工具:cmd/migrate/main.go(基于gormigrate,初始版本v0)
② 实现internal/repository/mysql/mysql.go(连接池配置:MaxOpenConns=100,MaxIdleConns=20)
③ 实现internal/repository/clickhouse/clickhouse.go(批量插入接口)
迁移工具、存储层初始化 执行go run cmd/migrate/main.go up,表结构版本号写入schema_migrations表
Day 15 ① 完善错误码定义:internal/pkg/errors/codes.go(映射UT:xxxx所有错误码及中英文描述)
② 实现统一响应封装:internal/pkg/response/response.go(Success、Error、Page)
③ 实现全局Recovery中间件(捕获panic,返回500,记录堆栈)
错误码、响应封装 调用response.Error(c, codes.Blacklist),返回JSON{"code":"UT:0006","msg":"黑名单"}

第4周(Day 16 ~ Day 20)

工作日 开发任务(Go程序员视角) 产出物 验收标准
Day 16 ① 编写internal/pkg/queue/consumer_group.go(优雅消费循环,支持暂停/恢复)
② 实现死信队列处理(消费失败3次后写入*-dlq topic)
③ 编写internal/pkg/cache/multi_level.go(本地缓存freecache + Redis,优先本地)
高级队列、多级缓存 消费失败消息进入死信;缓存Get优先命中本地,Miss时查Redis
Day 17 ① 实现JWT生成/解析:internal/pkg/jwt/jwt.go(含account_id、roles、permissions claims)
② 实现Casbin适配器:internal/pkg/casbin/enforcer.go(策略存储在MySQL)
③ 编写scripts/init_rbac.sql(基础角色:admin/客户运维/客服/集团)
JWT、RBAC引擎 生成Token可正确解析;Casbin能校验account_id是否拥有resource:action
Day 18 ① 为所有公共组件编写go doc注释
② 编写internal/pkg/README.md(各组件使用示例)
③ 重构internal/util,拆分出phone.go、content.go、template.go
文档、代码优化 golangci-lint run ./... 0 warning;go doc能显示完整注释
Day 19 ① 集成测试:编写test/integration/base_test.go(启动testcontainer模拟MySQL/Redis/Kafka)
② 验证配置加载→DB连接→缓存读写→消息生产消费全链路
集成测试框架 go test -tags=integration ./test/integration/... -count=1 全部PASS
Day 20 ① 阶段1代码评审(全员CR)
② 修复Review问题,更新CHANGELOG.md
③ 阶段1验收会议
阶段1交付物 A-1.1 ~ A-1.15 全部通过;单元覆盖率≥80%;阻塞条件无遗留

四、第2阶段:账号与权限体系(第5~6周,共10个工作日)

工作日 开发任务(Go程序员视角) 产出物 验收标准(启动前确保阶段1完成)
Day 21 ① 实现internal/service/account/service.go:CreateAccount(支持protocol、business位掩码)
② 实现internal/api/http/v1/account.go:POST /api/v1/accounts
③ 编写Account DAO扩展(根据协议/业务动态字段)
账号创建接口 调用API创建HTTP/CMPP账号,数据库记录正确,密码自动bcrypt加密
Day 22 ① 实现账号查询/列表(支持按username、protocol、status过滤)
② 实现账号更新(PUT /api/v1/accounts/{id})
③ 实现账号状态切换(启用/禁用)
④ 实现账号删除逻辑(检查last_send_time,沉默或>60天可删)
账号CRUD全量 禁用后Token失效;删除有发送记录账号返回业务错误;列表接口分页正常
Day 23 ① 实现IP白名单绑定与校验(存储为JSON数组)
② 实现账号审核模式配置(audit_mode字段)
③ 实现多业务开通开关(business字段按位操作)
账号配置扩展 IP校验中间件生效;开启/关闭业务线,对应功能权限即时变更
Day 24 ① 实现登录接口:POST /api/v1/auth/login(返回JWT)
② 实现登出接口(JWT加入Redis黑名单,TTL=剩余有效期)
③ 实现刷新Token接口
认证模块 正确密码返回Token;错误密码5次锁定15分钟;登出后Token立即失效
Day 25 ① 实现Casbin策略同步(账号创建/角色变更时自动写入casbin_rule表)
② 实现权限中间件internal/middleware/permission.go(从Token获取Roles,调用enforcer.Enforce)
③ 实现二级权限标记(recharge、proxy_send、export等)
权限引擎集成 普通账号访问/api/v1/accounts/export返回403;admin可正常导出
Day 26 ① 实现充值接口:POST /api/v1/accounts/{id}/recharge(记录充值日志,需二级权限校验)
② 实现批量充值(CSV导入)
③ 实现余额查询接口
充值模块 充值后balance_transactions表生成记录,余额正确累加;无权限用户充值被拦截
Day 27 ① 实现余额预警后台定时任务(cron每分钟扫描,低于阈值触发微信/短信)
② 实现预警配置接口(阈值/通知方式/接收人)
③ 集成企微/钉钉webhook推送
预警模块 将账号余额调至阈值以下,1分钟内收到webhook告警消息
Day 28 ① 实现账号上级切换(parent_id更新,需级联更新下级路径)
② 实现账号标星(is_starred)
③ 实现服务团队绑定(service_team)
④ 实现实名认证信息存储与审核状态流转
辅助功能 切换上级后,权限继承正确;标星账号列表置顶;实名审核通过后账户状态变更
Day 29 ① 实现审计日志拦截器(记录所有敏感操作:登录/充值/删除/导出)
② 实现审计日志查询接口(按账号/IP/时间范围)
③ 编写test/unit/account_test.go(覆盖所有业务逻辑)
审计、单元测试 敏感操作均在audit_logs表有记录;go test -cover ./internal/service/account/... ≥ 85%
Day 30 ① 阶段2验收:Postman集合全量回归
② 前端联调(如已准备)
③ 修复Bug,更新OpenAPI文档(api/openapi.yaml)
阶段2交付 A-2.1 ~ A-2.13全部通过;无阻塞项;接口文档与实现一致

五、第3阶段:通道管理与路由引擎(第7~8周,共10个工作日)

工作日 开发任务(Go程序员视角) 产出物 验收标准
Day 31 ① 设计CMPP协议包结构:internal/protocol/cmpp/header.go、body.go
② 实现CMPP连接建立(TCP Dial + Login请求)
③ 实现心跳处理(ActiveTest/ActiveTestResp)
CMPP基础协议 可连接模拟器(如cmpp-sim),Login返回status=0
Day 32 ① 实现CMPP Submit(短消息提交)及Submit_Resp处理
② 实现CMPP Deliver(回执/上行)接收解析
③ 实现CMPP连接池:internal/protocol/cmpp/pool.go(含心跳协程)
CMPP完整协议 发送消息能收到Submit_Resp;模拟通道返回Deliver,解析正确
Day 33 ① 实现HTTP通道适配器:internal/protocol/http/adapter.go(调用上游API,支持GET/POST,可配置鉴权方式)
② 实现SGIP协议基础(Submit/Report)
HTTP/SGIP适配 配置HTTP通道,成功调用上游发送接口并解析返回值;SGIP连接正常
Day 34 ① 实现SMPP协议:internal/protocol/smpp/(Bind_Transceiver/Submit_SM/Deliver_SM/EnquireLink)
② 实现SMPP连接池及流量控制(Window Size)
SMPP协议 连接SMPP模拟器,提交消息成功,收到Deliver_SM
Day 35 ① 实现通道CRUD API:internal/service/channel/service.go
② 实现通道测试工具(发送单条测试短信验证通道连通性)
③ 实现通道拦截配置(night_limit、day_limit、forbidden_regions)
通道管理 通道配置保存成功;测试工具发送通道返回正确MsgID;日限生效,超出返回-3错误
Day 36 ① 实现通道组(Channel Group)实体及API
② 实现权重路由算法(加权轮询)
③ 实现优先通道匹配(关键字/省份/运营商)
④ 实现默认兜底通道
路由基础组件 通道组内权重7:3分发,发送100条偏差<5%;关键字匹配准确命中指定通道
Day 37 ① 实现四步路由引擎Chain:internal/router/engine.go
② Step1过滤(频次/黑关键字/签名/地区/运营商)
③ Step2优先通道
④ Step3权重分发
⑤ Step4兜底
路由引擎 全链路路由选择能在10ms内完成;所有过滤条件命中对应错误码
Day 38 ① 实现导流策略(按账号维度/内容维度配置)
② 实现通道价格时间线API(price_timelines表 CRUD)
③ 实现通道估算余额计算器(定时任务,2小时刷新)
价格与导流 导流策略生效,特定账号走指定通道;价格时间线按当前时间返回正确单价
Day 39 ① 实现通道告警规则配置及检测协程
② 实现通道通讯实时监控WebSocket推送(2秒刷新)
③ 实现通道日志记录(连接/断开/发送/回执)
监控告警 手动断开通道,30s内触发告警并推送;WebSocket推送正常,页面2秒更新
Day 40 ① 编写路由引擎单元测试(覆盖所有分支)
② 压力测试(模拟1000条/秒路由决策)
③ 阶段3验收
阶段3交付 路由引擎P99延迟<10ms;所有A-3.x通过;阻塞条件无

六、第4阶段:消息发送主链路(第9~10周,共10个工作日)

工作日 开发任务(Go程序员视角) 产出物 验收标准
Day 41 ① 定义Submit DTO:internal/model/dto/submit.go
② 实现internal/service/send/validator.go(长度/模板变量/签名校验)
③ 实现模板CRUD及变量占位符解析({%var%})
发送模型、模板引擎 模板匹配准确率100%;变量替换内容正确;超长内容自动拆分
Day 42 ① 实现拦截器接口:internal/service/send/interceptor.go
② 实现黑名单三级检测(本地Redis Set + API调用 + 第三方通道)
③ 实现频次拦截(滑动窗口,支持自然日/24h)
④ 实现签名/退订/地区拦截
拦截器链 黑名单手机号返回UT:0006;频次超限返回UT:0016;地区屏蔽返回UT:0009
Day 43 ① 实现审核服务:internal/service/audit/service.go
② 实现免审/手动/自动三种策略
③ 实现审核任务入队及48小时超时扫描器
审核工作流 免审直接通过;手动审进入pending;48h后自动设为失败并回退余额
Day 44 ① 实现群发逻辑:单批次生成N条Message记录,共享batch_id
② 实现个性短信:每条独立内容,批量入库
③ 实现文件解析器(TXT/CSV/Excel),上传MinIO后异步解析
群发/个性/文件 群发10000条,批次记录完整;个性短信逐条内容不同;文件解析进度可查
Day 45 ① 实现定时短信:internal/service/send/timer.go(基于Redis ZSet存储定时任务)
② 实现定时扫描器(每5秒扫描一次到期任务)
③ 实现批量重置定时时间
定时发送 设置定时2小时后发送,任务准确触发;批量重置成功取消原定时
Day 46 ① 实现HTTP API提交接口:POST /api/v1/sms/send(含签名校验api_sign)
② 支持callback_url(回执绑定)和up_url(上行绑定)
③ 实现随机/固定扩展码分配
④ 入口双桶限流:全局令牌桶(5000/s)+账号桶(account.speed_limit),Redis Lua 原子(技术方案10.4.3)
⑤ 同步链路禁令:入口只做鉴权/校验/预扣/写Kafka,严禁MySQL直写(5000 TPS单条INSERT会打爆InnoDB)
HTTP API 接口鉴权通过;回执和上行地址存储正确;扩展码分配正确;5000 TPS下P99<50ms;超限返回429
Day 47 ① 实现CMPP客户接入:验证企业代码+通道号前缀(UT:0012)
② 实现CMPP合包聚合器(每5秒或1000条聚合提交,降低HTTP通道压力)
③ 实现SMPP客户接入
④ per-channel下发调度器:令牌桶=channel.speed(默认3000)+在途窗口256(16连接×16,Day39实测背书见技术方案10.4.1);p50>50ms持续30s自动降速10%
⑤ 群发匀速投放器:按下游预算逐秒投放(每秒min(剩余,Σ通道speed−在途余量)),防瞬时打满队列
CMPP/SMPP接入 CMPP提交通道号不匹配返回错误;合包后HTTP调用次数减少80%以上;3000 TPS峰值零超速零失败
Day 48 ① 实现发送全流程串联(API → 预扣费 → 审核 → 拦截 → 路由 → Kafka入队)
② 实现Kafka生产者写入submit Topic
③ 实现cmd/worker/submit_consumer.go(消费submit,执行实际通道下发)
④ 批量落库writer:明细攒批500条/批×10并发writer(扛5000 TPS INSERT,技术方案10.4.3);Kafka key=channel_id(submit)/detail_id(report)保证通道顺序与回执配对
⑤ 背压三级水位:lag>10万告警/>100万入口限流收紧至Σ(通道speed)/>500万暂停低优先级任务(技术方案10.4.4)
完整提交链路 提交接口返回batch_id和msg_ids;消费者取出消息后调用通道Adapter下发成功;MySQL批量写入不阻塞消费(lag不因落库增长)
Day 49 ① 实现上行码号分配算法(精确匹配 > 前缀匹配,归属账号)
② 实现上行Kafka生产者及消费者
③ 实现视频短信发送(复用短信流程,内容含视频URL合帧)
上行处理、视频发送 回复码号精确匹配归属正确账号;视频短信提交成功,通道收到合帧内容
Day 50 ① 全链路压测:入口5000 TPS持续5min(JMeter/Gatling 100并发×N轮)+ 下发满载复验(cmppbench 256窗口,对照Day39基线)
② 背压联动演练:5000入/3000出打5min,验证lag收敛、L1~L3水位动作、限流429正确
③ 监控发送延迟(入口/下发分层统计)和成功率
④ 阶段4验收
阶段4交付 入口P99<50ms@5000TPS;下发均值≥2200/峰值≥3000 TPS零超速;背压三级水位联动正确;成功率>99.9%;所有A-4.x通过

七、第5阶段:回执/上行与记录查询(第11~12周,共10个工作日)

工作日 开发任务(Go程序员视角) 产出物 验收标准
Day 51 ① 实现回执消费者:cmd/worker/report_consumer.go(消费report Topic)
② 实现状态归一化映射(运营商不同状态码 → 内部SUCCESS/FAILURE/UNKNOWN)
③ 实现错误码表维护接口
回执消费基础 收到DELIVRD映射为SUCCESS;EXPIRED映射为FAILURE;未知映射UNKNOWN
Day 52 ① 实现计费确认服务:internal/service/balance/confirm.go
② SUCCESS → 预扣转实扣(插入实扣流水)
③ FAILURE/UNKNOWN → 退还预扣金额
④ 实现幂等控制(基于msg_id防重)
实扣/退款 回执处理后余额变化正确;重复回执不重复扣费;流水表记录完整
Day 53 ① 实现回执重推服务(支持按account_id + time_range筛选,30天内)
② 实现手动配对状态(上传状态文件/直接指定状态/提取通道日志匹配)
③ 实现配对任务异步处理
回执重推、配对 重推后客户收到补发回执;配对上传文件后3h外无状态短信状态更新
Day 54 ① 实现上行消费者:cmd/worker/up_consumer.go
② 实现上行匹配逻辑(15天内发送数据匹配,失败归admin)
③ 实现上行自动拉黑规则(回复"拒收R" → 加入黑名单,页面隐藏)
上行处理 上行回复匹配成功归属账号;回复拒收后手机号进入黑名单,但上行记录仍推送
Day 55 ① 实现HTTP回调推送引擎(带重试队列,指数退避)
② 实现CMPP Deliver推送(通过客户绑定连接)
③ 实现推送失败重试及日志
回调推送 客户回调地址收到标准JSON回执;CMPP客户收到Deliver包;推送失败进入重试队列
Day 56 ① 实现下行批次记录API(5天热数据,Redis缓存)
② 实现下行明细API(号码级,5天热数据)
③ 实现批次状态统计聚合(成功/失败/未知/发送中)
记录查询 查询今日批次返回完整统计;明细列表支持按状态/手机号过滤
Day 57 ① 实现历史记录查询(ClickHouse,全量)
② 实现历史明细查询(支持大时间范围)
③ 实现路由层根据时间自动切换数据源(热数据查MySQL,历史查ClickHouse)
历史数据 查询90天前数据,响应时间<1s(ClickHouse);5天内数据走MySQL
Day 58 ① 实现明细异步下载(提交下载任务→写入MinIO→生成下载链接)
② 实现下载权限控制(非admin需开启export二级权限)
③ 实现定时记录管理(取消/重置时间)
下载中心、定时管理 下载任务异步生成,文件内容与查询结果一致;取消定时任务后不再触发
Day 59 ① 实现视频记录体系(复用短信Record Service,仅biz_type区分)
② 统一记录查询路由(根据biz_type路由至不同表或同一表分区)
③ 编写记录查询单元测试
视频记录 视频短信记录独立查询正常,不影响短信记录
Day 60 ① 阶段5集成测试:模拟全流程(提交→回执→计费→查询→重推)
② 验证数据最终一致性(MySQL事务 + ClickHouse最终一致)
③ 阶段5验收
阶段5交付 所有A-5.x通过;数据一致性校验(抽样比对)无误;阻塞条件无

八、第6阶段:统计与计费结算(第13~14周,共10个工作日)

工作日 开发任务(Go程序员视角) 产出物 验收标准
Day 61 ① 实现统计事件消费者:cmd/worker/stats_consumer.go
② 定义统计事件Schema(包含:account_id, channel_id, phone, province, operator, status, fee, report_time等)
③ 批量写入ClickHouse统计表(stats_minute预聚合)
统计消费者 发送消息后,ClickHouse stats_minute表在5秒内出现聚合数据
Day 62 ① 实现多维统计查询API(7维度:时间/用户/地区/运营商/签名/状态码/回执速率)
② 实现统计缓存(Redis,Key包含查询条件Hash,TTL=1小时)
③ 实现统计补算定时器(偶数整点刷新;昨日7/13/17补算)
统计查询 按日/月查询统计,数据准确;缓存命中后响应<20ms;补算后数据修正
Day 63 ① 实现用户统计看板接口(今日/昨日/近7天对比)
② 实现通道统计看板接口(成功率、耗时、量级)
③ 前端ECharts数据适配
用户/通道统计 看板数据与原始明细核对一致;通道成功率趋势图正确
Day 64 ① 实现下家结算模型:internal/service/settlement/client_settlement.go
② 生成月度账单(聚合成功条数 × 用户单价)
③ 实现账单明细导出(XLS)
④ 实现账单确认/付款状态管理
下家结算 客户月度账单金额=SUM(success)*price;导出XLS格式正确打开
Day 65 ① 实现上家结算模型:internal/service/settlement/channel_settlement.go
② 生成上家对账单(成功条数 × 通道成本单价)
③ 实现单价追加(历史账单锁定,新增单价不影响已结算账单)
④ 实现上家切换(旧通道关停,数据归档)
上家结算 通道对账单金额正确;切换上家后新发送走新通道,旧记录仍可查
Day 66 ① 实现利润分析引擎(下家总收入 - 上家总成本 - 运营成本)
② 实现用户级利润(含下级代理返点)
③ 实现通道级利润分析
④ 实现利润趋势图
利润分析 某时间段利润与手动核算一致;下级代理利润分成正确
Day 67 ① 实现消耗日志定时汇总(每天凌晨2点汇总前一天按账号/业务的消耗)
② 实现充值日志查询(关联付款审核确认状态)
③ 实现充值审核流程(提交→审核→到账)
日志查询 消耗日志表按日生成,与实时余额变动匹配;充值审核通过后余额实时增加
Day 68 ① 实现主页工作台聚合接口(今日发送量/成功量/余额/待审核数)
② 实现发送类型占比(群发/个性/定时/文件)
③ 实现消息量趋势图(近7日)
工作台 主页数据5秒内加载完成;待审核数与审核表一致;趋势图数据与统计表一致
Day 69 ① 结算模块单元测试(覆盖阶梯价格、退款冲正场景)
② 执行结算数据对账(业务表 ↔ 统计表 ↔ 结算表)
③ 编写结算操作手册
测试、文档 对账差异率=0;单元测试覆盖率≥80%
Day 70 ① 阶段6集成验收
② 执行全量回归测试(第0~6阶段所有核心流程)
③ 阶段6验收会议
阶段6交付 A-6.1 ~ A-6.12全部通过;全量回归无异常;阻塞条件无

九、第7阶段:生产上线与全网切换(第15~16周,共10个工作日)

目标:预发布环境验证 → 灰度发布 → 全量割接,保障平滑上线。

工作日 开发任务(Go程序员视角) 产出物 验收标准
Day 71 ① 搭建预发布(Staging)环境,配置与生产1:1(规格减半)
② 执行数据库迁移(migrate up至最新版本)
③ 导入脱敏测试数据(模拟10万账号、50通道)
Staging环境 所有Pod启动成功;Staging数据库连接正常;/health返回200
Day 72 ① 执行全量冒烟测试(所有P0/P1接口 Postman Collection)
② 执行压力测试(200 QPS持续30分钟,观察资源水位)
③ 记录性能基线(P99延迟、CPU/Memory、GC耗时)
性能测试报告 P99 < 50ms;CPU < 70%;无OOM;GC暂停 < 10ms
Day 73 ① 准备生产环境数据库(初始Schema + 基础配置数据)
② 配置生产Kafka Topic(分区数=节点数×3)
③ 配置生产Redis Cluster(maxmemory-policy allkeys-lru)
生产环境就绪 生产数据库show tables返回36张表;Kafka producer/consumer连通性测试通过
Day 74 ① 实现灰度发布策略(K8s Ingress按Header(version: canary)分流5%流量)
② 部署灰度版本(v1.0.0-canary)
③ 监控灰度版本日志和错误率
灰度环境 携带version: canary Header的请求进入灰度Pod;错误率与基线无显著差异(<1%)
Day 75 ① 扩大灰度比例至20%,持续观察2小时
② 验收灰度数据(数据库写入正确,无脏数据)
③ 若异常则立即回滚(kubectl rollout undo)
灰度验证 20%流量下业务指标正常;无数据一致性问题;回滚演练成功
Day 76 ① 灰度比例扩大至50%,观察4小时
② 监控上游通道状态,确认路由正确
③ 监控结算统计准确性(与预发布环境比对)
中流量验证 50%流量下发送成功率>99%;结算统计无误差
Day 77 ① 全量切换(100%流量指向新系统)
② 旧系统(汇网V6)配置为只读模式
③ 双写验证(新系统写入后对比旧系统查询结果)
全量切换 全量流量下系统稳定运行2小时;新旧系统数据完全一致
Day 78 ① 旧系统下线(关闭接入层)
② 迁移历史数据至ClickHouse(全量)
③ 开启生产环境所有定时任务(补算/预警/清理)
旧系统下线 旧系统无流量进入;历史数据迁移完成;定时任务执行正常
Day 79 ① 执行混沌工程测试(随机Kill Pod/网络延迟注入)
② 验证自动恢复能力(预期RTO<30s)
③ 编写上线总结报告(含性能对比、问题清单)
混沌测试 K8s自动重启Pod;Redis哨兵切换无感知;Kafka重平衡无数据丢失
Day 80 ① 生产验收评审
② 项目交付文档归档(架构文档/API文档/运维手册/操作手册)
③ 团队内部知识转移(KT)会议
最终交付 所有验收项全部通过;交付物完整;团队完成技能交接

十、各阶段“承上启下”检查清单(阻塞门禁)

在进入下一阶段之前,必须完成上一阶段的所有检查项,否则下一阶段不得开工。

阶段 入口门禁(必须满足) 出口门禁(必须交付)
阶段1启动 阶段0 A-0.x 全部通过,CI/CD能部署main分支 公共组件库单元覆盖率≥80%,数据库迁移工具可用
阶段2启动 阶段1 A-1.x 全部通过,ETCD配置热加载验证通过 账号CRUD+JWT+RBAC完整可用,审计日志有记录
阶段3启动 阶段2 A-2.x 全部通过,权限模型已验证 CMPP/HTTP/SMPP通道可接入,路由引擎单元测试通过
阶段4启动 阶段3 A-3.x 全部通过,通道测试工具成功发送测试短信 群发/个性/定时/文件四种发送方式均可提交,Kafka入队成功
阶段5启动 阶段4 A-4.x 全部通过,Kafka submit Topic有消费 回执消费并正确计费,上行匹配归属性准确,历史查询<1s
阶段6启动 阶段5 A-5.x 全部通过,计费确认/退款无差额 统计报表与业务明细一致,结算账单无误差,主页工作台可用
阶段7启动 阶段6 A-6.x 全部通过,全量回归测试PASS 预发布环境性能测试达标,灰度切换成功,生产割接完成

十一、开发资源分配建议(10人团队)

角色 人数 负责阶段 关键职责
后端TL(架构师) 1 全阶段 技术方案决策、代码Review把关、阻塞问题攻坚、阶段验收主持
高级Go工程师A 1 阶段3/4/5 协议栈(CMPP/SMPP)、路由引擎、通道池、回执消费
高级Go工程师B 1 阶段1/2/6 公共组件、账号权限、统计结算、工作台
中级Go工程师C 1 阶段2/4 账号CRUD、发送API、审核工作流、模板管理
中级Go工程师D 1 阶段3/5 通道管理、记录查询、上行处理、重推配对
中级Go工程师E 1 阶段4/6 定时任务、文件处理、下载中心、消费者编写
初级Go工程师F 1 阶段0/1 协助环境搭建、编写单元测试、编写文档、Docker/K8s资源配置
前端工程师 2 阶段2~6 管理后台页面开发(与后端接口联调)
测试工程师 1 全阶段 编写集成测试用例、执行全量回归、性能压测、验收协助

最终交付承诺:严格按照本计划执行,每阶段结束时均产出可部署、可演示的增量版本,80个工作日后具备完整生产上线能力。每日站会同步进度,每周五进行阶段里程碑Review,确保环环相扣、零偏差。