红包奖励运维

一、插件简介

红包奖励（redpacket）面向社区站点，允许发帖人在发帖时设置帖内红包。发布时从发帖人账户预扣积分或金币，读者在帖子详情页按条件领取，支持拼手气（随机）与普通（固定）两种模式。

适合活动激励、内容打赏、互动促活等场景。

• 前台入口：发帖/编辑页拓展区「红包」；帖子详情页红包领取区
• 后台入口：无独立后台菜单；管理员发帖同样可设置红包
• 接口路径（若社区开启伪静态后缀则追加，下同）：
• POST /redpacket/claim — 领取红包

二、核心能力

三、依赖与安装

建议环境：

• 已安装并启用 社区（community） 插件（积分/金币体系、发帖回帖）
• 社区需正常运作 Coin 服务（扣款、入账）

安装步骤：

1. 应用中心安装并启用 红包奖励
2. 打开「启用红包奖励」
3. 配置金额范围、人数上限、允许币种、默认领取方式与有效时长
4. 用测试账号发帖发红包并领取验证

数据表：

• {prefix}redpacket — 红包主表
• {prefix}redpacket_claim — 领取记录

四、应用中心基础配置

路径：应用中心 → 红包奖励 → 配置

五、发帖红包配置（重点）

发帖拓展区可配置：

扣款时机： 发帖保存成功时从发帖人账户扣除总金额；领完或过期后未领部分退回。

六、前台用户流程

1. 有权限用户发帖，拓展区设置红包参数并发布（账户余额需充足）
2. 帖子详情页展示红包卡片（topic_after_content）
3. 读者按领取条件操作：

• 登录即可：登录后点领取
• 回帖后领取：先回帖再领取
• 达到用户等级：等级达标方可领取

1. 领取成功获得随机或固定金额入账
2. 领完或过期后红包状态更新；过期余额自动退回发帖人

七、后台审核与运维

无独立后台页。运维要点：

• 异常红包帖按社区帖子管理处理
• 调整金额/人数限制只影响新发红包
• 关闭插件后前台不展示，历史数据保留

八、特殊说明

插件钩子：

字段迁移： ensureSchema 会自动补齐 claim_type、claim_level_id、expire_time 等列。

静态资源： redpacket.js、redpacket.css、redpacket-editor.js

九、推荐上线清单

1. 启用插件，确认积分/金币体系正常
2. 设置合理的金额与人数上下限
3. 按需限制可发布用户组
4. 配置有效时长（建议非 0，避免长期占用余额）
5. 测试三种领取方式各走一遍
6. 测试过期退回逻辑

十、常见问题

Q：发帖提示余额不足？ 发帖人对应币种余额须 ≥ 红包总金额。

Q：显示「当前用户组无权发起」？ 检查「可发布用户组」配置。

Q：回帖后仍无法领取？ 确认领取方式为「回帖后领取」且已在该帖回帖。

Q：红包过期钱去哪了？ 未领完部分自动退回发帖人账户。

Q：能否同时发投票和红包？ 可与投票等拓展共存，各自独立保存。