VIP会员运维

一、插件简介

独立 VIP 会员插件：后台配置阶梯时长与价格套餐，用户购买后获得会员身份。VIP 可在指定发布者用户组与板块范围内，跳过付费阅读、附件下载、隐藏内容、网盘资源的付费门槛（按周期配额）。

二、核心能力

三、依赖与安装

1. 将插件置于 plugins/vip/。
2. 在应用中心安装「VIP会员」。
3. 安装时创建 vip_member、vip_order、vip_bypass_log 表并注册菜单。
4. 推荐依赖：community（用户与板块）；payment（现金购买）；paidread/attachment/hide/netdisk（权益跳过目标）。

四、应用中心基础配置

五、后台重点配置

套餐配置（/admin/vip_settings/plans）

套餐不在 configSchema 中，而在后台套餐页维护，每条套餐包含：

保存接口：POST /admin/vip_settings/savePlans

会员与订单

六、前台用户流程

1. 登录后进入会员中心 → 点击「VIP会员」Tab 或访问 /vip。
2. 查看当前会员状态、到期时间与剩余权益次数。
3. 选择套餐 → 选择支付方式（积分/金币/现金）→ 确认购买。
4. 现金购买跳转支付中心扫码；积分/金币直接扣款开通。
5. 浏览帖子时，若满足 VIP 范围与配额，付费阅读/附件/隐藏/网盘自动跳过扣费。
6. 在 /vip/orders 查看个人购买记录。

七、后台审核与运维

前台路由

八、特殊说明

• 插槽：member_nav_extra — 会员中心「VIP会员」Tab；layout_body_end — 注入 vip.css、vip.js。
• 数据表：vip_member（会员状态与配额）、vip_order（购买记录）、vip_bypass_log（跳过记录，防重复扣配额）。
• 权益键：paidread、attachment、hide、netdisk。
• 现金汇率：金币定价套餐扫码金额按支付中心 coin_rate 换算；现金定价套餐固定走在线支付。

九、推荐上线清单

• 在后台配置至少一个套餐（名称、天数、价格、权益配额）
• 设置权限周期与默认支付方式
• 确认相关 content 插件（付费阅读等）已安装启用
• 若支持现金购买，确认支付中心已配置
• 配置 cron_key 并设置定时访问 /vip/cron
• 测试购买、权益跳过、到期逻辑

十、常见问题

Q：购买了 VIP 但仍需付费？ 检查套餐的发布者用户组与板块范围是否覆盖该帖子；检查对应权益配额是否用尽。

Q：配额何时重置？ 按应用中心「权限周期」设置，每日/每周/每月重置剩余次数。

Q：套餐在哪里配置？ 后台「VIP会员」→ 套餐配置页，非应用中心表单。

Q：现金购买价格如何计算？ 积分/金币套餐按套餐标价；若需人民币支付，现金定价套餐价格为分，或按支付中心汇率换算。

Q：到期后会怎样？ 会员 expire_time 过期后权益失效；可配置 cron 发送到期通知。