管理员指南
兑换码管理
批量生成和管理配额兑换码
兑换码用于活动赠送或用户自助充值额度。用户兑换入口为 `/console/wallet` 兑换码区域。管理员批量生成与管理需通过 `POST /api/redeem_code` 等管理接口操作，Web 管理页尚未上线。
| ID | 名称 | 状态 | 额度 | 创建时间 | 过期时间 | 兑换人 ID | 操作 | |
|---|---|---|---|---|---|---|---|---|
| ☐ | 101 | 活动赠送-3月 | 未使用 | 5000 | 2026-06-01 | 2026-12-31 | — | 查看 · 复制 · 编辑 · 删除 |
| ☐ | 88 | 内测补偿 | 已使用 | 1000 | 2026-05-10 | — | 2 | 查看 · 复制 · 编辑 · 删除 |
显示第 1 条 – 第 10 条，共 214 条 · 每页 10 条
兑换码列表示意：批量操作、搜索与分页
批量生成兑换码
打开生成弹窗
- 在兑换码列表页点击「添加兑换码」
- 弹窗中填写批次名称、数量与额度等参数
- 也可编辑已有记录：行内「编辑」或
GET /api/redeem_code/{id}
设置生成参数
| 参数 | 说明 |
|---|---|
name · 名称 | 批次名称或前缀，便于列表识别 |
count · 生成数量 | 一次批量生成的兑换码个数 |
quota · 额度 | 每个兑换码可兑换的额度面值 |
expired_time · 过期时间 | 可选；到期后状态变为已过期 |
status · 状态 | 新建默认启用；可预先禁用 |
生成兑换码
- 点击「生成」提交
POST /api/redeem_code - 系统为每条记录生成 32 位唯一
key，写入redemption表 - 列表默认由
GET /api/redeem_codes分页返回；用户兑换后更新used_user_id与redeemed_time - 用户侧兑换见
/console/wallet与 配额与充值 文档
导出兑换码
- 生成完成后，在结果区复制单条 key 或「复制所选兑换码到剪贴板」
- 行内「复制」快速复制一条完整兑换码
- 可将 key 列表导出为文本文件，用于活动发放或邮件推送
- 兑换码 key 具有额度价值，请通过安全渠道分发，勿公开提交到代码仓库
列表字段与操作
| 列 | 字段 | 说明 |
|---|---|---|
| ID | id | 兑换码记录 ID |
| 名称 | name | 批次或用途名称，便于识别 |
| 状态 | status | 未使用 / 已使用 / 已禁用 / 已过期 |
| 额度 | quota | 兑换成功后入账的额度数量 |
| 创建时间 | created_time | 生成时间戳 |
| 过期时间 | expired_time | 过期后不可兑换；留空表示永不过期 |
| 兑换人 ID | used_user_id | 已使用时记录兑换用户 ID |
- 添加兑换码（
POST /api/redeem_code）：打开生成弹窗，批量创建兑换码 - 复制所选到剪贴板：勾选多条后复制完整 key（32 位）
- 清除失效兑换码（
DELETE /api/redemption/invalid）：删除已使用、已过期或已禁用的记录 - 搜索（
GET /api/redeem_codes?keyword=）：按 ID 或名称关键词筛选
- 查看（
GET /api/redemption/{id}）：查看兑换码详情与完整 key - 复制：复制单条兑换码 key 到剪贴板
- 编辑（
PUT /api/redeem_code/{id}）：修改名称、额度、过期时间或状态 - 删除（
DELETE /api/redemption/{id}）：删除单条记录（不可恢复）
管理员边栏可在 个人设置 → 边栏模块中开启 sidebar_modules.admin.redemption。