131 lines
23 KiB
Markdown
131 lines
23 KiB
Markdown
# 当前工作上下文(最近更新: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% 过,下一任务不得开工。
|