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

131 lines
23 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-17 B2 收官,新会话从 B3 开工)
## 🔧 Issue#6 附加轮·下拉菜单视觉契约修复 F1~F4 已闭环(2026-11-17,3 commits 6e6f5caf/bfdaf901/1ecd5fd9+Gitea#6 评论 201)
- **F1 根因(P3 遗留漏网)**:ep-theme 漏 html.dark 双写→EP 官方 dark/css-vars 以特异性 0,1,1 覆盖 :root 颜色族→暗色下 EP 组件回退原生 #141414 与 slate token 割裂;修复=双写+--el-select-* 9 变量族;**惠及旧 web/ 全站 EP 组件暗色**。教训:DOM 断言必须含 EP 组件 computed 层。
- **F2 契约桥**:选项 padding 10/16/选中=primary-soft 底+primary-600 字/hover 中性/弹层圆角 4→12/dropdown-item flex-start。
- **F3 ScSelect 统一封装**(`web/src/components/ScSelect.vue`):options 数组模式 auto>5 自动 filterable(sub2api searchable=auto 同源);downlink 来源(4 项)/状态(6 项)正反示范;新代码下拉一律用它。
- **F4 门禁资产**:`web/scripts/verify-select-contract.mjs`(npm run verify:select;双主题 10 项 10/10)+sc-select.spec 4 用例;vitest 186 全绿。
- 注:此轮改动落在旧 web/(用户排查诉求针对现网观感);web-next 侧由并行 B 线推进,B1/B2 已收官。
## ✅ Issue#5 压测复盘已交付(2026-11-17 晚;报告 `docs/acceptance/issue5-bench-report.md` + 工单 #5 Markdown 回帖)
- **结论**:100 万条目标达成(下发成功 ≈112.7 万/累计提交 ≈213.8 万);计费三平分毫不差(充值 10.0001 亿−预扣 2,183,182+退款 999,741=余额 998,826,559);受理峰 287.9 QPS slow=0/lag 峰 476/零慢查询零重启。
- **三场**:白日场 vcmppgw 7.7 万@200/s(已清理)/夜间长短信 5.1 万任务×3 片/主战场 23:00~01:52 提交 199.9 万(50% 签名拦截 ISC:004 即时退款)。
- **挂账移交(下轮压测前清偿)**:①R1 余额对账差额 P0 ×33 次(典型 ±120~791,自愈无资损)根修预扣-落账时序;②deliver_fail 2,652 条去向复核;③长短信挂起 1,326 条 **11-19 reaper 到期核验**;④channel host 不热切换(改 host 须断连,runbook);⑤压测脚本签名对齐+客户端 CSV 强制留档;⑥正式场=11-18 整改→11-19 阶梯 200/500/1000 TPS,出账四件套入 SOP。
- **证据**:logs/bench-*.csv+log / vcmppgw*.log / 1m-watch.log(2,719 样本)/ capture pcap / DB 只读对账(billing_consume_log/account_balance_log/send_block_log/channel_log)。
## ⭐ Issue#6 · B 方案执行中:B2 三契约页已收官,下一步 B3 33 视图分批实装
- **B2 已交付(commit 见 git log)**:三契约页 1:1 逐行直抄 v3-2-tailwind.html——#p-dash 运营总览(895-1005:横幅+stat 6+4+chart.js 趋势+donut+监控表+系统健康+动态+快捷+快照)/#p-acct 帐号管理(1006-1034:单卡一体筛选+8 列表+分页)/#p-chan 通道编辑(1035-1059:双卡表单+switch+操作条);全部真实数据,缺数据项显式 —。
- **B2 连带根修**:①stats_handler.go 两处 `AS key` 撞 MySQL 8.0 保留字 → /stats/biz 500(P2 遗留 bug,反引号转义已修,单测绿);②网关旧二进制已重建重启(bin/gateway 现含 P2 三端点)。
- **B2 验收**:vue-tsc 0/build ✓(dash chunk gzip 65KB)/冒烟 12/12/stat-card computed style 与 17890 双会话对拍一致(radius16/pad20/flex/gap16)。截图:/tmp/b2-dash|acct|chan|contract-dash.png。
## B3 任务清单(新会话直接执行)
1. 33 视图分批实装(占位 ComingSoon 逐个替换;routes.ts component 已就位待换):范式族=表格页(ProTable 语义+契约表格 class)/表单页(契约 chan 范式)/详情页;**每页 defineOptions({name:路由名})**。
2. 范式族映射:审核中心/记录中心/统计结算=表格族;开户/充值=表单族;账号详情=详情族。
3. 每批完成后冒烟+commit;B4 收口(切部署/旧 web 归档/verify 重建/统一验收单/CHANGELOG/Gitea#6)。
4. **视觉规范(2026-11-17 用户拍板,覆盖契约蓝本)**:菜单内容页**不加 `h2.page-title`**——顶栏 AppHeader 的 h1#pageTitle 已显示 route.meta.title,内容页再放 h2 属重复;内容页 page-header 只留 page-description 副标题+右侧动作按钮。已交付 5 页(DashboardView/AccountList/ChannelEdit/ChannelList/DownlinkDetailView)已删,后续每批交付断言 views/ 无 page-title。
## B 方案决议留痕(2026-11-17 拍板)
- **决议(用户原话)**:执行 B 方案;**必须不要有旧前端的影子**;**新增前端工程目录**;A 方案(EP 换肤模拟)彻底废弃。
- **开发蓝本(用户重申)**:**v3-2-tailwind.html 按这个来开发前端**——文件里有什么,页面就做成什么样,不自由发挥;class 串 1:1 直抄。
- **根因留痕(P3 被否决)**:① 契约 v3-2-tailwind.html 内含 3 页蓝本,P1 只认知 Dashboard 页;② sub2api 无 EP,EP 模拟转译损耗结构性不可救。P3 六 commits 留档不回滚。
- **零影子复用边界**:✅ 仅复制纯逻辑层;❌ 零复用:样式/视图/组件/EP。
## 环境要点(B3 沿用)
- web-next dev:`cd web-next && npx vite --host 0.0.0.0 --port 5174 --strictPort`(nohup);依赖已装齐;:5173 旧 web 并行不动。
- 网关 :8080 已重建(含 P2 三端点);/stats/biz 保留字 bug 已修;**后端改动仅 stats_handler.go 一处**。
- chrome 铁律:channel:'chrome'+独立 launch+单 page;**同 browser 二次跨域导航会 ERR_ABORTED(CPU 缺陷),对拍用双会话**(/tmp/duel-style.mjs 模式);playwright 用 web/node_modules。
- 冒烟账号 s2demo/S2demo@2026;dev 库:账号 3+/通道 1(Hw测试专用)/近 7 日 206 万条。
- 坑留痕(B2 实录):①editor 大文件必须分段 insert,数好 template/script 闭合(根 div 缺闭合=plugin-vue 报 missing end tag,vue-tsc 不查模板结构);②MySQL 8.0 `key` 是保留字,SQL 别名必须反引号;③网关二进制日期要核对(bin/gateway 可能落后 main);④curl 循环带 TOKEN 必须同一命令字符串(多条命令=独立 shell 变量丢);⑤17890 契约预览 python http.server 对 HEAD/快速二连可能 abort。
- **Gitea API 已通**(账号 Tory):token 存 `/tmp/gitea_token`;写评论=POST /api/v1/repos/Tory/go-sms-V2/issues/{n}/comments。
## P3 留痕(已被 B 方案取代,commits 不回滚)
- **P2 后端 3 端点已入库**(/ops/system/overview + /stats/biz + /stats/realtime,openapi 1.5.0);**人工验收挂起**,与 B2/B3 合并统一验收单(验收标准已定稿待执行:重启网关+admin JWT+逐端点断言)。
- **P3 壳层= sub2api 契约落地于旧 EP 工程**(用户验收否决,详见顶部根因):C1 tokens(teal 16 阶+slate/gray+旧名兼容)/C2 shell(侧栏 256/折叠 72/顶栏 64 glass)/C3 MainLayout 重排+TagsBar/C4 ep-theme/C5 旧值清零;verify-layout 31/31+verify-p3-contract.mjs 30/30+vitest 182 全绿——**机器断言全绿仍被否,教训:断言范围≠用户感知范围,功能页范式没进断言集**。
- **坑留痕(通用)**:①Vue template 整段替换防 dropdown 内层 </template> 截断;②契约断言脚本须归一起始主题;③#020617 hex→dec=rgb(2,6,23);④契约类 HTML 文档必须**全文件通读**(3 页蓝本漏读 2 页=本次翻车主因)。
- 挂账(随 B4 清偿):channel flaky 测试/access 域 6 lint unused/工作区遗留 8 文件(先前会话半成品,未提交未回滚)。
## Issue#6 前端重构 · 视觉契约已锁定(2026-11-17,P1 收官)
- **契约 = `docs/design/issue6/v3-2-tailwind.html`(v3.2.1,Chrome 机器验收 23/23)**:sub2api(Wei-Shaw/sub2api,LGPL,仅取样式+内部不分发=无义务)源码级 1:1——CSS 775 行 sed 直拼(非手抄)+组件 class 串直抄(AppSidebar/AppHeader/QuickActions)+tailwind.config 直抄;**主色=sub2api 官方 teal 全阶(primary-500 #14b8a6),用户拍板替代 Issue#6 原「emerald 生命绿」口径**;Tailwind 本地运行时 docs/design/issue6/tailwind.js(451KB,无外网依赖)仅用于预览,不进工程。
- **契约文档**:`alignment-report.md`(渲染取证基线→源码规格表→契约锁定→豁免清单全程留痕);`baseline-ins2ai.json`;预览服务 `http://192.168.5.18:17890/`(python http.server,docs/design/issue6;注意本机内网 IP=192.168.5.18,5.27 是 Gitea 机)。ins2ai(token.unimsc.com)=sub2api 部署实例,Chrome 登录调研账号 info@inscom.ltd(密码在用户处)。
- **迭代过程存档**(全部留档 docs/design/issue6/):demo-c-aurora 原风格→v1 三案换色(用户否决「换汤不换药」)→v2 推倒范式×3(否决「太失望」,根因=完成度低+方向应回归现代 SaaS)→v3 现代 SaaS+侧栏+缓存Tab(用户要求保留)→v3.1.x 渲染取证对齐(多轮肉眼纠偏:字体/间距/灰阶/icon 20/logo 36/品牌18/折叠72/分组14)→**v3.2 Tailwind 零转译(根治转译损耗)+v3.1.3 数据模块合并=v3.2.1 锁定**。
- **统一范围(P3)**:视觉层全面换契约——tokens.scss(teal16阶+slate暗色系+源码间距/圆角/shadow 规格)/shell.scss(侧栏256折叠72+glass顶栏64+TagsBar+page-head)/ep-theme.scss 重映射/MainLayout 重排/全站松密度;**不变**:EP 组件库(用户裁决)/路由与 RBAC/功能行为(TagsBar keep-alive、版本红点等 Issue#2/#4 资产)。
- **P2~P5**:P2 后端 3 端点(`/ops/system/overview` `/stats/biz` `/stats/realtime`,通道实时复用现成 `/channels/monitor/ws`)→P3 壳层→P4 Dashboard 13 模块组件化(Hero/KPI6+4/双系列图/donut/通道实时/系统健康/动态流/快捷/快照)→P5 七件套门禁(verify-layout 断言全部重写)。
## 当前状态快照(2026-11-16,**Issue#3 三连修复+方案B 系统配置落地,S4 泳道收官,一期 18/27 计划日**)
- **Issue#4 版本号+发布日志已交付(2026-11-16 晚六)**:①侧栏底脚(折叠按钮旁)版本 chip `v1.5.0`,未读红点 CSS 脉冲闪烁(localStorage `gosms_seen_ver`≠APP_VERSION;首访=亮;点击/进发布日志页 markSeen 即灭;发新版全员再亮);②系统管理二级菜单「发布日志」/system/release(**全角色**,同 faq 口径用户拍板),时间线卡片渲染 Markdown。**单一事实源=web/src/data/releases.ts**(APP_VERSION=首条;package.json 1.5.0 同步,releases.spec 断言防漂移);渲染器 utils/markdown.ts **零新依赖**(先全量 HTML 转义+仅 http(s) 链接,v-html 零注入)。门禁:eslint0/vue-tsc0/**vitest 179**(+14)/build/verify-layout **31/31**(+8)/Chrome 走查 4 步+样式级复核(折叠态曾溢出 foot 55px>47px,修=去 v 短版本 1.5+10px+红点 badge 绝对定位)。**发版 SOP=releases.ts 头部插一条+package.json 同步**;红点=本地未读语义(换浏览器重提示,无服务端同步);移动端 ≤900 版本号随 sidebar-foot 既有约定隐藏。验收单 issue4-release-notes.md;Gitea #4 完成评论待用户(token)。
- **Issue#3 联调闭环(2026-11-16 晚五)🎉**:客户 192.168.5.210 登录成功(cmpp_conn_ok+抓包双证,-1 终结);首报「提交报错:0」=余额不足(MsgID=0+Result=10,充值 10000 恢复);重提 3 条全链打通(任务 status=2/明细 DELIVRD/计费正常)——**Issue#3 三问题(CMPP -1/充值无响应/SrcID 核验)全部闭环**。挂账:①抓包分析器混合流重组错位(D30/P2);②联调余额 10000 条在 s2demo;③上游 5.16:7890=旧平台网关与公网 121.46.230.53 同源(客户历史地址疑指此,已不影响联调)。
- **Issue#3 三连修复(2026-11-16 晚)**:①CMPP 连接报 -1 根因=`ConnectResp` 误按 **3.0 的 1B Status** 编码(标准 2.0 客户端按 4B 大端解析恒非 0)→ 修复=Marshal 4B(21B 包体)+AuthenticatorISMG 4B 参与 MD5+`ParseConnectResp` 自适应双布局(≥20B/2.0,17~19B/3.0);标准 2.0 探针真机实证 18B/垃圾值→21B/Status=0,**教训:2.0 与 3.0 在 CONNECT_RESP.Status/SUBMIT_RESP.Result 上互为镜像(2.0=4B/1B),自家 client+server 同源对称自测掩盖协议错位——同 Day39 坑**;②充值无响应=前端发 `{count}` 后端要 `{amount}`+submit 无 catch 静默吞错 → API/mock/组件三处修复;③SrcID 核验**用户裁定方案 C(前缀+动态扩展,行业惯例)**——s2demo 已配 ext_code=10690331(通道码即前缀),客户 SrcID 须以 10690331 开头+可追加扩展(≤21 位);真机四场景实证(纯码→10 过/码+扩展→10 过/不匹配→9/空→9);**运营口径:ext_code 变更后 30s 缓存生效(Day63 accCache)**。顺手修 TestClient_LoginOK 时序竞争(轮询吸收);门禁 -race 41 包/vitest 165/build 全绿;gateway 已串行部署(md5 比对 ✓)。
- **仓库**:main 已推 Gitea;每日 bundle+push 双轨。
- **一期进度**:S0✅ S1✅ S2✅ / S3 ✅(11-15 凌晨)/ **S4 ✅ 收官(11-16,三项验收全过:死信可查/拒收即拉黑/冷查 16ms<1s)**——D1/D2=C1 回调推送引擎+ C2 上行自动拉黑(真机六步实证,验收单 s4-d1d2-callback.md);D3=明细按天 RANGE(id) 分区热 5 天(迁移 v22,9 分区)+CH 冷热归档 job(count 校验零丢失方向)+/record/history 冷查(settle-check 热窗感知 DetailPartial 两方基线;真机 5 连坑全修存档,验收单 s4-d3-partition-archive.md)。
- **下一步=S5 基线与灰度(8 日,一期最后泳道)**:kind 安装+deploy/k8s manifests apply(NodePort 30081)→ 24h 稳定性复核(S4 动了大表结构,S5 压测前重跑一轮而非沿用 11-14 旧判)→ 压测基线 200QPS×30min(SSD 下重标 workers:4/55/s 等 HDD 数字)→ 消费参数重标定 → 灰度接管现网流量。**出口四项**:七件套全绿/P0+P1+结算覆盖矩阵全勾/SSD 基线报告入档/v2 承载 ≥1 周零 P0 事故+POC 转冷备。
- **S4 遗留挂账**:回调载荷无签名(需求未定义);拦截终态 HTTP 回调未挂(CMPP 侧已有);history 异步导出走下载中心(D29/P2);CH 生产建议副本+冷分区 S3(S5 运维项);pmax REORGANIZE 运维口径入 runbook 待补。
- **C1/C2/D3 口径留痕**:PushWorker 单实例 at-least-once;归档 job 单实例(CH 分区重写幂等吸收);CH count()=UInt64/time.Time 绑定 UTC 歧义(查询预格式化墙钟串)——CH 交互三坑已存档 techContext。
- **⚠️ 流程补正在途(两项,不阻塞开工)**:①S2 用户本人走查(s2-walkthrough.sh D2~D5,AI 预走查 27 PASS);②S2 结算页+S3 利润页+S4 回调管理页+record/history 页浏览器走查(:5173,s2demo 登录[admin 角色])。
- **24h 稳定性门槛 ✅ 终判通过(11-14)**;S4 后建议 S5 前复核 dmesg+零重启。
- **真浏览器通道就位(2026-11-15)**:Google Chrome 157 + Playwright `channel:'chrome'`(`scripts/chrome-session.mjs`;单 page 会话铁律)。
- **Issue#1 两轮交付均已入库(2026-11-15/16)**;**Issue#2 多标签导航+页签缓存已交付(2026-11-16 傍晚)**:TagsBar+tabs store+keep-alive(include=路由名,29 视图 defineOptions 守门)+vitest 165+verify-layout 23+Chrome 走查 17/17(状态保留实证);**Gitea API 读免 token=http://192.168.5.27:24400**(写评论仍需 token,待用户);verify-layout 凭据已 env 化(缺省 s2demo——admin 原密码不可知,admin123 已不可登录)。
- **六项裁决速查(S2 全闭环)**:R1/R6 换算只在 price.go / R2 事实源 D2 落账 / R3 双通道 D3 落地(ref_id 区分)/ R4 rebate_rate D5 落地(profit.go 现算不落档)/ R5 settle_ladder D4 落地。
- 归档仓(只读):/data/poc-archive/repos/go-sms.git。
- **【铁律】测试端口固定=5173**:Web 测试/联调/走查/对外验收口径**一律** `http://<服务器IP>:5173`(vite dev,`make web-dev`);**禁止**用 WEB_PORT 覆盖到其他端口、禁止 preview(4173 等)/临时容器端口(30099 等)作为验收与走查入口——一次性探测端口仅限本机调试且不入文档口径(2026-11-15 用户裁定)。
- **【铁律】外网测试统一域名入口=`https://sms.unimsc.com/`**(2026-11-15 用户裁定):nginx 根路径反代 443→192.168.5.18:5173(带 ws Upgrade 头);vite `allowedHosts:['sms.unimsc.com']`+`hmr.clientPort:443`(域名 HMR ✓,本机直连 HMR 退化为手动刷新);API 走 vite proxy→8080;**ai.unimsc.com/SmsDev 路径前缀通道废弃**(前缀反代下 vite 资源绝对路径错位无干净解);S5 上生产仅改 nginx proxy_pass→30081(web 镜像同构)。**S3 遗留缺陷顺手修**:build 不读 .env.development 致 dist 内 API base 缺失→新增 `web/.env.production`(VITE_API_BASE_URL=/api/v1)。
- **本会话教训**:①明细雪花 ID 直插 SQL 须 < int64 上限 9.22e18(9302… 段拒收,走查种子统一 7302… 段);②`sg docker -c '…$VAR…'` 单引号内变量不展开(内层空展开致 SQL 语法错)——多语句 SQL 用 `printf|docker exec -i` 外层展开;③网关重启须含最新端点二进制(串行 build→kill→md5);④**本机 chromium(含 headless shell)newPage 即 Target crashed**(disable-gpu/no-sandbox/GLIBC 关 AVX 均不救,dmesg 无痕)——Playwright 截图/e2e/LCP 实测本机不可用〔**11-15 已解:官方 Chrome 157 + `channel:'chrome'` 可用**,稳定口径=每会话独立 launch+单 page goto 导航(同 browser 第 2 个 newPage 必崩:renderer segfault error 25 固定偏移 0x90b1f9→zombie→挂起,chrome 崩溃 dmesg 有痕);工具=`scripts/chrome-session.mjs`,详见 techContext 工具链〕;⑤vite preview 只监听 IPv6 [::1](curl 127.0.0.1 不通,用 localhost);⑥组件测试 mount 须 `plugins:[ElementPlus]`(stubs 方式 el-table-column slot scope 会 undefined);⑦`web/.env.development.local` 已随 Mock 下线删除,再出现 VITE_API_MODE 文件即残留可径删。
- **历史运维教训**:①`pkill/pgrep -f` 自匹配(铁律:`[x]` 括号技巧);②大镜像单窗>体积÷带宽;③du 无 sudo 静默失败误诊;④sed 换行/sed 误伤方法名(重构期优先编辑器工具);⑤Go 工具忽略 `_` 前缀文件;⑥集成测试需 `sg docker` 包裹(docker 组未重登);⑦**Makefile recipe 的 `exit 0` 只退出当前行 shell 不终止目标**(幂等短路须 if/else 递归 `$(MAKE)` 子目标);⑧**管道 `| tail -N` 截首行误导诊断**(gw-start"玄学 NOMATCH"两轮误诊实为 THEN 分支已生效,排查须看全量输出)。
## 重建启动(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` 会把 vite 钉在 real——切 mock 前必查~~(S3 Mock 已下线,条目废止留痕;该文件已删,再出现 VITE_API_MODE 相关文件即残留径删)。
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% 过,下一任务不得开工。