cursor/plans/recharge-config规则说明字段_344d86ff.plan.md

name, overview, todos, isProject

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