feat(menu): 新增菜单结构迁移 SQL 脚本

配合前端菜单重构，新增数据库迁移脚本：

- v3.0_nav_restructure.sql: 初始菜单结构（部署/运维/运营分析）
- v3.2_ops_grouping.sql: 运维管理子目录（已标记废弃）
- v3.3_fix_ops_nesting.sql: 修复运维管理双层嵌套
- v3.4_system_restructure.sql: 系统管理/系统监控子目录
- v3.5_component_paths.sql: 组件路径更新（配合前端目录重构）

Author: LeonDev1024

opentcs-applications/opentcs-vehicle/src/main/java/org/opentcs/vehicle/application/VehicleApplicationService.java

@@ -7,18 +7,22 @@
 import org.opentcs.driver.api.dto.VehicleStatus;
 import org.opentcs.driver.registry.DriverRegistry;
 import org.opentcs.kernel.api.OrderLifecycleApi;
-import org.opentcs.kernel.api.dto.OrderStateDTO;
 import org.opentcs.kernel.api.dto.PositionDTO;
 import org.opentcs.kernel.api.dto.TransportOrderDTO;
 import org.opentcs.kernel.api.dto.VehicleDTO;
 import org.opentcs.vehicle.application.bo.VehicleBO;
 import org.opentcs.vehicle.application.bo.VehicleCrudBO;
+import org.opentcs.vehicle.application.bo.OpsActionResultBO;
 import org.opentcs.kernel.application.TransportOrderRegistry;
 import org.opentcs.kernel.application.VehicleRegistry;
 import org.opentcs.kernel.domain.order.TransportOrder;
 import org.opentcs.kernel.domain.vehicle.Vehicle;
 import org.opentcs.kernel.domain.vehicle.VehiclePosition;
 import org.opentcs.kernel.domain.vehicle.VehicleState;
+import org.opentcs.vehicle.controller.req.GoChargeRequest;
+import org.opentcs.vehicle.controller.req.MapSwitchRequest;
+import org.opentcs.vehicle.controller.req.ModeSwitchRequest;
+import org.opentcs.vehicle.controller.req.MoveRequest;
 import org.opentcs.vehicle.persistence.entity.VehicleEntity;
 import org.opentcs.vehicle.persistence.service.VehicleRepository;
 
@@ -28,10 +32,13 @@
 import org.springframework.transaction.annotation.Transactional;
 
 import jakarta.annotation.PostConstruct;
+import java.time.LocalDateTime;
 import java.util.ArrayList;
 import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
+import java.util.UUID;
+import java.util.concurrent.CopyOnWriteArrayList;
 import java.util.stream.Collectors;
 
 /**
@@ -48,6 +55,7 @@ public class VehicleApplicationService {
     private final TransportOrderRegistry orderRegistry;
     private final OrderLifecycleApi orderLifecycleApi;
     private final DriverRegistry driverRegistry;
+    private final List<Map<String, Object>> opsActionRecords = new CopyOnWriteArrayList<>();
 
     /**
      * 启动时向驱动层注册状态监听器，自动检测订单完成事件。
@@ -242,6 +250,121 @@ public void sendInstantAction(String vehicleId, InstantAction action) {
         log.info("即时动作已发送到车辆 {}: {}", vehicleId, action.getActionType());
     }
 
+    public OpsActionResultBO switchMode(String vehicleName, ModeSwitchRequest request) {
+        String targetMode = request.getTargetMode() == null ? "AUTOMATIC" : request.getTargetMode().toUpperCase();
+        String actionType = "AUTOMATIC".equals(targetMode) ? "RESUME" : "PAUSE";
+
+        Map<String, String> params = new HashMap<>();
+        params.put("targetMode", targetMode);
+        params.put("executePolicy", nvl(request.getExecutePolicy(), "REJECT_IF_BUSY"));
+        params.put("reason", nvl(request.getReason(), ""));
+        return executeOpsAction(vehicleName, "MODE_SWITCH", actionType, params);
+    }
+
+    public OpsActionResultBO switchMap(String vehicleName, MapSwitchRequest request) {
+        Map<String, String> params = new HashMap<>();
+        params.put("targetMapId", nvl(request.getTargetMapId(), ""));
+        params.put("targetMapVersion", nvl(request.getTargetMapVersion(), ""));
+        params.put("initPosition", nvl(request.getInitPosition(), ""));
+        params.put("fallbackMapId", nvl(request.getFallbackMapId(), ""));
+        return executeOpsAction(vehicleName, "MAP_SWITCH", "enableMap", params);
+    }
+
+    public OpsActionResultBO goCharge(String vehicleName, GoChargeRequest request) {
+        Map<String, String> params = new HashMap<>();
+        params.put("chargePolicy", nvl(request.getChargePolicy(), "NEAREST"));
+        params.put("stationId", nvl(request.getStationId(), ""));
+        params.put("interruptPolicy", nvl(request.getInterruptPolicy(), "WAIT_CURRENT_TASK"));
+        if (request.getMinSocThreshold() != null) {
+            params.put("minSocThreshold", String.valueOf(request.getMinSocThreshold()));
+        }
+        return executeOpsAction(vehicleName, "GO_CHARGE", "CHARGE", params);
+    }
+
+    public OpsActionResultBO moveVehicle(String vehicleName, MoveRequest request) {
+        String moveType = nvl(request.getMoveType(), "MOVE_TO_NODE");
+        Map<String, String> params = new HashMap<>();
+        params.put("moveType", moveType);
+        params.put("targetNodeId", nvl(request.getTargetNodeId(), ""));
+        params.put("mapId", nvl(request.getMapId(), ""));
+        params.put("confirmRisk", String.valueOf(Boolean.TRUE.equals(request.getConfirmRisk())));
+        if (request.getX() != null) {
+            params.put("x", String.valueOf(request.getX()));
+        }
+        if (request.getY() != null) {
+            params.put("y", String.valueOf(request.getY()));
+        }
+        if (request.getTheta() != null) {
+            params.put("theta", String.valueOf(request.getTheta()));
+        }
+
+        String actionType = "INIT_POSITION".equalsIgnoreCase(moveType) ? "initPosition" : "MOVE";
+        return executeOpsAction(vehicleName, "MOVE", actionType, params);
+    }
+
+    public Map<String, Object> precheck(String vehicleName, String actionType) {
+        Map<String, Object> result = new HashMap<>();
+        boolean online = vehicleRegistry.isOnline(vehicleName);
+        Vehicle vehicle = vehicleRegistry.getVehicleDomain(vehicleName);
+
+        result.put("vehicleName", vehicleName);
+        result.put("actionType", actionType);
+        result.put("online", online);
+        result.put("state", vehicle == null ? "UNKNOWN" : vehicle.getState().name());
+        result.put("allow", online);
+        result.put("reasonCode", online ? null : "OPS_AMR_001");
+        result.put("reasonMessage", online ? null : "车辆离线，禁止执行运维动作");
+        return result;
+    }
+
+    public List<Map<String, Object>> listOpsActionRecords(String vehicleName) {
+        if (vehicleName == null || vehicleName.isBlank()) {
+            return new ArrayList<>(opsActionRecords);
+        }
+        return opsActionRecords.stream()
+                .filter(record -> vehicleName.equals(record.get("vehicleName")))
+                .collect(Collectors.toList());
+    }
+
+    private OpsActionResultBO executeOpsAction(String vehicleName,
+                                               String actionCategory,
+                                               String actionType,
+                                               Map<String, String> parameters) {
+        if (!vehicleRegistry.isOnline(vehicleName)) {
+            throw new RuntimeException("车辆离线: " + vehicleName);
+        }
+
+        String actionId = "OPS-" + System.currentTimeMillis();
+        String traceId = UUID.randomUUID().toString().replace("-", "");
+
+        InstantAction action = new InstantAction(actionId, actionType);
+        action.setParameters(parameters);
+        driverRegistry.sendInstantAction(vehicleName, action);
+
+        Map<String, Object> record = new HashMap<>();
+        record.put("actionId", actionId);
+        record.put("traceId", traceId);
+        record.put("vehicleName", vehicleName);
+        record.put("actionCategory", actionCategory);
+        record.put("actionType", actionType);
+        record.put("requestPayload", parameters);
+        record.put("executeStatus", "ACCEPTED");
+        record.put("operatedAt", LocalDateTime.now().toString());
+        opsActionRecords.add(0, record);
+
+        OpsActionResultBO result = new OpsActionResultBO();
+        result.setActionId(actionId);
+        result.setAccepted(true);
+        result.setStatus("PENDING");
+        result.setTraceId(traceId);
+        result.setEstimatedFinishTime(LocalDateTime.now().plusMinutes(1).toString());
+        return result;
+    }
+
+    private String nvl(String value, String defaultValue) {
+        return value == null || value.isBlank() ? defaultValue : value;
+    }
+
     /**
      * 处理车辆状态变更（从驱动层回调）
      */

opentcs-applications/opentcs-vehicle/src/main/java/org/opentcs/vehicle/application/bo/OpsActionResultBO.java

@@ -0,0 +1,15 @@
+package org.opentcs.vehicle.application.bo;
+
+import lombok.Data;
+
+@Data
+public class OpsActionResultBO {
+
+    private String actionId;
+    private Boolean accepted;
+    private String status;
+    private String reasonCode;
+    private String reasonMessage;
+    private String traceId;
+    private String estimatedFinishTime;
+}

opentcs-applications/opentcs-vehicle/src/main/java/org/opentcs/vehicle/controller/OpsAmrController.java

@@ -0,0 +1,52 @@
+package org.opentcs.vehicle.controller;
+
+import lombok.RequiredArgsConstructor;
+import org.opentcs.common.core.domain.R;
+import org.opentcs.vehicle.application.VehicleApplicationService;
+import org.opentcs.vehicle.application.bo.OpsActionResultBO;
+import org.opentcs.vehicle.controller.req.GoChargeRequest;
+import org.opentcs.vehicle.controller.req.MapSwitchRequest;
+import org.opentcs.vehicle.controller.req.ModeSwitchRequest;
+import org.opentcs.vehicle.controller.req.MoveRequest;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+import java.util.Map;
+
+@RestController
+@RequestMapping("/ops/amr")
+@RequiredArgsConstructor
+public class OpsAmrController {
+
+    private final VehicleApplicationService vehicleApplicationService;
+
+    @PostMapping("/{vehicleName}/mode/switch")
+    public R<OpsActionResultBO> switchMode(@PathVariable String vehicleName, @RequestBody ModeSwitchRequest request) {
+        return R.ok(vehicleApplicationService.switchMode(vehicleName, request));
+    }
+
+    @PostMapping("/{vehicleName}/map/switch")
+    public R<OpsActionResultBO> switchMap(@PathVariable String vehicleName, @RequestBody MapSwitchRequest request) {
+        return R.ok(vehicleApplicationService.switchMap(vehicleName, request));
+    }
+
+    @PostMapping("/{vehicleName}/charge/go")
+    public R<OpsActionResultBO> goCharge(@PathVariable String vehicleName, @RequestBody GoChargeRequest request) {
+        return R.ok(vehicleApplicationService.goCharge(vehicleName, request));
+    }
+
+    @PostMapping("/{vehicleName}/move")
+    public R<OpsActionResultBO> moveVehicle(@PathVariable String vehicleName, @RequestBody MoveRequest request) {
+        return R.ok(vehicleApplicationService.moveVehicle(vehicleName, request));
+    }
+
+    @GetMapping("/{vehicleName}/precheck")
+    public R<Map<String, Object>> precheck(@PathVariable String vehicleName, @RequestParam String actionType) {
+        return R.ok(vehicleApplicationService.precheck(vehicleName, actionType));
+    }
+
+    @GetMapping("/actions")
+    public R<List<Map<String, Object>>> listActionRecords(@RequestParam(required = false) String vehicleName) {
+        return R.ok(vehicleApplicationService.listOpsActionRecords(vehicleName));
+    }
+}

opentcs-applications/opentcs-vehicle/src/main/java/org/opentcs/vehicle/controller/req/GoChargeRequest.java

@@ -0,0 +1,12 @@
+package org.opentcs.vehicle.controller.req;
+
+import lombok.Data;
+
+@Data
+public class GoChargeRequest {
+
+    private String chargePolicy;
+    private String stationId;
+    private String interruptPolicy;
+    private Integer minSocThreshold;
+}

opentcs-applications/opentcs-vehicle/src/main/java/org/opentcs/vehicle/controller/req/MapSwitchRequest.java

@@ -0,0 +1,12 @@
+package org.opentcs.vehicle.controller.req;
+
+import lombok.Data;
+
+@Data
+public class MapSwitchRequest {
+
+    private String targetMapId;
+    private String targetMapVersion;
+    private String initPosition;
+    private String fallbackMapId;
+}

opentcs-applications/opentcs-vehicle/src/main/java/org/opentcs/vehicle/controller/req/ModeSwitchRequest.java

@@ -0,0 +1,11 @@
+package org.opentcs.vehicle.controller.req;
+
+import lombok.Data;
+
+@Data
+public class ModeSwitchRequest {
+
+    private String targetMode;
+    private String executePolicy;
+    private String reason;
+}

opentcs-applications/opentcs-vehicle/src/main/java/org/opentcs/vehicle/controller/req/MoveRequest.java

@@ -0,0 +1,15 @@
+package org.opentcs.vehicle.controller.req;
+
+import lombok.Data;
+
+@Data
+public class MoveRequest {
+
+    private String moveType;
+    private String targetNodeId;
+    private String mapId;
+    private Double x;
+    private Double y;
+    private Double theta;
+    private Boolean confirmRisk;
+}