Files
go-sms-V2/memory-bank/progress.md
T

74 lines
7.6 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 | 利润/返点+三方对账(diff=0=S2 出口)+S2 收官走查 | ⬜ 排期中 |
| 观察项 | 24h 稳定性门槛(11-13 17:55 起计;期内 21:33 宿主主动重启=已知事件不判失败)期满核验 11-14 17:55 | ✅ 2026-11-14 18:02 终判通过(dmesg 0/零重启/驻留+md5 一致;S5 压测前置确认,S1 完全闭环) |
| S2~S5 | 结算域/前端收尾/C1C2+冷热/基线与灰度 | ⬜ 见《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 证据)。