72 KiB
go-Sms 全栈协同开发日历(第 1~80 工作日)
【文档状态】🔒 POC 进度事实源·已定稿(Day 71 止,2026-09-29) 逐日任务/验收/commit 证据链=重建「为什么这么做」知识库;Day 72-80 各行为未执行死计划,作重建排期原始参考,不作承诺。
文档定位:本日历由《memory-bank/docs/Go-sms-开发计划.md》(后端,Day 1-80)与《memory-bank/docs/Go-sms-前端开发计划.md》(前端,FE D1-40)合并而成,是全栈双轨并行的统一进度事实来源——包含每工作日任务、验收标准、验收日期、完成状态与更新明细(提交号)。 原两份计划保留为详细任务拆解参考;本日历按周对齐双轨,每周五行,后端/前端并排。 编制:2026-09-04 · 依据两份计划 + git 提交历史 + docs/phase1-review.md + CHANGELOG.md
图例
| 标记 | 含义 |
|---|---|
| ✅ | 已完成且已合入 develop(或已在验收分支通过验收)——验收标准 100% 逐条通过 |
| 🔶 | 已完成、已推送,等待合并(联调窗口统一合并) |
| 🔄 | 进行中 |
| ⬜ | 未开始 |
| 🚧 | 阶段验收门禁(承上启下检查点) |
| ❌ | 验收未通过(阻塞中)——下一任务冻结,修复复验通过后回填 ✅ |
验收日期规则:已完成项取实际提交/合并时间(git 历史);未完成项以工作日序号排期,自然日历日期待定(执行节奏以阶段门禁为准,不锁死日历日)。
零例外进度门禁协议(2026-09-04 增补 · 执行宪法)
总纲:任何任务(后端 Day N / 前端 D N)验收标准未 100% 通过,下一个任务不得开工。 本节优先级高于一切排期——排期可以顺延,质量门禁不可豁免;日历中每个任务都必须先定义「产出物 + 验收标准」,再动手开发。
1. 三层门禁模型
| 层级 | 粒度 | 通过判据(全部满足才 ✅) | 未过后果 |
|---|---|---|---|
| L1 每日门禁 | 单个任务(后端 Day N / 前端 D N) | ①验收标准逐条通过 ②质量基线全绿 ③提交推送 ④CHANGELOG 增补 ⑤本日历状态列更新 | 标记 ❌;次日冻结新任务,修复最高优先级;修复后完整复验,通过才解锁下一任务 |
| L2 阶段门禁 | 阶段(后端 8 个 / 前端 7 个) | 阶段内所有任务 ✅(无 ❌/⬜ 遗留)+ A-x.x 验收单全过 + 联调项通过 | 下一阶段所有任务不得开工;进入修复循环,顺延排期 |
| L3 双轨门禁 | 前后端联调项(🚧 联调日) | 前端页面切真实 API 与后端行为一致(替换 Mock);ISC 码/分页/权限三态对齐 | 前端该页保持 🔶* 标注,联调窗口补验;不阻塞后端推进(Mock 策略保障前端不被后端卡死) |
1.5 日闭环拉齐与人工验收(v2 增补 2026-09-10,Day 41 起生效)
阶段 4 起联调从「阶段末集中」改为「每日垂直切片」:后端 Day N 完成 → 当日前端拉齐 → 人工逐项验收,当日问题当日发现。v1 五件套对历史任务(Day 1-40)仍有效。
- 节奏:后端 Day N 交付(L1 五件套)→ 当日前端拉齐(对应 D N 页面切真实 API + lint/typecheck/build 三件套)→ AI 产出人工验收单(
docs/acceptance/dayNN.md,依_template.md,≤10 项 ≤20 分钟)→ 人工逐项走查 → 全过标✅A解锁 Day N+1;未过标❌严格冻结(沿用零例外总纲)。 - L1 判据增补第 ⑥ 项:人工验收单全过并归档
docs/acceptance/(Day 41 起生效)。 - 验收形态:页面日(D41-47)=真实浏览器操作走查;纯后端日(D48-50)=日志/数据/压测报告走查,不硬造页面操作。
- 兜底规则:后端 API 当日未就绪 → 前端按 openapi 契约 Mock 出页 🔶* 标注,次日首件事补联调;等待人工走查期间 AI 只做不依赖验收结论的工作(次日契约/DTO 草案),不空转。
- 状态标记:
✅=自动化+L1 过(v1 口径);✅A=人工验收单全过归档(阶段 4 起每任务必须达到);❌=冻结中;⏳W=自动化+验收单 #1~#10 过但前端人工走查(用户本人)未签(v3 起过渡态,走查过即转 ✅A)。 - 协议 v3(2026-09-11 增补,Day 43 起生效):所有任务的 D N 前端页面,必须由用户本人在浏览器逐项操作走查(验收单「二·五」节,AI 不得以 vitest/e2e mock 测试替代);W 节未签名不得标 ✅A、不得解锁 Day N+1。纯后端日不硬造页面操作(沿用 v2 口径)。
- 周表载体:第 9/10 周起,周表「验收日期 / 更新明细」列即人工验收记录(✅A/❌ + 验收人),验收单原文归档
docs/acceptance/。 - 协议 v4(2026-09-12 增补,Day 48 收官起生效)——分支治理与文档单一事实源:
- 三活分支模型:仓库仅保留
main(已验收归档线:代码+验收单+日历)/develop(集成线)/feature/*(当前任务段唯一活跃分支);其余分支(阶段遗留 feature/release 旧支)在并入 develop 后当周删除(本地+远程),僵尸分支(已合未删)清零。 - feature 生命周期 ≤ 一个任务段:Day N 人工验收 ✅A 当日即合并 develop 并删除 feature 分支;不允许 feature 分支跨任务段长期存活(消除日历/验收单多分支分叉窗口——2026-09-12 前 feature/phase4-send 曾领先 develop 21 提交,根治此况)。
- main 同步节奏:每 Day ✅A 收官或每阶段门禁通过后,develop → main
--no-ff合并推送;docs/acceptance/、开发日历、CHANGELOG 以 main 为权威查找源(索引见 docs/acceptance/README.md)。 - 文档不产生分叉窗口:验收单/日历/CHANGELOG 的当日更新随当日任务提交进 feature→当日合 develop;严禁在 main 上直接修改文档绕过 develop。
- 三活分支模型:仓库仅保留
2. 每日验收 DoD(完成定义五件套,缺一即 ❌)
后端任务(每个 Day N 收工前自查):
| # | 项 | 判据 |
|---|---|---|
| 1 | 代码 | 实现完整 + go doc 注释;go build ./... 0 错误 |
| 2 | 测试 | go test ./...(-race 阶段回归)全绿;新增逻辑覆盖率 ≥80%(核心服务);集成测试(若有)通过 |
| 3 | 规范 | golangci-lint run ./... 0 issue |
| 4 | 提交 | 推送 feature 分支;提交信息含验收结论(场景×结果) |
| 5 | 文档 | CHANGELOG 增补当日条目;本日历状态列改 ✅ 并填提交号 |
前端任务(每个 D N 收工前自查):
| # | 项 | 判据 |
|---|---|---|
| 1 | 代码 | 页面/组件实现;对接统一响应 {code,msg,data} 与 ISC 码(401→登录/403→提示/500→人工核查) |
| 2 | 测试 | pnpm test(Vitest)全绿;新增页面附对应用例 |
| 3 | 规范 | pnpm lint 0 error 0 warning;pnpm build 通过 |
| 4 | 提交 | 推送 feature/fe-* 分支;提交信息含自测报告 |
| 5 | 文档 | CHANGELOG 增补;本日历状态列改 ✅ |
3. 「100% 通过」判定与例外处理
- 逐条对照:验收标准每条都要有证据(命令输出/响应体/截图/测试名),一条不满足即整任务 ❌,不存在"基本完成"。
- 修复优先:❌ 任务次日为最高优先级;修复后完整复验全部标准(不是只测改动点),通过才回填 ✅ 并解锁后续任务。
- 升级机制:同一任务连续 2 天 ❌ → 上报 TL 评审,可裁剪范围(须同步修订验收标准并留痕,不得降低已通过项的标准)。
- 环境阻塞:第三方/运维类阻塞登记到「横切事项」,可并行开发下一任务中不受阻的部分,但受阻任务本身不得标 ✅。
- 双轨串行:后端 Day N 未 ✅ 不得开 Day N+1;前端 D N 未 ✅ 不得开 D N+1;前后端互不阻塞(L3 除外,联调项双端都未过则 FE 阶段验收 🔶* 顺延)。
双轨总览(截至 2026-09-13)
| 轨道 | 阶段 | 工作日窗口 | 状态 | 验收日期 | 更新明细 |
|---|---|---|---|---|---|
| 后端 | 阶段 0 环境与 CI | Day 1-10 | ✅ 完成(合入 develop 7b46b312) |
2026-09-03 | Day1-2 0e609c8b ~ Day10 eb56a32e 共 9 提交;A-0.x 全过 |
| 后端 | 阶段 1 数据模型与组件 | Day 11-20 | ✅ 完成(合入 develop b75fbe26) |
2026-09-03 | Day11 12194c61 ~ Day19-20 de0eb314 共 9 提交;A-1.1~A-1.15 全过(docs/phase1-review.md) |
| 后端 | 阶段 2 账号与权限 | Day 21-30 | ✅ 完成(验收全过,合入 develop) | 2026-09-04 | Day21 6748d20d … Day29 deb75560 · Day30 e35ec818;A-2.1~13 全过(docs/phase2-review.md) |
| 后端 | 阶段 3 通道与路由 | Day 31-40 | ✅ 10/10 天(Day 40 收官)+7 增补日;A-3.x 全过(A-3.10/11 计费侧注记顺延阶段 4),验收单 docs/phase3-review.md | 实际 2026-09-10 | Day37 路由 Step1 085a3474 · Day38 导流+分时价 b101c9cf · Day39 CMPP 中文/UDH/回执闭环 8c65225f+根因两层修复 d1f64275/c0ab7d57(真网 DELIVRD 双闭环) · Day39.5 压测工具+10 万条基线 a95b7ff8 · Day39.6 5000/3000 性能规划 44225a51 · Day31 追加×5(真网联调 8479d985/Web real×3/链路单测 e8b33240) · Day40 收官 4ca16173(告警/WS 监控/channel_log v7/断线重连演练/1000QPS 压测 p99 中位 7.9~8.8ms) |
| 后端 | 阶段 4 消息发送 | Day 41-50 | ✅ 完成(Day41-50 逐日 ✅A 收官,合入 develop 9a42a437;A-4.20 满载性能欠账转 Day51-55 专项——Day51 R3 已 ✅A) |
2026-09-12 | Day41 ~ Day50 b0f28521;Day47/48 031fa3f8;Day49 8e50baf9;详见 day41~50 验收单 |
| 后端 | 阶段 5 回执与记录 | Day 51-64(Day51-54 R1~R3 性能债专项+Day55 复测;验收 Day64,Day50 压测后排期变更) | 🔄 | 2026-09-15 | Day51-58 逐日 ✅A;Day59/60 计划任务(回调推送引擎/record API+FE-4 联调)未执行;Day61-65 连续 5 日生产救火(CMPP Deliver 下发/密码与连接可配/拦截终态回执/SubmitFast 异步化/明细查询超时/消费并发 worker 池,各 ✅A 补账提交);A-5.x 验收未关门,待阶段 5 收尾批次(2026-09-15 复盘裁决) |
| 后端 | 阶段 6 统计结算 | Day 65-74(随阶段 5 顺延 +4 日) | ⬜ | — | — |
| 后端 | 阶段 7 上线切换 | Day 75-84(80 日框架 +4 日,灰度段缓冲吸收/阶段 6 验收复盘) | ⬜ | — | — |
| 前端 | FE-0 工程与骨架 | D1-5 | ✅ 完成(合入 develop 36701945) |
2026-09-03 | 26ba2895 + 修复 d63a6eb8/8e56b960/b38a637c |
| 前端 | FE-1 账号与权限 | D6-10 | ✅ 完成(随 FE-0 合并) | 2026-09-03 | 11a30594(6 页,22/22 测试) |
| 前端 | FE-2 通道与路由 | D11-16 | ✅ 完成(验收通过,已合并 develop 5a91cb86) |
2026-09-04 | 6fb12ece + D11 验收 49b18383 + D12-D16 验收 5ad64a12;31/31 测试;D13 V2.0 六折叠面板迭代 b35087da(fe-tailwind) |
| 前端 | FE-3 发送与审核 | D17-23 | ✅ 完成(D17-23 逐日验收,随阶段 4 波次合入 develop;发送四方式/审核中心/结果反馈/聚合页) | 2026-09-12 | 详见 CHANGELOG Day44~47(D22/D23 双 ✅A 走查三轮闭环) |
| 前端 | FE-4 记录与回执 | D24-29 | 🔄 进行中(D24 ✅A 2026-09-13/D26 ✅A 09-13/D27 ✅A 09-14/D28 ✅A 09-14;方案 A 逐日顺延:Day57=D28…Day58=D29 页面收官,Day60 接 record API 联调=FE-4 验收 A-5.x) | — | 策略拍板 2026-09-13(用户裁决):按原计划逐日完成 D24-29,FE-4 全部完成后再单独立项规划重构;开发期不做中途重构;排期落位方案 A 2026-09-13(用户裁决,日历第 11/12 周 FE 列重排) |
| 前端 | FE-5 统计结算运营 | D30-36 | ⬜ | — | — |
| 前端 | FE-6 联调加固上线 | D37-40 | ⬜ | — | — |
累计进度(2026-09-15 复盘更新):后端名义 65/80 天(实际推进=Day1-58 计划内+Day61-65 生产救火 5 日,Day59/60 计划任务未执行)· 前端 29/40 天(D24-28 ✅A,D29+record API 联调未收官)· 阶段门禁 4/7(阶段 0-4 ✅;阶段 5 🔄 待 A-5.x 关门;阶段 6/7 ⬜ 且顺延预算已透支,重排待裁决)· 页面 27+/50
门禁合规:截至 2026-09-13 无 ❌ 遗留;每个已完成任务均满足 L1 五件套(证据见各周明细与 CHANGELOG)。
门禁合规(2026-09-15 复盘注记):Day59-65 连续 7 个工作日未提交未归档(L1 五件套③④⑤破窗,81 文件);当日已完成补账分批提交 develop+补录 day61/65 验收单+本日历状态回填。教训固化:救火日同样执行五件套,报障不得豁免提交纪律(破窗 1 天未纠即惯性延续)。
横切债务:①FE typecheck ②openapi 字典 codegen ③/channels/upstreams API ④fe-tailwind 分支 四项已全部清零(2026-09-10 Day41 开工首动作;详见 CHANGELOG Day 41)。新挂账:TestSGIP_Client -count=3 偶发 bind 超时(Day42 已修:Timeout 2s→5s);现存偶发:TestClient_LoginOK 全量并发偶发超时(Day51 单跑 3 次过,环境性,观察中)。
阶段门禁(承上启下检查清单)
| 门禁 | 入口条件(必须满足) | 出口交付(必须完成) | 状态 |
|---|---|---|---|
| 🚧 阶段 1 启动 | 阶段 0 A-0.x 全过;CI/CD 能部署 main | 公共组件单测覆盖 ≥80%;迁移工具可用 | ✅ 2026-09-03 |
| 🚧 阶段 2 启动 | 阶段 1 A-1.x 全过;ETCD 热加载验证通过 | 账号 CRUD+JWT+RBAC 完整;审计日志有记录 | ✅ 2026-09-03 |
| 🚧 阶段 3 启动 | 阶段 2 A-2.x 全过;权限模型已验证 | CMPP/HTTP/SMPP 通道可接入;路由引擎单测通过 | ✅ 2026-09-04(A-2.1~13 全过,docs/phase2-review.md) |
| 🚧 阶段 4 启动 | 阶段 3 A-3.x 全过;通道测试工具发测试短信成功 | 四种发送方式可提交;Kafka 入队成功 | ✅ 2026-09-10(A-3.1~14 全过,docs/phase3-review.md;A-3.10/11 计费侧注记顺延——扣费链路阶段 4 上线后回补) |
| 🚧 阶段 5 启动 | 阶段 4 A-4.x 全过;submit Topic 有消费 | 回执正确计费;上行归属准确;历史查询 <1s | ⬜(Day51 起实质启动:性能债专项 R3 ✅/R2·R1·复测 Day52-55;A-4.20 补账后转正) |
| 🚧 阶段 6 启动 | 阶段 5 A-5.x 全过;计费/退款无差额 | 报表与明细一致;账单无误差;工作台可用 | ⬜ |
| 🚧 阶段 7 启动 | 阶段 6 A-6.x 全过;全量回归 PASS | 预发性能达标;灰度成功;生产割接完成 | ⬜ |
第 1 周(Day 1-5 · 前端未启动)
| 工作日 | 后端任务 | 产出物 | 验收标准(100% 逐条过) | 状态 | 验收日期 / 更新明细 |
|---|---|---|---|---|---|
| Day 1-2 | Dockerfile 多阶段构建;docker-compose 六中间件;Makefile;go.mod 骨架;config loader(Viper+env) | Dockerfile · docker-compose.dev.yaml · Makefile · go.mod/go.sum · configs/*.yaml · internal/config/loader.go | make up 六容器全 healthy;make down 清理干净;go build ./... 通过 | ✅ | 2026-09-02 · 0e609c8b |
| Day 3 | K8s 清单(deployment/service/configmap)+ kind Dev 集群 | deployments/base/*.yaml · kind 配置 | kubectl apply 后 Pod Running | ✅ | 2026-09-02 · a7c3c583 |
| Day 4 | .gitlab-ci.yml(test→build→deploy-dev);/health 端点 | .gitlab-ci.yml · health 路由与中间件 | Push 触发 CI 全绿;/health 返回 200 | ✅ | 2026-09-03 · 1349eea6 |
| Day 5 | zap+lumberjack 结构化日志;请求日志中间件(trace_id) | internal/pkg/logger · middleware/logger.go(双端 JSON,含 trace_id/latency/status) | 测试请求双端输出结构化 JSON 且含 trace_id | ✅ | 2026-09-03 · e50423a7 |
第 2 周(Day 6-10 · 🚧 阶段 0 验收)
| 工作日 | 后端任务 | 产出物 | 验收标准(100% 逐条过) | 状态 | 验收日期 / 更新明细 |
|---|---|---|---|---|---|
| Day 6 | Redis 客户端(single/cluster/sentinel)+ 分布式锁(Lua+续期) | internal/pkg/redis(client/lock)+ miniredis 单测 | miniredis 单测通过;Lock/Unlock/续期正常 | ✅ | 2026-09-03 · 036381fd |
| Day 7 | Kafka 生产者(重试+死信)/消费者组(手动 offset);Topic 常量 | internal/pkg/queue(producer/consumer)+ Topic 常量 | 收发正常;无 ErrOutOfBrokers | ✅ | 2026-09-03 · 0f9f6a59 |
| Day 8 | 雪花 ID / 校验器(手机号/模板变量/长度)/ AES-GCM | internal/util(snowflake/validator/crypto) | util 覆盖率 ≥90%;并发无 ID 冲突 | ✅ | 2026-09-03 · 9ecd19af |
| Day 9 | 分布式限流(Redis 令牌桶)/ JWT 中间件 / OTLP 追踪 | middleware(ratelimit/auth/tracer) | 超阈值 429;无效 Token 401;Jaeger 见 Trace | ✅ | 2026-09-03 · ce975ded |
| Day 10 | 🚧 阶段 0 全链路回归 + README + 验收评审 | README · scripts/init_mysql.sql · 阶段 0 交付清单 | A-0.x 全过;阻塞条件无遗留 | ✅ | 2026-09-03 · eb56a32e,合入 develop 7b46b312 |
第 3 周(Day 11-15 · 前端未启动)
| 工作日 | 后端任务 | 产出物 | 验收标准(100% 逐条过) | 状态 | 验收日期 / 更新明细 |
|---|---|---|---|---|---|
| Day 11 | 36 表 DDL + GORM Entity + 泛型 BaseDAO(软删) | model/entity/*.go · repository/basedao.go | AutoMigrate 生成表结构;软删/恢复可用 | ✅ | 2026-09-03 · 12194c61 |
| Day 12 | ETCD 热更新 watcher + app 启动器 + 优雅停机 | internal/app · internal/config/watcher | 10s 内 config reloaded;SIGTERM 排空退出 | ✅ | 2026-09-03 · 63110ea4 |
| Day 13 | Prometheus 指标中心 + HTTP 埋点 + /metrics | internal/pkg/metrics + 埋点中间件 | 指标族可见;P99 分桶对齐 | ✅ | 2026-09-03 · beddd612 |
| Day 14 | gormigrate 迁移工具(up/down/version/status)+ ClickHouse 批插 | internal/pkg/migrate · pkg/clickhouse | 版本写入 schema_migrations;CH 批插核对一致 | ✅ | 2026-09-03 · 75878f21 |
| Day 15 | ISC 错误码体系 + 统一响应 + 全局 Recovery | pkg/errors(权威 48 码表)+ response + recovery | response.Error 输出 {code,msg};panic → 500 | ✅ | 2026-09-03 · a4d700b1 → 三位化 67b60b85 → 权威码表 426c7c22(48 码) |
第 4 周(Day 16-20 · 🚧 阶段 1 验收)
| 工作日 | 后端任务 | 产出物 | 验收标准(100% 逐条过) | 状态 | 验收日期 / 更新明细 |
|---|---|---|---|---|---|
| Day 16 | ConsumerGroup(暂停/恢复/死信)+ 多级缓存(freecache+Redis) | internal/pkg/queue 扩展 · internal/pkg/cache(L1/L2) | 失败入死信;Get 优先本地命中 | ✅ | 2026-09-03 · 8fc3e24c |
| Day 17 | JWT 包(claims)+ Casbin(MySQL 持久化)+ init_rbac | pkg/jwt · internal/pkg/casbin · scripts/init_rbac | Token 可解析;Enforce 判定正确 | ✅ | 2026-09-03 · aa7bd527 |
| Day 18 | go doc 全量注释 + pkg/README + util 拆分 + lint 清零 | 全包注释 · pkg/README.md | golangci-lint 0 warning | ✅ | 2026-09-03 · b09b031e |
| Day 19 | 集成测试(testcontainers:MySQL/Redis/Kafka 全链路) | test/integration(*_test.go,-tags=integration) | -tags=integration 全 PASS | ✅ | 2026-09-03 · de0eb314 |
| Day 20 | 🚧 阶段 1 代码评审 + 验收会议 | docs/phase1-review.md(A-1.1~15 证据映射) | A-1.1~A-1.15 全过;覆盖率 ≥80% | ✅ | 2026-09-03 · de0eb314,合入 develop b75fbe26 |
第 5 周(Day 21-25 ↔ FE D1-5 · FE-0)
双轨表列:任务 · 产出物 → 验收标准(须 100% 逐条通过才可标 ✅)
| # | 后端任务 · 产出物 | 后端验收标准(100% 过) | 状态 | 前端任务 · 产出物 | 前端验收标准(100% 过) | 状态 | 验收日期 / 更新明细 |
|---|---|---|---|---|---|---|---|
| 1 | Day21 开户接口:业务位掩码+bcrypt+事务(账号+配置行+授信流水) ▸ api/v1/account.go · service/account · entity/account |
开户三表同事务落库;密码 bcrypt(cost≥10);业务位掩码还原正确;重复用户名返业务码 | ✅ | D1 Vite+Vue3+TS 脚手架/ESLint/目录规范/.env ▸ web/ 工程骨架+README |
pnpm dev 一键起;pnpm lint 0/0 | ✅ | 后端 09-03 6748d20d · 前端 09-03 26ba2895 |
| 2 | Day22 账号 CRUD 全量+禁用即 Token 失效 ▸ api/v1/account.go · service/service.go |
过滤分页/详情/启停/删除守卫正确;禁用账号存量 Token 立即 401 | ✅ | D2 Axios 封装+msw Mock ▸ utils/request.ts · api/types.ts · mocks/ |
Mock 登录返 ISC:000;401 拦截跳登录(单测) | ✅ | 后端 09-03 29416feb · 前端 09-03 26ba2895 |
| 3 | Day23 IP 白名单(JSON/CIDR)+审核模式(0/1/2)+业务开关 ▸ service/config_service.go |
白名单命中/未命中三态正确;审核模式切换生效;开关硬删防唯一冲突 | ✅ | D3 主布局(18 模块导航/顶栏/面包屑/多标签)+主题 ▸ layouts/ · styles/ |
导航与需求模块地图一致;刷新不丢标签 | ✅ | 后端 09-04 73e112da · 前端 09-03 26ba2895 |
| 4 | Day24 认证:登录 5 次锁 15 分/登出黑名单/刷新轮换 ▸ service/auth/* · pkg/jwt(Sign 加 jti) |
正确密码返 Token;错 5 次锁 15 分;登出即失效;刷新轮换不互伤 | ✅ | D4 登录页+Pinia+路由守卫 ▸ views/login · stores/user · router/guard |
登录→工作台→登出闭环(Mock);未登录重定向 /login | ✅ | 后端 09-04 b645ce6f · 前端 09-03 26ba2895 |
| 5 | Day25 Casbin 策略同步+权限中间件+二级权限 ▸ middleware/permission.go · casbin 扩展 · /accounts/export |
customer 导出 403 ISC:403;admin 200 CSV;授予 export 即时放行/撤销收回;改角重绑 | ✅ | D5 动态路由+v-permission+错误页 ▸ directive/permission · views/error |
admin/customer 两角色实测隐藏无权菜单与按钮 | ✅ | 后端 09-04 8a0322ed · 前端 09-03 26ba2895;FE-0 合并 develop 36701945 |
第 6 周(Day 26-30 ↔ FE D6-10 · FE-1,🚧 阶段 2 验收)
| # | 后端任务 · 产出物 | 后端验收标准(100% 过) | 状态 | 前端任务 · 产出物 | 前端验收标准(100% 过) | 状态 | 验收日期 / 更新明细 |
|---|---|---|---|---|---|---|---|
| 1 | Day26 充值接口:单笔/CSV 批量/余额查询 ▸ api/v1/account.go · service/recharge.go · balance_log |
充值即余额+流水一致(事务);批量 CSV 行级报错定位;无 recharge 二级权限 403 | ✅ | D6 账号列表(搜索/分页 12+ 列/批量启停标星/导出) ▸ views/account/list |
与 /api/v1/accounts 分页排序一致;空态/加载态完整 | ✅ | 后端 09-04 899d5c6a · 前端 09-03 11a30594 |
| 2 | Day27 余额预警定时任务(cron+企微/钉钉 webhook) ▸ pkg/cronx · pkg/notify · service/warning.go |
余额低于阈值触发通知;同账号冷却期内不重复;定时器可停启 | ✅ | D7 开户表单(多业务线/四协议/单价时间线/授信/IP/审核模式) ▸ views/account/create |
分步校验与后端 util 同规则;提交后列表可见 | ✅ | 后端 09-04 66b1fbbe · 前端 09-03 11a30594 |
| 3 | Day28 上级切换(级联路径)/标星/服务团队/实名审核流转 ▸ service/hierarchy.go · service/profile.go |
切换上级后级联路径正确(无环);审核流转状态机合法 | ✅ | D8 账号详情+配置(业务矩阵/签名限制/推送地址/切换上级) ▸ views/account/detail |
只读/编辑分区清晰;保存后二次进入回显正确 | ✅ | 后端 09-04 1507d20e · 前端 09-03 11a30594 |
| 4 | Day29 审计日志拦截器+查询接口+account 单测 ≥85% ▸ middleware/audit.go · service/audit · api/audit_handler.go |
写操作 100% 留痕(who/what/when);按账号/IP/时间检索;覆盖率达标 | ✅ | D9 充值与余额(单笔/批量/流水/预警) ▸ views/account/recharge |
流水与 balance_log 一致;无权限按钮隐藏(v-permission) | ✅ | 后端 09-04 deb75560 · 前端 09-03 11a30594 |
| 5 | Day30 🚧 阶段 2 验收:Postman 全量回归+联调+openapi.yaml ▸ api/openapi.yaml · 阶段 2 验收单 |
A-2.x 全过;前端 FE-1 切真实 API 联调一致;openapi.yaml 与实现零偏差 | ✅ | D10 角色权限(权限树/Casbin)+登录审计;🚧 FE-1 验收=A-2.x 联调 ▸ views/account/roles · views/audit/login |
权限树勾选→菜单/按钮实时生效;审计可按账号/IP/日期检索 | ✅* | 后端 09-04 e35ec818(A-2 全过;联调契约已备,FE 切换待联调窗口) · 前端 09-03 11a30594(*Mock 联调) |
第 7 周(Day 31-35 ↔ FE D11-15 · FE-2)
| # | 后端任务 · 产出物 | 后端验收标准(100% 过) | 状态 | 前端任务 · 产出物 | 前端验收标准(100% 过) | 状态 | 验收日期 / 更新明细 |
|---|---|---|---|---|---|---|---|
| 1 | Day31 CMPP 协议:连接/Login/心跳 ▸ internal/protocol/cmpp(header/body/client) |
与模拟网关握手成功;心跳超时断连重试 | ✅ | D11 上家管理(CRUD/分类/联系人) ▸ views/channel/provider |
CRUD 联调一致;表单校验完整 | ✅* | 后端 09-04 ec1e75e0 · 前端 09-04 49b18383(D11 验收:Mock 契约+编辑/校验补齐;lint 0/0+27/27+build;真实 API 待后端 /channels/upstreams) |
| 2 | Day32 CMPP Submit/Deliver 解析/连接池 ▸ protocol/cmpp(submit.go · readLoop · pool.go) |
Submit 返 msg_id;Deliver 解析回执/上行;池化复用无泄漏 | ✅ | D12 通道列表(协议/状态筛选/启停/连接测试/20+ 字段) ▸ views/channel/list |
筛选/启停/连接测试(Mock)可用;列 20+ | ✅* | 后端 09-04 e3191241 · 前端 09-04 5ad64a12(列 9→21;Mock 通道 7 端点+测试) |
| 3 | Day33 HTTP 通道适配器+SGIP 基础 ▸ protocol/httpadapter · protocol/sgip |
可配置鉴权(appkey/签名)命中;SGIP bind/submit 打通模拟端 | ✅ | D13 通道新建/编辑(四协议分区/拦截配置/模板 ID 模式) ▸ views/channel/form |
四协议动态表单;保存回显正确 | ✅* | 后端 09-04 dec172fb · 前端 09-04 5ad64a12(回显改单查 get;协议类型修复) · 09-05 V2.0 迭代:后端实体 16 字段+测试工具 sp_id 映射 728d4298;前端六折叠面板/模板预填/sp_id≤6B 校验/新字段回显(Mock 契约 8 新用例,39/39) fe-tailwind |
| 4 | Day34 SMPP 协议(Bind/Submit/Deliver/EnquireLink)+连接池流控 ▸ protocol/smpp(pdu/bind/client) |
Bind 成功;流控窗口限速生效;链路探测保活 | ✅ | D14 通道组+四步路由配置器(拖拽排序/权重可视化) ▸ views/channel/group |
拖拽排序持久化;权重和=100% 校验 | ✅* | 后端 09-04 41362c07 · 前端 09-04 5ad64a12(权重和实时显示+超 100 拒;优先级上下移排序持久化——拖拽以移位降级,已留痕) |
| 5 | Day35 通道 CRUD+测试工具+拦截配置(夜发/日限/屏蔽地区) ▸ service/channel · api/channel_handler.go |
CRUD 全量;测试工具发测试短信成功;拦截三配置生效 | ✅ | D15 策略中心 5 页(黑白名单/关键字/频次/白名单/码号) ▸ views/policy/* |
5 页 CRUD+批量导入可用;列表筛选正确 | ✅* | 后端 09-04 bce59e3f · 前端 09-04 5ad64a12(五 Tab+批量导入+频次/码号 CRUD;策略 Mock 全套) |
第 8 周(Day 36-40 ↔ FE D16 · FE-2 收尾,🚧 阶段 3 验收)
| # | 后端任务 · 产出物 | 后端验收标准(100% 过) | 状态 | 前端任务 · 产出物 | 前端验收标准(100% 过) | 状态 | 验收日期 / 更新明细 |
|---|---|---|---|---|---|---|---|
| 1 | Day36 通道组+权重路由(7:3 偏差 <5%)+优先匹配+默认兜底 ▸ service/router(SWRR) · service/channel/group.go |
1000 条分配偏差 <5%;无匹配走兜底通道 | ✅ | D16 导流策略+签名/码号报备;🚧 FE-2 验收=A-3.x 联调 ▸ views/policy/traffic · views/policy/report |
报备流转状态正确;FE-2 六页联调(阶段 3 窗口) | ✅* | 后端 09-04 7c65bd94 · 前端 09-04 5ad64a12(Report.vue 新建:提报→审核→驳回重提状态机+路由注册) |
| 2 | Day37 四步路由引擎(过滤→优先→权重→兜底) ▸ service/router/engine.go |
全分支单测覆盖;全链路 <10ms | ✅ | —(FE-3 未启动) | — | ⬜ | 后端 09-10 085a3474(Step1 条件过滤:黑关键字/地区/运营商/频次/签名;engine 单测全分支;叠 Day36 SWRR+兜底构成四步全链) |
| 3 | Day38 导流策略+价格时间线 API+估算余额定时器(2h) ▸ service/policy · cron/estimate |
导流命中规则正确;时间线取价按生效区间;估算误差可接受 | ✅* | — | — | ⬜ | 后端 09-10 b101c9cf(Step0 steer:account/keyword 规则 CRUD+引擎消费+路由 REST;price_timelines 分时价 API;估算定时器;A-3.10/11 的计费侧验证顺延阶段 4——扣费链路未上线) |
| 4 | ▸ protocol/cmpp(split/EncodeContent) · 回执复核页 |
(原任务移入 Day 40 补位)GB 之外中文编码正确;长短信 UDH 分片可合并;回执复核 WEB 可查 | ✅ | — | — | ⬜ | 后端 09-10 8c65225f+根因两层修复 d1f64275/c0ab7d57(Msg_Length 4B→1B 纯 2.0;真网 3 条 DELIVRD 双闭环)+a95b7ff8 压测 10 万条零失败+44225a51 5000/3000 规划——Day 39 让位真网质量问题,更高优先级 |
| 5 | Day40 阶段 3 收官:补位 A-3.12 告警(notify webhook 复用)+A-3.13 WS 实时监控(2s)+A-3.14 通道日志(channel_log 建表) + A-3.5 真网断线重连演练 + 1000 条/秒路由压测 ▸ 阶段 3 验收单(docs/phase3-review.md) |
A-3.1~A-3.14 全过(A-3.10/11 计费侧注记顺延);1000 条/秒压测稳定;通道测试工具发测试短信成功;fe-tailwind 分支理顺合并 develop | ✅ | — | — | ⬜ | 后端 09-10 4ca16173:告警 link_down/fail_rate(cron 30s+断连事件即时,冷却去重)·WS 2s Hub(gorilla v1.5.3;静态段先于 :id 注册坑)+HTTP 快照·ChannelLog v7 真库迁移(连接逐条/提交回执 10s 窗口聚合)·A-3.5 可杀网关演练秒级重连留痕·压测 3 轮中位 p99 7.9~8.8ms<10ms 吞吐 1806/s·BootstrapLinks 装配补缺;验收单 phase3-review.md;26 包全绿 |
第 9 周(Day 41-45 ↔ FE D17-21 · FE-3)
📋 v2 人工验收:本表「验收日期 / 更新明细」列=人工验收记录(✅A/❌+验收人);每任务收官产出
docs/acceptance/dayNN.md,走查通过才解锁下一任务(协议 1.5 节)。
| # | 后端任务 · 产出物 | 后端验收标准(100% 过) | 状态 | 前端任务 · 产出物 | 前端验收标准(100% 过) | 状态 | 验收日期 / 更新明细 |
|---|---|---|---|---|---|---|---|
| 1 | Day41 Submit DTO+发送校验器+模板 CRUD+占位符解析 ▸ service/send(SubmitReq+Validate+Estimate) · service/template(CRUD/状态机/Render) · /templates+//send/estimate 另:开工三债清零(typecheck 9→0/openapi 字典 codegen 48 码/upstreams API) |
长度拆分与前端一致;变量/签名校验拒绝路径正确;模板状态机合法 | ✅A | D17 群发工作台(号码/TXT 导入预览前 50 行/本地+服务端双预估) ▸ views/sms/batch |
文件预览前 50 行;条数/拆分与后端 SmsLength 一致 | ✅A | 2026-09-10 ✅A 收官(验收单 #1~#10+R1~R3 全过);首走揭真缺陷 2:v8 迁移缺列(#6 模板 500)、#2/#3 计费口径未含签名→需求两变:①签名并入计费 ②去独立签名框(sign 可选,内容=签名+正文一体);FE 51 tests;commit 3ba34ee7→12fd5bbc |
| 2 | Day42 拦截器链:黑名单三级/频次滑动窗口/签名/退订/地区 ▸ service/interceptor/*(+SendBlockLog v9 落库+/send/precheck 真入口;另修 P1④⑤ flaky:SGIP 超时 5s/QPS 线 12.5ms 余量) |
五类拦截各有单测;命中顺序符合配置;拦截原因落库 | ✅A | D18 个性短信(变量表格)+拆分短信+模板联动 ▸ views/sms/personal |
变量校验({name} 规则);模板套用预览 | ✅A | 2026-09-10 ✅A 收官(验收单 #1~#10+R1~R3 全过;interceptor 13 测+API 集成 1 测;/policies 查明为 D15 纯 FE mock,造数走库直插;+ISC:036 codegen 49;FE 57 tests;29 包全绿 EXIT=0) |
| 3 | Day43 审核服务:免审/手动/自动+48h 超时扫描回退余额 ▸ service/audit |
三模式分流正确;超时自动回退余额且幂等 | ✅A | D19 定时发送(批量重置/可取消改期) ▸ views/sms/timer |
定时任务列表可取消/改期(联调) | ✅A | 2026-09-11 ✅A 收官(协议 v3 首单:#1~#10+R1~R3 过;一轮 W1/W4 ✅、W2/W3 ❌→修复循环方案 B:vite proxy 8081→8080+最小提交链 POST /send/submit 提前落地+batch 提交按钮,二轮 W2/W3/W5/W6 全 ✅ 签名;+submit_test 5 例;码表 51;FE 60 tests;29 包全绿 EXIT=0;Day44 范围调「文件入口+个性精检」) |
| 4 | Day44 群发(批次 batch_id)/个性短信/文件解析(TXT/CSV/Excel→MinIO) ▸ service/send/* · util/fileparse |
批次进度可查;个性变量一一对应;文件解析行数一致 | ✅A | D20 模板管理(报备/批量审核/状态流转) ▸ views/sms/template |
模板状态流转(待审/通过/拒绝)实时刷新 | ✅A | 2026-09-11 ✅A 收官(范围调「文件入口+个性精检」之文件入口:POST /files/numbers/import 三格式解析→归一去重→MinIO 落对象+PUT /templates/batch-review;+excelize/minio-go 依赖;pkg/storage+util/fileparse+fileimport 新模块;30 包 0 FAIL;D20 模板管理页+batch 导入升级,FE 67 tests;真环境三格式/批量审核/MinIO 对象全通;W1~W5 一轮+W6 二轮(修复:导入入口信息标签)走查全 ✅ 签名 Tory) |
| 5 | Day45 定时短信(Redis ZSet+5s 扫描)+批量重置 ▸ service/send/timer.go |
到点 5s 内发出;重置批量生效;重复扫描幂等 | ✅A | D21 审核中心(五类 Tab 聚合/批量通过拒绝/48h 标红) ▸ views/audit/center |
Tab 计数徽标;批量操作后列表与计数联动;超时样式区分 | ✅A | — |
第 10 周(Day 46-50 ↔ FE D22-23 · FE-3 收尾,🚧 阶段 4 验收)
📋 v2 人工验收:同第 9 周注记;Day 48-50 无新页面,验收形态=数据/日志/压测报告走查。
| # | 后端任务 · 产出物 | 后端验收标准(100% 过) | 状态 | 前端任务 · 产出物 | 前端验收标准(100% 过) | 状态 | 验收日期 / 更新明细 |
|---|---|---|---|---|---|---|---|
| 1 | Day46 HTTP API 提交接口(api_sign 签名)+callback/up 绑定+扩展码 ▸ service/openapi · /sms/api 协议域 |
api_sign 防重放/防篡改;错误签名 401;扩展码透传 | ✅A | D22 发送结果反馈(task_no/失败明细/ISC 中文表) ▸ views/sms/result |
提交返 task_no;ISC 码→中文映射与后端 48 码同步 | ✅A | 2026-09-11 · day46.md #1~#12+W1~W6 三轮走查闭环全 ✅(签名 Tory) |
| 2 | Day47 CMPP/SMPP 客户接入+合包聚合器(5s/1000 条) ▸ service/access + protocol server |
协议接入鉴权通过;聚合窗口触发正确 | ✅A | D23 短信聚合页+移动端走查;✅A FE-3 验收=A-4.x 联调 ▸ views/sms/home |
四种发送方式可提交;审核流可闭环;移动端走查表 | ✅A | 2026-09-11 · day47.md #1~#9 机器项全 ✅(CMPP/SMPP 真机冒烟+聚合单测 99.9% 削减+门禁全绿);W1~W5 用户走查一轮全过(「全部验收通过」)→ 双 ✅A 收官,解锁 Day48;调度器④⑤挪 Day48(用户裁决) |
| 3 | Day48 发送全流程串联(API→预扣→审核→拦截→路由→Kafka)+submit 消费者 ▸ service/send/pipeline · consumer/submit |
全流程状态机单测;Kafka 入队成功;失败各环节回退余额 | ✅A | — | — | ⬜ | 2026-09-11 · day48.md #1~#12 机器项全 ✅(状态机 7 例[预扣/拦截退费/全拦终态/拒绝退费/落库对冲/定时不投/个性同构]+消费者 6 例[认领幂等/域过滤/回滚/ReclaimScanner 修复审核通过即发]+调度④⑤ 6 例[令牌桶/窗口 256/p50 降速/PaceBudget]+背压+批量 writer 6 例;真机四链路:task33 成功路径[channel_log submit=1 合包+deliver=2 上游回执]/task32 频次拦截退费[余额扣3退3]/task35 审核拒绝退费[refund+1]/背压水位键 bp:level=0;附带修复:router 空组降级默认通道[原 404]+queue MaxRetry=0 死信 panic;cmd/consumer 新进程+Makefile run-consumer;openapi.emit 移除防双投;go 32 包 0 FAIL/vet 0,FE 79/79 无回归;冒烟数据已还原);用户走查确认 2026-09-12,✅A 闭环,解锁 Day49 |
| 4 | Day49 上行码号分配(精确>前缀)+上行 Kafka+视频短信 ▸ service/uplink |
上行按码号精确/前缀两级匹配;视频短信 biz_type 路由 | ✅A | — | — | ⬜ | — |
| 5 | Day50 🚧 阶段 4 验收:100 并发压测 ▸ 压测报告+阶段 4 验收单 |
P99 <50ms;成功率 >99.9%;A-4.x 全过 | ⬜ | — | — | ⬜ | — |
第 11 周(Day 51-55 ↔ FE D24-26 实做·方案 A 顺延 2 日 · FE-4)
| # | 后端任务 · 产出物 | 后端验收标准(100% 过) | 状态 | 前端任务 · 产出物 | 前端验收标准(100% 过) | 状态 | 验收日期 / 更新明细 |
|---|---|---|---|---|---|---|---|
| 1 | Day51 🚀R3 拦截器请求级缓存+批量 IN(Day50 性能债专项 1/4) ▸ interceptor/scope.go 请求级快照(策略/签名一次加载跨号复用+白名单/黑名单 IN 批查+Redis SMIsMember 批量) |
100 号 SQL 2 次而非 200(SQL 计数断言);批量 P50 915ms→<200ms | ✅A | D24 下行批次记录(筛选/进度占比/拦截号码下载)→未动,顺延 Day53(方案 A) ▸ views/record/down |
分页 100/页流畅;进度条与后端计数一致 | ⬜ | 2026-09-12 ✅A 收官(后端;scope_test 3 例:SQL 实测 3 vs 旧路径 400(Day50 口径×2 系漏计,旧路径实为每号 4 查)/语义回归零漂移/签名 1 次 vs 101 次;500TPS×2 轮 P50 211/190.8ms 达标<200ms,基线 915ms 降 79.1%,100% 成功,59000 明细全终态;坑:限流 env 全称 RATE_PER_SEC/孤儿压测进程→day51.md 三;FE D24 未动) |
| 2 | Day52 🚀R2 明细移 consumer 批量落库(专项 2/4;入口零明细写,回归方案 10.4.3 原文) ▸ send/submit 事务瘦身(仅落 task)+SubmitEvent 载明细(雪花 ID 入口预生成)+consumer 批量 INSERT 幂等 |
入口 P50<50ms;5min 压测明细数=任务计数(最终一致);回执配对零丢失;Σtask.fee_total=loadtest billed_total | ✅A(功能)/⚠️P50 | D25 下行明细(号码级/CMPP 钻入/ISC 筛选)→未动,顺延 Day54(方案 A) ▸ views/record/detail |
明细与批次钻取链路正确;ISC 码筛选联调 | ⬜ | 2026-09-13 ✅A 功能收官:入口零明细写+Details 随事件(雪花 ID 预生成/拦截终态行)+消费侧 500/批 OnConflict 幂等(先于 claim=回执配对键先于 submit 存在);投递语义反转——定时/全拦亦投(claim 三重域保证不误发);Kafka 故障降级同步落明细;真机三轮(1960/1260/350 号)明细数=任务计数全终态+三表对平(11480/5880/1610=billed);顺带修 4 存量缺陷:Dispatch 无 status 过滤(拦截号重复下发)/聚合器丢错误码/loadtest 字节索引(前置日「成功」实为 GBK 全灭假阴性——终态≠成功,验收必须核错误码)/空跑防御(ErrDetailsNotReady 回滚重扫,420 悬置实证收敛);首核项定论:submit 聚合量纲=合包后 CMPP 包数≠计费片数(4706 vs 11480,比值=合包率),负载核算以计费条数为准;⚠️P50 dev 未达标(724~2055ms,宿主盘 w_await 25ms/%util 47%+回执/channel_log 写风暴+fsync 串行;代码路径三重佐证无退化)→Day55 复测先核盘 IO 基线;午后:压测乱码根因=MsgFmtGBK 0x15 笔误(应 0x0F=15,Day39 引入)修复+上行 MO 按 Msg_Fmt 解码补齐+协议数值独立断言(上游日志 msgFmt=15/正常中文/msgLength=30 三重实证);→day52.md |
| 3 | Day53 🚀R1 资金一致性评审(预扣 Redis 化)+runbook P0 告警通道(顺延自 Day50 验收段) ▸ 评审纪要 · alertmanager+前端错误上报 |
过会三点:Redis/MySQL 双写窗口/AOF everysec 丢 1s 容忍/流水为唯一事实源余额可重算;告警通道通(R1 对账差额告警前置) | ✅A | D24 下行批次记录(方案 A 开工;Day60 record API 前契约先行 mock) ▸ views/record/down |
分页 100/页流畅;进度条与后端计数一致 | ✅A | 2026-09-13 双 ✅A 收官:①评审三点全过(docs/review/r1-balance.md:双写窗口=Redis 防超扣权威/MySQL 最终账务权威,偏小=少发不超扣;AOF everysec 丢 1s 容忍附三前置(生产 AOF/对账≤5min/flag 回退);流水为唯一事实源 balance(t)=Σamount 可重算+差额走 runbook §3 订正)+Day54 约束 8 条固化(Lua 原子/GOSMS_BALANCE_MODE flag/差额 gauge go_sms_balance_reconcile_diff/告警规则前置已挂/流水批写不丢/dev 开 AOF/Lua P99<5ms);②§6.2 Alertmanager 通道真机验通——compose 监控栈(prometheus 19090+alertmanager 19093)+规则三条(5xx 突增 P0/P99 P1/BalanceReconcileDiff P0 接入位;Kafka lag+通道速率指标未导出注记挂账 Day55/56)+AM webhook→gateway POST /alerts/sink(P0=Error/P1=Warn/resolved=Info 分级留痕;注入 P0/P1 各一条 firing→网关日志 alerts_sink_alert_received 2 条实证);③§6.4 前端错误上报——后端 POST /fe-errors(public 恒 200 尽力而为+截断+kind 归一)+v12_fe_error_log 迁移(顺带补齐 dev 库 v10/v11 欠账,v9→v12)+GET 排障端点;FE error-reporter(window error/unhandledrejection/VueHandler 三路+keepalive+60s 去重+防递归)+request.ts 拦截器 5xx/网络层上报带 X-Trace-Id;真机 curl→fe_error_log 落库;④D24 开工✅:api/record.ts 契约+fe4-handlers(种子 12 批次+拦截明细+五段聚合自证)+views/record/down(五段堆叠进度条/拦截 CSV 下载/分页 100)+记录中心路由分组;契约 7/7+guard 28 菜单;坑:jsdom XHR+blob 与 msw 不兼容(同 fe2 multipart 坑,fetch 直取);nohup 网关随会话被杀→setsid 保活;AM 注入须带未来 endsAt;→day53.md |
| 4 | Day54 🚀R1 预扣 Redis Lua+异步对账+故障回退(专项 4/4) ▸ send/refund.go Lua 化(balance:{account} check-and-decrement)+对账任务+feature flag |
50 并发×100 号零超扣零少扣(对账差额=0);Lua 路径 P99<5ms;kill Redis 回退 MySQL 原路径可用 | ✅A | D25 下行明细(号码级/CMPP 钻入/ISC 筛选;mock 先行) ▸ views/record/detail |
明细与批次钻取链路正确;ISC 码筛选联调 | ✅A | 2026-09-13 双 ✅A 收官;R1=balance 三件套(Store 接口/MySQLStore 平移+Fallback 业务错透传·基建错回退计数/RedisStore Lua check-and-decrement+key 缺失快照冷启+异步流水批写 4096/200/300ms 雪花预生成 OnConflict 幂等=无 DLQ 组件达 DLQ 语义/Reconciler FlushPending→Σ流水重算→diff gauge 覆写前采样→覆写 Redis→订正快照)+send 六处收口+gateway 装配(5m 对账/15s 热切/优雅排空)+config/metrics 四指标;8 约束逐条真机验证:50 并发零超扣零少扣/kill Redis 回退 3 发+fallback=3/5m 对账 diff=3→覆写+gauge 归零/AOF everysec 显式+重启余额保留实证/Lua P99=965µs(串行口径;8 并发 11837QPS;50 并发尾延迟=单线程排队数学必然注记)/流水幂等重投;FlushPending 竞态三轮修复终局=flusher 纯 tick+锁内循环排空(取出写入全程持锁,数学无窗口);种子语义:初始余额须带 recharge 流水(流水唯一事实源,否则对账「正确地」覆写);D25=record-progress.ts 拆分(修 mock 连带 axios/router 初始化致 vi.mock hoist 失效)+ISC 码字典联动+CMPP timeline 钻入;go 34 包(-race+count=3)+FE 93/93+tsc 零错;→day54.md |
| 5 | Day55 🚀性能债复测归档(上午:_bench 重建 tmpfs 正式场 5min,A-4.20 补账)+回执消费者+状态归一化起步(下午) ▸ docs/acceptance/day51-54.md · consumer/report |
批量 P50<30ms/受理 ≥4000TPS(单副本;5000 需按方案扩 2 |
✅A(吞吐+归档)/⚠️P50 | D26 历史记录(>5 天 ClickHouse <3s/异步导出;mock 先行) ▸ views/record/history |
查询 <3s;导出去下载中心 | ✅A | 2026-09-13 ✅A 收官:①tmpfs 正式场复刻(day50 备份+R1 生效模式)——受理 3960/4000TPS 满载 11880 请求 100% 成功零 429(对照 Day50 硬顶 1600=容量+150%),billed 595.92 万条均条 5.01 口径自证,R1 余额 Redis=MySQL 列=Σ流水三处一元 2038056(首轮 400 万 t≈204s 耗尽即正确拦截——压测余额预算=TPS×时长×均条×2);②⚠️P50 未达(满载 504/空载 91ms/百号)——非三债回归(空载证明 R1/R2/R3 全生效),第四瓶颈定位:批内逐号串行 3 次 Redis RT(频次 INCR×2+预扣 Lua)≈0.9ms/号+容量贴线排队→立项合批 Lua/并行分片(阶段 5 后性能批次),A-4.20=吞吐✅延迟❌双判定诚实归档 day51-54.md;③kafka_lag 挂账清偿:go_sms_kafka_lag{topic}+KafkaLagHigh P1(>10 万 for 2m)+gateway LagReader 15s 采样——新坑备案:sarama NextOffset 对 coordinator fetch 失败静默-1 与未起步组不可区分(压测期 gauge 冻结假值 20125,明细增速交叉证伪),根治 OffsetFetchRequest 直连挂账 Day56;④回执归一化起步:report/normalize.go 三态(SUCCESS/FAILURE/UNKNOWN 挂起=资损安全)表驱动 12 断言——Day56 地基;⑤坑:pkill -f 匹配 run_commands 自身命令行整链夭折→[b]in/xxx 正则规避;tmpfs 备份库流水(Σ=-1232)与快照(400 万)不自洽→启动对账轮「正确地」覆写 -1232→补 adjust 调差流水三平(runbook §3 姿势);FE D26 全套(契约/mock 状态机/页面/6 测)99/99+tsc 零错;→day55.md |
第 12 周(Day 56-60 ↔ FE D27-D29+Day60 联调收口 · FE-4 收尾;阶段 5 验收顺延 Day64 见第 13 周注记)
| # | 后端任务 · 产出物 | 后端验收标准(100% 过) | 状态 | 前端任务 · 产出物 | 前端验收标准(100% 过) | 状态 | 验收日期 / 更新明细 |
|---|---|---|---|---|---|---|---|
| 1 | Day56 回执消费者+状态归一化(SUCCESS/FAILURE/UNKNOWN)+错误码维护接口完成;并入回执持久化挂账(环形缓冲→channel_log)+长短信段级回执配对(1~9 片 UDH 每段独立 msg_id,按 detail 聚合段数判终态——09-13 小跑实证 detail 状态已闭环,但 channel_log 聚合量纲 450 vs 520 待核) ▸ consumer/report · 错误码表 API |
三态归一正确;错误码可维护(增改停用);重启后回执可查(持久化);长短信 9 片段回执聚合终态正确 | ✅ | D27 上行记录(码号/手机号查询/权限导出;15 天匹配后端 Day49 已交付) ▸ views/record/uplink |
15 天窗口提示;无权限导出按钮隐藏 | ✅ | 2026-09-14 ✅A 收官:①回执链路全程贯通——handleDeliver 状态报告 goroutine 派发 ReportSink→sms-report→-report 独立消费组(三态归一化+段级配对[v13 message_report_seg:msg_id+mobile 唯一,提交侧单发/合包「包×片」逐段登记]→按 detail 聚合判终态[任一 FAILURE→3/全 SUCCESS 到齐→2/其余挂起]+message_report 落库[uk_detail 冲突忽略]);②9 片段聚合 9 用例(8 片挂起→到齐成功/任一片失败整条失败/UNKNOWN 中间态/首到终态锁定[乱序异态不翻转]/无配对挂起不重试/合包多号独立置态);③错误码维护 /system/error-codes 增改停用(system:write,与归一化词表解耦);④回执持久化=receipts 改读 seg+uplink(重启后回执可查),内存环形降级;⑤lag 根治:OffsetFetchRequest V1 直连 coordinator(ErrAlreadyConnected 语义坑:client 连接池 broker 二次 Open 属正常,errors.Is 修正),真机 gauge 18569 正常;⑥端到端真机闭环:sarama 直投 sms-report→消费→detail 1→2+report 落库(冒烟数据已清);⑦合包失败回退只重发未确认号(修复 Day47 全量回退重复计费风险);FE D27 上行记录(15 天窗口提示/码号尾号匹配态筛选/uplink:export 权限导出)106/106+tsc 0;→day56.md |
| 2 | Day57 计费确认:预扣转实扣/失败退款/msg_id 幂等 ▸ consumer/billing(基于 Day54 R1 Redis 预扣新口径) |
预扣=实扣+退款(零差额);msg_id 重复回执幂等 | ✅A 09-14 | D28 回执重推工具+手动配对页(mock 先行) ▸ views/record/repush |
30 天窗口校验;任务提交反馈;配对结果回写列表 | ✅A 09-14 | — |
| 3 | Day58 回执重推(30 天窗)+手动配对(四方式)+异步任务 ▸ service/repush |
30 天窗口校验;四方式配对结果正确;任务状态可查 | ⬜ | D29 下载中心(任务/进度/下载)+定时记录管理;🚧 FE-4 页面开发收官 ▸ views/record/download |
异步任务状态轮询;记录四页+两工具可用 | ⬜ | — |
| 4 | Day59 回复"拒收"自动拉黑(上行消费者+15 天匹配 Day49 已交付仅剩拉黑)+回调推送引擎(指数退避重试)+CMPP Deliver 推送 ▸ consumer/uplink · service/callback |
拒收关键词命中即拉黑;推送失败退避重试;最终失败落死信可查 | ⬜ | FE-4 自查收口(契约用例补齐+MSW 回归;真实联调待 Day60 API) | 契约用例全绿 | ⬜ | — |
| 5 | Day60 下行批次/明细 API(5 天热数据 Redis 缓存)+状态聚合 ▸ api/v1/record.go · cache 层 |
热数据命中缓存;状态聚合计数准确 | ⬜ | 🚧 FE-4 联调+验收=A-5.x(D24-D26 mock 页面接真实 API:批次/明细/历史) | 记录四页+两工具联调可用 | ⬜ | — |
⚠️ Day50 排期变更(2026-09-12,压测后裁决):R1~R3 性能债专项占 Day51-54+Day55 上午(4.5 日,详见 Day50 验收单三),阶段 5 主线顺延——阶段 5 余量落位 Day61-64(Day61 历史查询 ClickHouse+冷热切换 / Day62 异步下载 MinIO+export 权限+定时管理 / Day63 视频记录体系 biz_type 路由+记录单测 / Day64 🚧 阶段 5 验收,验收标准同原 Day60 行:A-5.x 全过;回执计费零差额;上行归属准确;历史查询 <1s)。下方第 13 周起后端任务整体后移 4 日:本表 5 行实际落位 Day65-69(统计消费者 Day65/七维统计 Day66/看板接口 Day67/下家结算 Day68/上家结算 Day69);第 14 周→Day70-74(阶段 6 验收 Day74);第 15/16 周→Day75-84(80 日框架 +4 日,由阶段 7 灰度段缓冲压缩吸收,不可吸收则在阶段 6 验收时复盘)。**2026-09-15 复盘修正:Day65 被消费并发修复(生产救火)占用,阶段 6 本表 5 行再落位 Day66-70 起、第 14 周→Day71-75——+4 日弹性已透支 1 日,「不可吸收则复盘」条款触发,阶段 6/7 重排方案(压缩/延期/救火缓冲制度化三选一)待用户裁决,裁决前阶段 6 不开工。****2026-09-16 用户裁决:先做阶段 5 收尾(P0 流程止血→C1 回调推送引擎/C2 拉黑/C3 D28 回执重推+手动配对后端/C4 record API 联调+A-5.x 关门),阶段 6/7 重排待收尾实际耗时后再定。2026-09-24 进展:P0 止血+Day61-65 补账归档已毕(develop→main v4);C3 完成(Day66:四端点+终态链单一实现+实机验收 ✅A,含实机发现的 ctx 断开丢回写/逐条慢两 P1 修复,详见 day66.md)——阶段 6 起点再顺延,重排裁决时点=收尾 C1/C2/C4 毕。**FE 轨道(D30 起)不受后端顺延影响(msw mock 并行开发,联调窗口随后端 API 后移),故下方 FE↔后端周对齐自第 13 周起错位 4 日,表内 FE 列维持原节奏。
第 13 周(Day 61-65 ↔ FE D30-34 · FE-5)
| # | 后端任务 · 产出物 | 后端验收标准(100% 过) | 状态 | 前端任务 · 产出物 | 前端验收标准(100% 过) | 状态 | 验收日期 / 更新明细 |
|---|---|---|---|---|---|---|---|
| 1 | Day61 统计消费者(stats_minute 预聚合入 ClickHouse) ▸ consumer/stats |
预聚合值=明细手工汇总;乱序/重复消费幂等 | ⬜ | D30 图表基座(ECharts 封装/过滤栏/自适应) ▸ components/charts |
空/加载态统一;路由切换无内存泄漏 | ⬜ | — |
| 2 | Day62 七维统计查询+Redis 缓存(TTL 1h)+补算定时器 ▸ api/v1/stats.go · service/stats |
七维下钻数据正确;缓存命中;补算可指定日期 | ⬜ | D31 用户统计(趋势/七维下钻/XLS 导出) ▸ views/stats/user |
图表与明细抽 3 日核对一致;导出 XLS | ⬜ | — |
| 3 | Day63 用户/通道统计看板接口+ECharts 适配 ▸ api/v1/stats 扩展 |
与 stats_channel_daily 一致;估算余额计算正确 | ⬜ | D32 通道统计(成功率/耗时/估算余额/告警配置) ▸ views/stats/channel |
趋势与后端一致;告警阈值保存生效 | ⬜ | — |
| 4 | Day64 下家结算:月度账单(成功条数×单价)+XLS 导出+确认付款 ▸ service/settle/bill |
账单=成功条数×单价(抽样对账零差);确认付款状态流转 | ⬜ | D33 结算 4 页(下家账单/上家账单/结账/单价追加) ▸ views/settle/* |
账单金额与后端一致;状态流转清晰 | ⬜ | — |
| 5 | Day65 上家结算:对账单+单价追加锁定+上家切换归档 ▸ service/settle/provider |
单价追加后旧数据锁定;切换归档不可逆操作留痕 | ⬜ | D34 利润分析(双视角)+消耗/充值日志 ▸ views/settle/profit |
利润曲线与手工核算一致;日志可追溯操作人 | ⬜ | — |
第 14 周(Day 66-70 ↔ FE D35-36 · FE-5 收尾,🚧 阶段 6 验收)
| # | 后端任务 · 产出物 | 后端验收标准(100% 过) | 状态 | 前端任务 · 产出物 | 前端验收标准(100% 过) | 状态 | 验收日期 / 更新明细 |
|---|---|---|---|---|---|---|---|
| 1 | Day66 利润分析引擎(用户级含代理返点/通道级/趋势) ▸ service/settle/profit |
利润与手动核算一致;下级代理分成正确 | ⬜(阶段 6 未开工,2026-09-16 裁决收尾优先;Day66 实际=阶段5收尾 C3:D28 回执重推/手动配对后端 ✅A 09-24,见 day66.md;本行任务随阶段 6 重排落位) | D35 主页工作台+系统配置 4 页+日志报表 ▸ views/home · views/system/* |
工作台 5s 内加载;错误码表与后端种子一致 | ⬜ | — |
| 2 | Day67 消耗日志日汇总+充值日志/审核流程 ▸ cron/usage · service/recharge_audit |
消耗汇总与余额变动匹配;充值审核通过余额实时增加 | ⬜(阶段 6 未开工,重排待裁决;Day67 实际=明细查询单表化根治 Count 29.5s→亚秒+派生表 JOIN 改相关子查询 ✅A 09-28,见 day67.md;本行任务随阶段 6 重排落位) | D36 通讯录/短语/常用号码+预警公告;🚧 FE-5 验收=A-6.x ▸ views/tools/* |
三工具页可用;FE-5 全阶段页面联调通过 | ⬜ | — |
| 3 | Day68 工作台聚合接口(今日量/余额/待审数/7 日趋势) ▸ api/v1/dashboard |
主页 5s 内加载;待审数与审核表一致 | ⬜(阶段 6 未开工,重排待裁决;Day68 实际=运营总览 /home 真实数据后端 stats_daily 汇总表+/stats/summary·trend ✅A 09-28,见 day68.md;本行任务随阶段 6 重排落位) | — | — | ⬜ | — |
| 4 | Day69 结算单测(阶梯/退款冲正)+三方对账+操作手册 ▸ 结算测试集 · docs/settle-manual |
对账差异率=0;覆盖率 ≥80% | ⬜(阶段 6 未开工,重排待裁决;Day69 实际=入向长短信 UDH 全链路支持+回执并发竞态三轮根修+unpaired 重投自愈+百万级压测监测就绪 ✅A 09-28,见 day69.md;本行任务随阶段 6 重排落位) | — | — | ⬜ | — |
| 5 | Day70 🚧 阶段 6 验收:全量回归(阶段 0-6) ▸ 阶段 6 验收单 |
A-6.x 全过;全量回归无异常 | ⬜(阶段 6 未开工,重排待裁决;Day70 实际=长短信计费少计根修(fee≡上游真实片数)+存量 21837 条清偿 ✅A 09-28,见 day70.md;阶段 6 验收随重排落位) | — | — | ⬜ | — |
第 15 周(Day 71-75 ↔ FE D37-39 · FE-6)
| # | 后端任务 · 产出物 | 后端验收标准(100% 过) | 状态 | 前端任务 · 产出物 | 前端验收标准(100% 过) | 状态 | 验收日期 / 更新明细 |
|---|---|---|---|---|---|---|---|
| 1 | Day71 Staging 搭建(1:1 减半)+迁移+脱敏数据(10 万账号/50 通道) ▸ Staging 部署清单 |
Pod 全启;/health 200;数据量达标 | ⬜(阶段 7 未启动,重排待裁决;Day71 实际=入向长短信挂起制 72h「不齐不发,到期失败」终态制(v19/restore/reaper) ✅A 09-29,见 day71.md;Staging 搭建随阶段 6/7 重排落位) | D37 全站权限矩阵走查(五角色×全菜单)+Mock 下线 ▸ 权限矩阵走查表 |
五角色走查截图归档;无越权入口 | ⬜ | — |
| 2 | Day72 全量冒烟+压测(200 QPS×30min)记录性能基线 ▸ 性能测试报告 |
P99 <50ms;CPU <70%;无 OOM;GC <10ms | ⬜ | D38 性能优化(懒加载/首屏 LCP <2s/单包 <500KB) ▸ 性能报告(web-vitals) |
首屏 LCP <2s(内网);chunk 单包 <500KB | ⬜ | — |
| 3 | Day73 生产环境就绪(36 表/Topic 分区/Redis Cluster LRU) ▸ 生产就绪检查单 |
show tables 36 张;Kafka 连通;Redis 策略生效 | ⬜ | D39 CI 集成(test→build)+镜像(nginx)+kind 部署 ▸ CI 配置 · web/Dockerfile · nginx.conf |
CI 绿;容器化部署 kind Dev 通过(NodePort 30081) | ⬜ | — |
| 4 | Day74 灰度发布(Ingress Header 5% 分流)+监控 ▸ 灰度发布配置 |
canary Header 进灰度 Pod;错误率与基线差 <1% | ⬜ | — | — | ⬜ | — |
| 5 | Day75 灰度 20%+回滚演练 ▸ 灰度验证记录 |
20% 流量指标正常;回滚演练成功 | ⬜ | — | — | ⬜ | — |
第 16 周(Day 76-80 ↔ FE D40 · 🚧 生产总验收)
| # | 后端任务 · 产出物 | 后端验收标准(100% 过) | 状态 | 前端任务 · 产出物 | 前端验收标准(100% 过) | 状态 | 验收日期 / 更新明细 |
|---|---|---|---|---|---|---|---|
| 1 | Day76 灰度 50%(成功率 >99%/结算无误差) ▸ 中流量验证记录 |
50% 流量成功率 >99%;结算零误差 | ⬜ | D40 Playwright 冒烟 10 用例+验收会议+文档归档;🚧 FE 总验收 ▸ e2e/ 10 用例 · docs/frontend-review.md |
冒烟全绿;50 页走查表全过,零 P0 缺陷 | ⬜ | — |
| 2 | Day77 全量切换(旧系统只读+双写比对) ▸ 切换记录 |
全量稳定 2h;新旧系统数据完全一致 | ⬜ | — | — | ⬜ | — |
| 3 | Day78 旧系统下线+历史数据迁移 ClickHouse+定时任务全开 ▸ 下线与迁移记录 |
旧系统零流量;迁移完成;定时任务正常 | ⬜ | — | — | ⬜ | — |
| 4 | Day79 混沌工程(Kill Pod/网络延迟,RTO <30s)+上线总结 ▸ 混沌测试报告+上线总结 |
自动恢复 RTO <30s;Kafka 重平衡无丢失 | ⬜ | — | — | ⬜ | — |
| 5 | Day80 🚧 生产验收评审+交付文档归档+KT 会议 ▸ 最终交付清单 |
所有验收项通过;交付物完整;KT 完成 | ⬜ | — | — | ⬜ | — |
已完成验收档案(证据索引)
| 验收项 | 日期 | 结论与证据 |
|---|---|---|
| A-0.x 阶段 0 | 2026-09-03 | 全链路回归通过;合并 develop 7b46b312;详见 CHANGELOG 阶段 0 段 |
| A-1.1~A-1.15 阶段 1 | 2026-09-03 | 评审报告 docs/phase1-review.md 逐项证据映射;13 包 -race 全绿;lint 0;合并 develop b75fbe26 |
| A-2.7 登录流程(Day 24) | 2026-09-04 | 正确密码返 Token;错误 5 次锁 15 分;登出即失效;auth 包覆盖 90.4%(b645ce6f) |
| A-2.5/A-2.6 权限引擎(Day 25) | 2026-09-04 | customer 导出 403 ISC:403 / admin 200 CSV;二级权限授撤即时生效;17 包全绿+lint 0;casbin 覆盖 80.8%(8a0322ed) |
| Day 26 充值(Day 26) | 2026-09-04 | customer 充值 403/admin 200 余额落账;批量行级定位(4 行 2 成 2 败);并发 10×100 无丢失;越权查余额 403(899d5c6a) |
| Day 27 余额预警 | 2026-09-04 | 阈值触发单轮通知;冷却去重(3 轮 0 重复);失败下轮重试;授信计入可用额度;调度器可停启;API 越权 403(66b1fbbe) |
| Day 28 账号辅助能力 | 2026-09-04 | b 切挂 root 子孙路径级联重写/旁支不变;防环 400 路径零改动;标星列表置顶;实名状态机(驳回可重提/通过终态 400);越权 403(1507d20e) |
| Day 29 审计日志 | 2026-09-04 | 充值留痕 who/what/when 全字段;GET/400/401 不记而 export 记;登录成败各 1 条;查询五过滤+分页;customer 403;account 覆盖 87.0%(deb75560) |
| A-2.1~A-2.13 阶段 2 验收(Day 30) | 2026-09-04 | TestPhase2E2E 全链路(真登录/四协议/业务线/白名单/审核模式/角色隔离/二级权限/充值/预警/删除守卫/导出/实名/登录审计)全过;openapi.yaml 27p/35op 与实现一致;无阻塞项(e35ec818) |
| Day 31 CMPP 基础协议 | 2026-09-04 | 模拟网关握手 status=0;密钥错→ErrLoginRejected;心跳往返计数一致;静默→超时断连→恢复自动重连二次登录;21 包全绿;cmpp 覆盖 81.6%(ec1e75e0) |
| Day 32 CMPP 完整协议 | 2026-09-04 | Submit 返 msg_id(Result 0/1);状态报告全字段+上行原样解析;Deliver_Resp 自动回×2;池 2 连接并发 10 提交全成功;修复 ParseDeliver 偏移错位;cmpp 覆盖 85.9%(e3191241) |
| Day 33 HTTP+SGIP | 2026-09-04 | HTTP 三鉴权(appkey/sign/none)命中与拒绝全分支+message_id 解析;SGIP bind/submit Result=0、Report 全字段解析+自动回应答;httpadapter 90.6%/sgip 83.0%(dec172fb) |
| Day 34 SMPP+流控 | 2026-09-04 | Bind OK/错密码拒;窗口 2×慢网关 80ms 并发 8:在途峰值=2 全成功;窗口满→ErrWindowFull;enquire 保活 ≥2 次;回执/上行解析+自动回 resp×2;smpp 83.9%(41362c07) |
| Day 35 通道管理 | 2026-09-04 | CRUD 六断言全过;四协议测试工具连通拿 MsgID(777/up-88/up-35);夜发 -1/地区前缀 -2/日限计满 -3;customer 403;25 包全绿;channel 86.0%(bce59e3f) |
| Day 36 路由基础 | 2026-09-04 | SWRR 7:3×100 条=70/30 偏差 0(<5%);1100 条 770/330;关键字/省份/运营商命中+双命中取高优先;组内→全局兜底→ErrNoChannel;组五类校验+双守卫;router 96.0%(7c65bd94) |
| Day 37 路由引擎 Step1 | 2026-09-10 | 黑关键字/地区/运营商/频次/签名五类过滤全分支单测;过滤→SWRR→兜底全链 <10ms;engine 叠加 Day36 构成四步闭环(085a3474) |
| Day 38 导流+分时价 | 2026-09-10 | steer 规则 CRUD(类型白名单/account 须 account_id/keyword 须 config/通道存在性/停用跳过取次优)+REST 四端点(channel:write);price_timelines 分时区间取价;估算余额 2h 定时(b101c9cf) |
| Day 39 CMPP 编码+回执闭环 | 2026-09-10 | EncodeContent GBK/ASCII+UCS2 占位;UDH 长短信分片拆合;回执复核 WEB 页闭环(8c65225f) |
| 空内容根因双闭环(Day 39 修复链) | 2026-09-10 | 第一层删 3.0 独有 type 字段 d1f64275(通道方复测仍空);第二层 Msg_Length 4B→1B(2.0 Octet String) c0ab7d57——1B 宽度模型唯一解释两次空内容;黄金 dump @138=0x22/193B;真网 3 条 DELIVRD 全 ~3s 内精确匹配 msg_id(A-3.2+A-3.4 双闭环);26 包 -race ok |
| Day 39.5 压测基线 | 2026-09-10 | cmppbench 工具(~310 行:随机号/限速/CSV/JSON 摘要);10 万条 6 轮零失败零断链:8×4=266/16×8=490/32×16=861/64×16=1178/160=2573/256=3203 峰值 TPS;建议限流:连接 ≤16、在途 ≤64、常态 ≤720 TPS(a95b7ff8) |
| Day 39.6 性能规划合并 | 2026-09-10 | 5000 入/3000 出一收一发规划并入三文档:技术方案 10.4(实测基线表/数据流/各层容量/背压三级水位)+开发计划 Day46/47/48/50 硬数字+A-4.20~22;256 窗口实测持续 ~2263(3000=峰值口径);CHANGELOG NUL 字节治理(44225a51) |
| FE-0 验收 | 2026-09-03 | Mock 登录闭环/守卫/权限指令;22/22 测试;合并 develop 36701945 |
| FE-1 验收 | 2026-09-03 | 账号 6 页(Mock 联调);22/22 测试(11a30594) |
| FE-2 验收 | 2026-09-03 | 通道/策略 6 页;22/22 测试;待合并 develop(6fb12ece) |
| D11 上家管理验收 | 2026-09-04 | 修复后通过:补编辑入口(CRUD 之 U)+el-form rules(必填/电话格式)+Mock 契约 4 端点+测试 5 例;lint 0/0、Vitest 27/27、build 17s;登记 FE 存量 typecheck 债务 7 处(D39 前清零)(49b18383) |
| D12-D16 通道与策略验收 | 2026-09-04 | 修复后通过:Mock 15→51 端点(通道/组/策略/报备全契约);D12 列 9→21;D13 回显单查+类型修复;D14 权重和校验+排序持久化(拖拽降级移位,留痕);D15 批量导入+频次/码号 CRUD;D16 Report.vue 新建(报备状态机);lint 0/0、Vitest 31/31、build 17.52s(5ad64a12) |
| Day 40 阶段 3 收官 | 2026-09-10 | A-3.x 全过(4ca16173+phase3-review.md):A-3.12 告警 link_down/fail_rate(cron 30s+断连即时,冷却去重/失败重试)·A-3.13 WS 2s 快照帧(60s 滑窗 tps/fail_rate/latency_p50;gorilla v1.5.3)+轮询兜底·A-3.14 channel_log v7 真库迁移(连接逐条/提交回执 10s 窗口聚合——3000 TPS 防打爆,队列满丢弃不阻塞)·A-3.5 可杀网关演练秒级重连(<30s 线)+disconnect 留痕·1000QPS 3 轮 p99 中位 7.9~8.8ms<10ms·吞吐 1806/s·BootstrapLinks 装配补缺·26 包全绿(-race 抽查 ok);A-3.10/11 计费侧顺延阶段 4(扣费链路未上线) |
| Day 31 真实网关联调 | 2026-09-06 | 全链路打通:CMPP 鉴权两轮修正(9×0x00 + Connect 包体 27B/4B 大端 Timestamp + 鉴权串 ts 十位 ASCII——authprobe 八变体实测命中 status=0);A-3.1 握手 66ms ✔/A-3.2 Submit 连续 6+ 条 result=0 返回真实 MsgID 27-32ms ✔/心跳 30s 周期应答 ✔/HTTP 测试工具 79ms ✔/Web real 全链路(5173→8081→MySQL)✔;工具:seed-admin 首启引导/v6 差量补列/cmd/probe 长连接探针/cmd/authprobe;提交链 8479d985;⏳ Deliver 回执长连接观察中、A-3.5 断线重连待网关侧配合演练 |
| FE-2 线上交付缺口修复 | 2026-09-04 | 线上实测仅 FE-0/FE-1:根因=FE-2 验收后未执行 L2 合并,phase3-channel 工作区无 channel/policy 页面且路由指向 ComingSoon 占位。修复:fe-channel→develop(5a91cb86 干净合并)→ 同步 phase3(f3920f3a);合并后三件套全过(lint 0/31/31/build 17.5s);线上重启实测 9 页面组件全 200(account×2/channel×4/policy×3)。教训:L2 门禁"验收通过"必须当日内完成合并,验收≠交付 |
| D14/D15/D16 菜单不可见修复 | 2026-09-04 | 复核确认:D11/D14/D16 四路由(channel/upstream、channel/group、policy/route、policy/report)缺 menu:true 被侧边栏过滤;main.ts 未注册 icons(菜单图标空白)。修复:四路由补 menu+icon、icons 全局注册、guard 断言 18→22+四入口包含;31/31+build;线上 22 菜单/四路由 200(ea5426ab,cherry-pick develop b79bd654) |
当前位置与下一步(2026-09-11 · Day 46 ✅A 收官,Day 47 解锁)
-
🎉 Day 46 双 ✅A 收官(外部 HTTP API 提交+D22 结果反馈页;走查三轮闭环全 ✅ 签名 Tory:一轮 ❌ env 模式覆盖坑→修复;二轮 W1/W2/W4 ✅+W5/W6 ❌→修复循环;三轮 W3②/W5/W6 全 ✅):后端——
service/openapi新包(SMS_HTTP_1.6 十八码表/MD5 验签 sign=MD5(user+ts+MD5(secret)) ±5min 常数时间比对/验签序:存在性不泄露→禁用→未开通→IP 白名单→时间戳→签名;SendMass 群发定时(sendTime 秒级,过去/超 15 天拒)+SendOne 个性(phone×content 等长≤1000),复用 send.Submit/SubmitPersonal 全链(余额/审核分流/雪花明细),extCode/callData rune 截断透传落库;sms-submit 事件经 queue.Producer 投递(失败仅日志,Day45 调度器 DB 认领兜底))+/sms/api独立协议域(全局 IP 桶→验签 401→账号桶动态容量(middleware.RateLimitDynamic,speed_limit 请求期取,500/100 兜底))+GET/PUT /accounts/:id/api-config(reset_secret 重发 32hex 明文仅一次,库存 MD5;查看只回指纹前 8)+GET /send/tasks/:id/details(D22 数据源)+迁移 v10(并修 CurrentMigrationVersion 字典序坑 v10<v9)。真环境冒烟八项全过(群发/个性/定时/错签 401/时间戳 16/IP 白名单/动态限流 429(speed_limit=1:200×3+429×2)/Kafka 三分区事件),冒烟数据全清。go 31 包 0 FAIL。前端——D22 views/sms/result(任务检索→汇总卡→明细六状态 tag+错误码 ISC_CN tooltip+扩展码/回传数据→筛选分页→CSV BOM 导出);routes 25→26;vitest 79/79(eslint 0/tsc 0)。修复循环两枚:①.env.development.local(vite.local优先级)把 dev server 钉 real 模式→mock 不生效页面空(坑:切 real/mock 前必查该文件);②AccountDetail configs 为 Day22 硬编码占位恒「免审」→改接 GET /accounts/:id 真数据(+detail 契约 1 例);③捞出 Day46 漏跑 typecheck(build 脚本=纯 vite build 不含 vue-tsc)→SendTask 补 unknown_count 可选字段。遗留观察:go-sms-kafka 容器 DNS 故障重启循环(1217 次,hostname: Try again)——非本任务引入,网关 producer 实连 hwsms-kafka:19092 正常,建议次日开运维单处理容器。 -
🎉 Day 45 双 ✅A 收官(定时下发+D21 审核中心;协议 v3 走查一轮 W1~W6 全 ✅ 签名 Tory):后端——Redis ZSet 唤醒索引(真值在 MySQL,认领
UPDATE WHERE 可发条件原子翻转幂等)+5s 扫描(补偿入队:审核通过/改期 ≤5s 自动纠正,无需跨包事件;差集清理:取消/拒绝即时出队;Redis 故障 DB 直查降级)+ChannelDispatcher(router 选路→SubmitViaLink 真链路 CMPP)+CountByStatus/BatchReview 两端点;前端——审核中心页六 Tab 徽标/批量审(拒绝原因必填)/48h 临期标红+超时行区分/列表徽标联动。真环境冒烟:免审 0.9s 到点完成、真链路 succ=2/4.7s(channel_log submit+deliver)、改期 score 纠正、幂等计数恒定;捞出并修复 error_code varchar(16) 溢出致明细终态静默丢失。go 30 包 0 FAIL;FE tsc0/eslint0/vitest 72。 -
下一工作日 Day 46:HTTP API 提交(双桶限流+MySQL 同步禁令,precheck 链转非 DryRun);个性逐号精检仍在待办池择机;顺手项:AccountDetail audit_mode=2 文案「自动拒绝」→「自动审核(黑词)」校准。
-
🎉 Day 44 双 ✅A 收官(文件入口+D20 模板管理;协议 v3 走查 W1~W5 一轮 ✅、W6 ❌→修复循环(accept 过滤致 doc 选不到+入口零格式提示→用户裁决:导入按钮下加信息标签(格式/≤10,000 号/≤10MB/存档审计),复验 ✅ 签名)):后端——POST /files/numbers/import(TXT/CSV/XLSX 解析→表头启发/归一/去重/非法计数→MinIO 落对象 numbers/{acct}/{snowID}.{ext},依赖倒置 ObjectStore+memStore 单测;10MB/万号双闸;mobiles 全量返回)+PUT /templates/batch-review(事务原子翻转 WHERE status=0);新依赖 excelize/minio-go;前端——D20 模板管理页+batch 导入升级。真环境三格式+批量审核 curl 全通,30 包 0 FAIL,FE 67 tests。
-
🎉 Day 43 双 ✅A 收官(审核服务+D19 定时任务;协议 v3 首单两轮走查闭环):一轮 W1/W4 ✅、W2/W3 ❌→修复循环方案 B——①vite proxy 8081→8080(estimate/login 500 根因,前端代理层);②最小提交链提前落地(service/send/submit.go:Validate→定时须未来→余额只读 ISC:007→事务落 task+detail 雪花 ID→事务外 Route 分流;task_no 幂等;POST /send/submit;batch 提交按钮;Day44 原提交链任务不再含)→二轮 W2/W3/W5/W6 全 ✅ 签名(Tory)。commit 99a51587/merge a08378bb。
-
下一工作日 Day 44(范围已调):文件入口(TXT/CSV/Excel→MinIO)+个性逐号精检;提交链地基已就绪(直接复用 SubmitService)
-
🛡 生产运维基建立项(2026-09-11,Tory 裁决):手册
docs/runbook/incident-response.mdv1.0 落档(分级 SLA/trace_id 定位 SOP/hotfix 流程/数据修复专项/防复发演练/历史案例索引——Day43 vite proxy 500 为首案)。四项缺口 6 工作日:告警通道(Alertmanager)+前端错误上报(P0,Day53 与 R1 资金评审同日——顺延自 Day50 验收段);Loki 日志聚合+release 回滚流水线(P1,阶段 5 内择机)。逐项实施时各建验收单。 -
阶段 4 主线(Day41-50):
Day43 审核服务(⏳W 待走查);Day44 群发/个性/文件(TXT/CSV/Excel→MinIO;个性逐号精检);Day45 定时(Redis ZSet+5s 扫描);Day46 HTTP API 提交(双桶限流+MySQL 同步禁令,precheck 链转非 DryRun);Day47 客户协议+per-channel 调度器(令牌桶 channel.speed+窗口 256)+地区号段库/签名白名单数据源接入;Day48 全链路+批量落库+背压水位;Day49 上行+视频短信;Day50 验收(入口 5000 TPS P99<50ms/下发均值≥2200 峰值≥3000 零超速/背压演练) -
P1 挂账:①通道方连接配额确认(均值 3000 TPS 需 >16 连接);②UCS2(0x08)编码兜底;③回执持久化(Day56 并入回执消费者任务);
④TestSGIP_Client 偶发(Day42 已修:Timeout 5s);⑤TestPick1000QPS 压测线无余量(Day42 已修:默认 12.5ms+STRICT 开关);⑥/data/sms 未提交改动(已丢弃 2026-09-10);⑦TestSMPP_BindAndSubmit 并发竞态(Day42 已修:轮询断言) -
质量基线:后端 go test ./... 29 包全绿 EXIT=0 · vet 0;前端 lint 0/0 · 60/60 测试 · typecheck 0 错 · build 通过
-
门禁执行:自 Day 26 起 L1 五件套自查;Day 41 起升格六件套(+人工验收单全过归档,协议 v2);Day 43 起升格七件套(+前端用户本人走查,协议 v3);Day 39 例外已留痕
执行规范:分支
feature/phase2-*(后端)/feature/fe-*(前端)从 develop 拉出,按阶段合并;每次推送更新 CHANGELOG.md;本日历随每个工作日完成同步更新状态列;任一任务验收未 100% 通过时,下一任务不得开工(见门禁协议)。