---
name: recharge-config规则说明字段
overview: 为 `s_common.s_recharge_gift_config` 新增独立 `rule_desc` 字段，并在 `slot_admin` 与 `slot_console` 全链路打通，保持 `help` 兼容不破坏现有接口。
todos:
  - id: add-rule-desc-ddl
    content: 在 slot_console/db 与 slot_admin/db 增加 s_recharge_gift_config.rule_desc 的 DDL
    status: completed
  - id: wire-admin-rule-desc
    content: 打通 slot_admin 的 validate/logic/model 对 rule_desc 的读写
    status: completed
  - id: wire-console-rule-desc
    content: 在 slot_console 模型与 DailyRebate info 返回新增 rule_desc 并保留 help
    status: completed
  - id: verify-multi-repo
    content: 分别校验变更仓库并运行 verify-slot-backend 脚本
    status: completed
isProject: false
---

# s_recharge_gift_config 增加 rule_desc 计划

## 目标
- 在 `s_common.s_recharge_gift_config` 增加独立规则说明字段 `rule_desc`。
- 后台管理（`slot_admin`）支持新增/编辑/列表读写该字段。
- C 端（`slot_console`）返回新增 `rule_desc`，并继续保留现有 `help` 字段兼容。

## 变更范围
- 数据库 SQL（双落点）
  - [`/Users/ray/Documents/project/www/slot/slot_console/db/install.sql`](/Users/ray/Documents/project/www/slot/slot_console/db/install.sql)
  - [`/Users/ray/Documents/project/www/slot/backend/slot_admin/db`](/Users/ray/Documents/project/www/slot/backend/slot_admin/db)
  - 增加 `ALTER TABLE s_common.s_recharge_gift_config ADD COLUMN rule_desc ...`（含注释、默认值、可空策略）。

- `slot_admin`（配置录入链路）
  - [`/Users/ray/Documents/project/www/slot/backend/slot_admin/app/game/validate/RechargeGiftConfigValidate.php`](/Users/ray/Documents/project/www/slot/backend/slot_admin/app/game/validate/RechargeGiftConfigValidate.php)
  - [`/Users/ray/Documents/project/www/slot/backend/slot_admin/app/game/logic/RechargeGiftConfigLogic.php`](/Users/ray/Documents/project/www/slot/backend/slot_admin/app/game/logic/RechargeGiftConfigLogic.php)
  - [`/Users/ray/Documents/project/www/slot/backend/slot_admin/app/game/model/RechargeGiftConfigModel.php`](/Users/ray/Documents/project/www/slot/backend/slot_admin/app/game/model/RechargeGiftConfigModel.php)
  - 确保 `saveRedPacket/updateRedPacket` 等写入路径可接收并持久化 `rule_desc`，列表查询可读出该字段。

- `slot_console`（对外返回链路）
  - [`/Users/ray/Documents/project/www/slot/slot_console/app/model/common/RechargeGiftConfigModel.php`](/Users/ray/Documents/project/www/slot/slot_console/app/model/common/RechargeGiftConfigModel.php)
  - [`/Users/ray/Documents/project/www/slot/slot_console/app/api/logic/DailyRebateLogic.php`](/Users/ray/Documents/project/www/slot/slot_console/app/api/logic/DailyRebateLogic.php)
  - 在活动元数据中新增 `rule_desc`，并保留现有 `help` 字段。
  - 返回策略：`rule_desc` 优先读新字段；`help` 维持原语义不变。

## 验证
- SQL 可执行性：检查字段存在与默认值。
- 后台接口：新增/编辑后回读包含 `rule_desc`。
- C 端接口：`DailyRebate info` 同时返回 `help` 与 `rule_desc`。
- 执行门禁：在变更仓库分别运行 `~/.cursor/hooks/verify-slot-backend.sh`。