汽车修理管理系统 (Car Repair Management System)

项目简介

这是一个基于Spring Boot 3.1.5开发的汽车修理管理系统，提供完整的汽车维修业务管理功能，包括车辆管理、维修订单、配件库存、技师管理和报表统计等模块。

技术栈

• 后端框架: Spring Boot 3.1.5
• Java版本: JDK 21
• 数据库: MySQL 8.0+
• 持久层: Spring Data JPA + Hibernate
• 模板引擎: Thymeleaf
• 构建工具: Maven
• 开发工具: Lombok

功能模块

核心功能

1. 车辆管理

   • 车辆信息登记
   • 车主信息管理
   • 车辆维修历史查询

2. 维修订单管理

   • 维修订单创建
   • 维修进度跟踪
   • 维修费用计算
   • 维修单详情查看

3. 配件库存管理

   • 配件入库管理
   • 库存查询与统计
   • 配件使用记录
   • 库存预警功能

4. 技师管理

   • 技师信息管理
   • 技师工作量统计
   • 技师薪资计算

5. 报表统计

   • 业务统计报表
   • 配件使用报表
   • 技师薪资报表
   • 经营分析报表

系统架构

com.carrepair.system/
├── controller/     # 控制器层
├── entity/        # 实体类
├── repository/    # 数据访问层
├── service/       # 业务逻辑层
└── resources/
    ├── templates/ # 前端页面
    └── static/    # 静态资源

快速开始

环境要求

• JDK 21 或更高版本
• MySQL 8.0 或更高版本
• Maven 3.6 或更高版本

安装步骤

1. 克隆项目

   git clone <项目地址>
   cd java汽车修理系统/CarRepairSystem

2. 数据库配置

   • 创建MySQL数据库：car_repair_db
   • 修改 application.yml 中的数据库连接信息

   spring:
     datasource:
       url: jdbc:mysql://localhost:3306/car_repair_db
       username: your_username
       password: your_password

3. 运行项目

   # 使用Maven运行
   mvn spring-boot:run
   
   # 或打包后运行
   mvn clean package
   java -jar target/car-repair-system-1.0.0.jar

4. 访问系统

   • 打开浏览器访问：http://localhost:8080
   • 系统将自动初始化数据库表结构和示例数据

项目结构

CarRepairSystem/
├── src/main/java/com/carrepair/system/
│   ├── controller/          # 控制器
│   │   ├── CarController.java
│   │   ├── RepairController.java
│   │   ├── PartController.java
│   │   ├── MechanicController.java
│   │   ├── OwnerController.java
│   │   ├── ReportController.java
│   │   └── MainController.java
│   ├── entity/              # 实体类
│   │   ├── Car.java
│   │   ├── CarOwner.java
│   │   ├── Mechanic.java
│   │   ├── PartInventory.java
│   │   ├── PartUsage.java
│   │   └── RepairOrder.java
│   ├── repository/          # 数据访问层
│   │   ├── CarRepository.java
│   │   ├── CarOwnerRepository.java
│   │   ├── MechanicRepository.java
│   │   ├── PartInventoryRepository.java
│   │   ├── PartUsageRepository.java
│   │   └── RepairOrderRepository.java
│   ├── service/            # 业务逻辑层
│   │   ├── CarService.java
│   │   ├── RepairService.java
│   │   ├── PartService.java
│   │   ├── MechanicService.java
│   │   └── ReportService.java
│   └── CarRepairSystemApplication.java
├── src/main/resources/
│   ├── templates/          # 页面模板
│   │   ├── car/           # 车辆管理页面
│   │   ├── repair/        # 维修管理页面
│   │   ├── parts/         # 配件管理页面
│   │   ├── mechanic/      # 技师管理页面
│   │   ├── owner/         # 车主管理页面
│   │   ├── reports/       # 报表页面
│   │   ├── dashboard.html # 仪表板
│   │   └── index.html     # 首页
│   ├── application.yml    # 应用配置
│   ├── schema.sql         # 数据库表结构
│   └── data.sql           # 初始数据
└── pom.xml               # Maven配置

主要实体关系

• CarOwner (车主) ↔ Car (车辆)：一对多关系
• Car (车辆) ↔ RepairOrder (维修订单)：一对多关系
• RepairOrder (维修订单) ↔ PartUsage (配件使用)：一对多关系
• PartInventory (配件库存) ↔ PartUsage (配件使用)：一对多关系
• Mechanic (技师) ↔ RepairOrder (维修订单)：一对多关系

API接口

车辆管理

• GET /cars - 获取车辆列表
• POST /cars - 创建车辆
• GET /cars/{id} - 获取车辆详情
• PUT /cars/{id} - 更新车辆信息
• DELETE /cars/{id} - 删除车辆

维修订单

• GET /repairs - 获取维修订单列表
• POST /repairs - 创建维修订单
• GET /repairs/{id} - 获取维修订单详情
• PUT /repairs/{id} - 更新维修订单
• POST /repairs/{id}/parts - 添加配件使用记录

配件管理

• GET /parts - 获取配件库存
• POST /parts - 配件入库
• PUT /parts/{id} - 更新配件信息
• GET /parts/usage - 配件使用记录

开发指南

添加新的实体类

1. 在 entity 包中创建实体类
2. 在 repository 包中创建对应的Repository接口
3. 在 service 包中创建业务逻辑层
4. 在 controller 包中创建控制器

数据库迁移

项目使用JPA自动生成表结构，同时提供 schema.sql 和 data.sql 进行数据初始化。

部署说明

生产环境配置

1. 修改 application.yml 中的数据库连接为生产环境
2. 设置 spring.jpa.hibernate.ddl-auto=validate
3. 配置合适的日志级别
4. 设置服务器端口和安全配置

Docker部署（可选）

FROM openjdk:21-jdk-slim
COPY target/car-repair-system-1.0.0.jar app.jar
ENTRYPOINT ["java", "-jar", "/app.jar"]

贡献指南

1. Fork 本项目
2. 创建特性分支
3. 提交更改
4. 推送到分支
5. 创建Pull Request

许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情

最后更新: 2026-03-29