Files
CardAuth/README.md
T
2026-06-23 12:25:24 +08:00

3.6 KiB
Raw Blame History

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