港口设备管理系统 – 项目说明

一、项目概述

项目名称

港口设备管理系统（System Management Platform）

项目类型

企业级港口设备监控与管理系统

开发语言

• 后端：Java
• 前端：JavaScript

二、技术栈

后端技术栈

• 核心框架：Spring Boot 2.7.14
• 开发语言：Java 1.8
• 安全认证：Spring Security + JWT（JSON Web Token）
• 数据持久化：Spring Data JPA + Hibernate
• 数据库驱动：MySQL Connector 8.0.33
• 面向切面编程：Spring AOP
• 数据验证：Spring Boot Validation
• 工具类库：
  • Hutool 5.8.20（Java工具类）
  • Lombok（简化实体类开发）
  • Apache POI 5.2.3（Excel文件处理）
• API文档：Swagger 2.9.2
• 构建工具：Maven

前端技术栈

• 核心框架：Vue 3.3.4
• 路由管理：Vue Router 4.2.4
• 状态管理：Vuex 4.1.0
• UI组件库：Element Plus 2.3.9
• 图表库：ECharts 5.4.3
• HTTP客户端：Axios 1.4.0
• 样式预处理：Sass 1.64.2
• 构建工具：Vite 4.4.9

三、数据库

数据库类型

MySQL 8.0

数据库名称

sys_db

核心数据表

1. sys_user – 用户信息表
2. sys_crane – 轨道吊设备表
3. sys_camera – 摄像头设备表
4. sys_cargo_record – 货物出入库记录表
5. sys_fault_diagnosis – 故障诊断记录表
6. sys_operation_log – 操作日志表

四、用户界面

界面类型

Web GUI（图形用户界面）

界面特点

• 基于Element Plus的现代化响应式界面
• 支持数据可视化（ECharts图表展示）
• 单页应用（SPA）架构
• 前后端分离设计

五、项目功能

1. 用户管理模块

• 用户注册与登录
• 用户信息管理（增删改查）
• 基于角色的权限控制（RBAC）
• 管理员保护机制
• 个人信息修改
• 密码修改

2. 设备管理模块

轨道吊管理

• 轨道吊设备信息维护
• 设备状态监控（正常/故障）
• 工作状态跟踪（停止/工作中/故障）
• 设备位置信息管理
• 设备型号与负载参数配置
• 启动时间记录

摄像头管理

• 摄像头设备信息维护
• 设备状态监控
• 安装位置管理
• IP地址与端口配置
• 分辨率信息记录

3. 货物管理模块

• 货物出入库记录
• 货物编号与名称管理
• 货物数量与重量统计
• 仓位信息管理
• 操作人员记录
• 数据采集功能

4. 故障诊断模块

• 设备故障检测
• 故障类型分类（角度问题/物理损坏/失联/未知）
• 故障状态跟踪
• 故障说明记录
• 修复时间与修复人员管理
• 故障统计分析

5. 数据分析模块

• 货物出入库分析
• 设备运行统计
• 数据可视化展示
• 趋势分析报表

6. 操作日志模块

• 用户操作记录
• 基于AOP的自动日志记录
• 操作时间与内容追溯
• 操作权限控制
• 日志查询与导出

7. 数据统计模块

• 综合数据统计
• 多维度数据分析
• 实时数据监控

8. 系统管理模块

• 菜单权限控制
• 角色权限管理
• 普通用户只读访问控制
• 系统参数配置

六、系统特性

安全特性

• JWT Token身份认证
• Spring Security安全框架
• 密码加密存储
• 接口权限控制
• 操作日志审计

数据特性

• JPA自动建表（ddl-auto: update）
• 逻辑删除（软删除）
• 时间戳自动管理（创建时间/更新时间）
• 数据库事务管理

接口特性

• RESTful API设计
• 统一异常处理
• 跨域资源共享（CORS）支持
• Swagger API文档自动生成

部署特性

• 前后端分离部署
• 后端端口：8080
• 支持Excel数据导出
• 生产环境配置分离

七、项目结构

后端结构

backend/
├── src/main/java/com/sys/
│   ├── annotation/         # 自定义注解（操作日志）
│   ├── aspect/             # AOP切面（日志切面）
│   ├── config/             # 配置类（安全、CORS、数据初始化）
│   ├── controller/         # 控制器层
│   ├── entity/             # 实体类
│   ├── repository/         # 数据访问层
│   ├── service/            # 业务逻辑层
│   ├── util/               # 工具类
│   └── SystemApplication.java  # 启动类
└── src/main/resources/
    └── application.yml     # 应用配置文件

前端结构

frontend/
├── src/
│   ├── api/                # API接口封装
│   ├── assets/             # 静态资源
│   ├── components/         # 公共组件
│   ├── router/             # 路由配置
│   ├── store/              # Vuex状态管理
│   ├── utils/              # 工具函数
│   ├── views/              # 页面组件
│   │   ├── analysis/       # 数据分析页面
│   │   ├── device/         # 设备管理页面
│   │   ├── fault/          # 故障诊断页面
│   │   ├── log/            # 日志管理页面
│   │   ├── personal/       # 个人中心页面
│   │   ├── port/           # 港口数据采集页面
│   │   └── system/         # 系统管理页面
│   ├── App.vue             # 根组件
│   └── main.js             # 入口文件
└── package.json            # 项目依赖配置

八、部署说明

开发环境要求

• JDK 1.8+
• MySQL 8.0+
• Node.js 14+
• Maven 3.6+

启动步骤

后端启动

1. 配置MySQL数据库连接（application.yml）
2. 执行 mvn clean install
3. 运行 SystemApplication 主类
4. 访问 http://localhost:8080

前端启动

1. 安装依赖：npm install
2. 启动开发服务器：npm run dev
3. 构建生产版本：npm run build

API文档访问

• Swagger UI：http://localhost:8080/swagger-ui.html

---

版本号：1.0.0 最后更新时间：2025年9月

演示