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