Initial commit: Car Maintenance Management System
Author: Yang Lu School: Liaoning Institute of Science and Technology Major: Computer Science and Technology Class: BZ246 Tech Stack: - Backend: Spring Boot 2.7.18 + JPA + MySQL - Frontend: HTML5 + CSS3 + JavaScript Features: - User Management (Admin/Staff/Customer roles) - Vehicle Archive Management - Service Order Management - Parts Inventory Management - Online Appointment Service - Data Statistics and Analysis Generated with Claude Code Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
wangziqi
238
QUICKSTART.md
Normal file
238
QUICKSTART.md
Normal file
@@ -0,0 +1,238 @@
|
||||
# 车管家4S店车辆维保管理系统 - 快速启动指南
|
||||
|
||||
## 快速启动步骤
|
||||
|
||||
### 第一步：准备环境
|
||||
|
||||
确保您的计算机已安装：
|
||||
- ✅ JDK 1.8 或更高版本
|
||||
- ✅ Maven 3.6 或更高版本
|
||||
- ✅ MySQL 8.0 或更高版本
|
||||
- ✅ 现代浏览器（Chrome、Firefox、Edge等）
|
||||
|
||||
### 第二步：创建数据库
|
||||
|
||||
1. 启动MySQL服务
|
||||
|
||||
2. 打开MySQL命令行或MySQL Workbench
|
||||
|
||||
3. 执行数据库脚本：
|
||||
|
||||
```sql
|
||||
-- 方式一：使用MySQL命令行
|
||||
mysql -u root -p < database/schema.sql
|
||||
mysql -u root -p < database/data.sql
|
||||
|
||||
-- 方式二：在MySQL客户端中直接执行
|
||||
source D:/bs/yanglu/car-maintenance-system/database/schema.sql
|
||||
source D:/bs/yanglu/car-maintenance-system/database/data.sql
|
||||
```
|
||||
|
||||
### 第三步：配置数据库连接
|
||||
|
||||
编辑文件：`backend/src/main/resources/application.properties`
|
||||
|
||||
修改以下配置：
|
||||
|
||||
```properties
|
||||
spring.datasource.username=root
|
||||
spring.datasource.password=你的MySQL密码
|
||||
```
|
||||
|
||||
### 第四步：启动后端服务
|
||||
|
||||
#### 方式一：使用IDE（推荐）
|
||||
|
||||
1. 使用 IntelliJ IDEA 或 Eclipse 打开 `backend` 文件夹
|
||||
2. 等待 Maven 下载依赖（首次可能需要几分钟）
|
||||
3. 找到 `CarMaintenanceApplication.java` 文件
|
||||
4. 右键 -> Run 'CarMaintenanceApplication'
|
||||
5. 看到以下信息表示启动成功：
|
||||
|
||||
```
|
||||
========================================
|
||||
车管家4S店车辆维保管理系统启动成功!
|
||||
访问地址: http://localhost:8080/api
|
||||
========================================
|
||||
```
|
||||
|
||||
#### 方式二：使用命令行
|
||||
|
||||
```bash
|
||||
# 进入backend目录
|
||||
cd backend
|
||||
|
||||
# 打包项目
|
||||
mvn clean package -DskipTests
|
||||
|
||||
# 运行项目
|
||||
java -jar target/car-maintenance-system-1.0.0.jar
|
||||
```
|
||||
|
||||
### 第五步：启动前端服务
|
||||
|
||||
#### 方式一：使用 VS Code Live Server（推荐）
|
||||
|
||||
1. 使用 VS Code 打开 `frontend` 文件夹
|
||||
2. 安装 "Live Server" 插件
|
||||
3. 右键点击 `login.html`
|
||||
4. 选择 "Open with Live Server"
|
||||
5. 浏览器自动打开：http://localhost:5500/login.html
|
||||
|
||||
#### 方式二：直接打开文件
|
||||
|
||||
在文件浏览器中，双击打开 `frontend/login.html` 文件
|
||||
|
||||
注意：直接打开文件可能会遇到CORS跨域问题，建议使用Live Server。
|
||||
|
||||
### 第六步：登录系统
|
||||
|
||||
使用以下演示账号登录：
|
||||
|
||||
| 角色 | 用户名 | 密码 | 说明 |
|
||||
|------|--------|------|------|
|
||||
| **管理员** | admin | 123456 | 拥有所有权限，可管理用户、车辆、工单、配件等 |
|
||||
| **工作人员** | staff001 | 123456 | 可查看和处理分配的工单 |
|
||||
| **客户** | customer001 | 123456 | 可查看自己的车辆、维保记录、在线预约 |
|
||||
|
||||
---
|
||||
|
||||
## 常见问题解决
|
||||
|
||||
### 问题1：后端启动失败 - 端口被占用
|
||||
|
||||
**错误信息**：`Port 8080 was already in use`
|
||||
|
||||
**解决方案**：
|
||||
- 方式一：修改端口号
|
||||
编辑 `application.properties`，添加：
|
||||
```properties
|
||||
server.port=8081
|
||||
```
|
||||
同时修改前端 `js/config.js` 中的端口号
|
||||
|
||||
- 方式二：关闭占用端口的程序
|
||||
```bash
|
||||
# Windows
|
||||
netstat -ano | findstr :8080
|
||||
taskkill /PID <进程ID> /F
|
||||
|
||||
# Linux/Mac
|
||||
lsof -i :8080
|
||||
kill -9 <PID>
|
||||
```
|
||||
|
||||
### 问题2：数据库连接失败
|
||||
|
||||
**错误信息**：`Communications link failure`
|
||||
|
||||
**解决方案**：
|
||||
1. 确认MySQL服务已启动
|
||||
2. 检查用户名和密码是否正确
|
||||
3. 确认数据库 `car_maintenance_db` 已创建
|
||||
4. 检查MySQL端口是否为3306
|
||||
|
||||
### 问题3：前端无法连接后端
|
||||
|
||||
**错误信息**：`Failed to fetch` 或 `CORS error`
|
||||
|
||||
**解决方案**：
|
||||
1. 确认后端服务已启动（访问 http://localhost:8080/api）
|
||||
2. 检查前端配置文件 `js/config.js` 中的 `BASE_URL`
|
||||
3. 使用Live Server启动前端，不要直接双击HTML文件
|
||||
|
||||
### 问题4：Maven依赖下载失败
|
||||
|
||||
**解决方案**：
|
||||
1. 配置Maven国内镜像（阿里云）
|
||||
编辑 `~/.m2/settings.xml`，添加：
|
||||
```xml
|
||||
<mirrors>
|
||||
<mirror>
|
||||
<id>aliyun</id>
|
||||
<mirrorOf>central</mirrorOf>
|
||||
<url>https://maven.aliyun.com/repository/public</url>
|
||||
</mirror>
|
||||
</mirrors>
|
||||
```
|
||||
|
||||
2. 重新下载依赖：
|
||||
```bash
|
||||
mvn clean install -U
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 测试功能
|
||||
|
||||
### 管理员测试流程
|
||||
|
||||
1. 使用 admin/123456 登录
|
||||
2. 查看系统概览统计数据
|
||||
3. 进入"用户管理"，查看所有用户
|
||||
4. 进入"车辆管理"，查看所有车辆信息
|
||||
5. 进入"工单管理"，查看维保工单
|
||||
6. 进入"配件管理"，查看库存情况（注意库存预警功能）
|
||||
7. 进入"预约管理"，查看客户预约
|
||||
|
||||
### 工作人员测试流程
|
||||
|
||||
1. 使用 staff001/123456 登录
|
||||
2. 查看分配给自己的工单
|
||||
3. 使用车辆查询功能，输入车牌号查询车辆信息
|
||||
4. 使用配件查询功能，搜索配件
|
||||
|
||||
### 客户测试流程
|
||||
|
||||
1. 使用 customer001/123456 登录
|
||||
2. 查看"我的车辆"页面
|
||||
3. 查看"维保记录"
|
||||
4. 进入"在线预约"，提交新的预约
|
||||
5. 在"我的预约"中查看预约状态
|
||||
|
||||
---
|
||||
|
||||
## 下一步
|
||||
|
||||
系统已成功运行！您可以：
|
||||
|
||||
1. **添加更多测试数据**
|
||||
- 创建新用户
|
||||
- 添加车辆档案
|
||||
- 创建维保工单
|
||||
- 管理配件库存
|
||||
|
||||
2. **自定义配置**
|
||||
- 修改系统名称和Logo
|
||||
- 调整颜色主题
|
||||
- 添加更多服务项目
|
||||
|
||||
3. **扩展功能**
|
||||
- 添加统计报表
|
||||
- 实现消息通知
|
||||
- 增加数据导出功能
|
||||
- 开发移动端适配
|
||||
|
||||
4. **部署到生产环境**
|
||||
- 参考 README.md 中的部署指南
|
||||
- 配置Nginx反向代理
|
||||
- 启用HTTPS安全连接
|
||||
|
||||
---
|
||||
|
||||
## 技术支持
|
||||
|
||||
如遇到问题，请：
|
||||
1. 查看完整的 `README.md` 文档
|
||||
2. 检查后端控制台的错误日志
|
||||
3. 使用浏览器开发者工具（F12）查看网络请求
|
||||
4. 联系指导教师或技术支持
|
||||
|
||||
---
|
||||
|
||||
**祝您使用愉快！**
|
||||
|
||||
车管家4S店车辆维保管理系统
|
||||
辽宁科技学院 - 计算机科学与技术专业
|
||||
作者：杨璐
|
||||
指导教师：刘慧宇
|
||||
Reference in New Issue
Block a user