商品自动发卡系统配置使用教程
一、商品分类管理
商品分类用于对商城商品进行分组归类，方便成员按类别查找商品，让商城结构更清晰，便于运营管理。
1. 分类列表主界面
页面顶部为操作栏，下方为分类数据列表：
- + 添加：打开添加分类弹窗，新建商品分类
- 清空：一键删除全部分类数据，操作不可逆，需谨慎使用
| 列表字段说明： | 字段 | 功能说明 |
|---|---|---|
| ID | 系统自动生成的分类唯一编号 | |
| 分类名称 | 分类的展示名称，前端商城会显示该分类标题 | |
| 分类状态 | 「显示」代表该分类在前端商城可见；关闭后分类隐藏，对应商品也不会对外展示 | |
| 操作 | 支持编辑分类名称、删除单条分类 |
2. 新增分类
点击顶部「+ 添加」打开弹窗，仅需填写分类名称，例如「机器人续费」「会员权益」「增值道具」等，填写完成后点击「添加分类」即可完成创建。
3. 分类日常运维
- 显示/隐藏：通过状态开关可快速上下架整个分类，无需逐个调整商品，适合临时下架整类商品
- 编辑：点击操作列「编辑」，可修改分类的名称
- 删除：删除单条分类，删除前建议先转移或删除分类下的所有商品，避免商品归属异常
- 清空：一键清除全部分类，仅建议初始化、重置商城时使用，操作前请务必备份数据
二、商品列表管理
1. 商品列表主界面
所有已创建的商品均在此列表展示，可统一管理价格、库存、上下架状态。
| 列表核心字段说明： | 字段 | 功能说明 |
|---|---|---|
| ID | 商品的唯一编号 | |
| 商品名称 | 对外展示的商品名称，建议标注规格，如「月卡{30天}」 | |
| 价格 | 商品的售卖单价 | |
| 状态 | 「显示」代表商品上架可购买；关闭后商品隐藏，无法下单 | |
| 发货方式 | 商品的发放形式，默认「自动发卡」，下单后自动提取卡密发放 | |
| 库存 | 商品剩余可售数量，自动发卡模式下与卡密条数对应 | |
| 请求 | API对接的请求方式，如GET/POST | |
| 编码 | 接口请求的编码格式，默认UTF-8 | |
| 分类ID | 商品归属的分类编号，与分类列表ID对应 | |
| 操作 | 支持编辑商品信息、删除单条商品 |
2. 添加商品详细配置
点击顶部「+ 添加」打开添加商品弹窗，按以下规则填写各项参数：
基础信息
- 商品分类：下拉选择商品归属的分类，需先在分类管理中创建对应分类
- 商品名称：填写商品的展示名称，建议清晰标注规格与有效期
- 商品价格：设置商品的售卖价格
发货与接口配置
- 发货方式：默认选择「自动发卡」，下单后系统自动从卡密库提取卡密发放给用户
- 请求方式：对接第三方发货接口时选择，支持GET请求、POST请求，无API对接保持默认即可
- 请求编码：接口传输的编码格式，默认UTF-8，无需修改
- 下单参数：下单时传递的参数项，例如下单QQ、QQ邮箱，多个参数用
|分隔 - Api接口：第三方自动发货接口的地址，无需API对接则留空
- POST参数：POST请求方式的传参内容，使用GET请求时留空即可
商品内容
- 商品简介：填写商品的描述、使用说明、注意事项等，下单页会展示给用户查看
- 卡密内容：自动发卡模式的核心配置，一行填写一个卡密，总行数即为商品库存，用户兑换后系统自动扣减库存
全部配置完成后，点击「添加商品」保存，商品将自动归入对应分类并按设置状态上架。
三、运维说明与配置示例
常用配置示例：机器人续费月卡
- 商品分类：机器人续费
- 商品名称：机器人月卡{30天}
- 商品价格：30
- 发货方式：自动发卡
- 卡密内容：提前录入30天激活码，一行一个
- 商品简介：购买后自动发放激活码，有效期30天，兑换后立即生效
注意事项
- 自动发卡类商品请确保录入的卡密准确有效，库存耗尽后商品将无法正常下单，需及时补充卡密。
- 关闭商品状态仅隐藏商品，不会删除卡密与配置，可随时重新上架。
- 对接第三方API发货时，请先测试接口连通性与参数格式，避免用户下单后发货失败。
- 删除商品会同步清除对应的卡密数据，删除前请确认无需保留库存。
- 分类与商品均支持批量清空，操作不可逆，执行前请务必备份重要的卡密与配置数据。