42 KiB
42 KiB
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.jsonversion 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);红点=浏览器本地"未读"语义:localStoragegosms_seen_ver≠ 当前版本即亮(CSSgosms-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):①
MarshalStatus 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.vuesubmit 无 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)。e47610fA 层整包搬运 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 -cover23 包全绿 65s(sqlite/miniredis 离线口径);集成 -tags=integration 待七中间件起后跑。