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

56 lines
7.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-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-28~29)全部入 git 并完成文档对账(CHANGELOG 五条目归档+验收单 day67~71 补账归档+日历 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% 过,下一任务不得开工。