车辆监控管理系统：后端 API、Web 后台与移动端应用

车辆监控管理系统：后端 API、Web 后台与移动端应用 | 极客日志

// 平台核心能力示例代码
public class PlatformCapability {
    // 实时监控能力
    public Location getRealTimeLocation(Long vehicleId);
    
    // 风险预警能力
    public void triggerAlarm(AlarmType type, Vehicle vehicle);
    
    // 数据分析能力
    public Statistics getVehicleStatistics(DateRange range);
    
    // 权限管理能力
    public boolean checkPermission(User user, Permission permission);
}

┌─────────────────────────────────────────────────────────┐
│                 表现层 (Presentation Layer)              │
├─────────────────────────────────────────────────────────┤
│  Web 管理后台 (Vue.js 3)   │  移动端应用 (uni-app)       │
│  - Element Plus UI       │  - 跨平台支持               │
│  - Vuex 状态管理         │  - 响应式设计               │
└────────────────┬──────────────────┬─────────────────────┘
                │                  │
                ▼                  ▼
        HTTP/REST API (JSON)
                │
                ▼
┌─────────────────────────────────────────────────────────┐
│                 业务层 (Business Layer)                  │
├─────────────────────────────────────────────────────────┤
│           Spring Boot 2.7.14 后端服务                    │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐             │
│  │Controller│→│ Service  │→│Repository│             │
│  │  控制器层 │  │  业务层  │  │ 数据访问 │             │
│  └──────────┘  └──────────┘  └──────────┘             │
│  - JWT 认证授权  - 异常处理  - 日志管理                   │
└────────────────────────┬───────────────────────────────┘
                        ▼
┌─────────────────────────────────────────────────────────┐
│                 数据层 (Data Layer)                      │
├─────────────────────────────────────────────────────────┤
│  H2 内存数据库 (开发)  │  MySQL 8.0 (生产)               │
│  - 快速启动          │  - 高可用                       │
│  - 零配置            │  - 集群支持                     │
└─────────────────────────────────────────────────────────┘

# 技术选型示例配置
spring:
  boot:
    version: 2.7.14  # 稳定版本，生产验证
  security:
    jwt:
      secret: "vehicle-monitoring-secret-key"
      expiration: 86400000  # 24 小时

// 安全配置示例
@Configuration
@EnableWebSecurity
public class SecurityConfig {
    @Bean
    public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
        http.csrf().disable()
            .sessionManagement().sessionCreationPolicy(SessionCreationPolicy.STATELESS)
            .and()
            .authorizeRequests()
            .antMatchers("/api/auth/**").permitAll()
            .anyRequest().authenticated();
        return http.build();
    }
}

// 后端分层示例
com.bank.vehiclemonitoring/
├── controller/     # 控制器层 - 处理 HTTP 请求
├── service/        # 服务层 - 业务逻辑处理
├── repository/     # 数据访问层 - 数据库操作
├── entity/         # 实体层 - 数据模型
├── dto/            # 数据传输对象 - API 接口数据
├── security/       # 安全模块 - 认证授权
└── config/         # 配置类 - 系统配置

// 用户认证示例
@PostMapping("/auth/login")
public ApiResponse<JwtResponse> login(@RequestBody LoginRequest request) {
    Authentication authentication = authenticationManager.authenticate(
        new UsernamePasswordAuthenticationToken(request.getUsername(), request.getPassword())
    );
    String jwt = jwtUtils.generateJwtToken(authentication);
    return ApiResponse.success(new JwtResponse(jwt));
}

@Entity
@Table(name = "vehicles")
public class Vehicle {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    
    @Column(unique = true, nullable = false)
    private String imei;  // 设备 IMEI，唯一标识
    
    private String customerName;  // 客户名称
    private String vehicleName;   // 车辆名称
    private String plateNumber;   // 车牌号
    
    @Enumerated(EnumType.STRING)
    private VehicleStatus status;  // 车辆状态
    
    private LocalDateTime createTime;
    private LocalDateTime updateTime;
}

// 位置数据更新示例
@Service
public class LocationHistoryService {
    public void updateVehicleLocation(String imei, Double latitude, Double longitude) {
        Vehicle vehicle = vehicleRepository.findByImei(imei);
        LocationHistory location = new LocationHistory();
        location.setVehicle(vehicle);
        location.setLatitude(latitude);
        location.setLongitude(longitude);
        location.setLocationTime(LocalDateTime.now());
        locationRepository.save(location);
        
        // 检查围栏越界
        checkGeoFenceViolation(vehicle, latitude, longitude);
    }
}

// 报警触发和处理示例
@Service
public class AlarmService {
    public void triggerAlarm(AlarmType type, Vehicle vehicle, String content) {
        Alarm alarm = new Alarm();
        alarm.setType(type);
        alarm.setVehicle(vehicle);
        alarm.setContent(content);
        alarm.setStatus(AlarmStatus.UNHANDLED);
        alarm.setCreateTime(LocalDateTime.now());
        alarmRepository.save(alarm);
    }
    
    public void handleAlarm(Long alarmId, String handler, String remark) {
        Alarm alarm = alarmRepository.findById(alarmId).orElseThrow();
        alarm.setStatus(AlarmStatus.HANDLED);
        alarm.setHandler(handler);
        alarm.setHandleTime(LocalDateTime.now());
        alarm.setRemark(remark);
        alarmRepository.save(alarm);
    }
}

// 围栏越界检测示例
public boolean isPointInCircle(Double lat, Double lng,
        Double centerLat, Double centerLng,
        Double radius) {
    double distance = calculateDistance(lat, lng, centerLat, centerLng);
    return distance > radius;  // 超出半径范围
}

public boolean isPointInPolygon(Double lat, Double lng, List<Point> polygon) {
    // 射线法判断点是否在多边形内
    int crossings = 0;
    for (int i = 0; i < polygon.size(); i++) {
        Point p1 = polygon.get(i);
        Point p2 = polygon.get((i + 1) % polygon.size());
        // 射线与边的交点计算
        if (rayIntersectsEdge(lat, lng, p1, p2)) {
            crossings++;
        }
    }
    return (crossings % 2) == 1;
}

@GetMapping("/statistics/overview")
public ApiResponse<OverviewStatistics> getOverview() {
    long totalVehicles = vehicleRepository.count();
    long onlineVehicles = vehicleRepository.countByStatus(VehicleStatus.ONLINE);
    long unhandledAlarms = alarmRepository.countByStatus(AlarmStatus.UNHANDLED);
    
    OverviewStatistics stats = new OverviewStatistics();
    stats.setTotalVehicles(totalVehicles);
    stats.setOnlineVehicles(onlineVehicles);
    stats.setUnhandledAlarms(unhandledAlarms);
    
    return ApiResponse.success(stats);
}

// 分页查询示例
public Page<Vehicle> searchVehicles(String keyword, int page, int size) {
    Pageable pageable = PageRequest.of(page, size);
    return vehicleRepository.findByKeyword(keyword, pageable);
}

// 设备 API 服务接口
public interface DeviceProviderService {
    Location getDeviceLocation(String imei);
    DeviceStatus getDeviceStatus(String imei);
    boolean registerDevice(String imei, Vehicle vehicle);
}

# 克隆项目
git clone <repository-url>
cd vehicle-monitoring-system
# 一键启动（自动启动后端和前端）
chmod +x start-all.sh
./start-all.sh

cd backend
# 方式 A：使用启动脚本
chmod +x start-backend.sh
./start-backend.sh
# 方式 B：Maven 命令
mvn spring-boot:run
# 方式 C：打包后运行
mvn clean package -DskipTests java -jar target/vehicle-monitoring-1.0.0.jar

cd frontend
# 安装依赖（首次运行）
npm install
# 启动开发服务器
npm run serve

CREATE DATABASE vehicle_monitoring CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/vehicle_monitoring?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai
    driver-class-name: com.mysql.cj.jdbc.Driver
    username: root
    password: your_password
  jpa:
    hibernate:
      ddl-auto: update
    properties:
      hibernate:
        dialect: org.hibernate.dialect.MySQL8Dialect

mysql -u root -p vehicle_monitoring < database/mysql_schema.sql
mysql -u root -p vehicle_monitoring < database/mysql_data.sql

cd backend
mvn clean package -DskipTests java -jar -Dspring.profiles.active=prod target/vehicle-monitoring-1.0.0.jar

cd frontend
npm install
npm run build
# 将 dist 目录部署到 Nginx 或 Apache 服务器

server {
    listen 80;
    server_name your-domain.com;
    location / {
        root /path/to/frontend/dist;
        try_files $uri $uri/ /index.html;
    }
    location /api {
        proxy_pass http://localhost:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

用户名	密码	角色	权限
admin	admin123	ADMIN	全部权限

# application.yml 关键配置
server:
  port: 8080
  servlet:
    context-path: /api
jwt:
  secret: "your-secret-key-change-in-production" # 生产环境必须修改
  expiration: 86400000 # Token 有效期（毫秒）
spring:
  datasource:
    url: jdbc:h2:mem:testdb # 开发环境
    # url: jdbc:mysql://...  # 生产环境

// frontend/vue.config.js
module.exports = {
  devServer: {
    port: 8081,
    proxy: {
      '/api': {
        target: 'http://localhost:8080',
        changeOrigin: true
      }
    }
  }
}

// mobile/api/request.js
const BASE_URL = 'http://your-api-domain.com/api'  // 修改为实际后端地址
const USE_MOCK = false  // 使用真实后端

// 车辆注册示例
@PostMapping("/vehicles")
public ApiResponse<VehicleDTO> createVehicle(@RequestBody VehicleDTO vehicleDTO) {
    // 1. 检查 IMEI 是否已存在
    if (vehicleRepository.existsByImei(vehicleDTO.getImei())) {
        return ApiResponse.error("设备 IMEI 已注册");
    }
    
    // 2. 创建车辆记录
    Vehicle vehicle = new Vehicle();
    vehicle.setImei(vehicleDTO.getImei());
    vehicle.setCustomerName(vehicleDTO.getCustomerName());
    vehicle.setVehicleName(vehicleDTO.getVehicleName());
    vehicle.setPlateNumber(vehicleDTO.getPlateNumber());
    vehicle.setStatus(VehicleStatus.REGISTERED);
    
    // 3. 注册设备到第三方平台
    boolean registered = deviceProviderService.registerDevice(
        vehicleDTO.getImei(), vehicle
    );
    vehicle.setDeviceRegistered(registered);
    
    vehicleRepository.save(vehicle);
    return ApiResponse.success(convertToDTO(vehicle));
}

// 轨迹分析示例
@GetMapping("/track/history/{vehicleId}")
public ApiResponse<List<LocationHistoryDTO>> getHistoryTrack(
        @PathVariable Long vehicleId,
        @RequestParam String startTime,
        @RequestParam String endTime) {
    
    LocalDateTime start = LocalDateTime.parse(startTime);
    LocalDateTime end = LocalDateTime.parse(endTime);
    
    List<LocationHistory> tracks = locationHistoryRepository
        .findByVehicleIdAndLocationTimeBetween(vehicleId, start, end);
    
    // 计算行驶距离
    double totalDistance = calculateTotalDistance(tracks);
    
    List<LocationHistoryDTO> dtos = tracks.stream()
        .map(this::convertToDTO)
        .collect(Collectors.toList());
    
    return ApiResponse.success(dtos);
}

// 系统自动检测围栏越界
if (isPointOutsideFence(vehicleLocation, geoFence)) {
    alarmService.triggerAlarm(
        AlarmType.GEO_FENCE_OUT,
        vehicle,
        "车辆驶出围栏范围"
    );
}

@GetMapping("/track/replay/{vehicleId}")
public ApiResponse<TrackReplayDTO> replayTrack(
        @PathVariable Long vehicleId,
        @RequestParam @DateTimeFormat(iso = DateTimeFormat.ISO.DATE_TIME)
                LocalDateTime startTime,
        @RequestParam @DateTimeFormat(iso = DateTimeFormat.ISO.DATE_TIME)
                LocalDateTime endTime) {
    
    List<LocationHistory> tracks = locationHistoryRepository
        .findByVehicleIdAndLocationTimeBetweenOrderByLocationTime(
            vehicleId, startTime, endTime);
    
    TrackReplayDTO replay = new TrackReplayDTO();
    replay.setVehicleId(vehicleId);
    replay.setStartTime(startTime);
    replay.setEndTime(endTime);
    replay.setTrackPoints(convertToTrackPoints(tracks));
    replay.setTotalDistance(calculateDistance(tracks));
    replay.setDuration(Duration.between(startTime, endTime));
    
    return ApiResponse.success(replay);
}

@PreAuthorize("hasRole('ADMIN') or hasRole('MANAGER')")
@GetMapping("/vehicles")
public ApiResponse<Page<VehicleDTO>> getAllVehicles(
        @RequestParam(defaultValue = "0") int page,
        @RequestParam(defaultValue = "10") int size) {
    // 管理员和经理可查看所有车辆
    return ApiResponse.success(vehicleService.getAllVehicles(page, size));
}

@PreAuthorize("hasRole('MONITOR') or hasRole('USER')")
@GetMapping("/vehicles/my")
public ApiResponse<List<VehicleDTO>> getMyVehicles() {
    // 监控人员和普通用户只能查看分配的车辆
    String username = SecurityContextHolder.getContext()
        .getAuthentication().getName();
    return ApiResponse.success(vehicleService.getVehiclesByUser(username));
}

车辆监控管理系统：后端 API、Web 后台与移动端应用

引言

一、项目背景及简介

1.1 项目背景

1.2 项目简介

1.3 核心价值

二、目标客户

2.1 主要客户群体

2.2 客户需求特征

三、平台定位

3.1 产品定位

3.2 市场定位

3.3 功能定位

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具

四、平台技术与系统架构

4.1 技术架构概览

4.2 后端技术栈

4.3 前端技术栈

4.4 系统架构设计

五、平台核心业务功能

5.1 用户认证与权限管理

5.2 车辆全生命周期管理

5.3 实时位置监控与轨迹管理

5.4 智能报警系统

5.5 电子围栏管理

5.6 数据统计与分析

六、平台独特优势

6.1 技术优势

6.2 业务优势

6.3 用户体验优势

6.4 可扩展性优势

七、平台安装使用

7.1 系统要求

7.2 快速安装

7.3 生产环境部署

7.4 默认账号

7.5 配置说明

八、应用场景及使用案例说明

8.1 典型应用场景

8.2 使用案例详细说明

8.3 最佳实践建议

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具