Files
go-sms-V2/CHANGELOG.md
T

218 lines
42 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-17(晚)· Issue#5:压测复盘报告归档(100 万条目标达成 +12.7%)
- **工单**:Gitea #5「压测:100万条」(11-16 16:23 提出,11-17 19:05 催报)——完整报告归档 `docs/acceptance/issue5-bench-report.md` 并回帖工单(Markdown)。
- **三场实况**:①白日场 vcmppgw 模拟上家(预检 2×1k+S1 1 万+S2 6.5 万@限速 200/s,p50/p99=8.8/17.4ms 零失败;数据已按恢复 SOP 清理);②夜间长短信段 18:32 起(5.1 万任务×均 3 片=15.4 万计费条)+③主战场 23:00~11-17 01:52 真上家 5.16(提交 199.9 万/下发成功 99.97 万/签名拦截 99.99 万 ISC:004 即时退款)。**下发成功合计 ≈112.7 万条 ✅ 超 100 万目标 12.7%**;受理均 194/30s 窗峰 287.9 QPS 且 **slow>200ms=0**,lag 峰 476/均 88,慢查询 0,双进程零重启。
- **计费三平 ✅ 分毫不差**:充值 10.0001 亿(2 笔)− 预扣 2,183,182 + 拦截退款 999,741 = 余额 998,826,559(基数 100 万);billing_consume_log/余额流水/明细计费三方一致;100 万级拦截即时退款零差错。账单/利润链路 11-14 S2 泳道已验收,压测数据未出账(出账四件套入下轮 SOP;推算毛利 ≈7.33 万/112.7 万条=时间线价演示口径)。
- **问题 6 项**:①R1 余额对账差额 P0 告警 ×33 次(典型 ±120~791 条+1 次 10 亿充值瞬时窗口,reconciler 5min 自愈覆写,无资损)待根修预扣-落账时序;②主战场 50% 流量签名拦截=压测脚本口径(内容未带报备签名,平台行为正确);③channel_log deliver_fail 2,652 条终态去向待复核;④长短信挂起 1,326 条 72h 制 **11-19 reaper 到期核验**;⑤channel host 配置不热切换(17:07 恢复后存量连接仍走 vcmppgw,受审 75,191 vs CSV 77,000 差=切换窗口分流)→ runbook 增补;⑥主战场客户端 CSV 未留档 → SOP 强制。
- **规划**:11-18 P0 整改(R1 根修或窗口豁免+告警分级/deliver_fail 复核/脚本签名对齐/host runbook)→ 11-19 正式场阶梯 200/500/1000 TPS×30min(长短信占比 30%/按通道 speed 扩连接/双通道);收尾四件套=出账→确认→结账+利润报表+settle-check EXIT=0+XLSX。
## 2026-11-16(晚六)· Issue#4:版本号 + 发布日志(侧栏红点 / 系统管理二级菜单 / 运营大白话 Markdown)
- **工单**:Gitea Issue#4「增加:版本号及发布日志」——①菜单底部折叠展开旁显示最新版本号,有更新红点闪烁;②系统管理新增二级菜单「发布日志」,功能迭代明细用运营能读懂的大白话 + Markdown。
- **单一事实源**:`web/src/data/releases.ts`(版本列表最新在前,`APP_VERSION = RELEASE_NOTES[0].version`);`package.json` version 0.1.0→**1.5.0** 同步,**tests/releases.spec.ts 断言两侧一致防漂移**;版本线 v1.0.0(11-13 平台一期上线)→ v1.5.0(11-16 客户对接打通+充值修复+本功能),文案全部运营向大白话(不写实现细节/工单号)。
- **侧栏版本 chip**:MainLayout sidebar-foot(折叠按钮旁)加 `router-link → /system/release`(data-testid=sidebar-version);**红点=浏览器本地"未读"语义**:localStorage `gosms_seen_ver` ≠ 当前版本即亮(CSS `gosms-ver-blink` 脉冲闪烁);首访无记录=亮(引导看一次发布日志);点击 chip / 进入发布日志页 `markSeen()` 即灭;发新版重新部署后全员自动再亮。折叠态(64px)chip 缩为无边框短版本(v1.5)纵向排布。
- **发布日志页**:`views/system/ReleaseLog.vue`(`defineOptions name='system-release'` 守门)+ 路由 `system/release`(**全角色**,同 faq 口径——发布日志本质是面向所有用户的平台公告,用户拍板;icon=Memo;subtitle=平台功能迭代明细·大白话版);时间线卡片=版本徽章+日期+标签(新功能/优化/修复)+「当前版本」角标。
- **迷你 Markdown 渲染器**(`utils/markdown.ts`,**零新依赖**):标题/无序有序列表(`1.` 与 `1、` 顿号中文习惯均支持)/粗体/行内代码(哨兵保护,code 内 `**` 不误判粗体)/围栏代码块/链接(**仅 http(s)**,javascript: 伪协议不渲染为 a);**先全量 HTML 转义再解析**——内容源虽是仓库静态数据仍按不可信文本处理,v-html 零注入面。
- **守门**:tests/releases.spec.ts **+14**(数据一致性 4:单一事实源/降序/semver/日期标签白名单;渲染器 7:格式+转义+伪协议+哨兵;store 3:首访亮/markSeen 灭+刷新持久/新版再亮);guard.spec 菜单计数 33→**34** 显式更;role-menu-matrix 登记 `system-release: ALL`;verify-layout.mjs **+8 断言(23→31)**:chip 可见/文本 vN.N/首访红点/点击跳转/已读即灭/版本卡片≥3/Markdown 列表渲染/回 home。
- **门禁**:eslint 0 警/vue-tsc 0/**vitest 179 全绿(165+14)**/build ✓/verify-layout 31/31 ✓(Chrome 实机)。
- **口径诚实标注**:红点为本地"未读"(换浏览器/清缓存会重新提示一次,无服务端已读同步——单机后台语义够用);移动端 ≤900 sidebar-foot 沿用既有隐藏约定(版本号仅桌面侧栏可见);发布内容=仓库静态数据,**发版 SOP=releases.ts 头部插一条 + package.json version 同步**,部署后全员红点亮起。验收单 `docs/acceptance/issue4-release-notes.md`。
## 2026-11-16(晚五)· Issue#3 联调闭环:客户(192.168.5.210)登录+提交+回执全链打通
- **登录**:15:47:13 `cmpp_conn_ok{s2demo, 192.168.5.210, ver=0x20}`+抓包 `CONNECT_RESP 2.0(21B) status=0` 双证——**-1 问题终结**(协议修复全链生效)。
- **首报"提交报错:0"定位**:4 次 `cmpp_submit_rejected 余额不足`(s2demo 余额=0,验证额度已还原所致);平台回 `MsgID=0+Result=10` → 客户端显示"0"。**充值 10000 条即恢复**。
- **重提闭环实证(15:58)**:3 次提交 30s stats 无 rejected;任务 4/5/6(source=2/CMPP)全 `status=2` 终态、明细全 `DELIVRD 送达`、fee=1 条/条计费正常——**客户确认「成功发送,状态正常返回」**。
- **抓包分析器已知限制(挂账)**:高频「心跳+提交」混合流 PDU 重组错位(重传/乱序容错分支拼接缺陷;本次 Submit 明细靠日志定论)——D30/P2 优化。
- **运维口径**:抓包常驻(`scripts/cmpp-capture.sh`);联调余额 10000 条挂账 s2demo。
## 2026-11-16(晚四)· Issue#3 联调装备:CMPP 抓包分析能力 + 连接日志补盲
- **背景**:客户重测在即,-1 类问题需「数据说话」——Connect 成功零日志+无抓包能力导致此前排查吃力(且上轮公网归因教训:通道表第一条即上游 5.16:7890,内网双 7890 并存,客户地址指向待确认)。
- **抓包**:`apt install tcpdump 4.99.5`(新机原未装);`scripts/cmpp-capture.sh`(start/stop/status/analyze;`-i any -s 0 -C 50 -W 6` 环形 300MB 防打爆;**坑留痕:tcpdump 4.x 写 pcap 默认降权 tcpdump 用户致 Permission denied,须 `-Z root`**;PID 用 pgrep 管理+启动失败即报 stderr)。
- **分析器**:`scripts/cmpp-analyze.py`(**纯 python 标准库零依赖**):pcap 魔数/纳秒自适应→链路层自适应(SLL/SLL2/以太+VLAN/RAW)→TCP 按 seq 重组(容重传/重叠)→CMPP PDU 按 TotalLength 切分;输出按连接分组时间线(时:分:秒.毫秒),CONNECT(sp/ver/ts)/CONNECT_RESP(**布局自动判定 21B=2.0/18B=3.0**+status 语义)/SUBMIT(srcid/码数/result)/DELIVER/心跳;**status≠0/result≠0 自动 ⚠️**;`analyze all` 合并环形切片。
- **日志补盲**:server.go `cmpp_conn_accepted{client_ip}`(TCP 到达即留痕)+`cmpp_conn_ok{source_addr,client_ip,ver}`(Connect 成功留痕)——与抓包时间戳毫秒级互证,「客户连没连上」从此可追溯。
- **自测实证**:三场景探针(本机正确密码 status=0/错误密码 status=2 ⚠️/上游 5.16 status=3 ⚠️)抓包时间线与 gateway 日志**毫秒级对齐**;顺带抓到 4 条上游通道连接心跳(运维流量可见)。
- **联调 SOP**:`cmpp-capture.sh start` → 客户连 → `stop`+`analyze` → 30 秒出结论(到达与否/卡在哪步/谁拒绝/布局版本是否匹配);与 `cmpp_conn_*` 日志双通道互证。
## 2026-11-16(晚三)· Issue#3 追报:客户连公网 7890 非 本平台 + CMPP 版本协商 + 弹窗防截断
- **「登录仍报 -1」根因(网络层,非协议)**:探针对照实证——**公网 121.46.230.53:7890 是另一个 CMPP 网关**(回 Status=3 拒绝,本平台码值从不返回 3),s2demo 在彼处不存在;**本平台 CMPP 服务在内网 192.168.5.18:7890**(同请求 Status=0 鉴权通过)且 gateway 日志零客户连接记录(请求未达)。**结论:客户交付的连接地址指向公网机上的第三方/旧平台网关;本平台无公网 CMPP 入口。**解法=公网机 nginx 加 TCP stream 反代(7890 已被占用须用新端口如 17890→192.168.5.18:7890,需运维执行,配置片段已交付);过渡期客户可内网直连 192.168.5.18:7890。
- **CMPP 版本协商加固(Issue#3 加固)**:服务端按客户端 Connect.Version(包体 offset22)应答——≥0x30 回 **3.0 布局**(1B Status/18B 包体/ISMG 串按 1B 参与/version 回显 0x30),否则 2.0(4B Status/21B);`ConnectResp.ClientVersion` 字段+Marshal/AuthenticatorISMG 双分支。**ISMG 鉴权串规范修正**:server 侧新增可选接口 `ISMGSecretSource`(access 实现=账号 ApiSecret),AuthenticatorISMG=MD5(Status+clientAuth+**shared_secret**)按规范掺入真密钥(此前 Secret 恒空串,严格校验 ISMG 的客户端必判失败——潜在 -1 源)。真机探针实证:2.0(21B/4B)与 3.0(18B/1B)Status=0 且**严格客户端视角重算 ISMG 串均匹配**。
- **系统配置弹窗防截断**:Chrome 实测本机 1280×720/1024×600 几何均在视口内(用户场景为小视口/缩放/长选项);防御性全覆盖——dialog `align-center`(垂直居中,实测 top=精确居中)+`append-to-body`(防布局层裁剪)+max-width 92vw+body max-height 62vh 内滚(footer 恒可见);el-select 选项改**两行模板**(key 等宽主行+中文说明副行,原单行拼接 label ≈520px>面板 396px 必然省略号截断)+选中已知键在下方显示生效说明(keyHint)。
- **测试 +2**:TestServer_ConnectVersion30(裸 TCP 第三方视角:0x30→18B/1B/version 回显,0x20→21B/4B 回归)、TestConnectRespVersion30Layout(3.0 布局往返+ISMG 1B 口径);fakeHandler 实现 ISMGSecret。
- **门禁**:vet 0/-race cmpp+access+sysconfig 三包绿(全量 42 包前轮已绿)/lint 0;eslint 0/vue-tsc 0/vitest 165;gateway 串行部署(md5 ✓)。
## 2026-11-16(晚二)· Issue#3 方案B:系统配置页 + 系统级默认接入码回退链
- **范围(用户拍板 A+B)**:「系统配置」占位页做实(system_config KV 管理面)+ SrcID 校验两级回退链(账号 ext_code 优先 → 系统默认 cmpp.default_ext_code 兜底 → 均空放行)。
- **sysconfig 域**(新包):Get(30s TTL 读缓存+缺行空值缓存)/List(cfg_key 升序)/Set(uk UPSERT:值/备注/操作人/时间;**写即刻失效缓存——区别于账号 ext_code 的 30s accCache 窗口,管理页改完即生效**);DB 错误降级空串=放行口径与账号级缺省一致。
- **回退链(access)**:`effectiveExtCode`(账号 ext_code 优先,空读系统默认;getter 未注入=行为不变);precheck 改返 (cfg,ext,result)——直发/长短信 submitFragment/SMPP SubmitSM 三路径统一用生效前缀(扩展码剥离口径一致);拒收日志加 from_system_default 辨识来源。
- **端点**:GET /system/config(登录即可)/ PUT /system/config(system:write——admin 直通,同 error-codes 口径;AuditTrail 写方法自动留痕 updated_by)。与 error-codes 同口径未进 openapi.yaml paths。
- **前端**:系统配置页 views/system(占位页转正:KV 表格+新增/编辑对话框,已知键下拉 cmpp.default_ext_code/uplink.blacklist.keywords 带运营提示,defineOptions name=system 守门);api/system.ts;路由 meta 加 subtitle;AccountDetail 两处文案改「未配置时回退系统默认接入码」。
- **真机闭环实证**(第三方 2.0 探针四态矩阵):账号 ext 空+系统默认 SYSDEF:106 → SYSDEF:10699 过(10)/10690331 拒(9)=**系统级接管**;恢复账号 10690331 → 10690331 过(10)/SYSDEF:10699 拒(9)=**账号级优先不叠加**;GET/PUT/UPSERT(updated_by 留痕+created_at 保留首插)全链过。生产值已设 **cmpp.default_ext_code=10690331**(未配置账号开箱即校验;账号级可覆盖)。
- **测试 +8**:sysconfig 4 件(缺行空串/UPSERT+缓存即刻失效(长 TTL 反证)/List 顺序/键值校验)+ access 回退 3 件(系统默认放行+拒/账号优先不叠加/双空放行回归)。
- **门禁**:vet 0/**-race 42 包全绿**(+1 新包)/lint 0;eslint 0/vue-tsc 0/vitest **165**/build 9.91s;gateway 串行部署(md5 比对 ✓)。
## 2026-11-16(晚)· Issue#3:CMPP 服务端连接报 -1 + 充值无响应 + SrcID 核验口径
- **工单**:Gitea Issue#3「Bug:服务端CMPP链接-1」——s2demo 作服务端账号客户连接报 -1;页面充值点击无响应;通道号(接入码)SrcID(≤21位)是否需要核验。
- **CMPP -1 根因**:`ConnectResp.Marshal` 把 Status 按 **1 字节**编码(18B 包体)= CMPP **3.0** 布局;而 **CMPP 2.0 规范 CMPP_CONNECT_RESP.Status 为 4 字节整数**(21B 包体;两版本恰与 SUBMIT_RESP.Result 互为镜像——2.0 Result=1B、3.0=4B,本项目 SubmitResp 按 2.0 实现且与真实上游联调通过,唯独 ConnectResp 误用 3.0 布局)。标准 2.0 客户端按 4B 大端解析读到 [status,MD5[0..2]] **恒非 0** → 客户端工具报 -1;自家客户端同按 1B 解析,自测格式对称掩盖缺陷(与 Day39 Submit 布局坑同构:模拟网关与实现同源同错)。
- **修复(body.go)**:①`Marshal` Status 4B 大端(21B 包体);②`AuthenticatorISMG` 中 Status 以 4B 参与 MD5(2.0 规范);③`ParseConnectResp` 自适应双布局(≥20B 按 2.0 4B;17~19B 按 3.0 1B 兼容;短包取首字节)——自家客户端连真实上游 2.0 网关不再靠「status=0 时 b[0] 恰为零」侥幸,拒绝码也能正确读出。
- **充值无响应根因(双重)**:①前端 `accountApi.recharge` 发 `{count,remark}`,后端 `rechargeReq` 要求 `{amount}`(`binding:"required,gt=0"`)→ 恒 400;②`AccountRecharge.vue` submit 无 catch,BizError 被静默吞掉 → 点击零反馈。修复:API 字段对齐 amount+mock 契约同步(msw handlers)+submit catch 提示(含 acc 未装载 warning 分支)。
- **SrcID 核验口径(用户裁定:方案 C 前缀+动态扩展,行业惯例)**:CMPP 2.0 协议 Src_ID 定长 21 字节(协议层硬约束,parse 天然截断);平台核验=账号 ext_code 非空时前缀匹配(不匹配回 Result=9)。**s2demo 已配置 ext_code=10690331**(通道接入码即分配前缀):客户 SrcID 须以 10690331 开头,可追加自定义扩展位(总长 ≤21,扩展 ≤13 位)区分业务——纯下发填 10690331,带扩展填 10690331xxx。AccountDetail 两处文案(接入信息+交付文本)明确「定长 ≤21 位+ext_code 前缀规则」,动态显示账号 ext_code。
- **方案 C 真机四场景实证**(第三方 2.0 探针,余额 0 零副作用):纯接入码 10690331→Result=10(过码校验,欠费拒);接入码+扩展 10690331001→Result=10(**前缀+动态扩展通过**);不匹配 10699999→Result=9;空 SrcID→Result=9。日志双事件留痕(cmpp_submit_src_prefix_mismatch/cmpp_submit_rejected)。**运营口径:ext_code 变更后受理热路径账号缓存 30s 内生效**(Day63 accCache TTL;真机首验踩到,等 30s 后四场景全中)。
- **真机实证**:标准 2.0 客户端探针(纯标准库,4B 解析视角)——修复前 18B/Status=3222621(复现 -1);修复后(串行 build→kill→md5 部署)21B/Status=0 连接成功 ✓,错误密码 Status=2(标准语义码);充值 curl:count→ISC:400(复现被吞报错)/amount→ISC:000 余额 0→100 ✓,冒烟数据已还原。
- **顺手修**:TestClient_LoginOK 时序竞争(网关 logins.Add 在 WritePacket 后,客户端握手完成与落账存在调度窗口,全量 -race 并行下偶发 0)→ 轮询 1s 吸收;全量复跑 **41 包全绿**。
- **门禁**:vet 0/-race 41 包/lint 0;eslint 0/vue-tsc 0/vitest **165**/build 9.88s。
## 2026-11-16(傍晚)· Issue#2:管理前端多标签导航 + 页签缓存
- **工单**:Gitea Issue#2「优化:管理前端V1」——增加菜单 Tab 页(可独立关闭/一次全部关闭),切换后页面状态保留。
- **多标签导航**:stores/tabs.ts(tab 身份=fullPath;home 固定不可关;登出 $reset 防跨角色残留)+TagsBar.vue(纯原生元素,aurora token 风格;✕ 独立关闭+中键关闭[auxclick button===1,@click.middle 对中键永不触发]+关闭其他+全部关闭;关当前回退相邻 tab 右邻优先)。
- **页签缓存**:MainLayout `<keep-alive :include="tabs.cachedNames">`+`:key="fullPath"`(参数页/查询变体独立实例);**29 个业务视图 defineOptions name=路由名**(28 新增+stats/profit 对齐;script setup 文件名推断名永不命中 include——15 个 index.vue 全叫 "index");ComingSoon(11 路由共用)刻意豁免(无本地状态,不缓存零副作用)。
- **守门**:view-cache-name.spec.ts 固化「组件名=路由名」约定(漏写=缓存静默失效,测试红而非线上发现)+MainLayout keep-alive 结构断言;verify-layout.mjs +5 项 tags-bar 断言(18→23)且凭据 env 化(SHOT_USER/SHOT_PASS 缺省 s2demo;内置 admin 原密码首启打印一次已不可知,原硬编码 admin123 已不可登录)。
- **门禁**:eslint0/vue-tsc0/vitest **165**(+17:tabs-store 7+守门 4+tags-bar 6)/build 9.99s(chunk 剖面不变);verify-layout **23/23**;Chrome 157 实机走查 **17/17** 含两项核心状态保留实证(结算页内 Tab 选中+筛选 账号ID=2 切走切回均保留);验收单 issue2-frontend-tabs.md。
## 2026-11-16(下午)· S4-D3:明细按天分区+CH 冷热切换——S4 泳道收官(三项验收全过)
- **分区**:迁移 v22 `PARTITION BY RANGE (id)`(雪花时间位当天零点边界,主键即分区键零唯一键改造;热 5 天+未来 3 天+pmax 兜底;MySQL 守卫 sqlite 跳过)+EnsurePartitions 幂等滚动(archive/partition.go);真机 9 分区落地存量无损。
- **归档**:archive 域(schema CH 表 toDate 分区/ArchiveJob 1h:CH 当日分区重写幂等→分批 2000 迁出→**count 校验相等才 DROP MySQL 分区/DELETE 兜底**=零丢失方向;consumer 装配启动即首轮)+metrics archive_rows/errors。
- **冷查**:GET /record/history(CH;task_no MySQL 转译回填;D26 契约直连)——**真机 16ms(<1s 验收线)**,mobile 筛选✓;history 导出挂账 D29 下载中心。
- **settle-check 热窗感知**:月中对账 DetailPartial=true→明细↔汇总退化两方基线(日汇总↔结算单;reconcile 头注预声明落地);settle.Service 时钟注入(nowFn)。
- **真机 5 连坑全修**(教训存档验收单):①MySQL 8.0 information_schema 对非分区表也返回 NULL 行(判据加 PARTITION_NAME IS NOT NULL)②parseTime 下 DATE() Scan []string 带 RFC3339 尾巴(改 DISTINCT 时刻 Scan []time.Time+Go 去重,双方言兼容)③CH 24.3 无 DROP PARTITION IF EXISTS(先查 system.parts)④CH count() 返回 UInt64(*int64 Scan 不支持;count 错误曾被吞致 total 恒 0)⑤CH 绑定 time.Time UTC 歧义(时间窗参数预格式化墙钟串)。
- **门禁**:build/vet/lint 0/-race **41 包全绿**;迁移测试 v16..v22 两遍幂等;archive 单测 5 件+settle 热窗外基线用例;settle 测试改相对时间+period 动态(v22 前固定日期在热窗外误触发新逻辑);gofmt 全仓零;验收单 s4-d3-partition-archive.md。
## 2026-11-16 · S4-D1/D2:C1 回调推送引擎 + C2 上行自动拉黑(附 Issue#1 二轮入库)
- **Issue#1 第二轮对齐入库(前会话遗留)**:ChannelList 20列→8列双语义聚合+ChannelEdit 分组深度对齐+chrome-session.mjs 工具;门禁复验四件全绿。
- **C1 回调推送引擎**:callback_task 队列表(v21,状态机 pending→sent/dead)+PushWorker(2s 扫/2^n 秒指数退避封顶 10min/10 次耗尽死信/UPDATE CAS 防竞态);挂点=report 终态首锁(与 CMPP Deliver 同点,Consumer+PairService 双链)+uplink 消费尾;URL 门控=account_config.report_url/uplink_url(60s TTL 缓存,未配置零开销);GET /ops/callback(列表+状态面板)+POST /ops/callback/:id/resend(死信重派);openapi v1.4.0;前端回调管理页(ops-callback 路由+api);metrics callback_push_total/blacklist_total。
- **C2 上行自动拉黑**:AutoBlacklister 等值词表(默认 R/TD/退订/拒收,trim+lower 防误伤;SystemConfig `uplink.blacklist.keywords` 可配 60s 刷新)→policy_blacklist(source=2/账号级/uk 幂等)→Redis Set 即时生效;**拉黑不影响上行推送**(需求原文,真机实证)。
- **真机全链**:回执 DELIVRD→detail 终态→HTTP 回调 JSON 送达接收端(status=1/200);上行 R→拉黑落库+Redis=1+推送送达;坏 URL→attempt 10→dead→resend ISC:000→修复后重投 sent;状态面板 status_counts={dead:1,sent:2};冒烟数据全清+一次性探针即删。
- **门禁**:build/vet/-race **40 包全绿**/lint 0;eslint0/vue-tsc0/**vitest 148**(matrix+ops-callback;guard 菜单 32→33 显式更)/build;迁移 v15..v21 两遍幂等+dev 库实跑 v21;gofmt 存量 8 文件顺手清零(S2 遗留)。
- **口径诚实标注**:载荷无签名(需求未定义,挂账);拦截终态 HTTP 回调未挂(CMPP 侧已有);PushWorker 单实例语义(多实例 at-least-once 同 CMPP Deliver);验收单 docs/acceptance/s4-d1d2-callback.md。
## 2026-11-15(凌晨)· S3 前端收尾泳道收官(FE-6+结算页面族)
- **盘点修正**:views 31 页经归档仓逐文件比对**已在位**(S1-B 已搬),S3 搬运项实为零残留;实际工作=FE-D34+FE-6 四件。
- **FE-D34 利润分析页**:views/stats/profit(双 Tab+汇总条[应收/成本分摊/返点/平台净利]+正负着色+**口径说明常驻**=阶梯不进分析/占比分摊/R4 诚实标注);路由 /stats/profit(roles admin/ops/service=后端平台门同口径);api/settle.ts +profitUsers/profitChannels;vitest 2 件(api 契约+组件挂载)。
- **FE-6·Mock 下线**:浏览器 mock 通道全链移除(main.ts worker 分支/browser.ts/worker.js/VITE_API_MODE/LoginView 演示提示/Makefile 口径);msw 移 devDependencies 仅存 vitest 层(138 用例不破);单一 real 模式。
- **FE-6·权限矩阵走查**:role-menu-matrix.spec.ts 五角色×33 菜单**固化矩阵快照**(人工语义确认,未登记新菜单=红);资金页对 group/customer 关闭抽样;8 件。
- **FE-6·性能**:manualChunks 拆 vendor——主包 1.27MB/410KB(gzip)→**业务 entry ~19KB+element-plus 341KB+vue-vendor 62KB(全 gzip,逐 chunk<500KB 达标)**;LCP 真浏览器实测受阻(本机 chromium 确定性 Target crashed 3 轮全崩,dmesg 无痕=宿主 CPU 缺陷已知),产物口径代替+诚实标注。
- **FE-6·CI+镜像化**:ci.yml +web-test job(node22+corepack pnpm[packageManager 钉 12.18.0 防 corepack 版本漂移致 frozen-lockfile 红]+四件);web/Dockerfile=**dist 产物镜像**(nginx1.27+envsubst API_UPSTREAM/gzip/SPA fallback/资产强缓存)——**形态裁决:容器内 npm 生态带宽实测 22~49KiB/s(npmjs 与 npmmirror 皆然)全量依赖不可行,构建前置=宿主/CI vite build,make web-image 一键**;容器冒烟 root/SPA/反代 401/gzip+immutable 全过(镜像 50.2MB);deploy/k8s/web.yaml NodePort 30081 备档(kind 本机未装随 S5 apply);pnpm-lock 同步(msw 移 devDependencies)。
- **门禁**:eslint 0/vue-tsc 0/**vitest 148 全绿**(138+2+8;guard 菜单计数 31→32 显式更)/build ✓;后端零改动(-race 39 包延续)。真机:dev 重启无 msw 引用+proxy→gw 401 应答+SPA 路由壳。验收单 `docs/acceptance/s3-closeout.md`(两项环境受阻如实标注:LCP 实测/chromium、kind 未装)。
## 2026-11-14(深夜③)· S2-D5 利润/返点/三方对账 —— **S2 泳道收官**
- **settle/profit.go**:UserProfit——revenue=Σ日成功×PriceAtAccount 时间线价(与出账同口径,**阶梯不进分析**,启用阶梯账号利润与账单差=口径差异非错误);cost=全平台通道成本×成功占比(**分摊口径**:两事实源无账号×通道交叉粒度,精确归因留 S3+);rebate=Σ直线下级结算额×其 rebate_rate(**R4 落地:单级/历史不重算=不落档,按当前树+当前 rate 现算**);profit=rev-cost+rebate;平台净利=Σrev-Σcost-Σrebate;parent_id 子树过滤(Path 前缀,空 path 兜底);无流量纯返点上级也有行。ChannelProfit——cost=Σ日成功×通道价;revenue=用户收入×通道成功占比(同分母,Σ守恒)。
- **settle/reconcile.go**:三方对账——账号=明细直查↔billing_consume_log↔settle_customer(条数);通道=明细↔stats_channel_daily;上家=日汇总×当前归并/billing_mode 重推↔账单快照(生成后换绑/改模式/重刷如实暴露);**金额不比**(快照语义,事后调价必生噪音,金额核对走 XLSX);bill_missing 单列不判失败;AllZero=S2 出口判据。
- **cmd/reconcile/settle-check**:`-period [-json]`,退出码 0=all_zero/1=有差异/2=错误;**handler +2 端点** /stats/profit/users·channels(平台角色门,缺省窗=本月至今);openapi v1.3.0 双端点描述对齐。
- **测试 5 件**:利润(树/返点/分摊/子树/纯返点上级/守恒)+通道(直算/分摊/过滤)+对账(全链 AllZero+篡改 consume/stats/删账单逐项暴露+missing 不判失败)+handler(数值/403/坏日期)。门禁 vet/**-race 39 包**/lint 0。
- **真机全链**:种 2026-10 空月(通道/上家 9101)→汇总 1/1→下家 0.2→阶梯覆写 0.1→结账 SettleRecord→上家 2/0.1→利润双端点(rev0.2 时间线 vs 账单 0.1=口径差异实证)→**settle-check all_zero=true EXIT=0(S2 出口判据达成)**→清理 11 项零残留。
- **走查脚本扩 D4/D5**(s2-walkthrough.sh D2~D5 全域+自动清理):AI 预走查 **27 PASS/0 FAIL**;**修复两处存量 bug**——D2 段明细 ID 9302… 超 int64 上限 MySQL 拒收(改 7302… 段)、D2/D3 清理段 $ON/$B0 单引号内不展开致 SQL 语法错(改 printf|mysql_pipe 外层展开)。
- **收官判定**:s2-closeout.md——出口两项(结算单测+对账差异 0)全 ✅,六项裁决 R1~R6 全闭环,**S2 泳道收官**(附在途补正:用户本人走查)。验收单 `docs/acceptance/s2-d5.md`。
## 2026-11-14(深夜②)· S2 结算验收页(用户感知断层补正:前端人工验收面)
- **动因**:用户裁决「需要人工前端页面验收」——S2 后端 D1~D4 不可见,评审者零感知;以最小可视化验收面补正(S3 结算页面族在此精修)。
- **交付**:views/settle/index.vue 四 Tab(消耗汇总+回补/订单创建-确认-驳回/账单生成-重算-确认-结账-导出-明细抽屉/阶梯增删)+api/settle.ts(12 端点+带 token 文件流下载)+路由点亮 settle 挂点+seed_settle_demo.sql(s2demo 登录账号/demo-cust/价格时间线月中调价/近 5 天消耗 19550 成功/待确认订单)+Playwright 预走查脚本。
- **门禁**:eslint 0/vue-tsc 0/vitest 138 全过/build 9.7s。
- **Playwright 真库闭环**:订单确认余额 5000→6000;账单 SC202611-2=19550 条×1955.00 元与价格时间线分毫不差;6 截图入 shots/。**留痕:casbin 策略启动时载内存,SQL 直插 g 规则需重启 gateway 生效**(403 排查实录);验收指引见 `docs/acceptance/s2-frontend-preview.md`。
## 2026-11-14(深夜)· S2-D4 出账引擎+阶梯(S2 显式验收项落地)
- **settle/price.go(R1/R6 唯一换算点)**:PriceAtAccount(业务线×时间线回溯)/PriceAtChannel/LadderPrice(月量落档)。D4-0 六口径(Q1 无价 0 元入账/Q2 阶梯整月覆写/Q3 all=submit/Q4 当前 upstream 归并/Q5 全业务合并/Q6 状态机)经方案批准生效。
- **settle/bill.go**:下家/上家生成(uk UPSERT 幂等重算,已结 skipped)+确认(0→1)+结账(1→2 CAS+SettleRecord 金额快照同事务)+按天明细+ladder CRUD;**settle/export.go** excelize 双导出(下家按天/上家通道×天)。
- **handler 15 端点**(settle:write 门;customer 账单仅自己;上家平台角色)。
- **测试 6 件**:**阶梯结算单测(S2 显式验收项)**——首档覆写/恰好落档边界/删档回退时间线;月中调价按日分档;上家三口径+未绑通道不入账;状态机+SettleRecord+终态幂等;handler 全流程(生成→配档重算→确认→结账→skipped→导出 PK→403)。
- **真机出账全链**:生成 10→配阶梯重算 5→结账 SettleRecord(direction/amount 快照)→已结 skipped→**5637 字节真 XLSX**;数据还原。门禁 vet/**-race 39 包**/lint 0。修复留痕:Pluck 链式列污染→Select+Scan;isDuplicateKey 大小写归一;idx_period 同名方言坑第三例。验收单 `docs/acceptance/s2-d4.md`;**用户走查脚本** `docs/acceptance/scripts/s2-walkthrough.sh`(D2/D3 覆盖,本人走查项补正在途)。
## 2026-11-14(夜)· S2-D3 充值审核流(R3 双通道落地)
- **settle/recharge.go**:CreateOrder(pay_status=0 不动余额;OrderNo=B+时间戳+4 随机,uk 重试)/ConfirmOrder(**单事务=状态 CAS(WHERE pay_status=0→ISC:039)→余额原子自增 count→同事务回读→流水 ref_id=order_no**——双通道天然区分:即时充值流水 ref_id 空)/RejectOrder(0→2 不涉余额)/ListOrders。
- **ISC:039 订单状态冲突(409)** 新增,三处同步(codes.go+registry+x-isc-dict+dict.ts 52 码;openapi_sync_test/codes_test 断言随更)。
- **四端点**:列表(平台角色,group/customer 403)+创建/confirm/reject(account:recharge 二级权限同即时充值);审计自动留痕 module=billing。
- **测试 7 件**:创建校验/confirm 事务语义/状态机(409 且余额二次不变)/**并发 confirm 恰一成功(-race)**/驳回/列表/handler 全流程+双 403。
- **真机全链冒烟**(HS256 临时 token+dev secret 非侵入):创建零动余额→confirm 余额 0→123→重复 409 ISC:039;真库核验流水 ref_id 关联+审计留痕两设计实证;清理还原(审计行保留为证据)。门禁:vet/**-race 39 包**/lint 0。验收单 `docs/acceptance/s2-d3.md`。
## 2026-11-14(傍晚)· S2-D2 消耗日汇总引擎(settle 域首批业务代码)
- **settle/consume.go**:AggregateDay 账号×业务→billing_consume_log、通道→stats_channel_daily(GROUP BY+SUM(status=N)+[lo,hi) 半开窗双方言、OnConflict 复合 uk UPSERT、cost_total 不写守 R1)+ListConsume(时间窗按天归一修复:零点行不被带时刻参数误滤)。
- **滚动重刷模型(D1 计划关键修正)**:单日 T+1 落账在 72h 回执窗内会失真(UNKNOWN→成功迁移)→ 周期(1h)重刷近 4 天幂等收敛+启动回补 7 天;月结建议 T+4 后生成。job.go 照 StartStatsRefresher 模式(失败 Warn 自愈+errors 计数器)。
- **两端点**:GET /billing/consume(customer/group 强制收窄自身,越权带参覆盖)/POST /ops/settle/aggregate(settle:write 手动回补);Deps.Settle 装配+config.Settle 段+metrics 两件(go_sms_settle_aggregate_rows_total/errors_total)。
- **测试 6 件**(sqlite):正确性/幂等+跨天边界/**UNKNOWN 迁移收敛**/过滤分页/customer 收窄/手动回补+坏日期。
- **门禁**:vet 0/**-race 39 包零 FAIL**/lint 0;**真 MySQL 实机闭环**:种 3 条明细→启动回补落账逐列正确→UPDATE status 重启重刷收敛(success 1→2/unknown 1→0)→清理+三轮重驻 md5 一致。验收单 `docs/acceptance/s2-d2.md`。
## 2026-11-14(18:02)· 24h 稳定性门槛期满核验终判通过(S1 最后一项挂账清偿)
- **终判 ✅**:核验三项全绿——①dmesg 崩溃计数(segfault/sigill/error 25)=0(11-13 21:33 宿主重启清零后全窗零新增);②九中间件 Up 20 hours 全 healthy(自愈拉起后观察窗零重启);③gateway 同 PID 53153 驻留 19h47m+/health ok+md5 比对一致(ecf71db6…)。期内唯一事件=11-13 21:33 宿主内核升级主动有序重启(用户裁决:已知事件如实记录不判失败)。
- **影响**:S5 压测基线前置资格确认(CPU Plan B 复现率 0 + 24h 稳定性双前置全过);s1-b-closeout.md 第 6 项 ⏳→✅,**S1 泳道完全闭环**。
## 2026-11-14(上午)· S2-D1 结算域表设计评审 + 迁移 v20 + 契约草案
- **S2 结算域开工(D 层,5 工作日,出口=结算单测+对账差异 0)**。方案细化(12 维上下文研读+代码实证:结算 5 表 v0 已建且业务代码零使用/StatsUserDaily·StatsChannelDaily 双空壳/明细 Fee=片数非金额/v16 已建通道聚合索引)→ **六项表设计裁决定稿**(`docs/review/s2-settle-table-review.md`):R1 出账时刻计价(用户拍板:明细 Fee 保持片数、**send 域零改动**,金额=Σ日成功条数×生效单价按时间线+阶梯推导)/R2 消耗事实源统一 billing_consume_log+stats_channel_daily、**stats_user_daily 废弃**/R3 充值双通道(即时到账保留+BillingOrder 审核流)/R4 rebate_rate 单级返点、历史不重算/R5 settle_ladder 阶梯表/R6 条/元口径单点换算(出账引擎)。
- **迁移 v20_settle_domain**:billing_consume_log +unknown_count/updated_at;account_user +rebate_rate;DROP stats_user_daily;新表 settle_ladder;casbin 补 ops settle:write/customer settle:read(NOT EXISTS 逐条守卫)。加列=显式 SQL+HasColumn 守卫、空库=HasTable 守卫整表 AutoMigrate(v16/v17 抹索引教训,三路径收敛);**零新增索引**(复用 v16 idx_detail_channel_created);init_schema.sql 不动(Day11 基线惯例)。实体同步(All() 39 个,SettleLadder 随 v18/v19 惯例不进 All())。
- **openapi v1.3.0 契约草案**:+20 端点(billing/orders 审核族/consume 消耗查询/settle customer·upstream 生成-确认-结账-导出/ladder 阶梯 CRUD/profit 双分析/ops 手动汇总),js-yaml 解析 84 paths 通过;gen-dict 无新增 x-isc-dict 零影响。
- **门禁全绿**:vet 0 / **-race 全量 38 包 ok 零 FAIL** / lint 0 issues / 迁移单测(末七窗口 v14..v20 两遍幂等+五项 v20 断言)/ 集成 TestMySQL_AutoMigrate 39 表 + Casbin PASS;**dev 库实跑 v19→v20**(存量 ALTER 路径)+ information_schema 五项核验全过。验收单 `docs/acceptance/s2-d1.md`。
## 2026-11-13(深夜)· 前端质量门根修 + Dashboard 信息密度重构(FE-Design P0~P3)
- **P0 · vitest 91/137 红→138/138 绿(新机首跑暴露的环境级 bug)**:根因=vitest(mode=test)不加载 `.env.development` → `request.ts` 模块顶层 `baseURL=undefined`,而各 spec 内 `vi.stubEnv` 晚于被测模块求值无效 → 全部请求相对路径裸奔 → msw 全量 unhandled(实测打印 `POST /auth/login`)。老机靠 gitignored 本地 env 掩盖。修法=**`vitest.setup.ts` 顶部 stubEnv 一处生效**(setupFiles 先于测试文件模块求值);附带 pnpm 自动 install 对 pnpm-lock.yaml 的无关重排已回滚(最小变更纪律)。
- **P1 · DashboardView 信息密度重构**(12 维 rubric 审计 54/110「精美的快照」档→反模式"假装全知"3 处实锤):①删三处假数据——`rateNow=1180+random(160)` 假实时速率卡、8 条硬编码"示例"通道表、快捷卡死文案("5 条待复核/1,204 条可补");②假速率卡→**真"待人工审核"卡**(接口 `pending_audit_count` 早已返回但 UI 从未消费);③新增 **Hero 决策句**(四指标实时翻译为一句话判定 ok/warn/err/dim + 直达处置页);④**数据脉象**:live-chip 升级"实时·HH:MM:SS/连接异常·数据截至/不可用·重试"三态,catch 不再静默吞错;⑤通道表接 `channelApi.list` 真配置域(code/协议/运营商/限速/连接/优先级/状态),表头诚实标注"运行统计待 S5 压测后接入";⑥快捷卡 desc 与实时指标联动;⑦走势 7/30 日切换(mock/后端 trend(days) 双端已支持)。
- **P2 · 图标体系统一**:指标卡 emoji(📮✓⚡⚠)与快捷卡几何符号(✉≡↻◐)→ EP icon 全局体系(brand ✦ 保留),消除三体系并存。
- **P3 · 细节打磨**:指标数字 count-up(rAF 600ms easeOutCubic,`prefers-reduced-motion` 跳过)、走势图 hover 十字线+气泡(纯 SVG 零依赖,x 轴 30d 抽稀)、全局 `:focus-visible` 键盘焦点(aurora 主色)。
- **附 · Teleport 冷启动竞态修复(实锤级,旧版潜伏同病)**:`#page-head-extra`(MainLayout 渲染)晚于 Dashboard mount 时(Vue 3.4 无 `<Teleport defer>`)直接挂载 → 后续 patch 崩溃(`TypeError: setText null nodeValue`,fe_error_log 实证)→ **组件更新全中断**(API 已 200 返回但 UI 冻结在初始态,msw 数据永远进不来);修法=v-if 门控 nextTick 后挂载。新机慢冷启动放大暴露了旧版同样存在的病根。
- **实机验证(Playwright)**:verify-layout **18 断言全过** + 自建 Dashboard **15 项运行时断言全过**(hero warn 态文案/审核卡=12/假卡已删/脉象三态/快捷联动/通道表 3 行真数据+停用徽章/30 日切换/hover 气泡);截图矩阵 5 页×双主题重刷;验收单 `docs/acceptance/fe-dashboard-density.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 待七中间件起后跑。