客服独立授权站 - 项目文档

📋 项目概述

这是一个基于PHP开发的软件授权管理平台，为开发者提供安全、稳定、高效的授权管理服务。系统支持用户注册、商品管理、卡密管理、授权验证等核心功能。

项目特点

🔐 安全可靠 - 采用先进的加密技术和安全验证机制
⚡ 高效便捷 - 简洁直观的管理界面，一键式操作流程
📊 数据分析 - 实时监控授权状态和使用情况
🛠️ 灵活配置 - 支持多种授权模式和自定义配置
🌐 API接口 - 提供完善的RESTful API
💬 技术支持 - 专业的技术团队提供7×24小时技术支持

🗂️ 项目结构

客服独立授权站/
├── admin/                    # 后台管理目录
│   ├── assets/              # 静态资源文件
│   │   ├── css/            # 样式文件
│   │   ├── js/             # JavaScript文件
│   │   └── img/            # 图片资源
│   ├── db/                  # 数据库类库
│   │   ├── Medoo.php       # Medoo数据库框架
│   │   └── config.php      # 数据库配置
│   ├── epay/                # 支付接口
│   ├── layuiadmin/          # LayUI后台框架
│   ├── api.php              # 后台API接口
│   ├── auth.php             # 授权管理
│   ├── card.php             # 卡密管理
│   ├── goods.php            # 商品管理
│   ├── user.php             # 用户管理
│   ├── levels.php           # 等级管理
│   ├── recharge.php         # 充值管理
│   ├── config.inc.php       # 数据库配置文件
│   └── ...
├── user/                     # 用户中心目录
│   ├── index.php            # 用户中心首页
│   ├── login.php            # 用户登录
│   ├── invite.php           # 用户注册
│   ├── goods.php            # 商品列表
│   ├── my_auth.php          # 我的授权
│   ├── my_cards.php         # 我的卡密
│   ├── api.php              # 用户API接口
│   └── ...
├── install/                  # 安装向导
│   ├── index.php            # 安装页面
│   ├── mysql.sql            # 数据库结构
│   ├── install.lock         # 安装锁定文件
│   └── ...
├── vendor/                   # Composer依赖包
│   ├── phpmailer/           # 邮件发送库
│   ├── guzzlehttp/          # HTTP客户端
│   ├── rybakit/msgpack/     # 消息打包库
│   └── ...
├── logs/                     # 日志目录
│   └── cache/               # 缓存文件
├── uploads/                  # 上传文件目录
├── includes/                 # 公共类库
│   └── DownLoad.php         # 文件下载类
├── index.php                 # 网站首页
├── api.php                   # 前台API接口
├── fun.php                   # 核心函数库
├── fun.ajax.php             # AJAX初始化文件
├── main.php                  # 主要业务逻辑
├── pay.php                   # 支付处理
├── composer.json             # Composer配置
└── README.md                 # 项目文档

🚀 技术栈

后端技术

PHP 7.1 - 7.4 - 服务器端编程语言
MySQL/MariaDB - 关系型数据库
Medoo - 轻量级数据库框架
Composer - PHP依赖管理工具

前端技术

HTML5 / CSS3 - 页面结构与样式
JavaScript / jQuery - 前端交互
Vue.js - 前端MVVM框架
LayUI - 后台UI框架
Element UI - 前端组件库
Vant - 移动端组件库
ECharts - 数据可视化

第三方服务

PHPMailer - 邮件发送服务
Guzzle HTTP - HTTP客户端
MessagePack - 高效序列化格式

💾 数据库设计

核心数据表

1. 用户表 (lh_user)

存储用户基本信息和账户余额

字段名	类型	说明
id	int	用户ID（主键）
username	varchar(255)	用户名
password	varchar(255)	密码（加密）
money	varchar(255)	账户余额
code	int	账户状态（1=正常，0=禁用）
qq	varchar(255)	QQ号码
ip	text	登录IP记录
addtime	varchar(255)	注册时间

2. 用户等级表 (lh_user_levels)

管理用户等级和折扣信息

字段名	类型	说明
id	int	等级ID（主键）
name	varchar(255)	等级名称
price	decimal(10,2)	等级价格
discount	decimal(5,4)	折扣率（如0.9表示9折）
create_time	datetime	创建时间

3. 商品表 (lh_goods)

存储可销售的授权商品

字段名	类型	说明
id	int	商品ID（主键）
name	varchar(255)	商品名称
price	varchar(255)	商品价格
image	varchar(255)	商品图片
docs	text	商品详情描述
state	int	商品状态（1=上架，2=下架）
gid	int	远程商品ID
addtime	varchar(255)	添加时间

4. 卡密表 (lh_card)

管理授权卡密信息

字段名	类型	说明
id	int	卡密ID（主键）
cid	varchar(255)	关联卡密ID
card_key	varchar(255)	激活卡密
card_type_name	varchar(255)	卡密类型
status_text	varchar(255)	使用状态
uid	int	分配的用户ID
addtime	varchar(255)	新增时间
created_at	varchar(255)	创建时间

5. 授权表 (lh_auth)

记录授权激活信息

字段名	类型	说明
id	int	授权ID（主键）
auth_id	varchar(255)	关联授权ID
license_key	varchar(255)	激活卡密
authorized_domain	varchar(255)	授权域名
authorized_email	varchar(255)	授权邮箱
status_text	varchar(255)	授权状态
expire_time_text	varchar(255)	授权卡类型
last_verify_time	varchar(255)	最后验证时间
uid	int	关联用户ID
source_code_url	varchar(255)	源码地址
addtime	varchar(255)	新增时间

6. 充值记录表 (lh_pay)

记录用户充值订单

字段名	类型	说明
id	int	订单ID（主键）
user_id	int	用户ID
order_no	varchar(225)	充值订单号
recharge_amount	decimal(10,2)	充值金额
recharge_type	varchar(225)	充值方式
recharge_status	tinyint	充值状态
transaction_no	varchar(128)	第三方交易流水号
recharge_time	datetime	充值时间
completion_time	datetime	完成时间
remark	varchar(255)	备注

7. 用户日志表 (lh_user_log)

记录用户操作日志

字段名	类型	说明
id	int	日志ID（主键）
content	text	日志内容
uid	int	关联用户ID
value	text	操作值
addtime	varchar(255)	记录时间
ext1-ext9	text	扩展字段

8. 系统配置表 (lh_config)

存储系统配置信息

字段名	类型	说明
K	varchar(255)	配置键（主键）
V	text	配置值
C	text	配置说明
id	int	配置ID

9. 邮件配置表 (lh_mail)

存储邮件服务器配置

字段名	类型	说明
id	int	配置ID（主键）
token	varchar(255)	邮箱授权码
mail	varchar(255)	邮箱地址
smtp	varchar(255)	SMTP服务器
ssl	varchar(255)	SSL设置
port	varchar(255)	端口号
from	varchar(255)	发件人名称

🔧 安装部署

环境要求

PHP 7.1 - 7.4
MySQL 5.6+ 或 MariaDB 10.0+
Apache/Nginx Web服务器
Composer（可选）

安装步骤

上传项目文件到服务器
- 将所有文件上传到网站根目录

设置文件权限

# 设置文件所有者为www用户组
chown -R www:www ./

# 设置目录权限为755
chmod -R 755 ./

# 设置上传和日志目录为可写
chmod -R 777 ./uploads/
chmod -R 777 ./logs/

访问域名进行自助安装
- 直接访问您的域名（如：http://yourdomain.com）
- 系统会自动跳转到安装向导页面
- 按照提示填写数据库信息和管理员账号
- 完成安装后系统会自动锁定安装程序

📱 功能模块

前台功能

1. 用户中心

用户注册 - 支持邮箱/用户名注册
用户登录 - 安全的登录验证机制
个人资料 - 查看和修改个人信息
账户余额 - 查看余额和充值记录

2. 商品购买

商品列表 - 展示所有上架商品
商品详情 - 查看商品详细信息
等级价格 - 根据用户等级显示优惠价格
在线支付 - 支持支付宝、微信、QQ支付

3. 授权管理

我的授权 - 查看所有授权记录
授权激活 - 使用卡密激活授权
授权续期 - 为即将过期的授权续期
授权详情 - 查看授权域名、邮箱等信息

4. 卡密管理

我的卡密 - 查看购买的卡密列表
卡密使用 - 激活使用卡密
卡密状态 - 查看卡密使用状态

后台功能

1. 系统设置

基础设置 - 网站标题、备案号等
支付配置 - 配置支付接口参数
邮件配置 - 配置SMTP邮件服务
安全设置 - Token、密钥等安全配置

2. 用户管理

用户列表 - 查看所有注册用户
用户编辑 - 修改用户信息和余额
用户禁用 - 禁用违规用户账号
等级管理 - 设置用户等级和折扣

3. 商品管理

商品列表 - 管理所有商品
添加商品 - 创建新商品
编辑商品 - 修改商品信息和价格
上下架 - 控制商品显示状态
等级价格 - 为不同等级设置专属价格

4. 授权管理

授权列表 - 查看所有授权记录
授权分配 - 为用户分配授权
授权监控 - 监控授权使用状态
授权同步 - 从远程服务器同步授权数据

5. 卡密管理

卡密列表 - 管理所有卡密
生成卡密 - 批量生成卡密
卡密分配 - 为用户分配卡密
卡密监控 - 监控卡密使用情况

6. 订单管理

充值订单 - 查看充值订单列表
订单详情 - 查看订单详细信息
订单处理 - 手动处理异常订单

7. 日志管理

用户日志 - 查看用户操作记录
系统日志 - 查看系统运行日志
API日志 - 查看API调用记录

🔌 API接口

前台API (api.php)

获取商品列表

GET /api.php?act=getGoodsList

响应示例：

{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "list": [
      {
        "id": 1,
        "name": "商品名称",
        "price": "99.00",
        "image": "/path/to/image.jpg",
        "docs": "商品详情",
        "custom_level_prices": ["89.00", "79.00", "69.00"],
        "user_level_price": "89.00",
        "user_level_name": "VIP用户",
        "is_logged_in": true
      }
    ],
    "total": 10
  }
}

获取支付状态

GET /api.php?act=getPay&out_trade_no=订单号

卡密监控同步

GET /api.php?act=card_monitor&token=系统密钥

授权监控同步

GET /api.php?act=auth_monitor&token=系统密钥

商品监控同步

GET /api.php?act=goods_monitor&token=系统密钥

用户中心API (user/api.php)

所有用户相关的API接口，需要用户登录后访问。

后台API (admin/api.php)

所有后台管理API接口，需要管理员权限访问。

🎨 前端特性

响应式设计

完美支持PC、平板、手机等多种设备
自适应布局，提供最佳浏览体验

现代化UI

采用最新的设计风格
流畅的动画效果
优雅的过渡效果
美观的毛玻璃效果（Glassmorphism）

用户体验

友好的错误提示
加载动画反馈
表单验证提示
操作确认对话框

🔒 安全机制

数据安全

SQL注入防护 - 使用参数化查询
XSS防护 - 输入输出过滤
CSRF防护 - Token验证机制
密码加密 - 使用安全的哈希算法

访问控制

登录验证 - Session + Cookie双重验证
权限控制 - 用户权限分级管理
IP记录 - 记录用户登录IP
操作日志 - 详细的操作记录

支付安全

订单验证 - 严格的订单验证流程
支付回调验证 - 验证支付平台回调
订单锁机制 - 防止重复处理
异步通知 - 支付结果异步通知

🛠️ 开发指南

核心文件说明

fun.php

核心函数库，包含系统所需的各种辅助函数：

数据处理函数
安全过滤函数
字符串处理函数
时间处理函数
文件操作函数

fun.ajax.php

AJAX初始化文件，负责：

环境检测和初始化
数据库连接
会话管理
配置加载
用户状态验证

main.php

主要业务逻辑文件，包含：

订单处理逻辑
支付回调处理
数据同步逻辑

添加新功能

在相应的PHP文件中添加处理逻辑
在数据库中添加必要的表或字段
创建前端页面和交互逻辑
添加API接口（如需要）
更新权限控制（如需要）

📊 系统优化

性能优化

数据库索引 - 为常用查询字段添加索引
查询优化 - 避免N+1查询问题
缓存机制 - 使用文件缓存减少数据库查询
静态资源 - 使用CDN加速静态资源加载

代码优化

代码复用 - 提取公共函数和类
错误处理 - 完善的异常处理机制
日志记录 - 详细的操作日志
代码注释 - 清晰的代码注释

🐛 常见问题

安装问题

Q: 提示"为了更好的使用程序,当前PHP版本最低设置为7.1，最高为7.4"
A: 请检查服务器PHP版本，必须在7.1-7.4之间。

Q: 安装时提示数据库连接失败
A: 检查数据库配置信息是否正确，确保数据库服务正常运行。

Q: 安装后无法访问后台
A: 检查 install/install.lock 文件是否存在且内容为"安装锁"。

使用问题

Q: 用户无法登录
A: 检查用户账号状态（code字段），1为正常，0为禁用。

Q: 支付后订单未到账
A: 查看支付日志表，检查支付回调是否正常。检查支付配置是否正确。

Q: 卡密无法使用
A: 检查卡密状态，确认是否已被使用或过期。

性能问题

Q: 页面加载缓慢
A:

检查数据库查询是否有慢查询
开启PHP OpCache
使用CDN加速静态资源
优化数据库索引

Q: 数据库占用高
A:

定期清理过期日志
优化数据库查询
添加合适的索引

📄 许可证

本项目为商业软件，未经授权不得用于商业用途。

💬 技术支持

如有问题或建议，请联系技术支持团队。

最后更新时间： 2025-10-24
文档版本： 1.0.0