ZY俱乐部陪玩系统php源码 PHP+SQLite3开发

admin 发表于 2026-5-19 19:24:35

ZY俱乐部陪玩系统php源码 PHP+SQLite3开发

AI写的，可以参考学习一下，源码不是很完整

# ZY俱乐部陪玩系统 - 功能更新说明

## 更新日期
2026-03-23

## 更新内容

### 1. 店员工作台订单隐藏老板ID

**修改文件：** `staff-panel.php`

**功能说明：**
- 待接订单列表中不再显示老板的游戏ID
- 店员接单后，在"我的订单"中才会显示老板的游戏ID

**修改内容：**
- 待接订单部分：移除了游戏ID的显示
- 我的订单部分：添加了游戏ID的显示

---

### 2. 修复指定店员跳转问题

**修改文件：** `staff.php`

**问题描述：**
- 店员列表中的"指定"按钮原来跳转到 `staff-order.php`，这是一个简单的下单页面

**修复内容：**
- 将"指定"按钮的跳转链接改为 `products.php?staff_id=xxx`
- 点击"指定"后，会跳转到商品页面，用户可以选择商品后下单
- 商品页面会显示已指定店员的提示信息

---

### 3. 添加商品可隐藏功能

**修改文件：**
- `admin/products.php`（后台商品管理）
- `products.php`（前台商品列表）
- `product-detail.php`（商品详情页）

**功能说明：**

#### 3.1 后台管理
- 添加/编辑商品时，可以选择"正常显示"或"隐藏商品"
- 商品列表中，隐藏的商品会显示"已隐藏"标签，并带有半透明效果

#### 3.2 前台显示
- 隐藏的商品不会在前台商品列表中显示
- 隐藏的商品无法通过直接访问链接查看
- 数据库自动添加 `is_hidden` 字段（如果不存在）

---

### 4. 显示商品类型

**修改文件：**
- `products.php`（前台商品列表）
- `product-detail.php`（商品详情页）

**功能说明：**
- 商品列表中，商品名称旁边显示商品类型标签（护航/陪玩/代肝）
- 商品详情页，商品标题旁边显示商品类型标签
- 不同类型有不同的颜色标识：
- 护航：橙色背景 (#fff3e0, #e65100)
- 陪玩：蓝色背景 (#e3f2fd, #1565c0)
- 代肝：紫色背景 (#f3e5f5, #7b1fa2)

---

## 部署步骤

### 第一步：备份现有文件
```bash
cd /www/wwwroot/zyjlb.xulove.top/1
cp staff-panel.php staff-panel.php.backup.$(date +%Y%m%d)
cp staff.php staff.php.backup.$(date +%Y%m%d)
cp products.php products.php.backup.$(date +%Y%m%d)
cp product-detail.php product-detail.php.backup.$(date +%Y%m%d)
cp admin/products.php admin/products.php.backup.$(date +%Y%m%d)
```

### 第二步：上传更新文件
将 `zy_update_features.tar.gz` 上传到服务器 `/www/wwwroot/zyjlb.xulove.top/1` 目录

### 第三步：解压更新文件
```bash
cd /www/wwwroot/zyjlb.xulove.top/1
tar -xzf zy_update_features.tar.gz
```

### 第四步：验证更新
1. 访问店员工作台，确认待接订单不显示游戏ID
2. 接单后，在"我的订单"中确认显示游戏ID
3. 访问店员列表，点击"指定"按钮，确认跳转到商品页面
4. 在后台添加/编辑商品，测试隐藏功能
5. 在前台确认隐藏的商品不显示
6. 确认商品类型标签正确显示

---

## 注意事项
1. 更新前务必备份原有文件
2. 数据库会自动添加 `is_hidden` 字段（如果不存在）
3. 隐藏的商品在前台完全不可见，包括商品列表和商品详情页

# ZY俱乐部电竞陪玩系统 - 项目报告

## 一、项目概述

### 1.1 项目简介

ZY俱乐部是一款专业的电竞陪玩服务平台的完整源代码，采用PHP+SQLite3技术栈开发。系统提供完整的用户体系、陪玩店员管理、商品服务、订单处理、支付集成等核心功能，支持邮箱验证码登录和后台灵活配置支付接口参数。

### 1.2 项目定位

本系统旨在为电竞陪玩行业提供一套完整、可定制、易部署的解决方案。适合想要搭建陪玩平台的企业或个人使用。

### 1.3 技术选型

| 技术类别 | 选型方案 | 说明 |
|---------|---------|------|
| 后端语言 | PHP 7.0+ | 主流Web开发语言，兼容性好 |
| 数据库 | SQLite3 | 轻量级数据库，无需额外安装配置 |
| 前端技术 | HTML5 + CSS3 + JavaScript | 原生技术，无框架依赖 |
| 支付集成 | 彩虹易支付API | 成熟稳定的支付接口方案 |
| 邮件服务 | PHP mail()函数 | 内置邮件发送支持 |

---

## 二、功能架构

### 2.1 整体功能架构图

```
┌─────────────────────────────────────────────────────────┐
│ 前台用户系统 │
├─────────────┬─────────────┬─────────────┬───────────────┤
│用户注册 │用户登录 │商品浏览 │ 订单管理 │
│邮箱验证 │密码登录 │店员查看 │ 余额充值 │
│个人信息 │消息通知 │服务下单 │ 截图上传 │
└─────────────┴─────────────┴─────────────┴───────────────┘
 │
 ▼
┌─────────────────────────────────────────────────────────┐
│ 核心业务系统 │
├─────────────┬─────────────┬─────────────┬───────────────┤
│陪玩店员 │商品服务 │订单流程 │ 支付系统 │
│店员注册 │商品管理 │订单创建 │ 支付接口 │
│审核管理 │分类管理 │订单跟踪 │ 佣金结算 │
│佣金提现 │价格设置 │状态流转 │ 截图审核 │
└─────────────┴─────────────┴─────────────┴───────────────┘
 │
 ▼
┌─────────────────────────────────────────────────────────┐
│ 后台管理系统 │
├─────────────┬─────────────┬─────────────┬───────────────┤
│系统设置 │用户管理 │店员管理 │ 订单管理 │
│邮箱配置 │信息查看 │审核管理 │ 状态处理 │
│支付配置 │权限管理 │统计报表 │ 投诉处理 │
│Logo设置 │余额管理 │佣金管理 │ 截图审核 │
├─────────────┴─────────────┴─────────────┴───────────────┤
│ 商品管理 │ 分类管理 │ 卡密管理 │ 公告管理│
└─────────────────────────────────────────────────────────┘
```

---

## 三、核心功能详解

### 3.1 用户系统

#### 3.1.1 用户注册
- **普通注册**：用户名、密码、昵称、手机号（可选）、邮箱（可选）
- **邮箱验证**：支持发送6位数字验证码到邮箱，5分钟有效
- **角色区分**：普通用户(user)、店员(staff)、管理员(admin)

#### 3.1.2 用户登录
- **密码登录**：传统用户名+密码方式
- **邮箱验证码登录**：输入邮箱地址，获取验证码，快速登录
- **会话管理**：Session-based认证机制

#### 3.1.3 个人中心
- 个人信息查看与编辑
- 账户余额显示
- 我的订单列表
- 消息通知查看
- 退出登录

### 3.2 店员系统

#### 3.2.1 店员注册
- **普通申请**：填写基本信息、擅长游戏、单价描述
- **卡密快速审核**：输入卡密直接通过审核（用于地推等场景）
- **审核流程**：待审核→已通过/已拒绝

#### 3.2.2 店员资料
- 店员名称和头像
- 服务标签（如：上分王者、陪玩女神等）
- 擅长游戏列表
- 服务单价（元/小时）
- 个人简介描述
- 评分和接单数

#### 3.2.3 店员管理
- 接单/拒单功能
- 订单状态更新
- 完成服务后上传截图
- 佣金收入查看
- 佣金提现申请

### 3.3 商品服务系统

#### 3.3.1 商品管理
- 商品名称、图标、详细描述
- 关联游戏分类
- 价格设置（单价/小时）
- 上下架状态控制

#### 3.3.2 分类管理
- 支持多级分类（父分类+子分类）
- 分类图标和图片
- 排序权重设置
- 分类启用/禁用

#### 3.3.3 商品展示
- 首页热门商品推荐
- 分类浏览
- 商品详情页
- 店员服务关联

### 3.4 订单系统

#### 3.4.1 订单创建流程
```
用户选择服务 → 填写游戏信息(游戏ID/服务器) → 确认订单 → 在线支付 → 支付成功
```

#### 3.4.2 订单状态流转
```
待支付 → 已支付(待接单) → 已接单(服务中) → 已完成(待审核) → 已结算
 │ │ │
 └── 支付超时 ─────┘ └── 截图审核拒绝 → 重新上传
 │
 └── 审核通过 → 佣金结算
```

#### 3.4.3 订单信息
- 订单编号（唯一标识）
- 关联用户和店员
- 商品信息（名称、价格）
- 游戏信息（游戏ID、所在服务器）
- 联系方式和备注
- 支付信息（支付状态、支付方式、交易流水号）
- 截图凭证（服务完成截图）
- 佣金信息（佣金金额、结算状态）

### 3.5 支付系统

#### 3.5.1 支付配置（后台可设置）
- **支付接口地址**：可配置不同的支付网关
- **商户ID(PID)**：商户标识
- **商户密钥(KEY)**：接口验证密钥

#### 3.5.2 支付流程
- 用户选择支付方式（支付宝/微信等）
- 系统调用支付API生成支付链接
- 用户完成支付
- 支付平台异步通知系统支付结果
- 系统更新订单状态

#### 3.5.3 支付回调
- **异步回调(notify_url.php)**：支付平台主动通知，处理订单状态更新
- **同步回调(return_url.php)**：用户支付后页面跳转，展示支付结果

### 3.6 邮件验证系统

#### 3.6.1 邮箱配置（后台可设置）
- SMTP服务器地址
- SMTP端口
- SMTP用户名（发件人邮箱）
- SMTP密码/授权码
- 发件人名称

#### 3.6.2 验证码功能
- **注册验证码**：新用户注册时验证邮箱有效性
- **登录验证码**：邮箱验证码快捷登录
- **验证码机制**：
- 6位数字随机码
- 有效期5分钟
- 单次使用，用后即焚
- 请求间隔60秒限制

### 3.7 佣金系统

#### 3.7.1 佣金计算
- 系统按订单金额的设定比例计算佣金（默认10%）
- 支持自定义店员佣金比例
- 订单完成后自动计算佣金

#### 3.7.2 佣金结算
- 店员可查看累计佣金收入
- 截图审核通过后佣金入账
- 店员可申请提现

---

## 四、后台管理功能

### 4.1 系统设置
- 网站Logo设置
- 网站名称设置
- 邮箱SMTP配置
- 支付接口配置

### 4.2 用户管理
- 查看所有注册用户
- 用户信息编辑
- 用户余额调整
- 用户角色管理

### 4.3 店员管理
- 店员申请审核
- 店员信息管理
- 店员状态管理（在线/离线）
- 店员收入统计

### 4.4 订单管理
- 所有订单列表
- 订单状态筛选
- 截图审核
- 投诉处理

### 4.5 商品管理
- 商品增删改查
- 商品上下架
- 商品分类管理
- 首页推荐设置

### 4.6 卡密管理
- 卡密批量生成
- 卡密类型设置
- 卡密使用记录
- 未使用卡密查看

### 4.7 轮播图管理
- 首页轮播图上传
- 轮播图链接设置
- 轮播图排序
- 轮播图启用/禁用

### 4.8 公告管理
- 系统公告发布
- 公告类型区分
- 公告置顶功能
- 用户已读状态

### 4.9 反馈管理
- 用户反馈查看
- 反馈回复功能
- 反馈处理状态

---

## 五、数据库设计

### 5.1 主要数据表

| 表名 | 说明 | 主要字段 |
|-----|------|---------|
| users | 用户表 | id, username, password, nickname, phone, email, role, balance |
| staff | 店员表 | id, user_id, name, games, price, rating, orders, audit_status |
| products | 商品表 | id, name, game, price, category_id, product_type, status |
| categories | 分类表 | id, name, icon, image_url, sort, parent_id |
| orders | 订单表 | id, user_id, staff_id, total_amount, status, pay_status, screenshots |
| cards | 卡密表 | id, code, type, amount, status, used_by |
| email_codes | 邮箱验证码表 | id, email, code, type, expires_at, used |
| settings | 系统设置表 | key, value |
| notices | 公告表 | id, title, content, type, is_read |
| feedback | 反馈表 | id, user_id, content, status, reply |

### 5.2 核心关系

```
users (1) ──────< (N) orders
│ │
│ │
└─────< (N) staff │
 │ │
 └────< (N) orders
 │
 ▼
 products (N) >──── (1) categories
```

---

## 六、安全特性

### 6.1 认证安全
- 密码加密存储（md5 hash）
- Session会话管理
- 验证码单次使用
- 验证码时效性控制（5分钟）

### 6.2 输入安全
- SQL注入防护（Prepared Statements）
- XSS防护（htmlspecialchars转义）
- 表单数据验证

### 6.3 配置安全
- 敏感配置不硬编码
- 数据库配置集中管理
- 支付密钥可后台修改

---

## 七、部署要求

### 7.1 环境要求
- PHP 7.0 或更高版本
- SQLite3 扩展支持
- Apache/Nginx Web服务器
- PHP mail() 函数支持（邮件发送）

### 7.2 目录权限
- uploads/ 目录需要写权限
- database.sqlite 文件需要写权限

### 7.3 默认账户
- 管理员后台：/admin/
- 用户名：admin
- 密码：123456

---

## 八、文件结构

```
├── admin/ # 后台管理
│ ├── index.php # 管理首页
│ ├── settings.php # 系统设置
│ ├── users.php # 用户管理
│ ├── staff.php # 店员管理
│ ├── orders.php # 订单管理
│ ├── products.php # 商品管理
│ ├── categories.php # 分类管理
│ ├── cards.php # 卡密管理
│ ├── banners.php # 轮播图管理
│ ├── notice.php # 公告管理
│ ├── feedback.php # 反馈管理
│ └── cleanup-images.php # 图片清理
│
├── api/ # API接口
│ ├── email.php # 邮箱验证码接口
│ ├── mark-notice-read.php # 标记公告已读
│ └── unread-count.php # 未读消息数
│
├── lib/ # 第三方库
│ ├── EpayCore.class.php # 支付核心类
│ └── epay.config.php # 支付配置
│
├── css/ # 样式文件
│ └── style.css # 主样式表
│
├── uploads/ # 上传文件目录
│ ├── avatars/ # 用户头像
│ ├── banners/ # 轮播图
│ ├── categories/ # 分类图片
│ ├── logo/ # 网站Logo
│ ├── notice/ # 公告图片
│ ├── order_screenshots/ # 订单截图
│ └── products/ # 商品图片
│
├── config.php # 核心配置文件
├── index.php # 网站首页
├── login.php # 登录页
├── register.php # 注册页
├── products.php # 商品列表
├── product-detail.php # 商品详情
├── orders.php # 订单列表
├── mine.php # 个人中心
├── recharge.php # 充值页
├── staff.php # 店员列表
├── staff-detail.php # 店员详情
├── staff-panel.php # 店员面板
├── staff-register.php # 店员注册
├── staff-order.php # 店员订单
├── chat.php # 聊天室
├── messages.php # 消息中心
├── customer-service.php # 客服页
├── payapi.php # 支付接口
├── notify_url.php # 支付异步通知
├── return_url.php # 支付同步返回
├── fix_database.php # 数据库修复
└── upgrade_db.php # 数据库升级
```

---

## 九、总结

### 9.1 系统优势
1. **开源可定制**：完整源代码，无加密，可根据需求二次开发
2. **轻量易部署**：SQLite数据库，无需额外数据库服务
3. **功能完善**：用户、店员、商品、订单、支付五大核心模块完整
4. **配置灵活**：邮箱、支付等关键参数后台可改
5. **安全可靠**：内置多种安全防护机制

### 9.2 适用场景
- 电竞陪玩工作室自建平台
- 游戏代练/陪玩服务网站
- 中小型陪玩服务平台搭建
- 二次开发学习参考

### 9.3 后续建议
1. 建议启用HTTPS保障通信安全
2. 定期备份数据库文件
3. 及时更新服务器PHP版本
4. 根据业务需求扩展功能模块

static/image/hrline/5.gif

**ZY俱乐部陪玩系统PHP源码开发指南**

1. **需求分析与规划**：
- 确定系统功能需求，如用户管理、陪玩推荐、订单处理等。
- 设计数据库结构，包括用户表、陪玩信息表、订单表等。
- 确定技术栈，如使用PHP、SQLite3等。

2. **环境搭建**：
- 安装PHP和MySQL。
- 配置SQLite3数据库，用于存储临时数据。

3. **核心模块开发**：
- 用户管理模块：实现用户注册、登录、信息修改等功能。
- 陪玩推荐模块：根据用户喜好和评分推荐陪玩。
- 订单处理模块：处理用户下单、支付、评价等操作。

4. **接口设计**：
- 设计RESTful API接口，方便前端调用。
- 设计数据库API，方便后端与数据库交互。

5. **测试与优化**：
- 进行单元测试、集成测试和性能测试。
- 根据测试结果对系统进行优化。

6. **部署与维护**：
- 将系统部署到服务器上。
- 定期更新系统，修复bug，增加新功能。

7. **文档编写**：
- 编写系统使用手册、API文档等。

**开发过程概览**：

1. **需求分析与规划**：明确系统功能和架构设计。
2. **环境搭建**：准备开发环境，包括工具和依赖。
3. **核心模块开发**：按照设计规范开发各功能模块。
4. **接口设计**：定义API接口和数据库交互方式。
5. **测试与优化**：确保系统稳定可靠，并进行性能调优。
6. **部署与维护**：将系统部署到生产环境，并持续维护。
7. **文档编写**：整理开发文档，便于后续使用和维护。

希望以上指南能帮助您顺利开发ZY俱乐部陪玩系统php源码。如果您需要更具体的代码示例或详细步骤，请随时提问。

[本文内容由人工智能AI辅助生成，仅供参考]

**** Hidden Message *****

defier 发表于 2026-5-20 08:32:25

很抱歉，但您提供的信息似乎不完整。如果您需要关于ZY俱乐部陪玩系统PHP源码的详细开发说明、更新内容或功能说明，请提供更多详细信息，以便我能够为您提供更准确的帮助。

[本文内容由人工智能AI辅助生成，仅供参考]

奔走的老鱼 发表于 2026-6-22 07:26:25