wsh5485/carwash_order
Archived
1
0
Fork 0
Code Issues 2 Pull Requests Actions Packages Projects 1 Releases 8 Wiki Activity

docs: 更新README文档为完整订单管理系统说明

Browse Source 
- 扩展系统功能描述，增加详细技术架构和安装指南
- 添加完整的项目结构说明和功能模块文档
- 包含API接口文档和调试工具使用说明
- 增加常见问题解答和版本历史记录
This commit is contained in:
吴展鹏
2025-11-19 02:16:04 +08:00
parent cac504ee2e
commit 5619a1882e
1 changed files with 552 additions and 71 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+552 -71
View File
@@ -1,97 +1,578 @@
# 🚗 洗车预约系统
# 🚗 洗车店订单管理系统
现代化洗车预约管理系统，采用日历时间段选择模式，支持套餐管理和移动端优化。
一个功能完整的洗车店订单管理系统，支持VIP客户管理、订单处理、套餐管理等功能。
## ✨ 功能特性
## 📋 目录
- 📅 **日历选择** - 直观的周历显示和时间段网格
- ⚡ **快捷预约** - 1-4小时快捷时长选择，支持自定义
- 💼 **套餐管理** - 灵活的套餐配置和价格管理
- 📱 **移动优化** - 完美响应式设计，触摸友好
- 🔧 **管理功能** - 预约状态管理和时间冲突检查
- [系统概述](#-系统概述)
- [主要功能](#-主要功能)
- [技术架构](#-技术架构)
- [系统要求](#-系统要求)
- [安装指南](#-安装指南)
- [项目结构](#-项目结构)
- [功能模块](#-功能模块)
- [使用指南](#-使用指南)
- [API接口](#-api接口)
- [调试工具](#-调试工具)
- [常见问题](#-常见问题)
- [版本历史](#-版本历史)
## 🛠️ 技术栈
- **后端**: PHP 7.4+ | MySQL 5.7+
- **前端**: HTML5 + CSS3 + JavaScript
- **数据库**: PDO + MySQL
## 🎯 系统概述
本系统是一个专为洗车店设计的现代化订单管理平台，提供完整的客户管理、订单处理、VIP服务等功能。系统采用PHP + MySQL架构，界面简洁易用，功能完善稳定。
### 核心特性
- 🏆 **VIP客户管理** - 完整的VIP客户信息管理和搜索功能
- 📝 **订单管理** - 完整的洗车订单生命周期管理
- 📦 **套餐管理** - 灵活的洗车服务套餐配置
- 💾 **数据持久化** - 可靠的MySQL数据库存储
- 🔍 **搜索功能** - 强大的客户和订单搜索功能
- 📊 **报表统计** - 业务数据统计和报表功能
- 🛠️ **调试工具** - 完善的开发调试和监控工具
## 🚀 主要功能
### 1. 客户管理
- **客户信息录入** - 姓名、手机号、地址等基本信息
- **VIP客户管理** - 专门的VIP客户管理功能
- **客户搜索** - 支持姓名、手机号模糊搜索
- **客户分类** - 普通客户、VIP客户自动分类
### 2. 订单管理
- **订单创建** - 快速创建洗车订单
- **订单状态** - 待处理、进行中、已完成等状态管理
- **订单详情** - 完整的订单信息记录
- **订单搜索** - 多条件订单搜索功能
### 3. 套餐管理
- **服务套餐** - 预设洗车服务套餐
- **价格管理** - 灵活的价格设置
- **套餐配置** - 服务项目和时长配置
### 4. VIP服务
- **VIP专享** - 专门的VIP客户服务界面
- **优先处理** - VIP订单优先级处理
- **积分系统** - VIP积分管理和兑换
## 🏗️ 技术架构
### 前端技术
- **HTML5** - 现代化的页面结构
- **CSS3** - 响应式样式设计
- **JavaScript** - 动态交互和AJAX请求
- **Bootstrap** - UI组件库（可选）
### 后端技术
- **PHP 7.4+** - 服务器端脚本语言
- **MySQL 5.7+** - 关系型数据库
- **PDO** - 数据库抽象层
- **RESTful API** - 标准API设计
### 核心组件
- **数据库连接** (`db_connect.php`) - 统一的数据库连接管理
- **配置管理** (`config.php`) - 系统配置参数
- **VIP管理** (`vip.php`, `get_vip_customers.php`) - VIP客户相关功能
- **订单管理** (`bookings.php`) - 订单处理逻辑
## 💻 系统要求
### 服务器环境
- **PHP**: 7.4 或更高版本
- **MySQL**: 5.7 或更高版本
- **Web服务器**: Apache 2.4+ 或 Nginx 1.18+
- **PHP扩展**: PDO, PDO_MySQL, JSON
### 开发环境
- **操作系统**: Windows 10+, macOS 10.14+, Linux Ubuntu 18+
- **推荐工具**: XAMPP, WAMP, LAMP 或 Docker
- **浏览器**: Chrome 80+, Firefox 75+, Safari 13+
## 🔧 安装指南
### 1. 环境准备
#### 使用XAMPP（推荐）
```bash
# 下载并安装XAMPP
# 启动Apache和MySQL服务
```
#### 使用WAMP（Windows用户）
```bash
# 下载并安装WAMP
# 启动WAMP服务
```
### 2. 项目部署
#### 克隆项目
```bash
# 将项目文件复制到Web服务器根目录
# Windows (XAMPP): C:\xampp\htdocs\carwash_order\
# Linux/macOS: /var/www/html/carwash_order/
```
#### 数据库配置
```sql
-- 1. 创建数据库
CREATE DATABASE carwash_booking CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
-- 2. 导入数据库结构
SOURCE carwash_db.sql;
-- 3. 验证表创建
SHOW TABLES;
```
#### 配置文件设置
编辑 `config.php`：
```php
<?php
$host = 'localhost'; // 数据库主机
$username = 'root'; // 数据库用户名
$password = ''; // 数据库密码
$database = 'carwash_booking'; // 数据库名称
?>
```
### 3. 权限设置
#### Linux/macOS权限
```bash
# 设置目录权限
chmod -R 755 /var/www/html/carwash_order/
chown -R www-data:www-data /var/www/html/carwash_order/
```
#### Windows权限
确保IIS或Apache用户有读取项目文件的权限。
### 4. 访问测试
打开浏览器访问：
```
http://localhost/carwash_order/
```
## 📁 项目结构
## 📁 文件结构
```
carwash_order/
├── index.php # 预约首页
├── bookings.php # 预约管理
├── packages.php # 套餐管理
├── config.php # 数据库配置
├── db_connect.php # 数据库连接
├── carwash_db.sql # 数据库结构
└── style.css # 样式文件
├── README.md # 项目说明文档
├── SOLUTIONS.md # 解决方案文档
├── VIP_Function_Fix_Report.md # VIP功能修复报告
├── VIP_Search_Fix_Report.md # VIP搜索修复报告
│
├── 核心文件/
│ ├── index.php # 主页面入口
│ ├── config.php # 数据库配置
│ ├── db_connect.php # 数据库连接
│ └── style.css # 样式文件
│
├── 功能模块/
│ ├── vip.php # VIP客户管理
│ ├── bookings.php # 订单管理
│ ├── packages.php # 套餐管理
│ ├── get_vip_customers.php # VIP数据API
│ └── get_vip_customer.php # 单个VIP客户API
│
├── 数据库/
│ └── carwash_db.sql # 数据库结构和初始数据
│
├── 测试工具/
│ ├── test.php # 基础测试文件
│ ├── test_vip.php # VIP功能测试
│ ├── test_vip_loading.php # VIP数据加载测试
│ ├── verify_vip_data.php # VIP数据验证
│ ├── debug_vip.php # VIP调试工具
│ ├── vip_functionality_test.html # VIP功能测试页面
│ └── vip_search_debug.html # VIP搜索调试页面
│
└── 文档/
├── VIP_Function_Fix_Report.md
└── VIP_Search_Fix_Report.md
```
## 🚀 快速开始
## 🧩 功能模块
### 1. 环境要求
- PHP 7.4+ | MySQL 5.7+ | Web服务器
### 主系统模块
### 2. 数据库配置
```bash
mysql -u root -p < carwash_db.sql
#### 1. 客户管理系统
- **文件**: `index.php`, `vip.php`
- **功能**: 客户信息录入、编辑、查询
- **特性**:
- 支持VIP客户特殊标识
- 客户信息实时验证
- 搜索结果高亮显示
#### 2. 订单处理系统
- **文件**: `bookings.php`
- **功能**: 订单创建、状态管理、查询
- **特性**:
- 订单状态自动更新
- 服务套餐自动关联
- 订单历史记录
#### 3. 套餐管理系统
- **文件**: `packages.php`
- **功能**: 服务套餐配置、价格管理
- **特性**:
- 灵活的套餐配置
- 价格区间管理
- 套餐使用统计
### API接口模块
#### VIP客户接口
- **文件**: `get_vip_customers.php`
- **方法**: GET
- **返回**: JSON格式的VIP客户列表
- **参数**: 无
```json
{
"success": true,
"data": [
{
"id": 1,
"customer_name": "张总",
"phone": "13900139001",
"is_active": 1,
"created_at": "2024-01-01 10:00:00"
}
]
}
```
修改 `config.php` 数据库连接信息。
### 工具和调试模块
### 3. 访问系统
访问 `index.php` 开始预约，`packages.php` 管理套餐。
#### 1. 数据验证工具
- **文件**: `verify_vip_data.php`
- **功能**: 数据库连接测试、数据完整性验证
- **使用**: 浏览器访问或命令行执行
#### 2. 调试工具
- **文件**: `vip_search_debug.html`
- **功能**: 实时调试VIP搜索功能
- **特性**:
- 详细的调试日志
- 数据加载状态监控
- 搜索过程可视化
#### 3. 功能测试工具
- **文件**: `vip_functionality_test.html`
- **功能**: VIP功能完整性测试
- **特性**:
- 自动化测试流程
- 错误检测和报告
- 性能监控
## 📖 使用指南
### 客户预约流程
1. **选择日期** → 日历点击选择
2. **选择时间段** → 8:00-18:00时间段
3. **选择时长** → 快捷按钮或自定义
4. **选择套餐** → 从可用套餐选择
5. **填写信息** → 完善客户信息
6. **提交预约** → 自动检查冲突
### 基础操作流程
### 管理员操作
- **查看预约** → `bookings.php`
- **管理套餐** → `packages.php`
- **更新状态** → 待确认→已确认→已完成→已取消
#### 1. 客户管理
```
1. 打开系统主页 (index.php)
2. 选择客户类型：
- 普通客户：直接填写基本信息
- VIP客户：选择VIP客户搜索或新增
3. 填写客户信息（姓名、手机号等）
4. 提交订单
```
## 🗄️ 数据库结构
#### 2. VIP客户操作
```
VIP客户搜索：
1. 选择"VIP客户"类型
2. 在VIP搜索框中输入关键词：
- 客户姓名（如：张、王、总）
- 手机号（如：13900139001）
- 号段（如：139、138）
3. 查看搜索结果
4. 选择目标客户
### packages 表
| 字段 | 类型 | 说明 |
|------|------|------|
| id | INT | 主键 |
| name | VARCHAR(100) | 套餐名称 |
| description | TEXT | 套餐描述 |
| base_duration | INT | 基础时长（分钟） |
| base_price | DECIMAL(10,2) | 基础价格 |
| services | TEXT | 服务项目 |
| is_active | BOOLEAN | 是否启用 |
VIP客户管理：
1. 通过VIP搜索找到客户
2. 查看客户详细信息
3. 编辑客户信息（如需要）
4. 确认客户选择
```
### bookings 表
| 字段 | 类型 | 说明 |
|------|------|------|
| id | INT | 主键 |
| customer_name | VARCHAR(100) | 客户姓名 |
| phone | VARCHAR(20) | 联系电话 |
| package_id | INT | 套餐ID |
| start_time | DATETIME | 开始时间 |
| duration | INT | 时长（分钟） |
| status | ENUM | 预约状态 |
#### 3. 订单创建
```
1. 选择客户类型（普通/VIP）
2. 选择或搜索客户
3. 选择服务套餐
4. 确认订单信息
5. 提交订单
6. 查看订单状态
```
## 📋 预约状态
- **待确认** 🔵 | **已确认** 🟢 | **已完成** 🟦 | **已取消** 🔴
### 高级功能
## 🔧 常见问题
#### 1. 数据导出
- 客户数据导出
- 订单记录导出
- 统计报表导出
**数据库连接失败** → 检查 config.php 配置和MySQL服务
**页面显示异常** → 确认PHP版本和Web服务器配置
**日历功能异常** → 检查JavaScript支持和套餐数据
#### 2. 系统监控
- 数据库连接状态
- API响应时间
- 错误日志查看
## 许可证
本项目基于MIT许可证开源。
#### 3. 批量操作
- 批量客户导入
- 批量订单处理
- 批量数据清理
## 联系信息
如有问题或建议，请联系开发团队。
## 🔌 API接口
### VIP客户接口
#### 获取所有VIP客户
```http
GET /get_vip_customers.php
```
**响应示例**:
```json
{
"success": true,
"data": [
{
"id": 1,
"customer_name": "张总",
"phone": "13900139001",
"is_active": 1,
"created_at": "2024-01-01 10:00:00"
}
],
"count": 1
}
```
#### 获取单个VIP客户
```http
GET /get_vip_customer.php?id=1
```
**响应示例**:
```json
{
"success": true,
"data": {
"id": 1,
"customer_name": "张总",
"phone": "13900139001",
"is_active": 1,
"created_at": "2024-01-01 10:00:00"
}
}
```
### 订单接口
#### 创建订单
```http
POST /bookings.php
Content-Type: application/json
{
"customer_id": 1,
"package_id": 1,
"booking_date": "2024-01-15",
"booking_time": "14:00",
"notes": "VIP客户预约"
}
```
#### 获取订单列表
```http
GET /bookings.php?status=all&limit=50
```
### 套餐接口
#### 获取套餐列表
```http
GET /packages.php
```
**响应示例**:
```json
{
"success": true,
"data": [
{
"id": 1,
"package_name": "基础洗车",
"price": 30.00,
"description": "基础洗车服务",
"duration": 30
}
]
}
```
## 🛠️ 调试工具
### 1. 调试页面
- **VIP搜索调试**: `vip_search_debug.html`
- **VIP功能测试**: `vip_functionality_test.html`
- **数据验证**: `verify_vip_data.php`
### 2. 调试命令
#### 验证数据库连接
```bash
# 命令行执行
php verify_vip_data.php
```
#### 测试VIP功能
```bash
# 浏览器访问
http://localhost/carwash_order/vip_functionality_test.html
```
#### 调试搜索功能
```bash
# 浏览器访问
http://localhost/carwash_order/vip_search_debug.html
```
### 3. 日志查看
#### PHP错误日志
- **位置**: PHP错误日志文件
- **查看**: 浏览器开发者工具控制台
#### JavaScript调试
- 打开浏览器开发者工具 (F12)
- 查看Console标签页
- 监控网络请求 (Network标签)
#### 数据库日志
```sql
-- 查看MySQL错误日志
SHOW VARIABLES LIKE 'log_error';
-- 查看查询日志
SHOW VARIABLES LIKE 'general_log';
```
## ❓ 常见问题
### 安装问题
#### Q: PHP版本不兼容怎么办？
A: 确保使用PHP 7.4或更高版本，检查php.ini配置是否启用PDO扩展。
#### Q: 数据库连接失败？
A: 检查config.php中的数据库配置，确保MySQL服务正在运行，用户权限正确。
#### Q: 页面显示空白？
A: 检查PHP错误日志，查看是否有致命错误或语法错误。
### 功能问题
#### Q: VIP客户搜索不到？
A:
1. 检查数据库中是否有VIP客户数据
2. 查看浏览器控制台是否有JavaScript错误
3. 使用调试工具验证数据加载
#### Q: 订单提交失败？
A:
1. 验证必填字段是否完整
2. 检查客户信息是否正确
3. 查看服务器错误日志
#### Q: 页面加载缓慢？
A:
1. 检查数据库查询性能
2. 优化SQL查询语句
3. 考虑添加数据库索引
### 性能问题
#### Q: 如何优化查询性能？
A:
1. 添加适当的数据库索引
2. 使用数据库连接池
3. 实现查询结果缓存
#### Q: 如何处理大量数据？
A:
1. 实现分页查询
2. 使用数据压缩
3. 考虑数据库分区
## 📝 版本历史
### v2.1.0 (2024-01-15)
- ✨ **新增**: VIP客户搜索功能优化
- 🐛 **修复**: VIP客户数据加载时序问题
- 🔧 **改进**: 异步处理机制优化
- 📊 **增强**: 调试和监控功能
### v2.0.0 (2024-01-10)
- ✨ **新增**: VIP客户管理系统
- ✨ **新增**: 订单状态管理
- ✨ **新增**: 套餐配置功能
- 🔧 **改进**: 用户界面优化
- 📊 **新增**: 业务统计功能
### v1.0.0 (2024-01-01)
- 🎉 **初始版本**: 基础订单管理功能
- ✨ **新增**: 客户信息管理
- ✨ **新增**: 订单创建和处理
- 🔧 **建立**: 基础架构
## 🤝 贡献指南
### 开发规范
1. 遵循PSR编码规范
2. 使用有意义的变量和函数名
3. 添加必要的注释和文档
4. 进行充分的测试
### 提交流程
1. Fork项目仓库
2. 创建功能分支
3. 编写代码和测试
4. 提交Pull Request
5. 代码审查和合并
### 问题反馈
- 使用GitHub Issues报告Bug
- 提供详细的复现步骤
- 包含环境信息和错误日志
## 📞 技术支持
### 联系方式
- **项目维护者**: [Your Name]
- **技术支持**: [Your Email]
- **项目地址**: [GitHub Repository URL]
### 文档资源
- **API文档**: `/docs/api/`
- **用户手册**: `/docs/user-guide/`
- **开发者文档**: `/docs/developer-guide/`
---
## 📄 许可证
本项目采用 [MIT License](LICENSE) 开源协议。
## 🙏 致谢
感谢所有为这个项目贡献代码、反馈问题和提出建议的开发者们！
---
**洗车店订单管理系统** - 让洗车店管理更简单、更高效！ 🚗✨