cursor/plans/注册活动推荐游戏配置_0766f9ed.plan.md

name, overview, todos, isProject

name	overview	todos	isProject
注册活动推荐游戏配置	在 slot_admin 活动管理 type=7 编辑页增加「推荐游戏」多选，写入 ext_config.game_ids；配套列表展示与保存校验，与 slot_console 已实现的领取随机进游戏逻辑对齐。	id content status admin-model-api GameApiModel 查询方法 + ActivityController::publishedGames completed id content status admin-validate ActivityValidate::checkRegisterRewardExt + save/update 调用 completed id content status vue-edit activity/edit.vue type=7 推荐游戏多选与 submit/setFormData completed id content status vue-api-index activity.js API + index.vue type=7 列表展示 completed id content status manual-verify 后台保存后 C 端领取验证 game_id 随机返回 completed	false

注册活动 type=7 推荐游戏后台配置

背景

C 端已在 RegisterRewardLogic 读取 ext_config.game_ids，领取注册活动成功后随机返回 game_id。本任务补齐 后台配置入口，范围：

• backend/slot_admin_vue 活动编辑/列表
• backend/slot_admin 保存校验与游戏选项 API

不涉及 slot_console 改动（updateConfig 已原样持久化 ext_config JSON）。

配置契约（与 C 端一致）

{
  "game_ids": [101, 205, 308]
}

• 值为 game.id（s_game_api.game_id），须属于活动 model_id 下 status=1 的已发布游戏。
• 允许为空：领取仍成功，响应不含 game_id。

数据流

sequenceDiagram
    AdminVue->>ActivityController: GET publishedGames?model_id=
    ActivityController->>GameApiModel: 已上架 game_id 列表
    AdminVue->>ActivityController: POST save/update ext_config.game_ids
    ActivityController->>ActivityValidate: checkRegisterRewardExt
    ActivityController->>ConsoleInnerapi: ActivityService add/update
    ConsoleInnerapi->>DB: s_recharge_gift_config.ext_config

1. slot_admin 后端

1.1 游戏选项 API

在 ActivityController 新增：

• publishedGames(Request $request)
  • 入参：model_id（必填，对应活动「游戏模型」）
  • 出参：[{ game_id, name }]，供多选下拉

查询放在 GameApiModel（s_common.s_game_api）：

public static function optionsByGameModelId(int $gameModelId): array

条件：game_model_id、status = 1，field('game_id,name')，按 sort 排序；可对 game_id group 去重（与 console 侧一致）。

1.2 保存校验

在 ActivityValidate 新增 checkRegisterRewardExt(array $extConfig, int $gameModelId)：

规则	说明
game_ids 可选	缺失或 [] 直接通过
元素为正整数	非法 ID 抛 ValidateException
与渠道一致（推荐）	调用 GameApiModel::publishedGameIds($gameModelId, $ids)（与 console 同名语义），提交 ID 必须全部在已发布集合内，否则提示未上架 ID

在 ActivityController::save / update（updateData 全量更新时）中，当 type === 7 时调用：

$this->validate->checkRegisterRewardExt(
    (array) input('ext_config', []),
    (int) input('model_id', 0)
);

对齐 type=11 的 checkFreeCreditsExt 调用方式。

可在 GameApiModel 复用与 console 相同的 publishedGameIds 静态方法（admin 连接 s_common，表结构一致）。

2. slot_admin_vue 前端

2.1 API

在 src/api/game/activity.js 增加：

publishedGames(params) {
  return request({ url: '/game/activity/publishedGames', method: 'get', params })
}

（路径随 Webman 路由约定：game/activity/publishedGames。）

2.2 编辑页 type=7 表单项

文件：src/views/game/activity/edit.vue

在 仅 type=7 的 <template> 中增加（参考 type=11 独立区块，勿影响 type=8 下载奖励）：

<template v-if="formData.type === 7">
  <a-form-item label="推荐游戏" field="ext_config.game_ids"
    help="用户领取注册奖励后，从此列表随机推荐一款已上架游戏">
    <a-select
      v-model="formData.ext_config.game_ids"
      :options="publishedGameOptions"
      multiple allow-search allow-clear
      placeholder="请先选择游戏模型，再选择推荐游戏"
      :disabled="!formData.model_id"
    />
  </a-form-item>
</template>

脚本逻辑（对齐现有 type=10/11 的 setFormData / submit 分支）：

时机	处理
open / model_id 变更	loadPublishedGames() → 调 publishedGames({ model_id })，映射 { value: game_id, label: name + ' (' + game_id + ')' }
setFormData type=7	formData.ext_config.game_ids = (data.ext_config?.game_ids ?? []).map(Number)
submit type=7	data.ext_config = { ...data.ext_config, game_ids: 去重正整数数组 }，不覆盖其他 ext 字段

初始 formData.ext_config 在 type=7 时保证含 game_ids: []（避免 v-model 未定义）。

不复用首页导航的 cascader（indexGameNav/edit.vue 存的是 nav-{id}-{brandId}，与 game_id 语义不同）。

2.3 列表页展示

文件：src/views/game/activity/index.vue

在 #ext_config 插槽增加 type=7 分支：

• 有 game_ids：展示 推荐游戏: 101, 205, ...（或显示数量 + tooltip）
• 无配置：显示「未配置」灰色文案

3. 与现有编辑页结构的衔接

当前 type=7 属于 onlyGift，仍通过 goods 卡片 配置赠送金额（goods_id: -1 由 console 汇总），ext_config 此前为空。本次仅在 ext_config 增加 game_ids，与 goods 并存：

• 提交时 不要 像 type=11 那样 data.goods = []
• submit 中 type=7 仅 merge game_ids 进 ext_config

4. 验证方式

1. 后台新建/编辑 type=7 活动，选择游戏模型后多选 2+ 款已上架游戏，保存成功。
2. DB 检查：s_recharge_gift_config.ext_config 含 "game_ids":[...]。
3. C 端 POST /api/gift/receive 领取该活动，响应含随机 game_id。
4. 提交未上架 game_id 应被 admin 校验拦截。
5. game_ids 留空：保存成功，领取响应无 game_id。

文件清单

仓库	文件	变更
slot_admin	app/model/GameApiModel.php	optionsByGameModelId、publishedGameIds
slot_admin	app/game/controller/ActivityController.php	publishedGames；save/update 校验 type=7
slot_admin	app/game/validate/ActivityValidate.php	checkRegisterRewardExt
slot_admin_vue	src/api/game/activity.js	publishedGames
slot_admin_vue	src/views/game/activity/edit.vue	type=7 多选 + 加载/读写
slot_admin_vue	src/views/game/activity/index.vue	type=7 ext_config 展示

风险说明

• 切换「游戏模型」后已选 game_ids 可能与新模型不匹配：可在 model_id @change 时清空 game_ids 并提示重新选择（建议在实现时一并处理）。
• 游戏选项依赖 s_game_api 发布数据；未发布游戏不会出现在下拉，也无法通过校验提交。