虚拟商品管理使用说明

入口

用户管理 - VIP管理 - 会员商品列表
仅当商品类型为“虚拟商品”时显示“虚拟卡管理”入口

功能概述

虚拟商品管理用于配置并发放可通过金币兑换的虚拟类商品（如充值卡、会员卡等），包含商品信息维护、虚拟卡券导入与发放、H5 兑换与“我的卡券”查看等功能。

页面功能

1. 商品列表页面

• 功能: 展示所有商品（含虚拟/非虚拟）
• 主要操作:
  • 查看商品信息（ID、名称、描述、类型、金币价格、库存、状态等）
  • 添加新商品、编辑、删除
  • 虚拟卡管理（仅虚拟商品显示）
  • 分页浏览
• 关键字段:
  • ID：唯一标识
  • 商品名称 / 商品描述
  • 类型：会员时长 / 金币充值 / 虚拟商品
  • 金币价格：仅虚拟商品展示（虚拟商品仅支持金币兑换）
  • 库存：商品表 stock（与卡券池建议保持一致，或者小于卡券池）
  • 虚拟商品类型：充值卡 / 会员卡 / 其他
  • 每日兑换限制：0 表示不限制
  • 有效期(天)：发券后卡券有效期参考
  • 状态：上架 / 下架
  • 排序、创建时间、更新时间
• 客户端表现（H5 端）:
  • 金币兑换页展示“虚拟商品”列表与“我的卡券”页签
  • 列表内容为后台“上架”的虚拟商品，进入页面实时拉取

2. 添加商品页面

• 功能: 创建新的虚拟商品
• 必填字段:
  • 商品名称
  • 商品类型：选择“虚拟商品”
  • 金币价格（coins）
  • 库存（stock）
  • 状态（上架/下架）
• 可选字段:
  • 主商品图、商品描述
  • 虚拟商品类型（充值卡/会员卡/其他）
  • 每日兑换限制（针对单个用户，0 为不限制）
  • 有效期(天)
  • 排序
• 特殊说明:
  • 选择“虚拟商品”时：显示“金币价格/虚拟商品相关字段”，隐藏“现金价格/原价”
  • 虚拟商品仅支持金币支付，现金价格不生效
  • 库存建议与“未分配、未过期”的虚拟卡券数量保持一致（以免展示可兑换但卡券不足）

3. 编辑商品页面

• 功能: 修改现有虚拟商品信息
• 操作方式:
  • 在列表点击“编辑”进入
  • 修改后“更新”保存，实时生效

4. 虚拟卡管理页面（仅虚拟商品显示）

• 功能:
  • 查看当前商品的虚拟卡券列表
  • 批量导入卡券（卡号、卡密、面值、过期时间）
• 建议规范:
  • 过期时间需合法（晚于当前时间）
  • “未使用”状态卡券才会计入库存和发放
  • 同步维护商品库存（stock）与卡券池数量

5. H5 金币兑换与“我的卡券”

• 入口: App 内 H5 → 金币兑换
• 页签:
  • 虚拟商品：展示可兑换商品（仅金币）
  • 我的卡券：展示已兑换卡券（卡号、卡密、过期时间），支持“一键复制卡密”
• 核心流程:
  • 创建订单（金币支付）
  • 支付订单
  • 发放卡券 → “我的卡券”可见

使用流程

添加新虚拟商品

1. 进入会员商品列表页面
2. 点击“添加商品”
3. 填写信息：
   • 商品名称、描述
   • 类型选择“虚拟商品”
   • 填写金币价格、库存、虚拟商品类型、每日限制、有效期、状态、排序
4. 提交保存

导入虚拟卡券

1. 商品列表中对应商品点击“虚拟卡管理”
2. 选择“批量导入”
3. 按模板导入卡号、卡密、面值、过期时间
4. 导入成功后，未使用的卡券可被分配，建议同步调整商品库存

前台兑换与查看卡券

1. 用户打开“金币兑换”（H5）
2. 在“虚拟商品”页签选择商品 → 创建订单（金币）
3. 支付成功 → 自动分配卡券 → “我的卡券”可查看卡号/卡密/过期时间
4. 需要时可复制卡密进行外部使用/充值

注意事项

1. 虚拟商品仅支持金币兑换；金币不足或库存不足时不可兑换
2. 每日兑换限制（daily_limit）为 0 表示不限制；达上限会提示不可兑换
3. 库存策略：
   • 下单前检查库存
   • 支付成功后发券
   • 使用商品表 stock 做展示与前置校验，同时校验卡券池实际可用数
   • 支付成功后使用“乐观锁”扣减商品库存，严防并发超卖
4. 卡券过期时间应晚于发放时间；过期卡券不会被分配
5. 管理后台上架/下架实时生效；下架后前台不再展示，但数据保留
6. 建议定期校验商品库存与“未使用、未过期”的卡券数量一致性

常见问题

• Q: 兑换提示“库存不足”？
  • A: 当前商品库存或卡券池可用卡不足；请检查商品 stock 与卡券池数量
• Q: 兑换成功但未见卡券？
  • A: 进入“我的卡券”页签下拉刷新；或稍后重试。如仍无卡券，请检查服务端日志
• Q: 无法导入卡券？
  • A: 核对导入格式、过期时间合法性；确保卡号唯一未占用
• Q: 显示“已达每日上限”？
  • A: 用户当日兑换次数达到商品的每日限制（daily_limit）
• Q: 金币不足？
  • A: 页面展示余额不足，需先通过“兑换会员/金币充值”等方式获取金币后再兑换