SpringBoot+Vue船舶监造系统开发实战

1. 项目概述

船舶监造系统是船舶制造行业的核心管理工具，它贯穿于船舶设计、采购、生产、质检全流程。这套基于SpringBoot+Vue+MySQL的技术方案，是我在参与某大型船厂数字化改造项目时沉淀的实战成果，经过3个实际项目的验证，系统完整度达到生产级要求。

不同于通用OA系统，船舶监造需要特别关注：

• 多级进度管控（分段建造、合拢、舾装等阶段）
• 特种设备验收标准（如船级社规范）
• 图纸版本追溯（平均每艘船涉及2000+份图纸）
• 材料追溯体系（从钢板入库到分段使用的全链路跟踪）

2. 技术架构解析

2.1 后端技术栈

采用SpringBoot 2.7 + JDK11组合，关键依赖包括：

xml复制<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>fastjson</artifactId>
    <version>1.2.83</version>
</dependency>
<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-ooxml</artifactId>
    <version>5.2.2</version> <!-- 用于处理船用规格书 -->
</dependency>

特别设计的领域模型：

java复制@Entity
public class ShipSection {
    @Id
    private String sectionCode; // 分段编号如"A-101"
    
    @Enumerated(EnumType.STRING)
    private ConstructionPhase phase; // 分段建造阶段
    
    @OneToMany(mappedBy = "section")
    private List<MaterialUsage> materialUsages; // 材料使用记录
}

2.2 前端技术方案

Vue3 + Element Plus的组合，针对船舶行业特点做了以下优化：

1. 大型表格性能优化：采用虚拟滚动技术处理万级行数的物料清单
2. 图纸对比功能：集成Telerik Document Server实现DWG版本比对
3. 甘特图组件：改造vue-gantt-elastic支持分段建造计划

2.3 数据库设计要点

MySQL 8.0采用以下关键表结构：

sql复制CREATE TABLE `ship_inspection` (
  `id` varchar(36) NOT NULL COMMENT '检验ID',
  `section_code` varchar(20) NOT NULL COMMENT '分段编号',
  `inspection_type` enum('WELDING','PAINTING','ASSEMBLY') NOT NULL,
  `standard_code` varchar(50) NOT NULL COMMENT '如GB/T 34000-2016',
  `result_images` json DEFAULT NULL COMMENT '检验照片JSON数组',
  PRIMARY KEY (`id`),
  KEY `idx_section` (`section_code`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;

3. 核心功能实现

3.1 分段建造进度管理

采用有限状态机模型控制建造流程：

mermaid复制stateDiagram
    [*] --> MATERIAL_PREPARED
    MATERIAL_PREPARED --> SECTION_STARTED: 开工报告
    SECTION_STARTED --> WELDING_COMPLETED: 焊接检验
    WELDING_COMPLETED --> PAINTING_COMPLETED: 涂装检验
    PAINTING_COMPLETED --> QUALITY_APPROVED: 质检放行

对应实现代码：

java复制public class SectionProgressService {
    private final StateMachine<ConstructionState, ConstructionEvent> stateMachine;

    public void handleInspectionResult(String sectionCode, InspectionResult result) {
        if(result.isPassed()) {
            stateMachine.sendEvent(ConstructionEvent.valueOf(result.getInspectionType() + "_PASS"));
        }
    }
}

3.2 材料追溯系统

实现钢材"一物一码"管理：

1. 钢板入库时生成唯一追溯码
2. 数控切割机对接系统获取用料清单
3. 焊接时扫描材料码与分段关联

关键数据库关系：

sql复制-- 材料入库表
CREATE TABLE `material_stock` (
  `trace_code` varchar(50) PRIMARY KEY,
  `material_type` varchar(20),
  `specification` varchar(100),
  `inspection_cert` varchar(30)
);

-- 材料使用记录
CREATE TABLE `material_usage` (
  `id` int PRIMARY KEY AUTO_INCREMENT,
  `trace_code` varchar(50),
  `section_code` varchar(20),
  `used_time` datetime,
  FOREIGN KEY (`trace_code`) REFERENCES `material_stock` (`trace_code`)
);

4. 系统部署指南

4.1 环境准备

推荐服务器配置：

• 应用服务器：4核8G（建议Docker部署）
• 数据库：8核16G + SSD存储
• 网络：船厂内网需开放以下端口：
  • 后端：8080（API）、9999（WebSocket）
  • 前端：80（HTTP）、443（HTTPS）

4.2 初始化步骤

1. 数据库初始化：

bash复制mysql -u root -p < database/init_schema.sql
mysql -u root -p < database/init_data.sql

2. 后端启动参数配置：

properties复制# application-prod.properties
spring.datasource.url=jdbc:mysql://db-host:3306/ship_construction?useSSL=false
spring.datasource.username=admin
spring.datasource.password=ENC(AES加密密码)

3. 前端生产环境构建：

bash复制VUE_APP_API_BASE_URL=https://your-domain.com/api npm run build

5. 常见问题排查

5.1 图纸上传失败

可能原因及解决方案：

5.2 移动端扫码异常

现场常见问题处理流程：

1. 检查PDA设备网络连接状态
2. 验证扫码枪与系统的配对密钥
3. 排查车间AP信号强度（建议-65dBm以上）

6. 扩展开发建议

6.1 与MES系统集成

建议采用以下接口规范：

json复制// 生产任务下发接口
POST /api/mes/task
{
  "workshop": "分段车间",
  "deviceType": "数控切割机",
  "taskFile": "base64编码的NC文件"
}

6.2 船级社认证对接

实现LR/DNV等船级社标准对接时：

1. 准备标准检验项模板库
2. 配置检验报告XML格式
3. 申请船级社数字证书

关键代码示例：

java复制public class ClassSocietyService {
    public void generateCertReport(String sectionCode) {
        DNVStandard dnv = loadStandard("DNVGL-RU-SHIP");
        InspectionReport report = new InspectionReport(dnv);
        report.generatePDF();
    }
}

重要提示：实际部署时需特别注意船厂网络环境，建议在DMZ区部署前置机处理车间设备通信，避免直接暴露核心服务。我在某项目中就曾因PLC直接访问API服务导致过内存泄漏问题。