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

58 lines
7.3 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)
## 当前状态快照(2026-11-13 晚,S1-B D1+B 层全域 P1 完成日)
- **仓库**:main 至 `704f6f0`(今日 S1-B 14 提交:5986680→704f6f0);module 保持 `go-sms`;每日 03:30 bundle 备份照常。
- **中间件**:8/9 容器 healthy(mysql 10G/2000/10000/redo1G·SSD 基线生效、kafka compose 化 KRaft、redis/etcd/CH/prom/am/jaeger);**minio 遗留**(docker hub 不通+主流 mirror 缺旧 tag;1panel 单层重试中;备用=老机 save 摆渡;主链/集成测试不依赖)。
- **init 链**:4 topic×3 分区 ✓;**迁移链 v1~v19 空库独建+超管**(admin/4b5fc0333cd402c5,已交用户);**教训:init_schema.sql 快照与 gormigrate 双跑会 FK 冲突(Error 3780)——新环境只走迁移链,快照降级参考资产**。
- **B 层搬运**:P1 全域 12 域+双入口落位(两阶段等价法);channel P2 拆 pool 子包完成(Deps 断环六适配);**send P2 拆三子包=下一工作项**;dayNN 九文件改名/account·template 文案校准待收口。
- **质量门**:build/vet/lint(v2.1.6 首跑 27→0)/全仓 -race 36 包绿/集成六件绿/router MySQL 硬断言 p99=9.4ms·1620s;sqlite 口径 TestPick1000QPS 222/s 定性=无中间件环境差异非回归(测试自动探测 :13306)。
- **运行中**:gateway :8081(pid 232639)冒烟驻留;**24h 稳定性门槛 17:55 起计**(dmesg 零新增+进程零重启,首份快照 logs/1m-baseline.txt)。
- 归档仓(只读):/data/poc-archive/repos/go-sms.git(poc-final=5e09a4cc)。**Gitea 已闭环**:origin=`ssh://git@192.168.5.27:24401/Tory/go-sms-V2.git`(2026-11-13 push main=f1af4fb 20 提交 ✓;运营探讨入口=web 渲染 memory-bank/docs/Go-sms-重建计划.md)。
- **本会话运维教训**:①`pkill/pgrep -f` 自匹配四连(铁律:模式用 `[x]` 括号技巧或两步 PID 文件法);②docker 拉取大镜像单窗必须 >镜像体积/带宽(CH 950MB@1MB/s 需 1800s 窗,300s 窗永远截断大层);③du 无 sudo 静默失败会误诊"零字节停滞"。
## 重建启动(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`(宿主机休眠丢件对账退款)一并留档。
## 下一步(S1 主链搬运,B 层;《Go-sms-重建计划.md》5 工作日)
- **首动作**:compose 七中间件 up(SSD 基线参数先行:MySQL buffer_pool 16-24G 按 31G 内存折半取值、io_capacity 2000/10000、redo≥1G、Kafka flush 放宽)→ `make init-topics && make init-mysql && make init-schema` → 集成测试 -tags=integration 跑绿 → watch_1m.sh --once 首份快照。
- **B 层逐域搬运改造**(send 拆子包/去 dayNN 测试命名、access 72h 挂起制语义、report、router 空壳归位、channel 拆 pool/limiter、account/balance/interceptor)→ 验收=全包等价 -race 绿。
- FE 工具链(node/pnpm)于前端工作前安装;web/src/views 31 页随 B 层前端整包搬运(S3 收尾)。
- 24h 稳定性门槛(dmesg 零新增+进程零重启)为压测基线前置——随七中间件 up 后开始计时观察。
- 遗留观察项(随重建转移):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% 过,下一任务不得开工。