# beggars-kami **Repository Path**: heda321/beggars-kami ## Basic Information - **Project Name**: beggars-kami - **Description**: > 基于 FastAdmin 二次开发的卡密生成、分发、兑换与权益发放系统。 > 面向虚拟商品场景:AI 次数包、会员天数卡、课程兑换码、测评报告券等。 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-14 - **Last Updated**: 2026-11-14 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # kami-center · 卡密与权益发放系统=== > 基于 FastAdmin 二次开发的卡密生成、分发、兑换与权益发放系统。 > 面向虚拟商品场景:AI 次数包、会员天数卡、课程兑换码、测评报告券等。 ## 项目简介 `kami-center` 是一个轻量级的虚拟商品卡密系统。它解决的核心问题只有三件事: 1. **生成卡密**:按批次批量生成随机卡密,支持面值配置; 2. **分发卡密**:导出未使用卡密,用于线上销售或线下发放; 3. **兑换权益**:用户输入卡密后,原子性地为其账户发放对应权益(次数 / 天数 / 权限)。 与通用发卡系统不同的是,本项目把「**卡密状态变更**」和「**用户权益发放**」打通在同一个事务边界内,避免出现"卡密已核销、权益没到账"或"权益重复到账"的问题。 本项目基于开源项目 **beggars-kami** 二次开发,沿用其卡密生成与分发骨架,并补充了权益发放、兑换幂等、多产品类型解耦等能力。 ## 核心特性 - **批次化卡密生成**:按批次生成,支持自定义面值、数量、备注,便于对账与作废 - **卡密状态管理**:未使用 / 已使用 / 已作废,后台可视化管理 - **兑换原子性**:使用条件更新语句保证并发下不超发、不重复核销 - **兑换幂等**:网络重试或重复提交不会重复加次数 - **多产品类型解耦**:通过 `product_type` 区分不同权益,一套系统服务多个业务场景 - **权益类型可扩展**:次数包、天数卡、课程权限等,按需注册 - **兑换记录与审计**:记录兑换人、时间、IP、权益数量,便于纠纷追溯 - **防暴力猜码**:兑换接口带频率限制 - **后台管理开箱即用**:基于 FastAdmin 的 CRUD、Auth 权限与插件机制 - **可选能力**:邮件发卡、未使用卡密导出、批次作废 ## 技术栈 | 层级 | 技术 | | --- | --- | | 框架 | FastAdmin(ThinkPHP 5.1) | | 语言 | PHP 7.0 – 7.4 | | 数据库 | MySQL 5.7 | | 前端 | Layui / Bootstrap(FastAdmin 默认) | | 部署 | Nginx / Apache + PHP-FPM | > 注意:FastAdmin 部分老插件在 PHP 8.0+ 下可能存在兼容问题,建议使用 PHP 7.4 作为生产环境版本。 ## 数据表设计 | 表名 | 说明 | | --- | --- | | `kami_batch` | 卡密批次表:批次名、面值、数量、备注 | | `kami` | 卡密表:卡密码(唯一索引)、批次、面值、状态、使用人、使用时间 | | `kami_redeem_log` | 兑换记录表:卡密、用户、权益数量、IP、时间 | | `user` | FastAdmin 用户表,扩展 `remaining_count` 等权益字段 | ## 兑换逻辑说明 兑换接口的核心是「先核销卡密,成功后再发权益」,且核销使用条件更新保证原子性: ```sql UPDATE kami SET status = 'used', used_by = ?, used_at = NOW() WHERE kami_code = ? AND status = 'unused';