junhong_cmp_fiber/openspec/changes/add-carrier-channel-traffic-thresholds/tasks.md

1. 迁移与模型

• 1.1 成对迁移：tb_carrier 扩列 traffic_threshold_enabled（默认 false）、traffic_threshold_value（正数 numeric）、traffic_threshold_unit（MB/GB）；新增周期阈值停机锁表，(carrier_id, card_id, period_start) 唯一键（软删感知）、任务状态组（stop/resume：pending/submitted/confirmed/failed/unknown）、提交认领字段（stop_submitted_at/resume_submitted_at）、anomaly_flag、failure_reason。
• 1.2 锁表模型与 Store（含唯一键冲突 23505 识别、条件更新认领方法）。

2. 阈值配置与权限

• 2.1 carrier 创建/更新 DTO 增阈值字段与校验（正数、单位 MB/GB、周期复用 data_reset_day）。
• 2.2 字段级平台守卫：Create/Update 仅 SuperAdmin/Platform 可写阈值字段，非平台提交即拒绝；List/Get 对非平台账号不返回阈值字段；不改 carrier 其余字段既有可见性。
• 2.3 阈值新增、修改、启用、停用并入既有 carrier 更新审计前后值快照；同步 cmd/gendocs 文档。

3. 达量判定

• 3.1 period_start 计算（显式 Asia/Shanghai，resetDay 取卡 carrier 的 data_reset_day）与 GB→MB 换算常量（1 GB = 1024 MB）。
• 3.2 ApplyTrafficObservation 事务内达量判定：ReadingAccepted == true 且 carrier 阈值启用时，以 last_gateway_reading_mb 换算比较；达量写锁 + 停机 Outbox 事件同事务。
• 3.3 锁唯一键 23505 单独捕获为「该周期已处理」跳过，与流量基线 CAS 冲突分离。

4. 可靠停复机消费者

• 4.1 停机消费者：提交认领（stop_submitted_at IS NULL 条件更新）；卡已 offline 跳过 Gateway 直接确认；否则复用 stopCardWithRetry；成功后写 network_status=offline、stop_reason=channel_threshold、stopped_at；失败/未知保留锁与任务状态，unknown 的 Integration Log 必带 RecoveryStrategy。
• 4.2 复机消费者：结构同停机（resume_submitted_at 认领、复用 resumeCardWithRetry、成功后写 online/清停因/resumed_at）；新增 2 个 Outbox 事件类型与 worker 消费者注册、装配。

5. 周期处理与恢复 cron

• 5.1 周期处理 cron（@every 1m + asynq.Unique(10m) + 无 payload）：扫描 period_start 过期持锁锁行（按锁行自身 carrier 的 data_reset_day 判断），条件更新认领解锁，逐卡评估（有效主套餐 + 流量未耗尽 + 实名 OK + 非风险 extend + 无其他停因），全满足写复机事件，否则只解锁。
• 5.2 恢复扫描 cron（同形态）：扫描 stop/resume 为 submitted 的锁，只查询网关状态回填、绝不重复发起停复机；确认成功补写卡状态；自提交起超 30 分钟（常量）仍不可查 → anomaly_flag + 安全失败原因转人工，不自动删除锁。
• 5.3 worker 注册两个 cron 与装配；周期处理与恢复 Handler 审计上下文固定 ActorKind=AuditActorScheduledJob、Source=AuditSourceScheduler。

6. 停因与复机拒绝

• 6.1 新增 StopReasonChannelThreshold = "channel_threshold" 常量；确认不纳入 isPollingStopReason 与 isDeviceScopeReason。
• 6.2 持锁拒绝覆盖四个入口（resumeSingleCard、ManualStartCard、ForceStartCard、StartMachineSeparatedCard）：拒绝 + 审计 denied + 锁保留。

7. 验证

• 7.1 隔离库验证：平台配置阈值（含 GB 换算）成功 + 审计前后值，代理/企业写被拒且读不到字段；达量触发停机、同周期重复判定唯一冲突不重复锁/不重复停机；持锁期四入口复机拒绝且锁保留；停机 unknown 保留 + RecoveryStrategy + 恢复扫描确认补写卡状态、超期 anomaly 转人工；新周期解锁、条件满足才复机、其他停因（stop_reason 非空非本停因或风险 extend）只解锁；停用后新卡不再锁、已持锁卡新周期照常解锁复机；换运营商旧锁保留、新周期按新 carrier 重置日；第 12 项套餐预警与既有 3 种停因停复机回归不变；迁移 up/down/up。
• 7.2 运行 gofmt -w、go build ./cmd/api ./cmd/worker、go run cmd/gendocs/main.go、openspec validate add-carrier-channel-traffic-thresholds --strict 与 openspec doctor --json；自动化测试按项目决策为 N/A。