积分商城运维管控

一、插件简介

独立积分商城插件，用户使用积分或金币兑换实物、虚拟卡密、站内积分/金币、个性头衔与头像像框。头衔展示在用户等级后方。兑换消耗的币种名称读取支付中心配置，未填写时默认显示「积分」「金币」。关闭插件后前台入口隐藏，已兑换头衔/像框仍保留。

二、核心能力

三、依赖与安装

1. 将插件目录置于 plugins/creditsshop/。
2. 在应用中心安装「积分商城」。
3. 安装时创建 creditsshop_goods、creditsshop_order、creditsshop_card、creditsshop_title、creditsshop_frame 等表，并注册后台菜单。
4. 硬依赖：社区插件 community（会员账户、积分/金币扣款与流水）。
5. 软依赖：支付中心（积分/金币前台名称）；VIP 会员（会员专属商品）；消息中心（兑换成功通知）。未安装支付中心时名称回退为「积分」「金币」。

四、应用中心基础配置

在应用中心 → 积分商城 → 配置，字段来自 configSchema：

积分、金币的展示名称不在本插件配置，请到支付中心填写。

五、后台重点配置

商品管理

菜单「积分商城」/admin/creditsshop：新增/编辑商品，设置名称、封面、简介、类型、价格、币种（积分/金币）、库存、排序、上下架、是否会员专属。

• 像框：上传像框素材，可设有效天数或多档价格。
• 头衔：填写头衔文案、颜色、图标与有效期。
• 实物：维护库存；库存为 0 不可兑换。
• 虚拟卡密：在商品下导入卡密，兑换时自动核销一条。
• 站内积分/金币：配置发放数量；用户支付一种资产后获得对应数量。

发放、订单与持有

1. 发放商品：向指定用户直接发放，无需扣款兑换。
2. 兑换订单：查看兑换记录；实物订单填写快递公司、单号后发货（待发货 → 已发货）。
3. 持有记录：查看用户当前头衔、像框及有效期。

六、前台用户流程

1. 浏览兑换：打开 /creditsshop → 按类型或积分/金币筛选 → 查看价格与余额。
2. 兑换：登录后选择商品（像框/头衔可选档期）→ 确认消耗 → 实物需填写收件信息 → 提交。成功后扣减对应资产并写入流水（类型：积分商城兑换）。
3. 卡密 / 站内币：卡密立即展示；积分/金币立即入账（流水类型：积分商城发放）。
4. 佩戴：在「我的像框 / 我的头衔」中佩戴或卸下；像框叠加在社区头像上，头衔显示在等级后方。
5. 订单：/creditsshop/orders 查看兑换与物流状态。

七、后台审核与运维

前台路由

八、特殊说明

• 静态资源：商城页样式由社区布局与插件静态目录提供；像框叠加使用 /static/creditsshop/frame-overlay.css、frame-overlay.js。
• 流水类型：creditsshop_redeem（兑换扣款）、creditsshop_reward（发放入账）。
• 数据表：creditsshop_goods 商品；creditsshop_order 订单（1 完成 / 2 待发货 / 3 已发货）；creditsshop_card 卡密；creditsshop_title / creditsshop_frame 持有。
• 名称约定：插件菜单名固定为「积分商城」；商品标价单位随支付中心「积分名称」「金币名称」变化。
• 卸载：卸载将删除上述商城表并注销菜单，请先备份订单与持有数据。

九、推荐上线清单

• 启用积分商城，确认社区资产可用
• 按需到支付中心配置积分/金币展示名称
• 上架至少一类商品，核对价格、币种、库存或卡密库存
• 像框商品核对占框比例与前台头像叠加效果
• 实物流程：前台兑换填地址 → 后台发货 → 用户订单可见单号
• 会员专属商品需已安装并启用 VIP
• 抽检兑换扣款流水与余额不足提示
• 确认关闭商城后入口隐藏、已佩戴装扮仍显示

十、常见问题

Q：前台没有商城入口？ 确认插件已安装且「启用积分商城」为开；入口可加入社区顶部导航或会员信息卡。

Q：余额不足或币种名称不对？ 商品标价币种为积分或金币字段；展示名来自支付中心。未安装支付中心时显示「积分」「金币」。

Q：卡密兑换失败？ 检查该商品是否还有未使用卡密。

Q：实物兑换后没有物流？ 订单处于待发货，需管理员在兑换订单中发货。

Q：像框看不到或不居中？ 调整「头像占框比例」；确认用户已佩戴且未过期；页面已加载 frame-overlay 脚本。

Q：想同时戴多个像框？ 开启「允许同时佩戴多个像框」。

Q：会员专属兑不了？ 需开通 VIP；非会员前台会限制兑换。

Q：旧装扮商城数据呢？ 安装后会尝试迁入 avatarframe 商品与持有；旧地址会跳转到积分商城。