From f1af4fbff9cccb31a17aa7eeadce2828af9dfe5c Mon Sep 17 00:00:00 2001 From: Tory Date: Fri, 13 Nov 2026 17:58:54 +0800 Subject: [PATCH] =?UTF-8?q?S1-B=20D1=20=E6=94=B6=E5=B0=BE=E5=AF=B9?= =?UTF-8?q?=E8=B4=A6:=20=E9=AA=8C=E6=94=B6=E5=8D=95=20s1-b-layer-d1+CHANGE?= =?UTF-8?q?LOG+memory-bank=20=E5=9B=9E=E5=A1=AB(activeContext=20=E5=BF=AB?= =?UTF-8?q?=E7=85=A7/progress=20=E8=A1=A8)=E2=80=94=E2=80=9414=20=E6=8F=90?= =?UTF-8?q?=E4=BA=A4=E6=97=A5=E7=BB=88=E6=80=81;=E9=81=97=E7=95=99=3Dminio?= =?UTF-8?q?=20=E9=95=9C=E5=83=8F/send=20P2=20=E6=8B=86=E5=8C=85/dayNN=20?= =?UTF-8?q?=E6=94=B9=E5=90=8D/=E6=96=87=E6=A1=88=E6=A0=A1=E5=87=86/gofmt?= =?UTF-8?q?=20=E5=AD=98=E9=87=8F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- CHANGELOG.md | 11 ++++++++ docs/acceptance/s1-b-layer-d1.md | 45 ++++++++++++++++++++++++++++++++ memory-bank/activeContext.md | 16 +++++++----- memory-bank/progress.md | 4 ++- 4 files changed, 68 insertions(+), 8 deletions(-) create mode 100644 docs/acceptance/s1-b-layer-d1.md diff --git a/CHANGELOG.md b/CHANGELOG.md index 09964fcc..798d8aaf 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,6 +2,17 @@ > 本仓 CHANGELOG 自重建起记(POC 明细见归档仓 /data/poc-archive/repos/go-sms.git 的 CHANGELOG.md,已冻结)。 +## 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① 环境四件 + 编译循环终验 diff --git a/docs/acceptance/s1-b-layer-d1.md b/docs/acceptance/s1-b-layer-d1.md new file mode 100644 index 00000000..d1fe4784 --- /dev/null +++ b/docs/acceptance/s1-b-layer-d1.md @@ -0,0 +1,45 @@ +# S1-B 主链搬运 人工验收单(2026-11-13:D1 中间件就绪 + D2/D3-P1/D4/D5-P1 域搬运 + lint 清零) + +> 执行=Cline/用户;方法=两阶段等价法(P1 整包搬运绿→P2 结构改造绿);证据=本机实测输出。 + +## 一、D1 中间件与基线 + +| # | 用例 | 结果 | 证据 | +|---|---|---|---| +| 1 | compose SSD 改造生效 | ✅ | `@@innodb_buffer_pool_size`=10G / io_capacity=2000 / max=10000 / redo=1024M | +| 2 | Kafka 恢复 compose 管理 | ✅ | go-sms-kafka healthy(QUORUM_VOTERS=服务名自解析,新网络无老坑) | +| 3 | 8/9 容器 healthy | ✅ | mysql/redis/kafka/etcd/clickhouse healthy + prom/am/jaeger Up(minio 见遗留) | +| 4 | init 链 | ✅ | 4 topic×3 分区;迁移链 v1~v19 全量落地(空库由 gormigrate 独建,**init_schema 快照与迁移链双跑会 FK 冲突——init_schema 降级为参考资产**) | +| 5 | seed-admin | ✅ | admin 创建,密码仅打印一次 | +| 6 | 集成测试六件 | ✅ | `-tags=integration` RC=0(MySQL AutoMigrate 36 表/Kafka 生产消费/DLQ 消费组/CH BatchInsert/casbin/cache_lock) | +| 7 | 首份 SSD 基线快照 | ✅ | logs/1m-baseline.txt;watch_1m 修复后 gw=PID+metrics 全采;**24h 稳定性门槛 17:55 起计** | +| 8 | gateway 装配冒烟 | ✅ | bin/gateway :8081 /health=ok,/metrics 92 指标族 | + +## 二、B 层搬运(两阶段等价) + +| 域 | 文件 | P1 | P2 | 覆盖率 | +|---|---|---|---|---| +| interceptor | 13 | ✅ a3a180a | — | 86.1% | +| template | 2 | ✅ 9ae2742 | 文案校准待收口 | 83.0% | +| auth | 6 | ✅ f4723d4 | — | 91.2% | +| account | 14 | ✅ 838937d | audit_mode=2 待收口 | 82.8% | +| channel | 18 | ✅ 5ce1d09 | ✅ 234dc5e 拆 pool 子包 | 77.3%+pool 62.3% | +| router | 9 | ✅ 0e4c79d | 空壳消除(internal/router 未迁) | 82.1% | +| send | 26 | ✅ 4e44d3a | 拆三子包=下工作项 | 79.8% | +| report | 14 | ✅ 11ee6f4 | — | 47.5%(离线口径) | +| openapi | 4 | ✅ 55dd0ba | — | 73.4% | +| access | 6 | ✅ 2434b1d | 审计模板项 | 73.3% | +| uplink | 3 | ✅ 39e8da6 | — | 78.9% | +| api/http/v1 | 38 | ✅ 5c8393e | dayNN 改名待收口 | 50.3% | +| cmd gateway/consumer | — | ✅ 5c8393e | gateway 65.9MB 可编译 | — | + +## 三、门禁 + +- `go build ./...` ✓ / `go vet ./...` ✓ / **golangci-lint v2.1.6 首跑 27 条→清零**(errcheck 21+staticcheck 2+unused 4+ineffassign 2,全部最小修复) / 全仓 -race 36 包绿(router MySQL 硬断言 p99=9.4ms<10ms 线,吞吐 1620/s)。 +- **sqlite 模式 TestPick1000QPS 222/s<300 现象定性**:测试自动探测 :13306,老机门禁常开 MySQL=硬断言口径;新机无中间件时落 sqlite 参考口径。非回归,已实证。 + +## 四、遗留(不阻塞) + +1. **minio 镜像**:docker hub 直连不通+daocloud/1ms 缺旧 tag `RELEASE.2024-06-13T22-53-53Z`;1panel.live 有清单但单层反复重试(后台续);备用=老机 docker save 摆渡(~160MB/FC 1.5MB/s≈2min)。集成测试与主链不依赖 minio。 +2. send P2 拆包(submit/consume/dispatch)+ dayNN 九文件语义改名 + account/template 文案校准 → 下工作日。 +3. gofmt 存量 20 文件非格式化(POC 历史状态,lint 门禁不含 gofmt;待议专项)。 diff --git a/memory-bank/activeContext.md b/memory-bank/activeContext.md index 34a62962..70fc15dc 100644 --- a/memory-bank/activeContext.md +++ b/memory-bank/activeContext.md @@ -1,13 +1,15 @@ # 当前工作上下文(最近更新:2026-11-12) -## 当前状态快照(2026-11-13,S1①② 完成日) +## 当前状态快照(2026-11-13 晚,S1-B D1+B 层全域 P1 完成日) -- **仓库**:`/data/go-sms-v2` 新历史 main = `2a6a66f`(地基:memory-bank 全文库/.clinerules/.gitignore)→ `e47610f`(**A 层搬运 273 文件 +33973**,源=poc-final 5e09a4cc);module 名保持 `go-sms`(A 层零 touch,import 路径不变);工作树干净;每日 03:30 cron bundle → /data/backup(设计规范 §7)。 -- **S1 环境四件(2026-11-13 就位)**:Docker CE 29.7.2+compose v5.5.0+buildx(data-root=/data/docker;registry-mirrors=daocloud+1ms,docker hub 直连超时)/ Go 1.25.0(/usr/local/go,sha256 ✓,GOPROXY=goproxy.cn,模块缓存 434M 预热)/ gcc 14.2(-race 前置,无 gcc 时 CGO_ENABLED=0 拒跑)/ golangci-lint v2.1.6(~/go/bin)。 -- **A 层质量门实测(2026-11-13)**:`go build ./...` ✓(热缓存 5s)/ `go vet ./...` ✓ / **`go test -race -cover ./...` 23 包全绿 65s**(config/middleware/pkg×11/protocol×4/repository×2/service·audit·balance/util+fileparse;sqlite/miniredis 离线口径;集成 -tags=integration 待七中间件起后跑)。 -- **编译循环终验(CPU Plan B,设计规范 §6)**:20 轮 clean-cache 全量 build ≈35s/轮,**复现率 0、dmesg 零新增** → 裁决=正常推进(Go 工具链对 VEX 缺陷免疫结论坐实)。 -- **A 层搬运闭包口径**:清单 A 层 + 6 支撑包(config/model·entity/repository·{mysql,clickhouse}/service·audit·balance + app 单文件)——middleware→service/audit、reconcile→app+balance、migrate/集成测试→config+repository 的最小闭包,零 B 层拖带;web/src/views(31 页)留 B 层。 -- 归档仓(只读参考):/data/poc-archive/repos/go-sms.git(poc-final=5e09a4cc)。 +- **仓库**: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:独立内网机人工建设中,授权后推码(挂起)。 +- **本会话运维教训**:①`pkill/pgrep -f` 自匹配四连(铁律:模式用 `[x]` 括号技巧或两步 PID 文件法);②docker 拉取大镜像单窗必须 >镜像体积/带宽(CH 950MB@1MB/s 需 1800s 窗,300s 窗永远截断大层);③du 无 sudo 静默失败会误诊"零字节停滞"。 ## 重建启动(2026-11-12 裁决 / 盘点 / 迁移方案) diff --git a/memory-bank/progress.md b/memory-bank/progress.md index aa571fe5..ece3e7ce 100644 --- a/memory-bank/progress.md +++ b/memory-bank/progress.md @@ -8,7 +8,9 @@ | 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 层) | send/access/report/router/channel/account/balance/interceptor + 迁移链落地 + compose 七中间件(SSD 基线参数) | ⬜ 下一步 | +| 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 拆三子包/dayNN 九文件语义改名/account·template 文案校准/minio 镜像/gofmt 存量 20 文件待议 | ⬜ 下工作日 | | S2~S5 | 结算域/前端收尾/C1C2+冷热/基线与灰度 | ⬜ 见《Go-sms-重建计划.md》 |