兑换码概览
管理员批量生成 → 发给用户 → 用户在
/redeem输入 → 额度到账。
兑换码是什么
一张「兑换凭证」。形如 ABCD-1234-EFGH-5678-...（24 位）。
每个码绑定：
- 一个额度值（直接给账户余额）
- 或一个套餐（兑换后激活该套餐）
- 可兑换次数（默认 1 次）
- 过期时间
典型场景
- 拉新活动：注册后给新用户发一个 50 元兑换码
- 社群福利：在社群发若干张码
- 客服补偿：用户遇到问题，给一张小额补偿码
- 企业合作：给合作方批量兑换码，他们分发给自己的客户
三种兑换码
后台创建时选一种：
| 类型 | 用户兑换后得到 |
|---|---|
| 额度码 | 用户余额 直接 +N（按 QuotaPerUnit 换算） |
| 套餐码 | 激活 Subscription，按该套餐的 duration_days 算到期时间 |
| 限免码 | 内部用的「限时免费」标记（开发中） |
完整生命周期
管理员后台创建
│
▼
批量导出（CSV / TXT）
│
▼
发给用户（社群 / 邮件 / 活动）
│
▼
用户在前台 /redeem 输入
│
▼
校验：是否过期 / 已用完 / 失效
│
▼
到账：余额 +N 或 激活订阅跟其他方式的区别
| 方式 | 用户得到什么 | 由谁发 |
|---|---|---|
| 兑换码 | 余额 / 订阅 | 管理员后台 |
| 套餐订单 | 订阅 | 用户自己下单支付 |
| 充值 | 余额 | 用户自己下单支付 |
兑换码适合「批量发放」场景；订单 / 充值适合「用户主动购买」。