car-maintenance-system/QUICKSTART.md

# 车管家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店车辆维保管理系统
辽宁科技学院 - 计算机科学与技术专业
作者：杨璐
指导教师：刘慧宇