ok

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

@@ -0,0 +1,49 @@
+---
+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`。