Files
go-sms-V2/CHANGELOG.md
T

53 lines
6.7 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.
# Changelog(go-sms-v2 重建仓)
> 本仓 CHANGELOG 自重建起记(POC 明细见归档仓 /data/poc-archive/repos/go-sms.git 的 CHANGELOG.md,已冻结)。
## 2026-11-13(深夜)· 24h 门槛维持原时间核验 + gateway 重驻留(gw-start 幂等/pid 双 bug 根修)
- **事件**:11-13 21:33 宿主主动有序重启(当日内核 6.12.107→6.12.116 升级后二次重启;`last`=shutdown 有序记录,非崩溃)打断 24h 稳定性门槛观察窗(17:55 起计)——**按用户裁决:重启=已知事件如实记录不判失败,门槛维持原时间 11-14 17:55 期满核验**(S5 压测基线前置;dmesg 重启后清零,核验窗以重启后 dmesg 为准)。
- **重启后自愈核验**:九中间件 restart policy 全自动拉起 healthy;gateway 重驻(:8080,health ok/metrics 200,**md5 比对一致**,部署铁律)。
- **gw-start 双 bug 根修**(D1 遗留,幂等从未真正生效过):①pid 写入 `$!` 被 make 吞成空串→`$$!`;②**幂等短路 `exit 0` 只退出当前 recipe 行的 shell,make 继续执行后续行**——网关在跑时重跑 gw-start 会重复 build+nohup(新进程 bind 失败即死,health 打到老网关假成功,pid 文件被死 pid 污染);修法=幂等行 if/else 递归 `$(MAKE) gw-start-real`(curl /health 探活替代端口 grep——端口被占≠网关在跑);gw-stop 增强 pid 文件失效时按端口兜底。三场景实测:在跑跳过 ✓/脏 pid 按端口停 ✓/干净启动+md5 一致 ✓。**诊断教训留痕:`| tail -N` 截掉首行">> 网关已在"致两轮误诊"玄学 NOMATCH"——排查管道类输出须看全量**。
- 三处 :8081 陈旧注释校准(端口归位 8080 遗留)。
## 2026-11-13(夜)· S1-B 收口五件 + S1 泳道收官
- **send P2 拆三子包**(0550f2a):submit/consume/dispatch + facade 别名门面(外部零改动),契约族(事件/状态常量)迁 submit 并导出,依赖单向无环;**dayNN 19 文件语义改名**(5ccca41);**storage minio→s3 归一**(b499b66);**audit_mode=2 文案校准**(「2自动拒绝」→「2自动审核·黑词」,后端 2+openapi 1+前端已对);**gofmt 存量清零**(e9b70ea)。
- **S1 泳道出口判定 ✅**:B 层搬运+三项结构改造+迁移链落地+**全仓 -race 38 包 RC=0**+lint 0+集成七件绿;验收单 `docs/acceptance/s1-b-closeout.md`(24h 稳定性门槛在途,11-14 17:55 期满回填)。
- 唯一测试适配:clickhouse TestInsertSQL 断言随标识符反引号化更新(非业务语义)。
## 2026-11-13(晚)· 对象存储 MinIO→RustFS 切换
- **动因**:MinIO 社区版收费化;**方案=换服务端不换客户端**(minio-go SDK=Apache 2.0 通用 S3 客户端无授权风险)。
- compose `minio:`→`rustfs:`(rustfs/rustfs:1.0.5,346MB;宿主端口 19010/19011 沿用→应用配置零改动;RUSTFS_ACCESS_KEY/SECRET_KEY;healthcheck 双路径兜底);volume minio-data→rustfs-data。
- **实测兼容**:storage.NewMinIO 直连 RustFS——认证/MakeBucket 幂等/Put/覆盖写全通;新增集成测试 `TestStorage_RustFS_S3Compat`(不可达自动 skip),全量集成七件 RC=0。
- config.dev.yaml minio 段注释标注后端=RustFS(键名沿用);**D1 遗留 minio 镜像拉取项销账**;`pkg/storage/minio.go` 命名归一(minio→s3)留 S1-B 收口批次。
## 2026-11-13(晚)· 内网 Gitea 上库(协作触发条款生效)
- 独立机 Gitea(192.168.5.27:24401)验证通过(Tory/公钥「5.18 SmsDev」);`origin` 落位,**push main=f1af4fb(20 提交,~3.4MB 内网秒级)**;push 纪律=日终随 bundle;托管裁决修订与网络事实修正见 techContext。
## 2026-11-13(下午)· S1-B D1 中间件就绪 + B 层全域 P1 搬运 + channel P2 + D5-P1 + lint 清零
- **D1.1/1.2**(5986680):compose SSD 基线(MySQL 10G/2000/10000/redo 1G 实测生效)+ Kafka 恢复 compose 管理(新网络 QUORUM_VOTERS 自解析,healthy)。
- **D1.3-1.6**:9 镜像 8 就位(minio 遗留,见验收单);init 链全通;**迁移链 v1~v19 空库独建+seed-admin**(发现:init_schema 快照与迁移链双跑 FK 冲突,快照降级参考资产);集成六件绿;首份 SSD 基线快照+24h 门槛起计;gateway :8081 冒烟 ok。
- **B 层 P1 全域 12 域落位**(interceptor/template/auth/account/channel/router/send/report/openapi/access/uplink/api+cmd),两阶段等价法;唯一跨域适配=channel.{LinkStatus,Receipt,BatchAck}→pool.*。
- **D2.5-P2**(234dc5e):channel 拆 pool 子包(Deps 六方法断环/LogKind 移驻/测试 pool_test 化/访问器补齐),行为零改动双绿。
- **D5-P1**(5c8393e):api 38 文件+双入口,gateway 65.9MB 编译通。
- **lint 清零**(e03b63d):27 条→0;全仓 -race 36 包绿;router MySQL 硬断言 p99=9.4ms/1620s。
- **修直**:集成测试连字符标识符反引号化×3+BatchInsert 实现侧引号化(0e4c79d);watch_1m 端口参数化(704f6f0)。
- 验收单:`docs/acceptance/s1-b-layer-d1.md`。
## 2026-11-13 · S1①环境 + S1②git init/A 层搬运
### S1① 环境四件 + 编译循环终验
- **Docker CE 29.7.2** + compose plugin v5.5.0 + buildx 0.36.1 + containerd 2.3.3(aliyun docker-ce trixie 源,apt https 中途停滞 → curl 熔断续传 + dpkg -i 直装);data-root=/data/docker;registry-mirrors=daocloud+1ms;user 入 docker 组;json-file 日志轮转 50m×3;hello-world 拉跑 ✓。
- **Go 1.25.0**(/usr/local/go,aliyun golang 镜像,sha256 `2852af0c…b613` 校验 ✓;GOPROXY=goproxy.cn,direct / GOTOOLCHAIN=local / GOFLAGS=-mod=mod;模块缓存预热 434M)+ **gcc 14.2**(-race 前置)+ **golangci-lint v2.1.6**(~/go/bin)。
- **编译循环终验(CPU Plan B,设计规范 §6)**:20 轮 `go clean -cache` + `go build ./...`,≈35-48s/轮,复现率 **0**、dmesg 零新增 → 裁决**正常推进**(Go 工具链对宿主 VEX 缺陷免疫坐实)。
- 备份 cron:`30 3 * * * /usr/local/sbin/backup-v2.sh` → /data/backup/v2-YYYY-MM-DD.bundle(保留 14 天;首份已落)。
### S1② git init 新历史 + A 层搬运
- `2a6a66f` 地基:memory-bank 全文库 + .clinerules + README + .gitignore(自 poc-final 5e09a4cc)。
- `e47610f` **A 层整包搬运 273 文件 +33973**(源=poc-final,零改动;module 名保持 `go-sms`):协议四栈 / pkg 标准件 12 包 / util 计费纯函数 / middleware / 迁移链 repository·mysql v1~v19 + clickhouse / model·entity / config / service·audit·balance / app / cmd·{migrate,reconcile,cmppbench} / tools·gen-dict / _bench / test·integration / api·openapi.yaml / 监控三件 / 运维资产(compose+kind+CI 两套+Makefile+runbook+scripts 种子)/ cspell / 前端基建(web 根配置 + src 基建目录,mocks 51 端点;views 31 页留 B 层)。
- 支撑闭包口径:A 层 + config/entity/repository×2/audit/balance/app 六件(middleware、reconcile、migrate、集成测试的最小依赖闭包,零 B 层拖带)。
- **质量门**:build ✓ / vet ✓ / `go test -race -cover` **23 包全绿 65s**(sqlite/miniredis 离线口径);集成 -tags=integration 待七中间件起后跑。