勋章系统运维

一、插件简介

独立勋章插件：支持免费领取、付费购买、人工审核、管理员颁发等多种获取方式。用户可佩戴勋章，在帖子作者、回复用户、个人主页等位置展示。可与身份认证、邀请、签到等插件联动。

二、核心能力

三、依赖与安装

1. 将插件置于 plugins/badge/。
2. 在应用中心安装「勋章系统」。
3. 安装时创建 badge、badge_user 表，扩展 community_category 勋章门控字段，注册菜单与导航。
4. 可选依赖：invite（邀请条件）、signin（签到条件）、payment（付费购买）、verify（认证通过后颁发勋章）。

四、应用中心基础配置

五、后台重点配置

勋章管理（/admin/badge）

每条勋章在后台维护，主要字段：

管理接口

六、前台用户流程

1. 访问 /badge 浏览勋章墙，查看各勋章获取条件。
2. 满足条件后点击「领取」；付费勋章扣款后获得；需审核的进入待审状态。
3. 进入 /badge/mine 管理已拥有勋章，设置佩戴（最多 N 枚，N 为佩戴上限）。
4. 佩戴后，勋章显示在帖子作者名旁、回复用户名旁、个人主页。
5. 访问 /badge/user/{type}/{id} 查看他人勋章墙。

前台路由

七、后台审核与运维

• 审核申请：在「勋章管理」页面右上角进入审核，对待审领取执行通过/拒绝。
• 手动颁发：对指定用户直接颁发勋章（无需满足条件）。
• 版块门控：在社区分类设置中配置 badge_require_ids 与 badge_require_mode（any/all）。

八、特殊说明

• 插槽：reply_user_badges、topic_author_badges、user_home_badges（展示佩戴勋章）、member_nav_extra（「我的勋章」Tab）。
• 数据表：badge（勋章定义）、badge_user（用户持有与佩戴状态）。
• 社区扩展：community_category 增加 badge_require_ids、badge_require_mode 字段。
• 导航：通过 CommunityNavService 自动添加顶部「勋章」入口。
• 身份认证联动：认证类型可配置通过后颁发的 badge_id。

九、推荐上线清单

• 创建首批勋章（图标、条件、获取方式）
• 设置合理的佩戴上限
• 测试免费领取、付费购买、审核流程
• 确认帖子/回复处勋章展示正常
• 若使用条件类型（邀请/签到），确认对应插件已安装
• 检查社区导航「勋章」入口

十、常见问题

Q：领取后看不到勋章？ 检查是否需审核；审核通过且已佩戴才会在帖子旁展示。

Q：为什么只能佩戴 3 枚？ 应用中心「同时佩戴上限」控制，最大 6。

Q：付费勋章扣款失败？ 确认用户积分/金币余额充足；支付相关逻辑走社区 Coin 服务。

Q：版块提示需要勋章才能发帖？ 该分类配置了勋章门控，用户需持有指定勋章（任一或全部，取决于模式）。

Q：审核入口在哪里？ 已合并到「勋章管理」页面右上角，不再有独立「勋章审核」菜单。