mirror of
https://github.com/Wei-Shaw/sub2api.git
synced 2026-10-07 16:48:45 +08:00
shaw
0b6b4ea956
- 自动写回值域治理与留痕：上游声明值必须 > 0 且 <= 100 才写回。0 会让
accountCost 恒为 0（账号总额/日/周配额与成本告警全部静默失效），极大值可
一次打爆配额并污染成本报表；越界时保持原倍率、记 WARN，探测快照照常记 ok。
写回成功时记结构化 slog（account_id / 旧值 / 新值 / source），并在快照中
新增 synced_rate_multiplier 记录本次写回值——后台任务裸 SQL 不产生
audit_logs，这两处是唯一可追溯来源。管理员手工设 0 不受影响。
- 写回改用 resolved_rate_multiplier（不含高峰的基准倍率）：effective 含探测
那一刻的高峰系数，写回会把一个探测周期的峰值/谷值冻结进静态列，而展示与
调度用 upstreamBillingRateAt 按当前时间重算高峰，两者会持续不一致。
- 倍率解析失败不再污染公共探测路径：账号级值域/精度只在该账号已开启同步、
真要写回时才有影响；未开同步的账号照常记 ok 快照，不累计 failure_count、
不进入指数退避。
- 单账号编辑补 service 层守卫：同步开启时拒绝手工倍率（新增
UPSTREAM_BILLING_RATE_SYNC_CONFLICT，与批量路径同族），此前只有前端
disabled 挡人，直接 PUT /admin/accounts/{id} 可写入并活到下次成功探测。
判断的是本次请求生效后的状态，"关同步 + 改倍率"同请求仍然放行。
- 修正开关反推方向：不再由 rate_sync=true 推出 probe=true，否则一条"同步开、
探测键缺失"的僵尸记录会在任意一次无关编辑时静默打开周期性外呼；改为探测
关闭/缺失一律把同步归零。
- 删除死代码 UpdateWithUpstreamBillingProbeEnabled（PR 删接口后生产已无调用
方），其回滚测试改为直接覆盖生产路径 UpdateWithAccountBillingSettings。
upstreamBillingRateSyncEnabled 不再是只服务测试的假门控，现为写回前置过滤，
SQL CAS 仍是权威门控，两侧均加注释说明分工。
- en/zh 文案补充：同步的是不含高峰的基准倍率；开启同步会连带打开自动探测。