基于SpringBoot+Vue的船舶维保管理系统设计与实践

1. 项目背景与核心价值

船舶维保管理系统是航运企业数字化升级的关键基础设施。传统纸质工单和Excel表格的管理方式存在数据孤岛、响应滞后、维保记录追溯困难等痛点。我们团队基于SpringBoot+Vue技术栈开发的这套系统，实现了从故障申报、工单派发、维修执行到验收结算的全流程数字化管理。

系统上线后，某中型航运公司的平均故障响应时间从72小时缩短至12小时，备件库存周转率提升40%。这套代码之所以适合作为Java Web毕设选题，在于它完整覆盖了企业级应用的核心模块：

• 前后端分离架构实践
• RBAC权限控制体系
• 复杂业务状态机设计
• 多维度统计报表
• 移动端适配方案

2. 技术架构解析

2.1 后端技术栈选型

采用SpringBoot 2.7作为基础框架，主要基于以下考量：

1. 内嵌Tomcat简化部署
2. 自动配置减少XML配置
3. 丰富的Starter生态（特别是Spring Security和Spring Data JPA）

数据库选用MySQL 8.0，关键配置参数：

yaml复制spring:
  datasource:
    url: jdbc:mysql://localhost:3306/ship_maintenance?useSSL=false&serverTimezone=Asia/Shanghai
    username: root
    password: 加密存储
    hikari:
      maximum-pool-size: 20
      connection-timeout: 30000

2.2 前端架构设计

Vue 3组合式API带来更好的逻辑复用性，主要技术组件：

• Element Plus：表单/表格等基础组件
• ECharts：可视化报表
• Vue Router：路由守卫实现权限控制
• Axios：封装了带Token的请求拦截器

典型接口调用示例：

javascript复制// 获取待处理工单列表
const fetchPendingOrders = async () => {
  try {
    const res = await api.get('/api/work-order', {
      params: { status: 'PENDING' }
    })
    orderList.value = res.data
  } catch (err) {
    ElMessage.error('获取数据失败')
  }
}

3. 核心业务模块实现

3.1 工单状态机设计

船舶维保涉及复杂的业务流程，我们采用状态模式实现工单流转：

java复制public enum OrderStatus {
    CREATED(1, "已创建"),
    ASSIGNED(2, "已派单"),
    PROCESSING(3, "处理中"),
    NEED_APPROVAL(4, "待验收"),
    COMPLETED(5, "已完成"),
    CANCELLED(6, "已取消");

    // 状态流转规则
    private static final Map<OrderStatus, Set<OrderStatus>> TRANSITION_RULES = Map.of(
        CREATED, Set.of(ASSIGNED, CANCELLED),
        ASSIGNED, Set.of(PROCESSING, CANCELLED),
        PROCESSING, Set.of(NEED_APPROVAL, CANCELLED),
        NEED_APPROVAL, Set.of(COMPLETED, PROCESSING)
    );

    public static boolean isValidTransition(OrderStatus from, OrderStatus to) {
        return TRANSITION_RULES.getOrDefault(from, Set.of()).contains(to);
    }
}

3.2 权限控制方案

结合航运企业组织特点，设计四级权限体系：

1. 系统管理员：基础数据维护
2. 船队经理：维保计划制定
3. 轮机长：工单审核
4. 维修员：工单执行

通过注解实现接口权限控制：

java复制@PreAuthorize("hasRole('FLEET_MANAGER') || hasRole('SYSTEM_ADMIN')")
@PostMapping("/maintenance-plan")
public ResponseEntity<?> createPlan(@Valid @RequestBody PlanDTO dto) {
    // 业务逻辑
}

4. 关键问题解决方案

4.1 船舶位置追踪优化

原始方案频繁请求GPS设备导致性能瓶颈，改进方案：

1. 采用WebSocket长连接
2. 移动端位置缓存策略
3. 地理围栏触发状态变更

核心代码片段：

java复制@GetMapping("/tracking/{shipId}")
public SseEmitter streamLocation(@PathVariable Long shipId) {
    SseEmitter emitter = new SseEmitter(3600000L);
    locationService.addEmitter(shipId, emitter);
    emitter.onCompletion(() -> locationService.removeEmitter(shipId));
    return emitter;
}

4.2 大文件上传处理

维修报告常包含高清图片和视频，采用分片上传方案：

1. 前端使用spark-md5计算文件指纹
2. 每片2MB分片上传
3. 服务端使用Redis记录上传进度

前端关键代码：

javascript复制const uploadChunk = async (file, chunk, chunks) => {
  const formData = new FormData()
  formData.append('file', chunk)
  formData.append('chunkNumber', chunkIndex)
  formData.append('totalChunks', chunks)
  formData.append('identifier', fileHash)
  
  await axios.post('/api/upload', formData, {
    headers: { 'Content-Type': 'multipart/form-data' }
  })
}

5. 部署与运维实践

5.1 容器化部署方案

Docker Compose编排文件示例：

yaml复制version: '3'
services:
  backend:
    build: ./backend
    ports:
      - "8080:8080"
    depends_on:
      - mysql
  frontend:
    build: ./frontend
    ports:
      - "80:80"
  mysql:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: ${DB_PASSWORD}
    volumes:
      - db_data:/var/lib/mysql
volumes:
  db_data:

5.2 性能监控配置

Spring Boot Actuator关键配置：

properties复制management.endpoints.web.exposure.include=health,metrics,prometheus
management.metrics.export.prometheus.enabled=true
management.endpoint.health.show-details=always

配合Grafana监控面板可实时观测：

• JVM内存使用
• 数据库连接池状态
• 接口响应时间P99

6. 毕设开发建议

6.1 功能扩展方向

1. 预测性维护：基于历史数据预测设备故障
2. AR远程协助：维修人员第一视角直播
3. 区块链存证：关键维保记录上链

6.2 论文撰写要点

技术章节建议结构：

1. 系统架构设计图（建议使用PlantUML绘制）
2. 数据库ER图（Navicat逆向工程）
3. 核心算法流程图（如工单优先级计算）
4. 性能测试报告（JMeter压测结果）

避坑提示：MySQL 8.0默认使用caching_sha2_password认证，旧版本客户端连接需在my.cnf添加default_authentication_plugin=mysql_native_password

7. 项目资源使用指南

SQL脚本包含三个关键部分：

1. 基础表结构（DDL）
2. 初始数据（船舶信息、用户账号）
3. 存储过程（月度统计报表）

接口文档采用Swagger UI + OpenAPI 3.0规范，重点接口包括：

• POST /api/auth/login （JWT认证）
• GET /api/ships/{id}/maintenance-history
• POST /api/work-order/{id}/approve

源码目录结构说明：

code复制├── backend
│   ├── config       # 安全/JPA配置
│   ├── controller   # 接口层
│   ├── service      # 业务逻辑
│   └── entity       # 数据库实体
└── frontend
    ├── api          # 接口封装
    ├── views        # 页面组件
    └── store        # Pinia状态管理

实际开发中我们发现，维修工单的状态变更通知采用WebSocket比轮询方案节省约75%的网络开销。移动端适配时，使用vw单位配合媒体查询可以更好地适应不同船载终端设备。