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. 执行数据库脚本：

-- 方式一：使用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

修改以下配置：

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
========================================

方式二：使用命令行

# 进入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，添加：

  server.port=8081
  

  同时修改前端 js/config.js 中的端口号

• 方式二：关闭占用端口的程序

  # 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，添加：

   <mirrors>
       <mirror>
           <id>aliyun</id>
           <mirrorOf>central</mirrorOf>
           <url>https://maven.aliyun.com/repository/public</url>
       </mirror>
   </mirrors>
   

2. 重新下载依赖：

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