cursor/plans/channel auto transparent-0ecc7d51.plan.md

---

todos:

• id: "const" content: "GameServerModel 增加 WAGERING_MODEL_TRANSPARENT=2 常量(中文注释)" status: pending
• id: "logic-switch" content: "GameServerLogic 增加 batchSwitchToTransparent() 批量刷透明并返回改动 source 列表" status: pending
• id: "logic-reset" content: "GameServerLogic 增加 resetUsersWagerTaskBySource() 按渠道分批跑用户 offTask 整理" status: pending
• id: "command" content: "新建 ChannelTransparent 命令，支持 --source/--dry-run，编排上面两步" status: pending
• id: "register" content: "确认/登记 config/command.php 命令注册" status: pending
• id: "gate" content: "跑后端门禁脚本并附检测结果" status: pending isProject: false

---

渠道自动转透明 + 用户数据整理

背景结论

• 透明模式判定全系统统一为 extend_data.wagering_model == 2；1 或未设置 = 非透明（见 ShareConfigService.php L113-118、GameServerService.php L46-52）。
• 渠道数据在 s_common.game_server，由 GameServerLogic 维护，保存后 sync() 刷新缓存。
• 原数据整理：slot_admin Test.php L39-66 按 source 分批捞 UserModel，逐用户 WalletService::offTask($uid,$currency) → slot_wallet SiteController::offTask L44-129 重算提现要求/失效历史打码任务/补建恢复任务。

方案（按用户确认：新建 CLI 命令；改完渠道后只对本次切换的渠道用户跑整理）

1. 渠道侧常量

在 GameServerModel.php 增加：

• /** 打码模式-透明(version2) */ const WAGERING_MODEL_TRANSPARENT = 2;

2. GameServerLogic 编排（两个新 public 方法，含中文 PHPDoc）

• batchSwitchToTransparent(): array：查 status > 0 的全部渠道，遍历 decode extend_data，对 wagering_model != 2 的设为 2、json_encode 回写、调用 sync($source) 刷缓存；返回本次实际改动的 source 列表（已是 2 的跳过，天然幂等）。
• resetUsersWagerTaskBySource(string $source): int：复用 Test::offTask 的分批逻辑——按 source 用 id > $lastId 游标分页(1000/批)捞 UserModel(id,currency,source)，逐个 WalletService::offTask($uid,$currency)，返回处理用户数；关键节点写日志。

3. 新建命令 [backend/slot_admin/app/command/ChannelTransparent.php]

• protected static $defaultName = 'channelTransparent';
• 可选参数 --source（只处理指定渠道，便于灰度/测试）、--dry-run（只列出将变更的渠道，不写库不整理）。
• execute 流程：调用 batchSwitchToTransparent() 拿到改动 source 列表 → 输出列表 → 对每个 source 调 resetUsersWagerTaskBySource() → 输出每渠道处理用户数与总计。
• 命令为薄编排，业务逻辑全部落在 GameServerLogic。

4. 命令注册

确认 config/command.php 是否需手动登记（参照现有 test 命令注册方式），若需要则追加 ChannelTransparent::class。

执行方式

docker exec -w /app/www/slot/backend/slot_admin php82 php webman channelTransparent --dry-run   # 先预览
docker exec -w /app/www/slot/backend/slot_admin php82 php webman channelTransparent             # 正式执行

注意

• 数据整理对 wallet 是逐用户同步 HTTP，渠道用户多时耗时较长（与现有 Test 脚本一致）；保留 --source 可分渠道执行。
• 收尾前按门禁跑 ~/.cursor/skills/slot-backend-completion-report/scripts/report.sh 并附检测结果。