Files
go-sms-V2/memory-bank/progress.md
T
Tory bb60d60529
ci / test (push) Canceled after 0s
ci / web-test (push) Canceled after 0s
ci / build (push) Canceled after 0s
ci / deploy-dev (push) Canceled after 0s
S4-D1/D2: C1 回调推送引擎+C2 上行自动拉黑——验收项「死信可查/拒收即拉黑」✅: ①C1=callback_task 队列表(迁移 v21,状态机 pending→sent/dead+attempt/next_retry_at/last_code)+PushWorker(2s 扫/批 100/并发 8/2^n 秒指数退避封顶 10min/10 次耗尽死信/UPDATE CAS 防竞态)+双挂点(report 终态首锁[Consumer+PairService,与 CMPP Deliver 同点同语义]+uplink 消费尾)+URL 门控 account_config.report_url/uplink_url(60s TTL 缓存,未配置零任务)+GET /ops/callback(列表+状态计数面板)/POST /ops/callback/:id/resend(casbin ops callback:read/write v21 所种)+前端回调管理页(ops-callback 路由系统管理组+api/callback.ts+状态面板/筛选/载荷展开/死信重派;matrix+guard 33 菜单显式更)+metrics callback_push_total{type,result}/blacklist_total+openapi v1.4.0;②C2=AutoBlacklister 等值词表(trim+lower 防误伤,默认 R/TD/退订/拒收;SystemConfig uplink.blacklist.keywords 可配 60s 刷新)→policy_blacklist(source=2/账号级/uk 幂等)+Redis Set 即时生效,拉黑不影响上行推送(需求原文);③真机全链六步实证(dev 中间件):回执 DELIVRD→detail 终态→HTTP 回调 JSON 送达(200/sent)+上行 R→拉黑(source=2+Redis=1)+推送送达+坏 URL→attempt10→dead→resend ISC:000→修复重投 sent+status_counts 面板;一次性探针 cmd/cbprobe 用后即删+冒烟数据全清;④单测 +13(callback 6[入队门控/载荷/状态机全链/并发批]+uplink 5[词表/配置覆盖/幂等缓存/消费链]+report 2[首锁一次/nil]);⑤门禁=build/vet/-race 40 包/lint 0/eslint0/vue-tsc0/vitest 148/build 全绿;迁移测试 v15..v21 两遍幂等+dev 实跑 v21;gofmt 存量 8 文件顺手清零(S2 遗留);⑥口径诚实标注:载荷无签名挂账/拦截终态 HTTP 未挂(CMPP 侧已有)/PushWorker 单实例 at-least-once;验收单 s4-d1d2-callback.md+CHANGELOG+memory-bank 回填
2026-11-16 11:19:55 +08:00

78 lines
9.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 项目进度(截至 2026-09-29 / Day 71;Day67-71 已入 git `80d067e5`)
> **2026-11-12 终态**:POC 冻结(用户裁决:全部重建)。归档 tag `poc-final` + 全量 bundle(/data/go-sms-poc.bundle)交付摆渡;下方「未完成/待办池」**整体转入重建仓 go-sms-v2 排期**,不在本仓继续开发。重建盘点(A/B/C/D 四层)/迁移方案/环境三项裁决(Remote-SSH/纯CLI/不装 Gitea)见 `activeContext.md` 与 `techContext.md`。
## 重建进度(go-sms-v2,新历史 main;进度事实源=本节+每日提交)
| 阶段 | 内容 | 状态 |
|---|---|---|
| S0 环境与仓库 | debian13-smsDev 开荒/stress-ng CPU 画像/fio SSD 基线/bundle 过桥/归档 mirror/memory-bank 落位 | ✅ 2026-11-13 |
| S1① 环境四件+编译循环终验 | docker-ce 29.7.2+compose v5.5.0 / Go 1.25.0 / gcc 14.2 / golangci-lint v2.1.6;20 轮编译循环(CPU Plan B) | ✅ 2026-11-13(复现率 0) |
| S1② git init+A 层搬运 | 2a6a66f 地基 → e47610f A 层 273 文件 +33973(源=poc-final 5e09a4cc);build/vet/-race **23 包全绿 65s** | ✅ 2026-11-13 |
| S1-B D1 中间件+基线 | compose SSD 参数生效/Kafka compose 化/迁移链 v1~v19 落地/集成六件绿/首份快照/24h 门槛起计 | ✅ 2026-11-13(minio 镜像遗留) |
| S1-B B 层搬运 P1 | 12 域+双入口全落位(两阶段等价法);channel P2 拆 pool 完成;lint 27→0;全仓 -race 36 包绿 | ✅ 2026-11-13 |
| S1-B 收尾项 | send P2 拆三子包(0550f2a,facade 门面)/dayNN 19 文件改名/storage 归一/文案校准/gofmt 清零 | ✅ 2026-11-13 夜(**S1 泳道收官**) |
| S2-D1 表设计+v20+契约 | 六项裁决(R1 出账时刻计价/R2 事实源统一/R3 充值双通道/R4 返点/R5 阶梯表/R6 口径)+v20_settle_domain+openapi v1.3.0(+20 端点)+dev 库实跑 v20 | ✅ 2026-11-14(评审纪要 docs/review/s2-settle-table-review.md;验收单 s2-d1.md) |
| S2-D2 消耗日汇总引擎 | settle/consume.go+job.go(**滚动重刷模型**:1h 重刷近 4 天,修正单日 T+1 的 72h 失真)+两端点+config/metrics/装配;sqlite 6 测试;真 MySQL 端到端+收敛实证 | ✅ 2026-11-14 傍晚(验收单 s2-d2.md) |
| S2-D3 充值审核流 | recharge.go(创建/confirm 单事务 CAS+余额自增+流水 ref_id=order_no/驳回/列表)+ISC:039 三处同步+四端点(二级权限+平台角色门);测试 7 件含并发 confirm;真机全链冒烟+审计留痕实证 | ✅ 2026-11-14 夜(验收单 s2-d3.md) |
| S2-D4 出账+阶梯 | price.go(R1/R6 唯一换算)+bill.go(生成/确认/结账/SettleRecord/ladder)+export.go XLSX+15 端点;**阶梯结算单测(S2 显式验收项)**+上家三口径+状态机;真机出账全链(阶梯覆写/结账/真 XLSX) | ✅ 2026-11-14 深夜(验收单 s2-d4.md;用户走查在途补正) |
| S2 前端验收面 | 结算管理页四 Tab+api 12 端点+seed 演示(s2demo)+Playwright 预走查真库闭环(余额+1000/账单 1955.00);前端四件全绿 | ✅ 2026-11-14 深夜②(用户页面走查在途;s2-frontend-preview.md) |
| S2-D5 利润/返点/对账 | profit.go(时间线价收入+成本分摊+R4 返点现算+子树过滤;通道利润守恒分摊)+reconcile.go(三方对账,金额不比,missing 不判失败)+settle-check 子命令+/stats/profit 双端点;**真机 all_zero=true EXIT=0=S2 出口判据**;走查脚本扩 D2~D5 全域 27 PASS | ✅ 2026-11-14 深夜③(用户走查在途;s2-d5.md) |
| S2 泳道收官 | 出口两项(结算单测+对账差异 0)全过;六项裁决 R1~R6 全闭环 | ✅ 2026-11-14 深夜③(判定单 s2-closeout.md;用户走查在途补正) |
| S3 前端收尾 | 盘点修正:views 31 页已在位零残留;FE-D34 利润页(/stats/profit)+FE-6 四件(Mock 浏览器通道下线/五角色×33 菜单矩阵快照/拆包全 chunk gzip<500KB/ci.yml web job+Dockerfile nginx+NodePort 30081 备档);vitest 148 全绿;LCP 实测与 kind 两项环境受阻如实标注 | ✅ 2026-11-15 凌晨(s3-closeout.md;页面走查在途) |
| S4-D1/D2 C1 回调推送+C2 拉黑 | callback_task(v21)+PushWorker(指数退避/死信/重派)+双挂点(report 终态 Consumer/PairService+uplink 消费)+GET /ops/callback 管理面+前端回调管理页;C2 等值词表可配拉黑+Redis 即时生效;真机全链六步实证;**死信可查/拒收即拉黑两项验收 ✅** | ✅ 2026-11-16(s4-d1d2-callback.md) |
| S4-D3 分区+冷热 | 明细按天分区热 5 天(v17 口径上 DDL 改造,方案先行)+CH 冷热切换(5 天前迁出)+record/history 冷查<1s+settle-check 对账基线自动切换验证 | ⬜ 下一步 |
| 观察项 | 24h 稳定性门槛(11-13 17:55 起计;期内 21:33 宿主主动重启=已知事件不判失败)期满核验 11-14 17:55 | ✅ 2026-11-14 18:02 终判通过(dmesg 0/零重启/驻留+md5 一致;S5 压测前置确认,S1 完全闭环) |
| S2~S5 | 结算域/前端收尾/C1C2+冷热/基线与灰度 | 🔄 S2✅S3✅S4 D1/D2✅(见《Go-sms-重建计划.md》) |
## 阶段总览(8 阶段 / 80 工作日)
| 阶段 | 内容 | 状态 |
|---|---|---|
| 阶段 0(Day 1-10) | 工程地基:compose/配置/日志/队列/K8s CI | ✅ 2026-09-03(合并 develop `7b46b312`) |
| 阶段 1(Day 11-20) | 数据层:36 表/仓储/迁移 | ✅ 2026-09-03(`b75fbe26`) |
| 阶段 2(Day 21-30) | 账号/权限/余额/审计:E2E 全链 | ✅ 2026-09-04(`e35ec818`) |
| 阶段 3(Day 31-40) | 协议:CMPP/SMPP/SGIP/HTTP 适配 | ✅ 2026-09-08 前后(单日验收连续通过) |
| 阶段 4(Day 41-50) | 发送主链:提交/审核/定时/HTTP API/全链 | ✅(Day 43-50 逐日 ✅A 归档) |
| 阶段 5(Day 51-65) | 运营闭环:回执/重推/对账/消费并发 | ✅ 含收尾 C3(Day66=09-24)与补账(Day59-66) |
| 阶段 6(Day 66-69 原计划) | 结算域:利润/消耗汇总/结算单测 | ⬜ **未开工**(2026-09-16 裁决收尾优先,待重排) |
| 阶段 7(Day 71-80) | 上线:Staging/压测/灰度/切换/验收 | 🔄 部分透支(Day 71 实际=长短信挂起制,非 Staging) |
| 前端 FE-1~FE-5 | 账号→通道→策略→审核→群发/明细 ~50 页 | ✅(FE-6 权限走查/Mock 下线未做) |
| 前端 UI 重构 W1-W6 | demo-c-aurora 基准全站重构 | ✅ 2026-09-24(rebuild-ui 分支 6 commit) |
## 近期完成明细(Day 63-71,报障驱动修复期)
| 日 | 主题 | 关键成果 |
|---|---|---|
| Day 71(09-29) | 入向长短信挂起制 72h | v19 持久化/restore/reaper/失败终态制;✅A 真机六步 |
| Day 70(09-28) | 长短信计费少计根修 | fee≡上游片数;UCS2 口径;探针 longsmsprobe;存量 21837 条清偿 |
| Day 69(09-28) | 入向长短信 UDH 全链路 | ParseUDH+聚合器(组ID 三口径同源);回执并发竞态三轮根修(recheckPending 新事务重判)+unpaired 重投自愈;压测监测 7 指标+3 告警+watch_1m.sh |
| Day 68(09-28) | 运营总览真实数据后端 | v18 stats_daily+/stats/summary·trend(60~73ms/15.5ms);60s UPSERT;角色双口径 |
| Day 67(09-28) | 明细查询单表化根治 | v17 business/source 下沉+派生表改按页相关子查询;端到端 29.5s→1.0~1.2s;buffer_pool 6G |
| Day 66(09-24) | 阶段 5 收尾 C3 | D28 回执重推/手动配对四端点 |
| Day 65(09-16) | 消费并发 worker 池 | workers:4 消化 0→55/s;生产级死锁两连修 |
| Day 64(09-15) | 明细查询超时修复 | v16 双索引+延迟关联三段式 82s→645ms;buffer_pool 4G |
| Day 63(09-15) | SubmitFast 快路径 | 受理 p50 1.7s→14ms / TPS 45→4279;MsgID 口径统一 |
## 未完成 / 待办池
1. **阶段 6 结算域**(settle:利润分析/消耗日汇总/充值审核流程/阶梯结算单测/三方对账)——整域未开工,需重排落位。
2. **Day 72-80 上线序列**:压测基线(200 QPS×30min)→生产就绪检查→灰度 5%→20%→50%→全量切换→旧系统下线+ClickHouse 迁移→混沌工程→总验收。
3. **FE-6(D37-39)**:全站权限矩阵走查(五角色×全菜单)+Mock 下线;前端性能(LCP<2s/单包<500KB);CI 集成+web 镜像化(nginx+kind NodePort 30081)。
4. **运维缺口**(2026-09-11 立项,6 工作日):告警通道 Alertmanager 联通(规则已有);Loki 日志聚合;release 回滚流水线。
5. **P1 挂账**:通道方连接配额确认(3000 TPS 需 >16 连接);生产换 SSD(明细回表/消费吞吐解锁项)。
6. **小项**:前端 LP/LSM:NOTCMPL 错误码文案映射(待运营反馈);个性逐号精检(待办池择机);账号 audit_mode=2 文案校准。
7. **观察项**:长短信组上限 16384(watchdog expf);`web/.env.development.local` 当前=real(联调期,切 mock 前必查)。
## 已知问题(修复史与遗留)
- go-sms-kafka 容器曾 DNS 故障重启循环(1217 次,Day 46 观察;网关实连 hwsms-kafka 正常)——非代码问题。
- 回执偶发双推容忍(72h 末端 reaper 与到齐路径毫秒级窗口,概率趋零)。
- cmppbench 接入账号口令未知(tcmpp 为 bcrypt)——压测受限非阻塞。
## 验收档案索引
- 单日验收单:`docs/acceptance/day41~day71.md`(Day 41 起强制,协议 v2→v3;day67~71 为 2026-09-29 补账归档,证据取自 CHANGELOG 各日条目)。
- 阶段评审:`docs/phase1/2/3-review.md`;资金评审 `docs/review/r1-balance.md`;前端审计 `docs/review/fe-design-audit.md`(W 阶段一~十三全链登记)。
- 完成验收映射表:开发日历文末「已完成验收档案」(逐项含 commit 证据)。