Files
go-sms-V2/CHANGELOG.md
T

16 KiB
Raw Blame History

Changelog(go-sms-v2 重建仓)

本仓 CHANGELOG 自重建起记(POC 明细见归档仓 /data/poc-archive/repos/go-sms.git 的 CHANGELOG.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 待七中间件起后跑。