35 KiB
35 KiB
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,确保环环相扣、零偏差。