0cd8fc9d64399eac1154eb0705e3acf7f36c5001
CardAuth - 卡密授权管理系统
半成品,持续开发中。
一个轻量级的卡密(激活码)+ 机器授权管理系统,支持多项目管理、代理分销、在线支付购买,适用于软件授权、会员激活等场景。
技术栈
| 层 | 技术 |
|---|---|
| 后端 | PHP 7.4+ 自研框架(Router + Middleware + Controller) |
| 数据库 | MySQL 8.0+ |
| 前端 | Vue 3 + Element Plus + Pinia |
| 构建 | Vite |
功能概览
角色体系
- 超级管理员:全部权限,用户管理、项目管理、系统配置、操作日志
- 项目管理员:仅管理指定项目(不会看到代理信息),可操作卡密、授权、订单
- 代理:代理商城、卡密生成/导入(余额扣费)、授权管理,可发展下级代理
核心功能
- 项目与 API 密钥管理(每个项目独立密钥,API 鉴权)
- 商品/套餐管理(自定义时长、价格、代理价格)
- 卡密生成、批量导入、状态追踪
- 在线授权(直接创建授权,不依赖卡密;代理按代理价扣费)
- 代理余额体系(充值记录、扣费追溯、额度查询)
- 订单管理(代客手动完成 / 手动确认)
- 在线购买商城(公开页面,支持 epay/codepay 支付回调)
- 黑名单系统(机器码/IP 封禁,可配置封禁策略)
- 操作日志
内置页面
/仪表盘/login管理员登录/agent/login代理登录/agent/register代理注册/shop自助购买(公开页面)
快速开始
环境要求
- PHP 7.4+(需启用 PDO、PDO_MySQL)
- MySQL 8.0+
- Node.js 16+
1. 初始化数据库
mysql -u root -p < backend/database/schema.sql
2. 配置后端
cd backend
cp .env.example .env
# 编辑 .env 填入数据库信息
3. 安装 PHP 依赖
cd backend
php composer.phar install
4. 启动
# 一键启动(前端 + 后端)
.\start.ps1
# 或分别启动
cd backend && php -S 0.0.0.0:8080 -t backend
cd frontend && npm install && npm run dev
5. 访问
- 管理后台:
http://localhost:3000 - 代理登录:
http://localhost:3000/#/agent/login - 购买商城:
http://localhost:3000/#/shop
6. 默认管理员
数据库默认会插入 admin / admin123 的超级管理员账号(需在 schema.sql 末尾自行添加 INSERT 语句,或在用户管理页面注册后手动修改角色)。
项目结构
card/
├── backend/ # PHP 后端
│ ├── app/
│ │ ├── Controllers/ # 控制器 (11 个模块)
│ │ ├── Core/ # 框架核心 (Router/Controller/Database/Middleware/Validator)
│ │ ├── Middleware/ # 中间件 (Auth/JWT/RateLimit/ApiKey/Blacklist/Role)
│ │ └── Services/ # 服务层 (Jwt/Blacklist/Permission/Snowflake)
│ ├── config/ # 配置文件
│ ├── database/ # SQL 与 Migration
│ └── routes/ # 路由定义
├── frontend/ # Vue 3 前端
│ └── src/
│ ├── api/ # 接口封装
│ ├── composables/ # 组合式函数
│ ├── router/ # 路由配置
│ ├── stores/ # Pinia 状态管理
│ └── views/ # 页面组件 (管理后台 + 代理 + 公开)
└── deploy/ # 部署配置 (Nginx + 宝塔)
待完善
- 支付回调验签完善
- 代理层级佣金结算
- 数据统计与报表导出
- 单元测试与 E2E 测试覆盖
- Docker 化部署
License
MIT