49 lines
3.2 KiB
Markdown
49 lines
3.2 KiB
Markdown
---
|
||
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`。 |