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

7.0 KiB
Raw Blame History

当前工作上下文(最近更新:2026-11-12)

当前状态快照

  • 分支:rebuild-ui;工作树干净(Day 67-71 已全部入 git)。
  • 最近提交:80d067e5(2026-09-29)Day67-71 补账——入向长短信全链路/计费根修+清偿/72h 挂起制+明细单表化+运营总览后端,62 文件 +3177/−213(含 CHANGELOG 条目归位/验收单 day67~71/日历回填/aggregator -race 补修)。
  • 已完成日:开发日推进至 Day 71(2026-09-29);前端 UI 重构 W1-W6 全收官(独立于日历编号)。
  • 质量基线(2026-09-29 补账门禁实测):后端 build+vet+go test -race -cover 35 包全绿(修 aggregator 计数器竞态后);前端 lint 0 / vue-tsc 0 / vitest 138 / build ✓ / verify-layout 18/18。
  • 项目定性变更(2026-11-12 用户裁决):本项目为测试可用性(POC),使命完成,决定全部重建——新 SSD 环境(121.46.230.53)+ 新仓 go-sms-v2;本仓冻结为归档(tag poc-final,全量 bundle 交付摆渡)。
  • 重建环境三项裁决(2026-11-12):①开发形态=本地 VS Code + Remote-SSH(服务器只跑 vscode-server,Cline 在 server 端);②服务器重装纯命令行 Debian 13(xrdp/Xfce/VS Code GUI 弃用);③不装 Gitea——服务器本地仓为中心,备份=定期 bundle 拉回本地。
  • 新机 S0 就绪(2026-11-13):debian13-smsDev(1822/user 免密 + sudo NOPASSWD + DNS ✓);磁盘=顺序 662MB/s + 4K 随机读 76.3k IOPS(HDD 500 倍级);CPU 画像=CPUID 无 AVX + VEX 执行即 SIGILL(dispatch 类免疫/编译禁 -march=native,Go 无影响);fio/git/curl 就位,归档仓 mirror 落位 /data/poc-archive/repos/go-sms.git;用户连 Remote-SSH 即开 S1(docker/Go 安装+编译循环终验为 S1 首动作)。

重建启动(2026-11-12 裁决 / 盘点 / 迁移方案)

  • 盘点结论(A/B/C/D 四层):A 直接保留=协议四栈(cmpp/smpp/sgip/httpadapter)+pkg 标准件+计费纯函数(util)+middleware+openapi.yaml+监控三件+运维资产+v1~v19 迁移链终态 DDL;B 改造保留=send 主链(13 文件拆包/去 dayNN 命名)/access 长短信(72h 挂起制最终语义)/report(补 C1 回调推送)/router(空壳目录归位)/channel/account/balance/interceptor/前端整包(31 页+三件套样式+ProTable,FE-6 收尾);C 结论保留=明细单表化+按页相关子查询(禁 JOIN 计数)/幂等三锚/MsgID=DetailID 雪花全链/削峰(受理-下发解耦)/部署串行铁律/-race 全量门禁;D 新做=结算域(0%)/C1 回调引擎+C2 拉黑/ClickHouse 冷热/通知域/明细按天分区热 5 天。
  • 迁移方式:git bundle 摆渡(老 IPv6 ↔ 新 IPv4 仅 FC 慢速中转;一次性 ~35M;node_modules/bin/logs 全不迁)。新机依赖大头=Docker 镜像(3-5G)+Go mod cache+pnpm store+Playwright(共 5-8G),按外网连通性决定下载/介质摆渡;vscode-server 首装亦需出网(update.code.visualstudio.com),不通则按 commit hash 离线装。
  • CPU 缺陷对策(实体机约束,不可换宿主/微码):纯 CLI 影响非零(压测基线可信度>编译偶发>Node);缓解=GLIBC_TUNABLES 关 AVX 派发+开荒第一步 stress-ng(avx2/memcpy)+20 轮编译循环实测复现率(≈0 接受/频发建议换整机)+压测基线前置 24h 稳定性门槛。
  • SSD 基线重标定(重建首个性能工作项):workers:4/消费顶 55/s 是 HDD 数字不可沿用;buffer_pool 16-24G/io_capacity 2000/10000/Kafka flush 放宽;就绪验收=七件套全绿+watch_1m.sh --once 首份 SSD 基线快照。

刚完成(2026-11-12:服务器 121.46.230.53 VS Code「必须 --no-sandbox」排查 ✅,环境运维非开发日)

根因=宿主 CPU 指令执行缺陷(dmesg 实锤:code 确定性 SEGV error 25 跨 socket 0/4/8/12 + extensionHost SIGILL + evolution-alarm libatomic invalid opcode 系统级旁证;Xeon 8173M 虚拟化 AVX 全掩/BMI1-2 保留),软件侧无根治;AppArmor userns profile / SUID chrome-sandbox / --disable-gpu / FC_FONTATIONS=0 逐一实测排除。实测裸 code(无 --no-sandbox)可正常打开(真实配置冷启动,renderer 闪崩 1 次后自动 reload;--no-sandbox 下同样偶崩=沙箱开关非决定因素)。已做变更仅 /etc/apparmor.d/code 幂等重载;测试进程与 /tmp 残留已清。遗留:报云厂商换宿主/升级微码。详见 techContext「远程服务器」小节。

刚完成(2026-09-29:Day67-71 补账提交 80d067e5)

报障驱动五日(09-2829)全部入 git 并完成文档对账(CHANGELOG 五条目归档+验收单 day6771 补账归档+日历 Day67-71 状态列回填);提交门禁补修 internal/service/send/aggregator.go 三计数器数据竞争(-race 必现的 Day 47 遗留,int64 裸写→atomic.Int64)——教训:门禁必须 -race 全量,裸跑 go test 掩盖竞争。事故工具 cmd/reconcile/refund_lost(宿主机休眠丢件对账退款)一并留档。

下一步(重建,2026-11-12 起)

  • 老环境侧(本提交):归档三件套=bench 入档+poc-final tag+全量 bundle(/data/go-sms-poc.bundle);老 Gitea 推送 develop(快进 2)+rebuild-ui(首推 11 提交,W1-W6+Day67-71+memory-bank 此前仅存本地);main 不动。
  • 新环境侧(121.46.230.53,重装纯 CLI Debian 13 后):SSH 加固(仅密钥/fail2ban)/NTP/Docker → 开荒第一步 stress-ng+编译循环实测 CPU 复现率 → 本地 VS Code+Remote-SSH+Cline → bundle 过桥 → clone 本地归档仓 /data/poc-archive + git init /data/go-sms-v2(A 层搬运)→ compose 七中间件(SSD 参数基线)→ 七件套复跑 → watch_1m.sh --once SSD 首份基线快照(前置 24h 稳定性门槛)。
  • 原「阶段 6/7 重排三选一」裁决已被全部重建取代;日历 Day72-80 原计划转入重建造价。
  • 观察项(随重建转移):16384 长短信组上限(watchdog expf);LP/LSM:NOTCMPL 文案映射待运营反馈。

活跃的架构决策记录(近期)

决策 内容
长短信语义(Day 71) 完整性优先:72h 不齐=失败终态(LSM:NOTCMPL/零费/UNDELIV),废除「超时退化逐片直发」
计费口径(Day 70) fee≡上游真实拆分片数;FeeSegments>0(客户端 pk_total=运营商计费依据)优先于重算
MsgID 口径(Day 63) CMPP Submit_Resp MsgID=DetailID 雪花,与回执同口径
消费并发(Day 65) 每分区 worker 池(workers:4,HDD 顶 55/s);生产换 SSD 是解锁项
UNKNOWN 终态(Day 69/71) 出向回执挂起 72h 后保持 UNKNOWN(部分段事实送达,不标失败)

常踩的坑(防复发)

  1. .env.development.local(gitignore)会把 vite 钉在 real 模式——切 mock 前必查。
  2. build 与 kill 并行=旧 inode 进程(Day 70);部署必须串行+md5 比对。
  3. 持久化-还原键字段必须成对审计(Day 71 ref 字段漏存教训)。
  4. 迁移版本号字典序坑(v10<v9,Day 46 修);gofmt 的 // 注释误闭合致 vite 编译错(W4)。
  5. pgrep -f 匹配 bash 壳;watch_1m.sh 用脚本名过滤需排除自身。

门禁协议(七件套,Day 43 起)

go vet+test(-race)→ lint → 前端 eslint+tsc+vitest+build → 人工验收单归档(docs/acceptance/dayNN.md)→ 前端用户本人走查(协议 v3,W1~W6)→ CHANGELOG 更新 → 日历状态列回填。任一未 100% 过,下一任务不得开工。