Merge branch 'feat/mes' of https://gitee.com/zhijiantianya/ruoyi-vue-pro into master-jdk17

YunaiV
2 parents 82037d02 3f514a5c
Showing 1162 changed files with 91090 additions and 0 deletions
pom.xml
yudao-framework/yudao-common/src/main/java/cn/iocoder/yudao/framework/common/util/collection/CollectionUtils.java
yudao-framework/yudao-common/src/main/java/cn/iocoder/yudao/framework/common/util/date/LocalDateTimeUtils.java
yudao-framework/yudao-common/src/main/java/cn/iocoder/yudao/framework/common/util/object/ObjectUtils.java
yudao-module-infra/src/main/java/cn/iocoder/yudao/module/infra/api/config/ConfigApi.java
yudao-module-infra/src/main/java/cn/iocoder/yudao/module/infra/api/websocket/WebSocketSenderApi.java
yudao-module-mes/pom.xml
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/cal/calendar/MesCalCalendarController.java
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/cal/calendar/vo/MesCalCalendarListReqVO.java
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/cal/calendar/vo/MesCalCalendarRespVO.java
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/cal/holiday/MesCalHolidayController.java
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/cal/holiday/vo/MesCalHolidayRespVO.java
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/cal/holiday/vo/MesCalHolidaySaveReqVO.java
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/cal/package-info.java
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/cal/plan/MesCalPlanController.java
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/cal/plan/MesCalPlanShiftController.java
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/cal/plan/MesCalPlanTeamController.java
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/cal/plan/vo/MesCalPlanPageReqVO.java
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/cal/plan/vo/MesCalPlanRespVO.java
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/cal/plan/vo/MesCalPlanSaveReqVO.java
@@ -25,6 +25,7 @@
 <!--        <module>yudao-module-erp</module>-->
 <!--        <module>yudao-module-ai</module>-->
 <!--        <module>yudao-module-iot</module>-->
+        <module>yudao-module-mes</module>
     </modules>
     <name>${project.artifactId}</name>
@@ -349,4 +349,27 @@ public class CollectionUtils {
         return (LinkedHashSet<T>) toCollection(LinkedHashSet.class, elementType, value);
     }
+    public static boolean dfs(Long node, Map<Long, Set<Long>> graph) {
+        return dfs(node, graph, new HashSet<>(), new HashSet<>());
+    }
+
+    private static boolean dfs(Long node, Map<Long, Set<Long>> graph, Set<Long> visited, Set<Long> inStack) {
+        if (inStack.contains(node)) {
+            return true;
+        }
+        if (visited.contains(node)) {
+            return false;
+        }
+        visited.add(node);
+        inStack.add(node);
+        Set<Long> neighbors = graph.getOrDefault(node, Collections.emptySet());
+        for (Long neighbor : neighbors) {
+            if (dfs(neighbor, graph, visited, inStack)) {
+                return true;
+            }
+        }
+        inStack.remove(node);
+        return false;
+    }
+
 }
 \ No newline at end of file
@@ -336,6 +336,27 @@ public class LocalDateTimeUtils {
     }
     /**
+     * 获取指定日期所在季度的第一天
+     *
+     * @param date 日期
+     * @return 所在季度的第一天
+     */
+    public static LocalDate getQuarterStart(LocalDate date) {
+        Month firstMonthOfQuarter = date.getMonth().firstMonthOfQuarter();
+        return LocalDate.of(date.getYear(), firstMonthOfQuarter, 1);
+    }
+
+    /**
+     * 获取指定日期所在周的第一天（周一）
+     *
+     * @param date 日期
+     * @return 所在周的周一
+     */
+    public static LocalDate getWeekStart(LocalDate date) {
+        return date.with(DayOfWeek.MONDAY);
+    }
+
+    /**
      * 将给定的 {@link LocalDateTime} 转换为自 Unix 纪元时间（1970-01-01T00:00:00Z）以来的秒数。
      *
      * @param sourceDateTime 需要转换的本地日期时间，不能为空
@@ -60,6 +60,11 @@ public class ObjectUtils {
         return Arrays.asList(array).contains(obj);
     }
+    @SafeVarargs
+    public static <T> boolean notEqualsAny(T obj, T... array) {
+        return !Arrays.asList(array).contains(obj);
+    }
+
     public static boolean isNotAllEmpty(Object... objs) {
         return !ObjectUtil.isAllEmpty(objs);
     }
@@ -7,6 +7,7 @@ package cn.iocoder.yudao.module.infra.api.config;
  */
 public interface ConfigApi {
+
     /**
      * 根据参数键查询参数值
      *
@@ -11,6 +11,7 @@ import cn.iocoder.yudao.framework.common.util.json.JsonUtils;
  */
 public interface WebSocketSenderApi {
+
     /**
      * 发送消息给指定用户
      *
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <parent>
+        <groupId>cn.iocoder.boot</groupId>
+        <artifactId>yudao</artifactId>
+        <version>${revision}</version>
+    </parent>
+    <modelVersion>4.0.0</modelVersion>
+    <artifactId>yudao-module-mes</artifactId>
+    <packaging>jar</packaging>
+
+    <name>${project.artifactId}</name>
+    <description>
+        mes 模块下，制造执行系统（Manufacturing Execution System）。
+        例如说：基础数据、排班日历、设备管理、工具管理、生产管理、质量管理、仓库管理等等
+    </description>
+
+    <dependencies>
+        <dependency>
+            <groupId>cn.iocoder.boot</groupId>
+            <artifactId>yudao-module-system</artifactId>
+            <version>${revision}</version>
+        </dependency>
+
+        <!-- 业务组件 -->
+
+        <!-- Web 相关 -->
+        <dependency>
+            <groupId>cn.iocoder.boot</groupId>
+            <artifactId>yudao-spring-boot-starter-web</artifactId>
+        </dependency>
+
+        <dependency>
+            <groupId>cn.iocoder.boot</groupId>
+            <artifactId>yudao-spring-boot-starter-security</artifactId>
+        </dependency>
+
+        <!-- DB 相关 -->
+        <dependency>
+            <groupId>cn.iocoder.boot</groupId>
+            <artifactId>yudao-spring-boot-starter-mybatis</artifactId>
+        </dependency>
+
+        <dependency>
+            <groupId>cn.iocoder.boot</groupId>
+            <artifactId>yudao-spring-boot-starter-redis</artifactId>
+        </dependency>
+
+        <!-- 工具类相关 -->
+        <dependency>
+            <groupId>cn.iocoder.boot</groupId>
+            <artifactId>yudao-spring-boot-starter-excel</artifactId>
+        </dependency>
+
+        <!-- Test 测试相关 -->
+        <dependency>
+            <groupId>cn.iocoder.boot</groupId>
+            <artifactId>yudao-spring-boot-starter-test</artifactId>
+        </dependency>
+
+    </dependencies>
+
+</project>
+package cn.iocoder.yudao.module.mes.controller.admin.cal.calendar;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.date.DatePattern;
+import cn.hutool.core.date.LocalDateTimeUtil;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.module.mes.controller.admin.cal.calendar.vo.MesCalCalendarListReqVO;
+import cn.iocoder.yudao.module.mes.controller.admin.cal.calendar.vo.MesCalCalendarRespVO;
+import cn.iocoder.yudao.module.mes.controller.admin.cal.team.vo.shift.MesCalTeamShiftListReqVO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.cal.holiday.MesCalHolidayDO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.cal.plan.MesCalPlanDO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.cal.plan.MesCalPlanShiftDO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.cal.team.MesCalTeamDO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.cal.team.MesCalTeamMemberDO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.cal.team.MesCalTeamShiftDO;
+import cn.iocoder.yudao.module.mes.enums.cal.MesCalHolidayTypeEnum;
+import cn.iocoder.yudao.module.mes.service.cal.holiday.MesCalHolidayService;
+import cn.iocoder.yudao.module.mes.service.cal.plan.MesCalPlanService;
+import cn.iocoder.yudao.module.mes.service.cal.plan.MesCalPlanShiftService;
+import cn.iocoder.yudao.module.mes.service.cal.team.MesCalTeamMemberService;
+import cn.iocoder.yudao.module.mes.service.cal.team.MesCalTeamService;
+import cn.iocoder.yudao.module.mes.service.cal.team.MesCalTeamShiftService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.time.LocalDateTime;
+import java.util.*;
+import java.util.stream.Collectors;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.*;
+
+@Tag(name = "管理后台 - MES 排班日历")
+@RestController
+@RequestMapping("/mes/cal/calendar")
+@Validated
+public class MesCalCalendarController {
+
+    @Resource
+    private MesCalTeamShiftService teamShiftService;
+    @Resource
+    private MesCalTeamService teamService;
+    @Resource
+    private MesCalPlanShiftService planShiftService;
+    @Resource
+    private MesCalPlanService planService;
+    @Resource
+    private MesCalTeamMemberService teamMemberService;
+    @Resource
+    private MesCalHolidayService holidayService;
+
+    @GetMapping("/list")
+    @Operation(summary = "查询排班日历")
+    @PreAuthorize("@ss.hasPermission('mes:cal-team-shift:query')")
+    public CommonResult<List<MesCalCalendarRespVO>> getCalendarList(@Valid MesCalCalendarListReqVO reqVO) {
+        // 1.1 根据查询类型获取班组排班记录
+        List<MesCalTeamShiftDO> teamShifts = getTeamShifts(reqVO);
+        if (CollUtil.isEmpty(teamShifts)) {
+            return success(Collections.emptyList());
+        }
+        // 1.2 按日期范围查询假期，构建节假日日期集合
+        Set<String> holidaySet = buildHolidaySet(reqVO.getStartDay(), reqVO.getEndDay());
+        // 1.3 批量查询关联数据：班组、班次、排班计划
+        Map<Long, MesCalTeamDO> teamMap = teamService.getTeamMap(
+                convertSet(teamShifts, MesCalTeamShiftDO::getTeamId));
+        Map<Long, MesCalPlanShiftDO> shiftMap = planShiftService.getPlanShiftMap(
+                convertSet(teamShifts, MesCalTeamShiftDO::getShiftId));
+        Map<Long, MesCalPlanDO> planMap = planService.getPlanMap(
+                convertSet(teamShifts, MesCalTeamShiftDO::getPlanId));
+
+        // 2. 按 day 分组聚合
+        Map<String, List<MesCalTeamShiftDO>> dayGroupMap = convertMultiMap(teamShifts,
+                teamShift -> LocalDateTimeUtil.format(teamShift.getDay(), DatePattern.NORM_DATE_PATTERN));
+
+        // 3. 遍历分组，过滤假期，构建日历响应
+        List<MesCalCalendarRespVO> result = new ArrayList<>();
+        for (Map.Entry<String, List<MesCalTeamShiftDO>> entry : dayGroupMap.entrySet()) {
+            String dayStr = entry.getKey();
+            // 3.1 过滤节假日
+            if (holidaySet.contains(dayStr)) {
+                continue;
+            }
+            List<MesCalTeamShiftDO> dayShifts = entry.getValue();
+            dayShifts.sort(Comparator.comparing(ts -> ts.getSort() != null ? ts.getSort() : 0));
+            // 3.2 获取轮班方式（取第一条记录关联的排班计划）
+            Integer shiftType = null;
+            MesCalTeamShiftDO first = dayShifts.get(0);
+            if (first.getPlanId() != null) {
+                MesCalPlanDO plan = planMap.get(first.getPlanId());
+                if (plan != null) {
+                    shiftType = plan.getShiftType();
+                }
+            }
+            // 3.3 构建班组排班项列表
+            List<MesCalCalendarRespVO.TeamShiftItem> items = convertList(dayShifts,
+                    teamShift -> buildTeamShiftItem(teamShift, teamMap, shiftMap));
+
+            // 3.4 构建日历项，添加到结果列表
+            MesCalCalendarRespVO calendarVO = MesCalCalendarRespVO.builder()
+                    .day(LocalDateTimeUtil.parseDate(dayStr, DatePattern.NORM_DATE_FORMATTER).atStartOfDay())
+                    .shiftType(shiftType)
+                    .teamShifts(items)
+                    .build();
+            result.add(calendarVO);
+        }
+        return success(result);
+    }
+
+    /**
+     * 根据查询类型获取班组排班记录
+     */
+    @SuppressWarnings("EnhancedSwitchMigration")
+    private List<MesCalTeamShiftDO> getTeamShifts(MesCalCalendarListReqVO reqVO) {
+        LocalDateTime startDay = reqVO.getStartDay();
+        LocalDateTime endDay = reqVO.getEndDay();
+        switch (reqVO.getQueryType()) {
+            case MesCalCalendarListReqVO.QUERY_TYPE_TYPE:
+                return getTeamShiftsByCalendarType(reqVO.getCalendarType(), startDay, endDay);
+            case MesCalCalendarListReqVO.QUERY_TYPE_TEAM:
+                return getTeamShiftsByTeamId(reqVO.getTeamId(), startDay, endDay);
+            case MesCalCalendarListReqVO.QUERY_TYPE_USER:
+                return getTeamShiftsByUserId(reqVO.getUserId(), startDay, endDay);
+            default:
+                return Collections.emptyList();
+        }
+    }
+
+    /**
+     * 构建单条 TeamShiftItem
+     */
+    private MesCalCalendarRespVO.TeamShiftItem buildTeamShiftItem(MesCalTeamShiftDO ts,
+                                                                  Map<Long, MesCalTeamDO> teamMap,
+                                                                  Map<Long, MesCalPlanShiftDO> shiftMap) {
+        MesCalTeamDO team = teamMap.get(ts.getTeamId());
+        MesCalPlanShiftDO shift = shiftMap.get(ts.getShiftId());
+        return MesCalCalendarRespVO.TeamShiftItem.builder()
+                .teamId(ts.getTeamId()).teamName(team != null ? team.getName() : null)
+                .shiftId(ts.getShiftId()).shiftName(shift != null ? shift.getName() : null)
+                .sort(ts.getSort()).build();
+    }
+
+    /**
+     * 按班组类型查询排班记录
+     */
+    private List<MesCalTeamShiftDO> getTeamShiftsByCalendarType(Integer calendarType,
+                                                                  LocalDateTime startDay, LocalDateTime endDay) {
+        if (calendarType == null) {
+            return Collections.emptyList();
+        }
+        // 1. 查询指定类型的所有班组
+        List<MesCalTeamDO> teams = teamService.getTeamList().stream()
+                .filter(t -> calendarType.equals(t.getCalendarType()))
+                .collect(Collectors.toList());
+        if (CollUtil.isEmpty(teams)) {
+            return Collections.emptyList();
+        }
+        // 2. 一次 IN 查询这些班组在日期范围内的排班记录
+        MesCalTeamShiftListReqVO reqVO = new MesCalTeamShiftListReqVO()
+                .setTeamIds(convertSet(teams, MesCalTeamDO::getId))
+                .setStartDay(startDay).setEndDay(endDay);
+        return teamShiftService.getTeamShiftList(reqVO);
+    }
+
+    /**
+     * 按班组编号查询排班记录
+     */
+    private List<MesCalTeamShiftDO> getTeamShiftsByTeamId(Long teamId, LocalDateTime startDay, LocalDateTime endDay) {
+        if (teamId == null) {
+            return Collections.emptyList();
+        }
+        MesCalTeamShiftListReqVO reqVO = new MesCalTeamShiftListReqVO()
+                .setTeamId(teamId).setStartDay(startDay).setEndDay(endDay);
+        return teamShiftService.getTeamShiftList(reqVO);
+    }
+
+    /**
+     * 按用户编号查询排班记录（先查用户所属班组，再查班组排班）
+     */
+    private List<MesCalTeamShiftDO> getTeamShiftsByUserId(Long userId,
+                                                            LocalDateTime startDay, LocalDateTime endDay) {
+        if (userId == null) {
+            return Collections.emptyList();
+        }
+        // 1. 查询用户所属的班组（一个用户只属于一个班组）
+        MesCalTeamMemberDO member = teamMemberService.getTeamMemberByUserId(userId);
+        if (member == null) {
+            return Collections.emptyList();
+        }
+        // 2. 查询该班组在日期范围内的排班记录
+        MesCalTeamShiftListReqVO reqVO = new MesCalTeamShiftListReqVO()
+                .setTeamId(member.getTeamId()).setStartDay(startDay).setEndDay(endDay);
+        return teamShiftService.getTeamShiftList(reqVO);
+    }
+
+    /**
+     * 按日期范围查询假期，构建节假日日期集合（yyyy-MM-dd 格式）
+     */
+    private Set<String> buildHolidaySet(LocalDateTime startDay, LocalDateTime endDay) {
+        List<MesCalHolidayDO> holidays = holidayService.getHolidayList(startDay, endDay);
+        return convertSet(holidays,
+                holiday -> LocalDateTimeUtil.format(holiday.getDay(), DatePattern.NORM_DATE_PATTERN),
+                holiday -> MesCalHolidayTypeEnum.HOLIDAY.getType().equals(holiday.getType()));
+    }
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.cal.calendar.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.time.LocalDateTime;
+
+import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+@Schema(description = "管理后台 - MES 排班日历查询 Request VO")
+@Data
+public class MesCalCalendarListReqVO {
+
+    public static final String QUERY_TYPE_TYPE = "TYPE";
+    public static final String QUERY_TYPE_TEAM = "TEAM";
+    public static final String QUERY_TYPE_USER = "USER";
+
+    @Schema(description = "开始日期", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "开始日期不能为空")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime startDay;
+
+    @Schema(description = "结束日期", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "结束日期不能为空")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime endDay;
+
+    @Schema(description = "查询类型：TYPE-按分类，TEAM-按班组，USER-按个人", requiredMode = Schema.RequiredMode.REQUIRED, example = "TYPE")
+    @NotEmpty(message = "查询类型不能为空")
+    private String queryType;
+
+    @Schema(description = "班组类型（queryType=TYPE 时使用）", example = "1")
+    private Integer calendarType;
+
+    @Schema(description = "班组编号（queryType=TEAM 时使用）", example = "201")
+    private Long teamId;
+
+    @Schema(description = "用户编号（queryType=USER 时使用）", example = "1")
+    private Long userId;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.cal.calendar.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+@Schema(description = "管理后台 - MES 排班日历 Response VO")
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class MesCalCalendarRespVO {
+
+    @Schema(description = "日期", requiredMode = Schema.RequiredMode.REQUIRED, example = "2025-01-15 00:00:00")
+    private LocalDateTime day;
+
+    @Schema(description = "轮班方式", example = "2")
+    private Integer shiftType; // 对应 MesCalShiftTypeEnum 枚举值
+
+    @Schema(description = "班组排班列表")
+    private List<TeamShiftItem> teamShifts;
+
+    @Schema(description = "班组排班项")
+    @Data
+    @Builder
+    @NoArgsConstructor
+    @AllArgsConstructor
+    public static class TeamShiftItem {
+
+        @Schema(description = "班组编号", example = "201")
+        private Long teamId;
+
+        @Schema(description = "班组名称", example = "注塑A组")
+        private String teamName;
+
+        @Schema(description = "班次编号", example = "1")
+        private Long shiftId;
+
+        @Schema(description = "班次名称", example = "白班")
+        private String shiftName;
+
+        @Schema(description = "排序", example = "1")
+        private Integer sort;
+
+    }
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.cal.holiday;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.mes.controller.admin.cal.holiday.vo.MesCalHolidayRespVO;
+import cn.iocoder.yudao.module.mes.controller.admin.cal.holiday.vo.MesCalHolidaySaveReqVO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.cal.holiday.MesCalHolidayDO;
+import cn.iocoder.yudao.module.mes.service.cal.holiday.MesCalHolidayService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.format.annotation.DateTimeFormat;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+
+@Tag(name = "管理后台 - MES 假期设置")
+@RestController
+@RequestMapping("/mes/cal/holiday")
+@Validated
+public class MesCalHolidayController {
+
+    @Resource
+    private MesCalHolidayService holidayService;
+
+    @PostMapping("/save")
+    @Operation(summary = "保存假期设置", description = "如果该日期已存在记录，则更新")
+    @PreAuthorize("@ss.hasPermission('mes:cal-holiday:create')")
+    public CommonResult<Long> saveHoliday(@Valid @RequestBody MesCalHolidaySaveReqVO saveReqVO) {
+        return success(holidayService.saveHoliday(saveReqVO));
+    }
+
+    @GetMapping("/get-by-day")
+    @Operation(summary = "根据日期获得假期设置")
+    @Parameter(name = "day", description = "日期", required = true)
+    @PreAuthorize("@ss.hasPermission('mes:cal-holiday:query')")
+    public CommonResult<MesCalHolidayRespVO> getHolidayByDay(
+            @RequestParam("day") @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND) LocalDateTime day) {
+        MesCalHolidayDO holiday = holidayService.getHolidayByDay(day);
+        return success(BeanUtils.toBean(holiday, MesCalHolidayRespVO.class));
+    }
+
+    @GetMapping("/list")
+    @Operation(summary = "获得假期设置列表", description = "支持可选日期范围过滤，不传则返回全量数据")
+    @PreAuthorize("@ss.hasPermission('mes:cal-holiday:query')")
+    public CommonResult<List<MesCalHolidayRespVO>> getHolidayList(
+            @RequestParam(value = "startDay", required = false)
+            @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND) LocalDateTime startDay,
+            @RequestParam(value = "endDay", required = false)
+            @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND) LocalDateTime endDay) {
+        List<MesCalHolidayDO> list = holidayService.getHolidayList(startDay, endDay);
+        return success(BeanUtils.toBean(list, MesCalHolidayRespVO.class));
+    }
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.cal.holiday.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - MES 假期设置 Response VO")
+@Data
+public class MesCalHolidayRespVO {
+
+    @Schema(description = "编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "日期")
+    private LocalDateTime day;
+
+    @Schema(description = "日期类型")
+    private Integer type;
+
+    @Schema(description = "备注")
+    private String remark;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.cal.holiday.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - MES 假期设置新增/修改 Request VO")
+@Data
+public class MesCalHolidaySaveReqVO {
+
+    @Schema(description = "编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "日期", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "日期不能为空")
+    private LocalDateTime day;
+
+    @Schema(description = "日期类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "2")
+    @NotNull(message = "日期类型不能为空")
+    private Integer type;
+
+    @Schema(description = "备注")
+    private String remark;
+
+}
+/**
+ * MES 日历排班（Calendar / Shift Planning）：班次、班组、班组成员、排班计划、假期设置等生产人员轮班与工作日历
+ */
+package cn.iocoder.yudao.module.mes.controller.admin.cal;
+package cn.iocoder.yudao.module.mes.controller.admin.cal.plan;
+
+import cn.iocoder.yudao.framework.apilog.core.annotation.ApiAccessLog;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.framework.excel.core.util.ExcelUtils;
+import cn.iocoder.yudao.module.mes.controller.admin.cal.plan.vo.MesCalPlanPageReqVO;
+import cn.iocoder.yudao.module.mes.controller.admin.cal.plan.vo.MesCalPlanRespVO;
+import cn.iocoder.yudao.module.mes.controller.admin.cal.plan.vo.MesCalPlanSaveReqVO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.cal.plan.MesCalPlanDO;
+import cn.iocoder.yudao.module.mes.service.cal.plan.MesCalPlanService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.servlet.http.HttpServletResponse;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import java.io.IOException;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.apilog.core.enums.OperateTypeEnum.EXPORT;
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+
+@Tag(name = "管理后台 - MES 排班计划")
+@RestController
+@RequestMapping("/mes/cal/plan")
+@Validated
+public class MesCalPlanController {
+
+    @Resource
+    private MesCalPlanService planService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建排班计划")
+    @PreAuthorize("@ss.hasPermission('mes:cal-plan:create')")
+    public CommonResult<Long> createPlan(@Valid @RequestBody MesCalPlanSaveReqVO createReqVO) {
+        return success(planService.createPlan(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新排班计划")
+    @PreAuthorize("@ss.hasPermission('mes:cal-plan:update')")
+    public CommonResult<Boolean> updatePlan(@Valid @RequestBody MesCalPlanSaveReqVO updateReqVO) {
+        planService.updatePlan(updateReqVO);
+        return success(true);
+    }
+
+    @PutMapping("/confirm")
+    @Operation(summary = "确认排班计划")
+    @Parameter(name = "id", description = "编号", required = true)
+    @PreAuthorize("@ss.hasPermission('mes:cal-plan:update')")
+    public CommonResult<Boolean> confirmPlan(@RequestParam("id") Long id) {
+        planService.confirmPlan(id);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除排班计划")
+    @Parameter(name = "id", description = "编号", required = true)
+    @PreAuthorize("@ss.hasPermission('mes:cal-plan:delete')")
+    public CommonResult<Boolean> deletePlan(@RequestParam("id") Long id) {
+        planService.deletePlan(id);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得排班计划")
+    @Parameter(name = "id", description = "编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('mes:cal-plan:query')")
+    public CommonResult<MesCalPlanRespVO> getPlan(@RequestParam("id") Long id) {
+        MesCalPlanDO plan = planService.getPlan(id);
+        return success(BeanUtils.toBean(plan, MesCalPlanRespVO.class));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得排班计划分页")
+    @PreAuthorize("@ss.hasPermission('mes:cal-plan:query')")
+    public CommonResult<PageResult<MesCalPlanRespVO>> getPlanPage(@Valid MesCalPlanPageReqVO pageReqVO) {
+        PageResult<MesCalPlanDO> pageResult = planService.getPlanPage(pageReqVO);
+        return success(BeanUtils.toBean(pageResult, MesCalPlanRespVO.class));
+    }
+
+    @GetMapping("/export-excel")
+    @Operation(summary = "导出排班计划 Excel")
+    @PreAuthorize("@ss.hasPermission('mes:cal-plan:export')")
+    @ApiAccessLog(operateType = EXPORT)
+    public void exportPlanExcel(@Valid MesCalPlanPageReqVO pageReqVO,
+                                HttpServletResponse response) throws IOException {
+        pageReqVO.setPageSize(PageParam.PAGE_SIZE_NONE);
+        List<MesCalPlanDO> list = planService.getPlanPage(pageReqVO).getList();
+        // 导出 Excel
+        ExcelUtils.write(response, "排班计划.xls", "数据", MesCalPlanRespVO.class,
+                BeanUtils.toBean(list, MesCalPlanRespVO.class));
+    }
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.cal.plan;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.mes.controller.admin.cal.plan.vo.shift.MesCalPlanShiftPageReqVO;
+import cn.iocoder.yudao.module.mes.controller.admin.cal.plan.vo.shift.MesCalPlanShiftRespVO;
+import cn.iocoder.yudao.module.mes.controller.admin.cal.plan.vo.shift.MesCalPlanShiftSaveReqVO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.cal.plan.MesCalPlanShiftDO;
+import cn.iocoder.yudao.module.mes.service.cal.plan.MesCalPlanShiftService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+
+@Tag(name = "管理后台 - MES 计划班次")
+@RestController
+@RequestMapping("/mes/cal/plan-shift")
+@Validated
+public class MesCalPlanShiftController {
+
+    @Resource
+    private MesCalPlanShiftService planShiftService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建计划班次")
+    @PreAuthorize("@ss.hasPermission('mes:cal-plan:update')")
+    public CommonResult<Long> createPlanShift(@Valid @RequestBody MesCalPlanShiftSaveReqVO createReqVO) {
+        return success(planShiftService.createPlanShift(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新计划班次")
+    @PreAuthorize("@ss.hasPermission('mes:cal-plan:update')")
+    public CommonResult<Boolean> updatePlanShift(@Valid @RequestBody MesCalPlanShiftSaveReqVO updateReqVO) {
+        planShiftService.updatePlanShift(updateReqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除计划班次")
+    @Parameter(name = "id", description = "编号", required = true)
+    @PreAuthorize("@ss.hasPermission('mes:cal-plan:update')")
+    public CommonResult<Boolean> deletePlanShift(@RequestParam("id") Long id) {
+        planShiftService.deletePlanShift(id);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得计划班次")
+    @Parameter(name = "id", description = "编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('mes:cal-plan:query')")
+    public CommonResult<MesCalPlanShiftRespVO> getPlanShift(@RequestParam("id") Long id) {
+        MesCalPlanShiftDO planShift = planShiftService.getPlanShift(id);
+        return success(BeanUtils.toBean(planShift, MesCalPlanShiftRespVO.class));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得计划班次分页")
+    @PreAuthorize("@ss.hasPermission('mes:cal-plan:query')")
+    public CommonResult<PageResult<MesCalPlanShiftRespVO>> getPlanShiftPage(@Valid MesCalPlanShiftPageReqVO pageReqVO) {
+        PageResult<MesCalPlanShiftDO> pageResult = planShiftService.getPlanShiftPage(pageReqVO);
+        return success(BeanUtils.toBean(pageResult, MesCalPlanShiftRespVO.class));
+    }
+
+    @GetMapping("/list-by-plan")
+    @Operation(summary = "获得指定排班计划的班次列表")
+    @Parameter(name = "planId", description = "排班计划编号", required = true)
+    @PreAuthorize("@ss.hasPermission('mes:cal-plan:query')")
+    public CommonResult<List<MesCalPlanShiftRespVO>> getPlanShiftListByPlan(@RequestParam("planId") Long planId) {
+        List<MesCalPlanShiftDO> list = planShiftService.getPlanShiftListByPlanId(planId);
+        return success(BeanUtils.toBean(list, MesCalPlanShiftRespVO.class));
+    }
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.cal.plan;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.mes.controller.admin.cal.plan.vo.team.MesCalPlanTeamRespVO;
+import cn.iocoder.yudao.module.mes.controller.admin.cal.plan.vo.team.MesCalPlanTeamSaveReqVO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.cal.plan.MesCalPlanTeamDO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.cal.team.MesCalTeamDO;
+import cn.iocoder.yudao.module.mes.service.cal.plan.MesCalPlanTeamService;
+import cn.iocoder.yudao.module.mes.service.cal.team.MesCalTeamService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+
+@Tag(name = "管理后台 - MES 计划班组关联")
+@RestController
+@RequestMapping("/mes/cal/plan-team")
+@Validated
+public class MesCalPlanTeamController {
+
+    @Resource
+    private MesCalPlanTeamService planTeamService;
+    @Resource
+    private MesCalTeamService teamService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建计划班组关联")
+    @PreAuthorize("@ss.hasPermission('mes:cal-plan:update')")
+    public CommonResult<Long> createPlanTeam(@Valid @RequestBody MesCalPlanTeamSaveReqVO createReqVO) {
+        return success(planTeamService.createPlanTeam(createReqVO));
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除计划班组关联")
+    @Parameter(name = "id", description = "编号", required = true)
+    @PreAuthorize("@ss.hasPermission('mes:cal-plan:update')")
+    public CommonResult<Boolean> deletePlanTeam(@RequestParam("id") Long id) {
+        planTeamService.deletePlanTeam(id);
+        return success(true);
+    }
+
+    @GetMapping("/list-by-plan")
+    @Operation(summary = "获得指定排班计划的班组列表")
+    @Parameter(name = "planId", description = "排班计划编号", required = true)
+    @PreAuthorize("@ss.hasPermission('mes:cal-plan:query')")
+    public CommonResult<List<MesCalPlanTeamRespVO>> getPlanTeamListByPlan(@RequestParam("planId") Long planId) {
+        List<MesCalPlanTeamDO> list = planTeamService.getPlanTeamListByPlanId(planId);
+        List<MesCalPlanTeamRespVO> respList = BeanUtils.toBean(list, MesCalPlanTeamRespVO.class);
+        // 拼装班组编码/名称
+        // TODO @AI：if return
+        if (CollUtil.isNotEmpty(respList)) {
+            Map<Long, MesCalTeamDO> teamMap = teamService.getTeamMap(
+                    convertList(respList, MesCalPlanTeamRespVO::getTeamId));
+            respList.forEach(resp -> {
+                // TODO @AI：findand then
+                MesCalTeamDO team = teamMap.get(resp.getTeamId());
+                if (team != null) {
+                    resp.setTeamCode(team.getCode()).setTeamName(team.getName());
+                }
+            });
+        }
+        return success(respList);
+    }
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.cal.plan.vo;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.time.LocalDateTime;
+
+import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+@Schema(description = "管理后台 - MES 排班计划分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class MesCalPlanPageReqVO extends PageParam {
+
+    @Schema(description = "计划编码", example = "PLAN001")
+    private String code;
+
+    @Schema(description = "计划名称", example = "2024年排班")
+    private String name;
+
+    @Schema(description = "轮班方式", example = "1")
+    private Integer shiftType;
+
+    @Schema(description = "状态", example = "0")
+    private Integer status;
+
+    @Schema(description = "班组类型", example = "1")
+    private Integer calendarType;
+
+    @Schema(description = "开始日期")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime[] startDate;
+
+    @Schema(description = "结束日期")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime[] endDate;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.cal.plan.vo;
+
+import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
+import cn.idev.excel.annotation.ExcelProperty;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - MES 排班计划 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class MesCalPlanRespVO {
+
+    @Schema(description = "计划编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @ExcelProperty("计划编号")
+    private Long id;
+
+    @Schema(description = "计划编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "PLAN001")
+    @ExcelProperty("计划编码")
+    private String code;
+
+    @Schema(description = "计划名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "2024年排班计划")
+    @ExcelProperty("计划名称")
+    private String name;
+
+    @Schema(description = "班组类型", example = "1")
+    @ExcelProperty("班组类型")
+    private Integer calendarType;
+
+    @Schema(description = "开始日期", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("开始日期")
+    private LocalDateTime startDate;
+
+    @Schema(description = "结束日期", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("结束日期")
+    private LocalDateTime endDate;
+
+    @Schema(description = "轮班方式", example = "1")
+    @ExcelProperty("轮班方式")
+    private Integer shiftType;
+
+    @Schema(description = "倒班方式", example = "1")
+    @ExcelProperty("倒班方式")
+    private Integer shiftMethod;
+
+    @Schema(description = "倒班天数", example = "7")
+    @ExcelProperty("倒班天数")
+    private Integer shiftCount;
+
+    @Schema(description = "状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "0")
+    @ExcelProperty("状态")
+    private Integer status;
+
+    @Schema(description = "备注")
+    @ExcelProperty("备注")
+    private String remark;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("创建时间")
+    private LocalDateTime createTime;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.cal.plan.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - MES 排班计划新增/修改 Request VO")
+@Data
+public class MesCalPlanSaveReqVO {
+
+    @Schema(description = "计划编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "计划编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "PLAN001")
+    @NotEmpty(message = "计划编码不能为空")
+    private String code;
+
+    @Schema(description = "计划名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "2024年排班计划")
+    @NotEmpty(message = "计划名称不能为空")
+    private String name;
+
+    @Schema(description = "班组类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "班组类型不能为空")
+    private Integer calendarType;
+
+    @Schema(description = "开始日期", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "开始日期不能为空")
+    private LocalDateTime startDate;
+
+    @Schema(description = "结束日期", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "结束日期不能为空")
+    private LocalDateTime endDate;
+
+    @Schema(description = "轮班方式", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "轮班方式不能为空")
+    private Integer shiftType;
+
+    @Schema(description = "倒班方式", example = "1")
+    private Integer shiftMethod;
+
+    @Schema(description = "倒班天数", example = "7")
+    private Integer shiftCount;
+
+    @Schema(description = "状态", example = "0")
+    private Integer status;
+
+    @Schema(description = "备注")
+    private String remark;
+
+    }
+package cn.iocoder.yudao.module.mes.controller.admin.cal.plan.vo.shift;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+@Schema(description = "管理后台 - MES 计划班次分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class MesCalPlanShiftPageReqVO extends PageParam {
+
+    @Schema(description = "排班计划编号", example = "1")
+    private Long planId;
+
+    @Schema(description = "班次名称", example = "白班")
+    private String name;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.cal.plan.vo.shift;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - MES 计划班次 Response VO")
+@Data
+public class MesCalPlanShiftRespVO {
+
+    @Schema(description = "班次编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "排班计划编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Long planId;
+
+    @Schema(description = "显示顺序", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Integer sort;
+
+    @Schema(description = "班次名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "白班")
+    private String name;
+
+    @Schema(description = "开始时间", requiredMode = Schema.RequiredMode.REQUIRED, example = "08:00")
+    private String startTime;
+
+    @Schema(description = "结束时间", requiredMode = Schema.RequiredMode.REQUIRED, example = "17:00")
+    private String endTime;
+
+    @Schema(description = "备注")
+    private String remark;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.cal.plan.vo.shift;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+@Schema(description = "管理后台 - MES 计划班次新增/修改 Request VO")
+@Data
+public class MesCalPlanShiftSaveReqVO {
+
+    @Schema(description = "班次编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "排班计划编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "排班计划不能为空")
+    private Long planId;
+
+    @Schema(description = "显示顺序", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "显示顺序不能为空")
+    private Integer sort;
+
+    @Schema(description = "班次名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "白班")
+    @NotEmpty(message = "班次名称不能为空")
+    private String name;
+
+    @Schema(description = "开始时间", requiredMode = Schema.RequiredMode.REQUIRED, example = "08:00")
+    @NotEmpty(message = "开始时间不能为空")
+    private String startTime;
+
+    @Schema(description = "结束时间", requiredMode = Schema.RequiredMode.REQUIRED, example = "17:00")
+    @NotEmpty(message = "结束时间不能为空")
+    private String endTime;
+
+    @Schema(description = "备注")
+    private String remark;
+
+    }
+package cn.iocoder.yudao.module.mes.controller.admin.cal.plan.vo.team;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - MES 计划班组关联 Response VO")
+@Data
+public class MesCalPlanTeamRespVO {
+
+    @Schema(description = "编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "排班计划编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Long planId;
+
+    @Schema(description = "班组编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Long teamId;
+
+    @Schema(description = "班组编码", example = "T001")
+    private String teamCode;
+
+    @Schema(description = "班组名称", example = "A组")
+    private String teamName;
+
+    @Schema(description = "备注")
+    private String remark;
+
+    @Schema(description = "创建时间")
+    private LocalDateTime createTime;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.cal.plan.vo.team;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+@Schema(description = "管理后台 - MES 计划班组关联新增 Request VO")
+@Data
+public class MesCalPlanTeamSaveReqVO {
+
+    @Schema(description = "编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "排班计划编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "排班计划不能为空")
+    private Long planId;
+
+    @Schema(description = "班组编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "班组不能为空")
+    private Long teamId;
+
+    @Schema(description = "备注")
+    private String remark;
+
+    }
+package cn.iocoder.yudao.module.mes.controller.admin.cal.team;
+
+import cn.iocoder.yudao.framework.apilog.core.annotation.ApiAccessLog;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.framework.excel.core.util.ExcelUtils;
+import cn.iocoder.yudao.module.mes.controller.admin.cal.team.vo.MesCalTeamPageReqVO;
+import cn.iocoder.yudao.module.mes.controller.admin.cal.team.vo.MesCalTeamRespVO;
+import cn.iocoder.yudao.module.mes.controller.admin.cal.team.vo.MesCalTeamSaveReqVO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.cal.team.MesCalTeamDO;
+import cn.iocoder.yudao.module.mes.service.cal.team.MesCalTeamService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.servlet.http.HttpServletResponse;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import java.io.IOException;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.apilog.core.enums.OperateTypeEnum.EXPORT;
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+
+@Tag(name = "管理后台 - MES 班组")
+@RestController
+@RequestMapping("/mes/cal/team")
+@Validated
+public class MesCalTeamController {
+
+    @Resource
+    private MesCalTeamService teamService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建班组")
+    @PreAuthorize("@ss.hasPermission('mes:cal-team:create')")
+    public CommonResult<Long> createTeam(@Valid @RequestBody MesCalTeamSaveReqVO createReqVO) {
+        return success(teamService.createTeam(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新班组")
+    @PreAuthorize("@ss.hasPermission('mes:cal-team:update')")
+    public CommonResult<Boolean> updateTeam(@Valid @RequestBody MesCalTeamSaveReqVO updateReqVO) {
+        teamService.updateTeam(updateReqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除班组")
+    @Parameter(name = "id", description = "编号", required = true)
+    @PreAuthorize("@ss.hasPermission('mes:cal-team:delete')")
+    public CommonResult<Boolean> deleteTeam(@RequestParam("id") Long id) {
+        teamService.deleteTeam(id);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得班组")
+    @Parameter(name = "id", description = "编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('mes:cal-team:query')")
+    public CommonResult<MesCalTeamRespVO> getTeam(@RequestParam("id") Long id) {
+        MesCalTeamDO team = teamService.getTeam(id);
+        return success(BeanUtils.toBean(team, MesCalTeamRespVO.class));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得班组分页")
+    @PreAuthorize("@ss.hasPermission('mes:cal-team:query')")
+    public CommonResult<PageResult<MesCalTeamRespVO>> getTeamPage(@Valid MesCalTeamPageReqVO pageReqVO) {
+        PageResult<MesCalTeamDO> pageResult = teamService.getTeamPage(pageReqVO);
+        return success(BeanUtils.toBean(pageResult, MesCalTeamRespVO.class));
+    }
+
+    @GetMapping("/list")
+    @Operation(summary = "获得班组列表")
+    @PreAuthorize("@ss.hasPermission('mes:cal-team:query')")
+    public CommonResult<List<MesCalTeamRespVO>> getTeamList() {
+        List<MesCalTeamDO> list = teamService.getTeamList();
+        return success(BeanUtils.toBean(list, MesCalTeamRespVO.class));
+    }
+
+    @GetMapping("/export-excel")
+    @Operation(summary = "导出班组 Excel")
+    @PreAuthorize("@ss.hasPermission('mes:cal-team:export')")
+    @ApiAccessLog(operateType = EXPORT)
+    public void exportTeamExcel(@Valid MesCalTeamPageReqVO pageReqVO,
+                                HttpServletResponse response) throws IOException {
+        pageReqVO.setPageSize(PageParam.PAGE_SIZE_NONE);
+        List<MesCalTeamDO> list = teamService.getTeamPage(pageReqVO).getList();
+        // 导出 Excel
+        ExcelUtils.write(response, "班组.xls", "数据", MesCalTeamRespVO.class,
+                BeanUtils.toBean(list, MesCalTeamRespVO.class));
+    }
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.cal.team;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.collection.MapUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.mes.controller.admin.cal.team.vo.member.MesCalTeamMemberPageReqVO;
+import cn.iocoder.yudao.module.mes.controller.admin.cal.team.vo.member.MesCalTeamMemberRespVO;
+import cn.iocoder.yudao.module.mes.controller.admin.cal.team.vo.member.MesCalTeamMemberSaveReqVO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.cal.team.MesCalTeamMemberDO;
+import cn.iocoder.yudao.module.mes.service.cal.team.MesCalTeamMemberService;
+import cn.iocoder.yudao.module.system.api.user.AdminUserApi;
+import cn.iocoder.yudao.module.system.api.user.dto.AdminUserRespDTO;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.Collection;
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+
+@Tag(name = "管理后台 - MES 班组成员")
+@RestController
+@RequestMapping("/mes/cal/team-member")
+@Validated
+public class MesCalTeamMemberController {
+
+    @Resource
+    private MesCalTeamMemberService teamMemberService;
+    @Resource
+    private AdminUserApi adminUserApi;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建班组成员")
+    @PreAuthorize("@ss.hasPermission('mes:cal-team:create')")
+    public CommonResult<Long> createTeamMember(@Valid @RequestBody MesCalTeamMemberSaveReqVO createReqVO) {
+        return success(teamMemberService.createTeamMember(createReqVO));
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除班组成员")
+    @Parameter(name = "id", description = "编号", required = true)
+    @PreAuthorize("@ss.hasPermission('mes:cal-team:delete')")
+    public CommonResult<Boolean> deleteTeamMember(@RequestParam("id") Long id) {
+        teamMemberService.deleteTeamMember(id);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得班组成员")
+    @Parameter(name = "id", description = "编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('mes:cal-team:query')")
+    public CommonResult<MesCalTeamMemberRespVO> getTeamMember(@RequestParam("id") Long id) {
+        MesCalTeamMemberDO member = teamMemberService.getTeamMember(id);
+        return success(BeanUtils.toBean(member, MesCalTeamMemberRespVO.class));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得班组成员分页")
+    @PreAuthorize("@ss.hasPermission('mes:cal-team:query')")
+    public CommonResult<PageResult<MesCalTeamMemberRespVO>> getTeamMemberPage(@Valid MesCalTeamMemberPageReqVO pageReqVO) {
+        PageResult<MesCalTeamMemberDO> pageResult = teamMemberService.getTeamMemberPage(pageReqVO);
+        return success(BeanUtils.toBean(pageResult, MesCalTeamMemberRespVO.class));
+    }
+
+    @GetMapping("/list-by-team")
+    @Operation(summary = "获得班组成员列表", description = "支持单个 teamId 或多个 teamIds")
+    @PreAuthorize("@ss.hasPermission('mes:cal-team:query')")
+    public CommonResult<List<MesCalTeamMemberRespVO>> getTeamMemberListByTeam(
+            @RequestParam(value = "teamId", required = false) Long teamId,
+            @RequestParam(value = "teamIds", required = false) Collection<Long> teamIds) {
+        List<MesCalTeamMemberDO> list;
+        if (CollUtil.isNotEmpty(teamIds)) {
+            list = teamMemberService.getTeamMemberListByTeamIds(teamIds);
+        } else if (teamId != null) {
+            list = teamMemberService.getTeamMemberListByTeamId(teamId);
+        } else {
+            list = Collections.emptyList();
+        }
+        return success(buildMemberRespVOList(list));
+    }
+
+    // ==================== 拼接 VO ====================
+
+    private List<MesCalTeamMemberRespVO> buildMemberRespVOList(List<MesCalTeamMemberDO> list) {
+        if (CollUtil.isEmpty(list)) {
+            return Collections.emptyList();
+        }
+        Map<Long, AdminUserRespDTO> userMap = adminUserApi.getUserMap(
+                convertSet(list, MesCalTeamMemberDO::getUserId));
+        return BeanUtils.toBean(list, MesCalTeamMemberRespVO.class, vo ->
+                MapUtils.findAndThen(userMap, vo.getUserId(), user -> {
+                    vo.setNickname(user.getNickname());
+                    vo.setTelephone(user.getMobile());
+                }));
+    }
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.cal.team;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.collection.MapUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.mes.controller.admin.cal.team.vo.shift.MesCalTeamShiftListReqVO;
+import cn.iocoder.yudao.module.mes.controller.admin.cal.team.vo.shift.MesCalTeamShiftRespVO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.cal.plan.MesCalPlanShiftDO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.cal.team.MesCalTeamDO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.cal.team.MesCalTeamShiftDO;
+import cn.iocoder.yudao.module.mes.service.cal.plan.MesCalPlanShiftService;
+import cn.iocoder.yudao.module.mes.service.cal.team.MesCalTeamService;
+import cn.iocoder.yudao.module.mes.service.cal.team.MesCalTeamShiftService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+
+@Tag(name = "管理后台 - MES 班组排班")
+@RestController
+@RequestMapping("/mes/cal/team-shift")
+@Validated
+public class MesCalTeamShiftController {
+
+    @Resource
+    private MesCalTeamShiftService teamShiftService;
+    @Resource
+    private MesCalTeamService teamService;
+    @Resource
+    private MesCalPlanShiftService planShiftService;
+
+    @GetMapping("/list")
+    @Operation(summary = "获得班组排班列表")
+    @PreAuthorize("@ss.hasPermission('mes:cal-team-shift:query')")
+    public CommonResult<List<MesCalTeamShiftRespVO>> getTeamShiftList(@Valid MesCalTeamShiftListReqVO reqVO) {
+        List<MesCalTeamShiftDO> list = teamShiftService.getTeamShiftList(reqVO);
+        if (CollUtil.isEmpty(list)) {
+            return success(Collections.emptyList());
+        }
+        // 关联查询班组名称和班次名称
+        Map<Long, MesCalTeamDO> teamMap = teamService.getTeamMap(
+                convertSet(list, MesCalTeamShiftDO::getTeamId));
+        Map<Long, MesCalPlanShiftDO> shiftMap = planShiftService.getPlanShiftMap(
+                convertSet(list, MesCalTeamShiftDO::getShiftId));
+        return success(BeanUtils.toBean(list, MesCalTeamShiftRespVO.class, vo -> {
+            MapUtils.findAndThen(teamMap, vo.getTeamId(), team -> vo.setTeamName(team.getName()));
+            MapUtils.findAndThen(shiftMap, vo.getShiftId(), shift -> vo.setShiftName(shift.getName()));
+        }));
+    }
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.cal.team.vo;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+@Schema(description = "管理后台 - MES 班组分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class MesCalTeamPageReqVO extends PageParam {
+
+    @Schema(description = "班组编码", example = "TEAM-A")
+    private String code;
+
+    @Schema(description = "班组名称", example = "注塑")
+    private String name;
+
+    @Schema(description = "班组类型", example = "1")
+    private Integer calendarType;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.cal.team.vo;
+
+import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
+import cn.idev.excel.annotation.ExcelProperty;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - MES 班组 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class MesCalTeamRespVO {
+
+    @Schema(description = "班组编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @ExcelProperty("班组编号")
+    private Long id;
+
+    @Schema(description = "班组编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "TEAM-A")
+    @ExcelProperty("班组编码")
+    private String code;
+
+    @Schema(description = "班组名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "注塑A组")
+    @ExcelProperty("班组名称")
+    private String name;
+
+    @Schema(description = "班组类型", example = "1")
+    @ExcelProperty("班组类型")
+    private Integer calendarType;
+
+    @Schema(description = "备注")
+    @ExcelProperty("备注")
+    private String remark;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("创建时间")
+    private LocalDateTime createTime;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.cal.team.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+@Schema(description = "管理后台 - MES 班组新增/修改 Request VO")
+@Data
+public class MesCalTeamSaveReqVO {
+
+    @Schema(description = "班组编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "班组编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "TEAM-A")
+    @NotEmpty(message = "班组编码不能为空")
+    private String code;
+
+    @Schema(description = "班组名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "注塑A组")
+    @NotEmpty(message = "班组名称不能为空")
+    private String name;
+
+    @Schema(description = "班组类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "班组类型不能为空")
+    private Integer calendarType;
+
+    @Schema(description = "备注")
+    private String remark;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.cal.team.vo.member;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+@Schema(description = "管理后台 - MES 班组成员分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class MesCalTeamMemberPageReqVO extends PageParam {
+
+    @Schema(description = "班组编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "201")
+    @NotNull(message = "班组编号不能为空")
+    private Long teamId;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.cal.team.vo.member;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - MES 班组成员 Response VO")
+@Data
+public class MesCalTeamMemberRespVO {
+
+    @Schema(description = "班组成员编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "班组编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "201")
+    private Long teamId;
+
+    @Schema(description = "用户编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Long userId;
+
+    @Schema(description = "用户昵称", example = "管理员")
+    private String nickname;
+
+    @Schema(description = "电话", example = "13800138000")
+    private String telephone;
+
+    @Schema(description = "备注")
+    private String remark;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.cal.team.vo.member;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+@Schema(description = "管理后台 - MES 班组成员新增 Request VO")
+@Data
+public class MesCalTeamMemberSaveReqVO {
+
+    @Schema(description = "班组成员编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "班组编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "201")
+    @NotNull(message = "班组编号不能为空")
+    private Long teamId;
+
+    @Schema(description = "用户编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "用户编号不能为空")
+    private Long userId;
+
+    @Schema(description = "备注")
+    private String remark;
+
+    }
+package cn.iocoder.yudao.module.mes.controller.admin.cal.team.vo.shift;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.time.LocalDateTime;
+import java.util.Collection;
+
+import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+@Schema(description = "管理后台 - MES 班组排班列表 Request VO")
+@Data
+public class MesCalTeamShiftListReqVO {
+
+    @Schema(description = "班组编号", example = "201")
+    private Long teamId;
+
+    @Schema(description = "班组编号集合")
+    private Collection<Long> teamIds;
+
+    @Schema(description = "排班计划编号", example = "1")
+    private Long planId;
+
+    @Schema(description = "开始日期")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime startDay;
+
+    @Schema(description = "结束日期")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime endDay;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.cal.team.vo.shift;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - MES 班组排班 Response VO")
+@Data
+public class MesCalTeamShiftRespVO {
+
+    @Schema(description = "编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "排班计划编号", example = "1")
+    private Long planId;
+
+    @Schema(description = "班组编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "201")
+    private Long teamId;
+
+    @Schema(description = "班组名称", example = "注塑A组")
+    private String teamName;
+
+    @Schema(description = "班次编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Long shiftId;
+
+    @Schema(description = "班次名称", example = "白班")
+    private String shiftName;
+
+    @Schema(description = "日期", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime day;
+
+    @Schema(description = "排序", example = "1")
+    private Integer sort;
+
+    @Schema(description = "备注")
+    private String remark;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.dv.checkplan;
+
+import cn.iocoder.yudao.framework.apilog.core.annotation.ApiAccessLog;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.framework.excel.core.util.ExcelUtils;
+import cn.iocoder.yudao.module.mes.controller.admin.dv.checkplan.vo.MesDvCheckPlanPageReqVO;
+import cn.iocoder.yudao.module.mes.controller.admin.dv.checkplan.vo.MesDvCheckPlanRespVO;
+import cn.iocoder.yudao.module.mes.controller.admin.dv.checkplan.vo.MesDvCheckPlanSaveReqVO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.dv.checkplan.MesDvCheckPlanDO;
+import cn.iocoder.yudao.module.mes.service.dv.checkplan.MesDvCheckPlanService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.servlet.http.HttpServletResponse;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import java.io.IOException;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.apilog.core.enums.OperateTypeEnum.EXPORT;
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+
+@Tag(name = "管理后台 - MES 点检保养方案")
+@RestController
+@RequestMapping("/mes/dv/check-plan")
+@Validated
+public class MesDvCheckPlanController {
+
+    @Resource
+    private MesDvCheckPlanService checkPlanService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建点检保养方案")
+    @PreAuthorize("@ss.hasPermission('mes:dv-check-plan:create')")
+    public CommonResult<Long> createCheckPlan(@Valid @RequestBody MesDvCheckPlanSaveReqVO createReqVO) {
+        return success(checkPlanService.createCheckPlan(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新点检保养方案")
+    @PreAuthorize("@ss.hasPermission('mes:dv-check-plan:update')")
+    public CommonResult<Boolean> updateCheckPlan(@Valid @RequestBody MesDvCheckPlanSaveReqVO updateReqVO) {
+        checkPlanService.updateCheckPlan(updateReqVO);
+        return success(true);
+    }
+
+    @PutMapping("/enable")
+    @Operation(summary = "启用点检保养方案")
+    @Parameter(name = "id", description = "编号", required = true)
+    @PreAuthorize("@ss.hasPermission('mes:dv-check-plan:update')")
+    public CommonResult<Boolean> enableCheckPlan(@RequestParam("id") Long id) {
+        checkPlanService.enableCheckPlan(id);
+        return success(true);
+    }
+
+    @PutMapping("/disable")
+    @Operation(summary = "停用点检保养方案")
+    @Parameter(name = "id", description = "编号", required = true)
+    @PreAuthorize("@ss.hasPermission('mes:dv-check-plan:update')")
+    public CommonResult<Boolean> disableCheckPlan(@RequestParam("id") Long id) {
+        checkPlanService.disableCheckPlan(id);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除点检保养方案")
+    @Parameter(name = "id", description = "编号", required = true)
+    @PreAuthorize("@ss.hasPermission('mes:dv-check-plan:delete')")
+    public CommonResult<Boolean> deleteCheckPlan(@RequestParam("id") Long id) {
+        checkPlanService.deleteCheckPlan(id);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得点检保养方案")
+    @Parameter(name = "id", description = "编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('mes:dv-check-plan:query')")
+    public CommonResult<MesDvCheckPlanRespVO> getCheckPlan(@RequestParam("id") Long id) {
+        MesDvCheckPlanDO checkPlan = checkPlanService.getCheckPlan(id);
+        return success(BeanUtils.toBean(checkPlan, MesDvCheckPlanRespVO.class));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得点检保养方案分页")
+    @PreAuthorize("@ss.hasPermission('mes:dv-check-plan:query')")
+    public CommonResult<PageResult<MesDvCheckPlanRespVO>> getCheckPlanPage(@Valid MesDvCheckPlanPageReqVO pageReqVO) {
+        PageResult<MesDvCheckPlanDO> pageResult = checkPlanService.getCheckPlanPage(pageReqVO);
+        return success(BeanUtils.toBean(pageResult, MesDvCheckPlanRespVO.class));
+    }
+
+    @GetMapping("/export-excel")
+    @Operation(summary = "导出点检保养方案 Excel")
+    @PreAuthorize("@ss.hasPermission('mes:dv-check-plan:export')")
+    @ApiAccessLog(operateType = EXPORT)
+    public void exportCheckPlanExcel(@Valid MesDvCheckPlanPageReqVO pageReqVO,
+                                      HttpServletResponse response) throws IOException {
+        pageReqVO.setPageSize(PageParam.PAGE_SIZE_NONE);
+        List<MesDvCheckPlanDO> list = checkPlanService.getCheckPlanPage(pageReqVO).getList();
+        // 导出 Excel
+        ExcelUtils.write(response, "点检保养方案.xls", "数据", MesDvCheckPlanRespVO.class,
+                BeanUtils.toBean(list, MesDvCheckPlanRespVO.class));
+    }
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.dv.checkplan;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.collection.MapUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.mes.controller.admin.dv.checkplan.vo.machinery.MesDvCheckPlanMachineryRespVO;
+import cn.iocoder.yudao.module.mes.controller.admin.dv.checkplan.vo.machinery.MesDvCheckPlanMachinerySaveReqVO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.dv.checkplan.MesDvCheckPlanMachineryDO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.dv.machinery.MesDvMachineryDO;
+import cn.iocoder.yudao.module.mes.service.dv.checkplan.MesDvCheckPlanMachineryService;
+import cn.iocoder.yudao.module.mes.service.dv.machinery.MesDvMachineryService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+
+@Tag(name = "管理后台 - MES 点检保养方案设备")
+@RestController
+@RequestMapping("/mes/dv/check-plan-machinery")
+@Validated
+public class MesDvCheckPlanMachineryController {
+
+    @Resource
+    private MesDvCheckPlanMachineryService checkPlanMachineryService;
+    @Resource
+    private MesDvMachineryService machineryService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建方案设备关联")
+    @PreAuthorize("@ss.hasPermission('mes:dv-check-plan:update')")
+    public CommonResult<Long> createCheckPlanMachinery(@Valid @RequestBody MesDvCheckPlanMachinerySaveReqVO createReqVO) {
+        return success(checkPlanMachineryService.createCheckPlanMachinery(createReqVO));
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除方案设备关联")
+    @Parameter(name = "id", description = "编号", required = true)
+    @PreAuthorize("@ss.hasPermission('mes:dv-check-plan:update')")
+    public CommonResult<Boolean> deleteCheckPlanMachinery(@RequestParam("id") Long id) {
+        checkPlanMachineryService.deleteCheckPlanMachinery(id);
+        return success(true);
+    }
+
+    @GetMapping("/list-by-plan")
+    @Operation(summary = "获得指定方案的设备列表")
+    @Parameter(name = "planId", description = "方案编号", required = true)
+    @PreAuthorize("@ss.hasPermission('mes:dv-check-plan:query')")
+    public CommonResult<List<MesDvCheckPlanMachineryRespVO>> getCheckPlanMachineryListByPlan(
+            @RequestParam("planId") Long planId) {
+        List<MesDvCheckPlanMachineryDO> list = checkPlanMachineryService.getCheckPlanMachineryListByPlanId(planId);
+        return success(buildCheckPlanMachineryRespVOList(list));
+    }
+
+    // ==================== 拼接 VO ====================
+
+    private List<MesDvCheckPlanMachineryRespVO> buildCheckPlanMachineryRespVOList(
+            List<MesDvCheckPlanMachineryDO> list) {
+        if (CollUtil.isEmpty(list)) {
+            return Collections.emptyList();
+        }
+        Map<Long, MesDvMachineryDO> machineryMap = machineryService.getMachineryMap(
+                convertSet(list, MesDvCheckPlanMachineryDO::getMachineryId));
+        return BeanUtils.toBean(list, MesDvCheckPlanMachineryRespVO.class, vo ->
+            MapUtils.findAndThen(machineryMap, vo.getMachineryId(), machinery ->
+                vo.setMachineryCode(machinery.getCode()).setMachineryName(machinery.getName())
+                  .setMachineryBrand(machinery.getBrand()).setMachinerySpec(machinery.getSpec())
+            )
+        );
+    }
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.dv.checkplan;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.collection.CollectionUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.mes.controller.admin.dv.checkplan.vo.subject.MesDvCheckPlanSubjectRespVO;
+import cn.iocoder.yudao.module.mes.controller.admin.dv.checkplan.vo.subject.MesDvCheckPlanSubjectSaveReqVO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.dv.checkplan.MesDvCheckPlanSubjectDO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.dv.subject.MesDvSubjectDO;
+import cn.iocoder.yudao.module.mes.service.dv.checkplan.MesDvCheckPlanSubjectService;
+import cn.iocoder.yudao.module.mes.service.dv.subject.MesDvSubjectService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+
+@Tag(name = "管理后台 - MES 点检保养方案项目")
+@RestController
+@RequestMapping("/mes/dv/check-plan-subject")
+@Validated
+public class MesDvCheckPlanSubjectController {
+
+    @Resource
+    private MesDvCheckPlanSubjectService checkPlanSubjectService;
+    @Resource
+    private MesDvSubjectService subjectService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建方案项目关联")
+    @PreAuthorize("@ss.hasPermission('mes:dv-check-plan:update')")
+    public CommonResult<Long> createCheckPlanSubject(@Valid @RequestBody MesDvCheckPlanSubjectSaveReqVO createReqVO) {
+        return success(checkPlanSubjectService.createCheckPlanSubject(createReqVO));
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除方案项目关联")
+    @Parameter(name = "id", description = "编号", required = true)
+    @PreAuthorize("@ss.hasPermission('mes:dv-check-plan:update')")
+    public CommonResult<Boolean> deleteCheckPlanSubject(@RequestParam("id") Long id) {
+        checkPlanSubjectService.deleteCheckPlanSubject(id);
+        return success(true);
+    }
+
+    @GetMapping("/list-by-plan")
+    @Operation(summary = "获得指定方案的项目列表")
+    @Parameter(name = "planId", description = "方案编号", required = true)
+    @PreAuthorize("@ss.hasPermission('mes:dv-check-plan:query')")
+    public CommonResult<List<MesDvCheckPlanSubjectRespVO>> getCheckPlanSubjectListByPlan(
+            @RequestParam("planId") Long planId) {
+        List<MesDvCheckPlanSubjectDO> list = checkPlanSubjectService.getCheckPlanSubjectListByPlanId(planId);
+        List<MesDvCheckPlanSubjectRespVO> respList = BeanUtils.toBean(list, MesDvCheckPlanSubjectRespVO.class);
+        // 拼装项目编码/名称/类型/内容/标准
+        // MesDvCheckPlanMachineryController.java 参考下里面的 todo；
+        if (CollUtil.isNotEmpty(respList)) {
+            List<Long> subjectIds = CollectionUtils.convertList(respList, MesDvCheckPlanSubjectRespVO::getSubjectId);
+            Map<Long, MesDvSubjectDO> subjectMap = subjectService.getSubjectMap(subjectIds);
+            respList.forEach(resp -> {
+                MesDvSubjectDO subject = subjectMap.get(resp.getSubjectId());
+                if (subject != null) {
+                    resp.setSubjectCode(subject.getCode());
+                    resp.setSubjectName(subject.getName());
+                    resp.setSubjectType(subject.getType());
+                    resp.setSubjectContent(subject.getContent());
+                    resp.setSubjectStandard(subject.getStandard());
+                }
+            });
+        }
+        return success(respList);
+    }
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.dv.checkplan.vo;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.time.LocalDateTime;
+
+import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+@Schema(description = "管理后台 - MES 点检保养方案分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class MesDvCheckPlanPageReqVO extends PageParam {
+
+    @Schema(description = "方案编码", example = "CHP001")
+    private String code;
+
+    @Schema(description = "方案名称", example = "注塑机")
+    private String name;
+
+    @Schema(description = "方案类型", example = "1")
+    private Integer type;
+
+    @Schema(description = "状态", example = "0")
+    private Integer status;
+
+    @Schema(description = "创建时间")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime[] createTime;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.dv.checkplan.vo;
+
+import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
+import cn.idev.excel.annotation.ExcelProperty;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - MES 点检保养方案 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class MesDvCheckPlanRespVO {
+
+    @Schema(description = "编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @ExcelProperty("编号")
+    private Long id;
+
+    @Schema(description = "方案编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "CHP001")
+    @ExcelProperty("方案编码")
+    private String code;
+
+    @Schema(description = "方案名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "注塑机日检方案")
+    @ExcelProperty("方案名称")
+    private String name;
+
+    @Schema(description = "方案类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @ExcelProperty("方案类型")
+    private Integer type;
+
+    @Schema(description = "开始日期")
+    @ExcelProperty("开始日期")
+    private LocalDateTime startDate;
+
+    @Schema(description = "结束日期")
+    @ExcelProperty("结束日期")
+    private LocalDateTime endDate;
+
+    @Schema(description = "周期类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @ExcelProperty("周期类型")
+    private Integer cycleType;
+
+    @Schema(description = "周期数量", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @ExcelProperty("周期数量")
+    private Integer cycleCount;
+
+    @Schema(description = "状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "0")
+    @ExcelProperty("状态")
+    private Integer status;
+
+    @Schema(description = "备注")
+    @ExcelProperty("备注")
+    private String remark;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("创建时间")
+    private LocalDateTime createTime;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.dv.checkplan.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - MES 点检保养方案新增/修改 Request VO")
+@Data
+public class MesDvCheckPlanSaveReqVO {
+
+    @Schema(description = "编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "方案编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "CHP001")
+    @NotEmpty(message = "方案编码不能为空")
+    private String code;
+
+    @Schema(description = "方案名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "注塑机日检方案")
+    @NotEmpty(message = "方案名称不能为空")
+    private String name;
+
+    @Schema(description = "方案类型（1=设备点检，2=设备保养）", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "方案类型不能为空")
+    private Integer type;
+
+    @Schema(description = "开始日期")
+    private LocalDateTime startDate;
+
+    @Schema(description = "结束日期")
+    private LocalDateTime endDate;
+
+    @Schema(description = "周期类型（1=天，2=周，3=月，4=年）", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "周期类型不能为空")
+    private Integer cycleType;
+
+    @Schema(description = "周期数量", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "周期数量不能为空")
+    private Integer cycleCount;
+
+    @Schema(description = "状态", example = "0")
+    private Integer status;
+
+    @Schema(description = "备注")
+    private String remark;
+
+    }
+package cn.iocoder.yudao.module.mes.controller.admin.dv.checkplan.vo.machinery;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - MES 点检保养方案设备 Response VO")
+@Data
+public class MesDvCheckPlanMachineryRespVO {
+
+    @Schema(description = "编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "方案编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Long planId;
+
+    @Schema(description = "设备编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Long machineryId;
+
+    @Schema(description = "设备编码", example = "EQ001")
+    private String machineryCode;
+
+    @Schema(description = "设备名称", example = "注塑机A")
+    private String machineryName;
+
+    @Schema(description = "品牌", example = "海天")
+    private String machineryBrand;
+
+    @Schema(description = "规格型号", example = "HTF120")
+    private String machinerySpec;
+
+    @Schema(description = "备注")
+    private String remark;
+
+    @Schema(description = "创建时间")
+    private LocalDateTime createTime;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.dv.checkplan.vo.machinery;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+@Schema(description = "管理后台 - MES 点检保养方案设备新增 Request VO")
+@Data
+public class MesDvCheckPlanMachinerySaveReqVO {
+
+    @Schema(description = "编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "方案编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "方案编号不能为空")
+    private Long planId;
+
+    @Schema(description = "设备编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "设备不能为空")
+    private Long machineryId;
+
+    @Schema(description = "备注")
+    private String remark;
+
+    }
+package cn.iocoder.yudao.module.mes.controller.admin.dv.checkplan.vo.subject;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - MES 点检保养方案项目 Response VO")
+@Data
+public class MesDvCheckPlanSubjectRespVO {
+
+    @Schema(description = "编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "方案编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Long planId;
+
+    @Schema(description = "项目编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Long subjectId;
+
+    @Schema(description = "项目编码", example = "CHK001")
+    private String subjectCode;
+
+    @Schema(description = "项目名称", example = "油温检查")
+    private String subjectName;
+
+    @Schema(description = "项目类型", example = "1")
+    private Integer subjectType;
+
+    @Schema(description = "项目内容", example = "检查油温是否正常")
+    private String subjectContent;
+
+    @Schema(description = "标准", example = "40-60°C")
+    private String subjectStandard;
+
+    @Schema(description = "备注")
+    private String remark;
+
+    @Schema(description = "创建时间")
+    private LocalDateTime createTime;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.dv.checkplan.vo.subject;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+@Schema(description = "管理后台 - MES 点检保养方案项目新增 Request VO")
+@Data
+public class MesDvCheckPlanSubjectSaveReqVO {
+
+    @Schema(description = "编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "方案编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "方案编号不能为空")
+    private Long planId;
+
+    @Schema(description = "项目编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "点检保养项目不能为空")
+    private Long subjectId;
+
+    @Schema(description = "备注")
+    private String remark;
+
+    }
+package cn.iocoder.yudao.module.mes.controller.admin.dv.checkrecord;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.apilog.core.annotation.ApiAccessLog;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.collection.MapUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.framework.excel.core.util.ExcelUtils;
+import cn.iocoder.yudao.module.mes.controller.admin.dv.checkrecord.vo.MesDvCheckRecordPageReqVO;
+import cn.iocoder.yudao.module.mes.controller.admin.dv.checkrecord.vo.MesDvCheckRecordRespVO;
+import cn.iocoder.yudao.module.mes.controller.admin.dv.checkrecord.vo.MesDvCheckRecordSaveReqVO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.dv.checkplan.MesDvCheckPlanDO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.dv.checkrecord.MesDvCheckRecordDO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.dv.machinery.MesDvMachineryDO;
+import cn.iocoder.yudao.module.mes.service.dv.checkplan.MesDvCheckPlanService;
+import cn.iocoder.yudao.module.mes.service.dv.checkrecord.MesDvCheckRecordService;
+import cn.iocoder.yudao.module.mes.service.dv.machinery.MesDvMachineryService;
+import cn.iocoder.yudao.module.system.api.user.AdminUserApi;
+import cn.iocoder.yudao.module.system.api.user.dto.AdminUserRespDTO;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.servlet.http.HttpServletResponse;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import java.io.IOException;
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.apilog.core.enums.OperateTypeEnum.EXPORT;
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+
+@Tag(name = "管理后台 - MES 设备点检记录")
+@RestController
+@RequestMapping("/mes/dv/check-record")
+@Validated
+public class MesDvCheckRecordController {
+
+    @Resource
+    private MesDvCheckRecordService checkRecordService;
+
+    @Resource
+    private MesDvCheckPlanService checkPlanService;
+
+    @Resource
+    private MesDvMachineryService machineryService;
+
+    @Resource
+    private AdminUserApi adminUserApi;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建设备点检记录")
+    @PreAuthorize("@ss.hasPermission('mes:dv-check-record:create')")
+    public CommonResult<Long> createCheckRecord(@Valid @RequestBody MesDvCheckRecordSaveReqVO createReqVO) {
+        return success(checkRecordService.createCheckRecord(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新设备点检记录")
+    @PreAuthorize("@ss.hasPermission('mes:dv-check-record:update')")
+    public CommonResult<Boolean> updateCheckRecord(@Valid @RequestBody MesDvCheckRecordSaveReqVO updateReqVO) {
+        checkRecordService.updateCheckRecord(updateReqVO);
+        return success(true);
+    }
+
+    @PutMapping("/submit")
+    @Operation(summary = "提交设备点检记录（草稿→已完成）")
+    @Parameter(name = "id", description = "编号", required = true)
+    @PreAuthorize("@ss.hasPermission('mes:dv-check-record:update')")
+    public CommonResult<Boolean> submitCheckRecord(@RequestParam("id") Long id) {
+        checkRecordService.submitCheckRecord(id);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除设备点检记录")
+    @Parameter(name = "id", description = "编号", required = true)
+    @PreAuthorize("@ss.hasPermission('mes:dv-check-record:delete')")
+    public CommonResult<Boolean> deleteCheckRecord(@RequestParam("id") Long id) {
+        checkRecordService.deleteCheckRecord(id);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得设备点检记录")
+    @Parameter(name = "id", description = "编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('mes:dv-check-record:query')")
+    public CommonResult<MesDvCheckRecordRespVO> getCheckRecord(@RequestParam("id") Long id) {
+        MesDvCheckRecordDO checkRecord = checkRecordService.getCheckRecord(id);
+        if (checkRecord == null) {
+            return success(null);
+        }
+        return success(buildCheckRecordRespVOList(Collections.singletonList(checkRecord)).get(0));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得设备点检记录分页")
+    @PreAuthorize("@ss.hasPermission('mes:dv-check-record:query')")
+    public CommonResult<PageResult<MesDvCheckRecordRespVO>> getCheckRecordPage(@Valid MesDvCheckRecordPageReqVO pageReqVO) {
+        PageResult<MesDvCheckRecordDO> pageResult = checkRecordService.getCheckRecordPage(pageReqVO);
+        return success(new PageResult<>(buildCheckRecordRespVOList(pageResult.getList()), pageResult.getTotal()));
+    }
+
+    @GetMapping("/export-excel")
+    @Operation(summary = "导出设备点检记录 Excel")
+    @PreAuthorize("@ss.hasPermission('mes:dv-check-record:export')")
+    @ApiAccessLog(operateType = EXPORT)
+    public void exportCheckRecordExcel(@Valid MesDvCheckRecordPageReqVO pageReqVO,
+                                       HttpServletResponse response) throws IOException {
+        pageReqVO.setPageSize(PageParam.PAGE_SIZE_NONE);
+        List<MesDvCheckRecordDO> list = checkRecordService.getCheckRecordPage(pageReqVO).getList();
+        ExcelUtils.write(response, "设备点检记录.xls", "数据", MesDvCheckRecordRespVO.class,
+                buildCheckRecordRespVOList(list));
+    }
+
+    // ==================== 拼接 VO ====================
+
+    @SuppressWarnings("DuplicatedCode")
+    private List<MesDvCheckRecordRespVO> buildCheckRecordRespVOList(List<MesDvCheckRecordDO> list) {
+        if (CollUtil.isEmpty(list)) {
+            return Collections.emptyList();
+        }
+        // 1. 批量获取关联数据
+        Map<Long, MesDvCheckPlanDO> planMap = checkPlanService.getCheckPlanMap(
+                convertSet(list, MesDvCheckRecordDO::getPlanId));
+        Map<Long, MesDvMachineryDO> machineryMap = machineryService.getMachineryMap(
+                convertSet(list, MesDvCheckRecordDO::getMachineryId));
+        Map<Long, AdminUserRespDTO> userMap = adminUserApi.getUserMap(
+                convertSet(list, MesDvCheckRecordDO::getUserId));
+        // 2. 拼接 VO
+        return BeanUtils.toBean(list, MesDvCheckRecordRespVO.class, vo -> {
+            MapUtils.findAndThen(planMap, vo.getPlanId(),
+                    plan -> vo.setPlanName(plan.getName()).setPlanCode(plan.getCode())
+                            .setPlanStartDate(plan.getStartDate()).setPlanEndDate(plan.getEndDate())
+                            .setPlanCycleType(plan.getCycleType()).setPlanCycleCount(plan.getCycleCount()));
+            MapUtils.findAndThen(machineryMap, vo.getMachineryId(), machinery -> vo
+                    .setMachineryCode(machinery.getCode()).setMachineryName(machinery.getName())
+                    .setMachineryBrand(machinery.getBrand()).setMachinerySpec(machinery.getSpec()));
+            MapUtils.findAndThen(userMap, vo.getUserId(),
+                    user -> vo.setNickname(user.getNickname()));
+        });
+    }
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.dv.checkrecord;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.collection.MapUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.mes.controller.admin.dv.checkrecord.vo.line.MesDvCheckRecordLinePageReqVO;
+import cn.iocoder.yudao.module.mes.controller.admin.dv.checkrecord.vo.line.MesDvCheckRecordLineRespVO;
+import cn.iocoder.yudao.module.mes.controller.admin.dv.checkrecord.vo.line.MesDvCheckRecordLineSaveReqVO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.dv.checkrecord.MesDvCheckRecordLineDO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.dv.subject.MesDvSubjectDO;
+import cn.iocoder.yudao.module.mes.service.dv.checkrecord.MesDvCheckRecordLineService;
+import cn.iocoder.yudao.module.mes.service.dv.subject.MesDvSubjectService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+
+@Tag(name = "管理后台 - MES 设备点检记录明细")
+@RestController
+@RequestMapping("/mes/dv/check-record-line")
+@Validated
+public class MesDvCheckRecordLineController {
+
+    @Resource
+    private MesDvCheckRecordLineService checkRecordLineService;
+
+    @Resource
+    private MesDvSubjectService subjectService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建设备点检记录明细")
+    @PreAuthorize("@ss.hasPermission('mes:dv-check-record:create')")
+    public CommonResult<Long> createCheckRecordLine(@Valid @RequestBody MesDvCheckRecordLineSaveReqVO createReqVO) {
+        return success(checkRecordLineService.createCheckRecordLine(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新设备点检记录明细")
+    @PreAuthorize("@ss.hasPermission('mes:dv-check-record:update')")
+    public CommonResult<Boolean> updateCheckRecordLine(@Valid @RequestBody MesDvCheckRecordLineSaveReqVO updateReqVO) {
+        checkRecordLineService.updateCheckRecordLine(updateReqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除设备点检记录明细")
+    @Parameter(name = "id", description = "编号", required = true)
+    @PreAuthorize("@ss.hasPermission('mes:dv-check-record:delete')")
+    public CommonResult<Boolean> deleteCheckRecordLine(@RequestParam("id") Long id) {
+        checkRecordLineService.deleteCheckRecordLine(id);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得设备点检记录明细")
+    @Parameter(name = "id", description = "编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('mes:dv-check-record:query')")
+    public CommonResult<MesDvCheckRecordLineRespVO> getCheckRecordLine(@RequestParam("id") Long id) {
+        MesDvCheckRecordLineDO line = checkRecordLineService.getCheckRecordLine(id);
+        if (line == null) {
+            return success(null);
+        }
+        return success(buildCheckRecordLineRespVOList(Collections.singletonList(line)).get(0));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得设备点检记录明细分页")
+    @PreAuthorize("@ss.hasPermission('mes:dv-check-record:query')")
+    public CommonResult<PageResult<MesDvCheckRecordLineRespVO>> getCheckRecordLinePage(@Valid MesDvCheckRecordLinePageReqVO pageReqVO) {
+        PageResult<MesDvCheckRecordLineDO> pageResult = checkRecordLineService.getCheckRecordLinePage(pageReqVO);
+        return success(new PageResult<>(buildCheckRecordLineRespVOList(pageResult.getList()), pageResult.getTotal()));
+    }
+
+    // ==================== 拼接 VO ====================
+
+    private List<MesDvCheckRecordLineRespVO> buildCheckRecordLineRespVOList(List<MesDvCheckRecordLineDO> list) {
+        if (CollUtil.isEmpty(list)) {
+            return Collections.emptyList();
+        }
+        // 1. 批量获取关联数据
+        Map<Long, MesDvSubjectDO> subjectMap = subjectService.getSubjectMap(
+                convertSet(list, MesDvCheckRecordLineDO::getSubjectId));
+        // 2. 拼接 VO
+        return BeanUtils.toBean(list, MesDvCheckRecordLineRespVO.class, vo ->
+                MapUtils.findAndThen(subjectMap, vo.getSubjectId(), subject -> vo
+                        .setSubjectCode(subject.getCode()).setSubjectName(subject.getName())
+                        .setSubjectType(subject.getType()).setSubjectContent(subject.getContent()).setSubjectStandard(subject.getStandard())));
+    }
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.dv.checkrecord.vo;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.time.LocalDateTime;
+
+import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+@Schema(description = "管理后台 - MES 设备点检记录分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class MesDvCheckRecordPageReqVO extends PageParam {
+
+    @Schema(description = "点检计划编号", example = "1")
+    private Long planId;
+
+    @Schema(description = "设备编号", example = "1")
+    private Long machineryId;
+
+    @Schema(description = "点检人编号", example = "1")
+    private Long userId;
+
+    @Schema(description = "状态", example = "10")
+    private Integer status;
+
+    @Schema(description = "点检时间")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime[] checkTime;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.dv.checkrecord.vo;
+
+import cn.iocoder.yudao.framework.excel.core.annotations.DictFormat;
+import cn.iocoder.yudao.framework.excel.core.convert.DictConvert;
+import cn.iocoder.yudao.module.mes.enums.DictTypeConstants;
+import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
+import cn.idev.excel.annotation.ExcelProperty;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - MES 设备点检记录 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class MesDvCheckRecordRespVO {
+
+    @Schema(description = "编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @ExcelProperty("编号")
+    private Long id;
+
+    @Schema(description = "点检计划编号", example = "1")
+    private Long planId;
+
+    @Schema(description = "计划名称", example = "日常点检计划")
+    @ExcelProperty("计划名称")
+    private String planName;
+
+    @Schema(description = "计划编码", example = "P001")
+    @ExcelProperty("计划编码")
+    private String planCode;
+
+    @Schema(description = "开始时间")
+    @ExcelProperty("开始时间")
+    private LocalDateTime planStartDate;
+
+    @Schema(description = "结束日期")
+    @ExcelProperty("结束日期")
+    private LocalDateTime planEndDate;
+
+    @Schema(description = "频率类型", example = "1")
+    @ExcelProperty(value = "频率类型", converter = DictConvert.class)
+    @DictFormat(DictTypeConstants.MES_DV_CYCLE_TYPE)
+    private Integer planCycleType;
+
+    @Schema(description = "频率数量", example = "5")
+    @ExcelProperty(value = "频率数量")
+    private Integer planCycleCount;
+
+    @Schema(description = "设备编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Long machineryId;
+
+    @Schema(description = "设备编码", example = "M001")
+    @ExcelProperty("设备编码")
+    private String machineryCode;
+
+    @Schema(description = "设备名称", example = "机床A")
+    @ExcelProperty("设备名称")
+    private String machineryName;
+
+    @Schema(description = "品牌", example = "西门子")
+    @ExcelProperty("品牌")
+    private String machineryBrand;
+
+    @Schema(description = "规格型号", example = "X-100")
+    @ExcelProperty("规格型号")
+    private String machinerySpec;
+
+    @Schema(description = "点检时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("点检时间")
+    private LocalDateTime checkTime;
+
+    @Schema(description = "点检人编号", example = "1")
+    private Long userId;
+
+    @Schema(description = "点检人名称", example = "张三")
+    @ExcelProperty("点检人")
+    private String nickname;
+
+    @Schema(description = "状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "10")
+    @ExcelProperty(value = "状态", converter = DictConvert.class)
+    @DictFormat(DictTypeConstants.MES_DV_CHECK_RECORD_STATUS)
+    private Integer status;
+
+    @Schema(description = "备注", example = "测试备注")
+    @ExcelProperty("备注")
+    private String remark;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("创建时间")
+    private LocalDateTime createTime;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.dv.checkrecord.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import jakarta.validation.constraints.NotNull;
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - MES 设备点检记录新增/修改 Request VO")
+@Data
+public class MesDvCheckRecordSaveReqVO {
+
+    @Schema(description = "编号", requiredMode = Schema.RequiredMode.NOT_REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "点检计划编号", example = "1")
+    private Long planId;
+
+    @Schema(description = "设备编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "设备不能为空")
+    private Long machineryId;
+
+    @Schema(description = "点检时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "点检时间不能为空")
+    private LocalDateTime checkTime;
+
+    @Schema(description = "点检人编号", example = "1")
+    private Long userId;
+
+    @Schema(description = "备注", example = "测试备注")
+    private String remark;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.dv.checkrecord.vo.line;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+@Schema(description = "管理后台 - MES 设备点检记录明细分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class MesDvCheckRecordLinePageReqVO extends PageParam {
+
+    @Schema(description = "点检记录编号", example = "1")
+    private Long recordId;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.dv.checkrecord.vo.line;
+
+import cn.iocoder.yudao.framework.excel.core.annotations.DictFormat;
+import cn.iocoder.yudao.framework.excel.core.convert.DictConvert;
+import cn.iocoder.yudao.module.mes.enums.DictTypeConstants;
+import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
+import cn.idev.excel.annotation.ExcelProperty;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - MES 设备点检记录明细 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class MesDvCheckRecordLineRespVO {
+
+    @Schema(description = "编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @ExcelProperty("编号")
+    private Long id;
+
+    @Schema(description = "点检记录编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Long recordId;
+
+    @Schema(description = "点检项目编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Long subjectId;
+
+    @Schema(description = "项目编码", example = "S001")
+    @ExcelProperty("项目编码")
+    private String subjectCode;
+
+    @Schema(description = "项目名称", example = "润滑油检查")
+    @ExcelProperty("项目名称")
+    private String subjectName;
+
+    @Schema(description = "项目类型", example = "1")
+    @ExcelProperty("项目类型")
+    private Integer subjectType;
+
+    @Schema(description = "检查内容", example = "检查润滑油是否充足")
+    @ExcelProperty("检查内容")
+    private String subjectContent;
+
+    @Schema(description = "检查标准", example = "油位不低于最低刻度")
+    @ExcelProperty("检查标准")
+    private String subjectStandard;
+
+    @Schema(description = "点检结果", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @ExcelProperty(value = "点检结果", converter = DictConvert.class)
+    @DictFormat(DictTypeConstants.MES_DV_CHECK_RESULT)
+    private Integer checkStatus;
+
+    @Schema(description = "异常描述", example = "设备异响")
+    @ExcelProperty("异常描述")
+    private String checkResult;
+
+    @Schema(description = "备注", example = "测试备注")
+    @ExcelProperty("备注")
+    private String remark;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("创建时间")
+    private LocalDateTime createTime;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.dv.checkrecord.vo.line;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import jakarta.validation.constraints.NotNull;
+
+@Schema(description = "管理后台 - MES 设备点检记录明细新增/修改 Request VO")
+@Data
+public class MesDvCheckRecordLineSaveReqVO {
+
+    @Schema(description = "编号", requiredMode = Schema.RequiredMode.NOT_REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "点检记录编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "点检记录不能为空")
+    private Long recordId;
+
+    @Schema(description = "点检项目编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "点检项目不能为空")
+    private Long subjectId;
+
+    @Schema(description = "点检结果", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "点检结果不能为空")
+    private Integer checkStatus;
+
+    @Schema(description = "异常描述", example = "设备异响")
+    private String checkResult;
+
+    @Schema(description = "备注", example = "测试备注")
+    private String remark;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.dv.machinery;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.apilog.core.annotation.ApiAccessLog;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.collection.MapUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.framework.excel.core.util.ExcelUtils;
+import cn.iocoder.yudao.module.mes.controller.admin.dv.machinery.vo.MesDvMachineryImportExcelVO;
+import cn.iocoder.yudao.module.mes.controller.admin.dv.machinery.vo.MesDvMachineryImportRespVO;
+import cn.iocoder.yudao.module.mes.controller.admin.dv.machinery.vo.MesDvMachineryPageReqVO;
+import cn.iocoder.yudao.module.mes.controller.admin.dv.machinery.vo.MesDvMachineryRespVO;
+import cn.iocoder.yudao.module.mes.controller.admin.dv.machinery.vo.MesDvMachinerySaveReqVO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.dv.machinery.MesDvMachineryDO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.dv.machinery.MesDvMachineryTypeDO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.md.workstation.MesMdWorkshopDO;
+import cn.iocoder.yudao.module.mes.service.dv.machinery.MesDvMachineryService;
+import cn.iocoder.yudao.module.mes.service.dv.machinery.MesDvMachineryTypeService;
+import cn.iocoder.yudao.module.mes.service.md.workstation.MesMdWorkshopService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.Parameters;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.servlet.http.HttpServletResponse;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+import org.springframework.web.multipart.MultipartFile;
+
+import java.io.IOException;
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.apilog.core.enums.OperateTypeEnum.EXPORT;
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+
+@Tag(name = "管理后台 - MES 设备台账")
+@RestController
+@RequestMapping("/mes/dv/machinery")
+@Validated
+public class MesDvMachineryController {
+
+    @Resource
+    private MesDvMachineryService machineryService;
+
+    @Resource
+    private MesDvMachineryTypeService machineryTypeService;
+
+    @Resource
+    private MesMdWorkshopService workshopService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建设备")
+    @PreAuthorize("@ss.hasPermission('mes:dv-machinery:create')")
+    public CommonResult<Long> createMachinery(@Valid @RequestBody MesDvMachinerySaveReqVO createReqVO) {
+        return success(machineryService.createMachinery(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新设备")
+    @PreAuthorize("@ss.hasPermission('mes:dv-machinery:update')")
+    public CommonResult<Boolean> updateMachinery(@Valid @RequestBody MesDvMachinerySaveReqVO updateReqVO) {
+        machineryService.updateMachinery(updateReqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除设备")
+    @Parameter(name = "id", description = "编号", required = true)
+    @PreAuthorize("@ss.hasPermission('mes:dv-machinery:delete')")
+    public CommonResult<Boolean> deleteMachinery(@RequestParam("id") Long id) {
+        machineryService.deleteMachinery(id);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得设备")
+    @Parameter(name = "id", description = "编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('mes:dv-machinery:query')")
+    public CommonResult<MesDvMachineryRespVO> getMachinery(@RequestParam("id") Long id) {
+        MesDvMachineryDO machinery = machineryService.getMachinery(id);
+        if (machinery == null) {
+            return success(null);
+        }
+        return success(buildMachineryRespVOList(Collections.singletonList(machinery)).get(0));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得设备分页")
+    @PreAuthorize("@ss.hasPermission('mes:dv-machinery:query')")
+    public CommonResult<PageResult<MesDvMachineryRespVO>> getMachineryPage(@Valid MesDvMachineryPageReqVO pageReqVO) {
+        PageResult<MesDvMachineryDO> pageResult = machineryService.getMachineryPage(pageReqVO);
+        return success(new PageResult<>(buildMachineryRespVOList(pageResult.getList()), pageResult.getTotal()));
+    }
+
+    @GetMapping("/export-excel")
+    @Operation(summary = "导出设备 Excel")
+    @PreAuthorize("@ss.hasPermission('mes:dv-machinery:export')")
+    @ApiAccessLog(operateType = EXPORT)
+    public void exportMachineryExcel(@Valid MesDvMachineryPageReqVO pageReqVO,
+                                      HttpServletResponse response) throws IOException {
+        pageReqVO.setPageSize(PageParam.PAGE_SIZE_NONE);
+        List<MesDvMachineryDO> list = machineryService.getMachineryPage(pageReqVO).getList();
+        // 导出 Excel
+        ExcelUtils.write(response, "设备台账.xls", "数据", MesDvMachineryRespVO.class,
+                buildMachineryRespVOList(list));
+    }
+
+    @GetMapping("/simple-list")
+    @Operation(summary = "获得设备精简列表", description = "主要用于前端的下拉选项")
+    @PreAuthorize("@ss.hasPermission('mes:dv-machinery:query')")
+    public CommonResult<List<MesDvMachineryRespVO>> getMachinerySimpleList() {
+        List<MesDvMachineryDO> list = machineryService.getMachineryList();
+        return success(BeanUtils.toBean(list, MesDvMachineryRespVO.class));
+    }
+
+    @GetMapping("/get-import-template")
+    @Operation(summary = "获得设备导入模板")
+    public void importTemplate(HttpServletResponse response) throws IOException {
+        // 手动创建导出 demo
+        List<MesDvMachineryImportExcelVO> list = Collections.singletonList(
+                MesDvMachineryImportExcelVO.builder().code("EQ-001").name("示例设备")
+                        .brand("示例品牌").spec("型号A").machineryTypeCode("MT-001")
+                        .workshopCode("WS-001").status(0).build()
+        );
+        // 输出
+        ExcelUtils.write(response, "设备导入模板.xls", "设备列表", MesDvMachineryImportExcelVO.class, list);
+    }
+
+    @PostMapping("/import")
+    @Operation(summary = "导入设备")
+    @Parameters({
+            @Parameter(name = "file", description = "Excel 文件", required = true),
+            @Parameter(name = "updateSupport", description = "是否支持更新，默认为 false", example = "true")
+    })
+    @PreAuthorize("@ss.hasPermission('mes:dv-machinery:import')")
+    public CommonResult<MesDvMachineryImportRespVO> importExcel(@RequestParam("file") MultipartFile file,
+                                                                 @RequestParam(value = "updateSupport", required = false,
+                                                                         defaultValue = "false") Boolean updateSupport) throws Exception {
+        List<MesDvMachineryImportExcelVO> list = ExcelUtils.read(file, MesDvMachineryImportExcelVO.class);
+        return success(machineryService.importMachineryList(list, updateSupport));
+    }
+
+    // ==================== 拼接 VO ====================
+
+    private List<MesDvMachineryRespVO> buildMachineryRespVOList(List<MesDvMachineryDO> list) {
+        if (CollUtil.isEmpty(list)) {
+            return Collections.emptyList();
+        }
+        // 1. 批量获取设备类型和车间信息
+        Map<Long, MesDvMachineryTypeDO> machineryTypeMap = machineryTypeService.getMachineryTypeMap(
+                convertSet(list, MesDvMachineryDO::getMachineryTypeId));
+        Map<Long, MesMdWorkshopDO> workshopMap = workshopService.getWorkshopMap(
+                convertSet(list, MesDvMachineryDO::getWorkshopId));
+        // 2. 拼接 VO
+        return BeanUtils.toBean(list, MesDvMachineryRespVO.class, vo -> {
+            MapUtils.findAndThen(machineryTypeMap, vo.getMachineryTypeId(),
+                    machineryType -> vo.setMachineryTypeName(machineryType.getName()));
+            MapUtils.findAndThen(workshopMap, vo.getWorkshopId(),
+                    workshop -> vo.setWorkshopName(workshop.getName()));
+        });
+    }
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.dv.machinery;
+
+import cn.iocoder.yudao.framework.common.enums.CommonStatusEnum;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.mes.controller.admin.dv.machinery.vo.type.MesDvMachineryTypeListReqVO;
+import cn.iocoder.yudao.module.mes.controller.admin.dv.machinery.vo.type.MesDvMachineryTypeRespVO;
+import cn.iocoder.yudao.module.mes.controller.admin.dv.machinery.vo.type.MesDvMachineryTypeSaveReqVO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.dv.machinery.MesDvMachineryTypeDO;
+import cn.iocoder.yudao.module.mes.service.dv.machinery.MesDvMachineryTypeService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+
+@Tag(name = "管理后台 - MES 设备类型")
+@RestController
+@RequestMapping("/mes/dv/machinery-type")
+@Validated
+public class MesDvMachineryTypeController {
+
+    @Resource
+    private MesDvMachineryTypeService machineryTypeService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建设备类型")
+    @PreAuthorize("@ss.hasPermission('mes:dv-machinery-type:create')")
+    public CommonResult<Long> createMachineryType(@Valid @RequestBody MesDvMachineryTypeSaveReqVO createReqVO) {
+        return success(machineryTypeService.createMachineryType(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新设备类型")
+    @PreAuthorize("@ss.hasPermission('mes:dv-machinery-type:update')")
+    public CommonResult<Boolean> updateMachineryType(@Valid @RequestBody MesDvMachineryTypeSaveReqVO updateReqVO) {
+        machineryTypeService.updateMachineryType(updateReqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除设备类型")
+    @Parameter(name = "id", description = "编号", required = true)
+    @PreAuthorize("@ss.hasPermission('mes:dv-machinery-type:delete')")
+    public CommonResult<Boolean> deleteMachineryType(@RequestParam("id") Long id) {
+        machineryTypeService.deleteMachineryType(id);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得设备类型")
+    @Parameter(name = "id", description = "编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('mes:dv-machinery-type:query')")
+    public CommonResult<MesDvMachineryTypeRespVO> getMachineryType(@RequestParam("id") Long id) {
+        MesDvMachineryTypeDO machineryType = machineryTypeService.getMachineryType(id);
+        return success(BeanUtils.toBean(machineryType, MesDvMachineryTypeRespVO.class));
+    }
+
+    @GetMapping("/list")
+    @Operation(summary = "获得设备类型列表")
+    @PreAuthorize("@ss.hasPermission('mes:dv-machinery-type:query')")
+    public CommonResult<List<MesDvMachineryTypeRespVO>> getMachineryTypeList(@Valid MesDvMachineryTypeListReqVO listReqVO) {
+        List<MesDvMachineryTypeDO> list = machineryTypeService.getMachineryTypeList(listReqVO);
+        return success(BeanUtils.toBean(list, MesDvMachineryTypeRespVO.class));
+    }
+
+    @GetMapping("/simple-list")
+    @Operation(summary = "获得设备类型精简列表", description = "只包含被开启的类型，主要用于前端的下拉选项")
+    public CommonResult<List<MesDvMachineryTypeRespVO>> getMachineryTypeSimpleList() {
+        List<MesDvMachineryTypeDO> list = machineryTypeService.getMachineryTypeList(
+                new MesDvMachineryTypeListReqVO().setStatus(CommonStatusEnum.ENABLE.getStatus()));
+        return success(convertList(list, machineryType -> new MesDvMachineryTypeRespVO()
+                .setId(machineryType.getId()).setName(machineryType.getName())
+                .setParentId(machineryType.getParentId())));
+    }
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.dv.machinery.vo;
+
+import cn.idev.excel.annotation.ExcelProperty;
+import cn.iocoder.yudao.framework.excel.core.annotations.DictFormat;
+import cn.iocoder.yudao.framework.excel.core.convert.DictConvert;
+import cn.iocoder.yudao.module.mes.enums.DictTypeConstants;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+/**
+ * 设备台账 Excel 导入 VO
+ */
+@Data
+@Builder
+@AllArgsConstructor
+@NoArgsConstructor
+public class MesDvMachineryImportExcelVO {
+
+    @ExcelProperty("设备编码")
+    private String code;
+
+    @ExcelProperty("设备名称")
+    private String name;
+
+    @ExcelProperty("品牌")
+    private String brand;
+
+    @ExcelProperty("规格型号")
+    private String spec;
+
+    @ExcelProperty("设备类型编码")
+    private String machineryTypeCode;
+
+    @ExcelProperty("所属车间编码")
+    private String workshopCode;
+
+    @ExcelProperty(value = "设备状态", converter = DictConvert.class)
+    @DictFormat(DictTypeConstants.MES_DV_MACHINERY_STATUS)
+    private Integer status;
+
+    @ExcelProperty("备注")
+    private String remark;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.dv.machinery.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Builder;
+import lombok.Data;
+
+import java.util.List;
+import java.util.Map;
+
+@Schema(description = "管理后台 - MES 设备台账导入 Response VO")
+@Data
+@Builder
+public class MesDvMachineryImportRespVO {
+
+    @Schema(description = "创建成功的设备编码数组", requiredMode = Schema.RequiredMode.REQUIRED)
+    private List<String> createCodes;
+
+    @Schema(description = "更新成功的设备编码数组", requiredMode = Schema.RequiredMode.REQUIRED)
+    private List<String> updateCodes;
+
+    @Schema(description = "导入失败的设备集合，key 为设备编码，value 为失败原因", requiredMode = Schema.RequiredMode.REQUIRED)
+    private Map<String, String> failureCodes;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.dv.machinery.vo;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+import java.util.Set;
+
+@Schema(description = "管理后台 - MES 设备台账分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class MesDvMachineryPageReqVO extends PageParam {
+
+    @Schema(description = "设备编码", example = "EQ-001")
+    private String code;
+
+    @Schema(description = "设备名称", example = "CNC 加工中心")
+    private String name;
+
+    @Schema(description = "品牌", example = "西门子")
+    private String brand;
+
+    @Schema(description = "设备类型编号", example = "100")
+    private Long machineryTypeId;
+
+    @Schema(description = "设备类型编号列表（含子类型，由后端自动填充）", hidden = true)
+    private Set<Long> machineryTypeIds;
+
+    @Schema(description = "所属车间编号", example = "200")
+    private Long workshopId;
+
+    @Schema(description = "设备状态", example = "1")
+    private Integer status;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.dv.machinery.vo;
+
+import cn.iocoder.yudao.framework.excel.core.annotations.DictFormat;
+import cn.iocoder.yudao.framework.excel.core.convert.DictConvert;
+import cn.iocoder.yudao.module.mes.enums.DictTypeConstants;
+import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
+import cn.idev.excel.annotation.ExcelProperty;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - MES 设备台账 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class MesDvMachineryRespVO {
+
+    @Schema(description = "编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @ExcelProperty("编号")
+    private Long id;
+
+    @Schema(description = "设备编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "EQ-001")
+    @ExcelProperty("设备编码")
+    private String code;
+
+    @Schema(description = "设备名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "CNC 加工中心")
+    @ExcelProperty("设备名称")
+    private String name;
+
+    @Schema(description = "品牌", example = "西门子")
+    @ExcelProperty("品牌")
+    private String brand;
+
+    @Schema(description = "规格型号", example = "S7-300")
+    @ExcelProperty("规格型号")
+    private String spec;
+
+    @Schema(description = "设备类型编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "100")
+    private Long machineryTypeId;
+
+    @Schema(description = "设备类型名称", example = "数控机床")
+    @ExcelProperty("设备类型")
+    private String machineryTypeName;
+
+    @Schema(description = "所属车间编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "200")
+    private Long workshopId;
+
+    @Schema(description = "所属车间名称", example = "一号车间")
+    @ExcelProperty("所属车间")
+    private String workshopName;
+
+    @Schema(description = "设备状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @ExcelProperty(value = "设备状态", converter = DictConvert.class)
+    @DictFormat(DictTypeConstants.MES_DV_MACHINERY_STATUS)
+    private Integer status;
+
+    @Schema(description = "最近保养时间")
+    @ExcelProperty("最近保养时间")
+    private LocalDateTime lastMaintenTime;
+
+    @Schema(description = "最近点检时间")
+    @ExcelProperty("最近点检时间")
+    private LocalDateTime lastCheckTime;
+
+    @Schema(description = "备注", example = "备注")
+    @ExcelProperty("备注")
+    private String remark;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("创建时间")
+    private LocalDateTime createTime;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.dv.machinery.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - MES 设备台账新增/修改 Request VO")
+@Data
+public class MesDvMachinerySaveReqVO {
+
+    @Schema(description = "编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "设备编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "EQ-001")
+    @NotEmpty(message = "设备编码不能为空")
+    private String code;
+
+    @Schema(description = "设备名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "CNC 加工中心")
+    @NotEmpty(message = "设备名称不能为空")
+    private String name;
+
+    @Schema(description = "品牌", example = "西门子")
+    private String brand;
+
+    @Schema(description = "规格型号", example = "S7-300")
+    private String spec;
+
+    @Schema(description = "设备类型编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "100")
+    @NotNull(message = "设备类型不能为空")
+    private Long machineryTypeId;
+
+    @Schema(description = "所属车间编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "200")
+    @NotNull(message = "所属车间不能为空")
+    private Long workshopId;
+
+    @Schema(description = "设备状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "设备状态不能为空")
+    private Integer status;
+
+    @Schema(description = "最近保养时间")
+    private LocalDateTime lastMaintenTime;
+
+    @Schema(description = "最近点检时间")
+    private LocalDateTime lastCheckTime;
+
+    @Schema(description = "备注", example = "备注")
+    private String remark;
+
+    }
+package cn.iocoder.yudao.module.mes.controller.admin.dv.machinery.vo.type;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.experimental.Accessors;
+
+@Schema(description = "管理后台 - MES 设备类型列表 Request VO")
+@Data
+@Accessors(chain = true)
+public class MesDvMachineryTypeListReqVO {
+
+    @Schema(description = "类型名称", example = "数控机床")
+    private String name;
+
+    @Schema(description = "状态", example = "0")
+    private Integer status;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.dv.machinery.vo.type;
+
+import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
+import cn.idev.excel.annotation.ExcelProperty;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - MES 设备类型 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class MesDvMachineryTypeRespVO {
+
+    @Schema(description = "编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @ExcelProperty("编号")
+    private Long id;
+
+    @Schema(description = "类型编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "MT-001")
+    @ExcelProperty("类型编码")
+    private String code;
+
+    @Schema(description = "类型名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "数控机床")
+    @ExcelProperty("类型名称")
+    private String name;
+
+    @Schema(description = "父类型编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "0")
+    private Long parentId;
+
+    @Schema(description = "状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "0")
+    @ExcelProperty("状态")
+    private Integer status;
+
+    @Schema(description = "显示排序", requiredMode = Schema.RequiredMode.REQUIRED, example = "0")
+    @ExcelProperty("显示排序")
+    private Integer sort;
+
+    @Schema(description = "备注", example = "备注")
+    @ExcelProperty("备注")
+    private String remark;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("创建时间")
+    private LocalDateTime createTime;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.dv.machinery.vo.type;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+@Schema(description = "管理后台 - MES 设备类型新增/修改 Request VO")
+@Data
+public class MesDvMachineryTypeSaveReqVO {
+
+    @Schema(description = "编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "类型编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "MT-001")
+    @NotEmpty(message = "类型编码不能为空")
+    private String code;
+
+    @Schema(description = "类型名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "数控机床")
+    @NotEmpty(message = "类型名称不能为空")
+    private String name;
+
+    @Schema(description = "父类型编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "0")
+    @NotNull(message = "父类型编号不能为空")
+    private Long parentId;
+
+    @Schema(description = "状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "0")
+    @NotNull(message = "状态不能为空")
+    private Integer status;
+
+    @Schema(description = "显示排序", requiredMode = Schema.RequiredMode.REQUIRED, example = "0")
+    @NotNull(message = "显示排序不能为空")
+    private Integer sort;
+
+    @Schema(description = "备注", example = "备注")
+    private String remark;
+
+    }
+package cn.iocoder.yudao.module.mes.controller.admin.dv.maintenrecord;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.apilog.core.annotation.ApiAccessLog;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.collection.MapUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.framework.excel.core.util.ExcelUtils;
+import cn.iocoder.yudao.module.mes.controller.admin.dv.maintenrecord.vo.MesDvMaintenRecordPageReqVO;
+import cn.iocoder.yudao.module.mes.controller.admin.dv.maintenrecord.vo.MesDvMaintenRecordRespVO;
+import cn.iocoder.yudao.module.mes.controller.admin.dv.maintenrecord.vo.MesDvMaintenRecordSaveReqVO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.dv.checkplan.MesDvCheckPlanDO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.dv.machinery.MesDvMachineryDO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.dv.maintenrecord.MesDvMaintenRecordDO;
+import cn.iocoder.yudao.module.mes.service.dv.checkplan.MesDvCheckPlanService;
+import cn.iocoder.yudao.module.mes.service.dv.machinery.MesDvMachineryService;
+import cn.iocoder.yudao.module.mes.service.dv.maintenrecord.MesDvMaintenRecordService;
+import cn.iocoder.yudao.module.system.api.user.AdminUserApi;
+import cn.iocoder.yudao.module.system.api.user.dto.AdminUserRespDTO;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.servlet.http.HttpServletResponse;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import java.io.IOException;
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.apilog.core.enums.OperateTypeEnum.EXPORT;
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+
+@Tag(name = "管理后台 - MES 设备保养记录")
+@RestController
+@RequestMapping("/mes/dv/mainten-record")
+@Validated
+public class MesDvMaintenRecordController {
+
+    @Resource
+    private MesDvMaintenRecordService maintenRecordService;
+
+    @Resource
+    private MesDvCheckPlanService checkPlanService;
+
+    @Resource
+    private MesDvMachineryService machineryService;
+
+    @Resource
+    private AdminUserApi adminUserApi;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建设备保养记录")
+    @PreAuthorize("@ss.hasPermission('mes:dv-mainten-record:create')")
+    public CommonResult<Long> createMaintenRecord(@Valid @RequestBody MesDvMaintenRecordSaveReqVO createReqVO) {
+        return success(maintenRecordService.createMaintenRecord(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新设备保养记录")
+    @PreAuthorize("@ss.hasPermission('mes:dv-mainten-record:update')")
+    public CommonResult<Boolean> updateMaintenRecord(@Valid @RequestBody MesDvMaintenRecordSaveReqVO updateReqVO) {
+        maintenRecordService.updateMaintenRecord(updateReqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除设备保养记录")
+    @Parameter(name = "id", description = "编号", required = true)
+    @PreAuthorize("@ss.hasPermission('mes:dv-mainten-record:delete')")
+    public CommonResult<Boolean> deleteMaintenRecord(@RequestParam("id") Long id) {
+        maintenRecordService.deleteMaintenRecord(id);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得设备保养记录")
+    @Parameter(name = "id", description = "编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('mes:dv-mainten-record:query')")
+    public CommonResult<MesDvMaintenRecordRespVO> getMaintenRecord(@RequestParam("id") Long id) {
+        MesDvMaintenRecordDO maintenRecord = maintenRecordService.getMaintenRecord(id);
+        if (maintenRecord == null) {
+            return success(null);
+        }
+        return success(buildMaintenRecordRespVOList(Collections.singletonList(maintenRecord)).get(0));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得设备保养记录分页")
+    @PreAuthorize("@ss.hasPermission('mes:dv-mainten-record:query')")
+    public CommonResult<PageResult<MesDvMaintenRecordRespVO>> getMaintenRecordPage(@Valid MesDvMaintenRecordPageReqVO pageReqVO) {
+        PageResult<MesDvMaintenRecordDO> pageResult = maintenRecordService.getMaintenRecordPage(pageReqVO);
+        return success(new PageResult<>(buildMaintenRecordRespVOList(pageResult.getList()), pageResult.getTotal()));
+    }
+
+    @GetMapping("/export-excel")
+    @Operation(summary = "导出设备保养记录 Excel")
+    @PreAuthorize("@ss.hasPermission('mes:dv-mainten-record:export')")
+    @ApiAccessLog(operateType = EXPORT)
+    public void exportMaintenRecordExcel(@Valid MesDvMaintenRecordPageReqVO pageReqVO,
+                                         HttpServletResponse response) throws IOException {
+        pageReqVO.setPageSize(PageParam.PAGE_SIZE_NONE);
+        List<MesDvMaintenRecordDO> list = maintenRecordService.getMaintenRecordPage(pageReqVO).getList();
+        // 导出 Excel
+        ExcelUtils.write(response, "设备保养记录.xls", "数据", MesDvMaintenRecordRespVO.class,
+                buildMaintenRecordRespVOList(list));
+    }
+
+    @PutMapping("/submit")
+    @Operation(summary = "提交设备保养记录（草稿→已提交）")
+    @Parameter(name = "id", description = "编号", required = true)
+    @PreAuthorize("@ss.hasPermission('mes:dv-mainten-record:update')")
+    public CommonResult<Boolean> submitMaintenRecord(@RequestParam("id") Long id) {
+        maintenRecordService.submitMaintenRecord(id);
+        return success(true);
+    }
+
+    // ==================== 拼接 VO ====================
+
+    private List<MesDvMaintenRecordRespVO> buildMaintenRecordRespVOList(List<MesDvMaintenRecordDO> list) {
+        if (CollUtil.isEmpty(list)) {
+            return Collections.emptyList();
+        }
+        // 1. 批量获取关联数据
+        Map<Long, MesDvCheckPlanDO> planMap = checkPlanService.getCheckPlanMap(
+                convertSet(list, MesDvMaintenRecordDO::getPlanId));
+        Map<Long, MesDvMachineryDO> machineryMap = machineryService.getMachineryMap(
+                convertSet(list, MesDvMaintenRecordDO::getMachineryId));
+        Map<Long, AdminUserRespDTO> userMap = adminUserApi.getUserMap(
+                convertSet(list, MesDvMaintenRecordDO::getUserId));
+        // 2. 拼接 VO
+        return BeanUtils.toBean(list, MesDvMaintenRecordRespVO.class, vo -> {
+            MapUtils.findAndThen(planMap, vo.getPlanId(),
+                    plan -> vo.setPlanName(plan.getName())
+                            .setPlanCode(plan.getCode())
+                            .setPlanStartDate(plan.getStartDate())
+                            .setPlanEndDate(plan.getEndDate())
+                            .setPlanCycleType(plan.getCycleType())
+                            .setPlanCycleCount(plan.getCycleCount()));
+            MapUtils.findAndThen(machineryMap, vo.getMachineryId(), machinery -> vo
+                    .setMachineryCode(machinery.getCode()).setMachineryName(machinery.getName())
+                    .setMachineryBrand(machinery.getBrand()).setMachinerySpec(machinery.getSpec()));
+            MapUtils.findAndThen(userMap, vo.getUserId(),
+                    user -> vo.setNickname(user.getNickname()));
+        });
+    }
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.dv.maintenrecord;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.apilog.core.annotation.ApiAccessLog;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.collection.MapUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.framework.excel.core.util.ExcelUtils;
+import cn.iocoder.yudao.module.mes.controller.admin.dv.maintenrecord.vo.line.MesDvMaintenRecordLinePageReqVO;
+import cn.iocoder.yudao.module.mes.controller.admin.dv.maintenrecord.vo.line.MesDvMaintenRecordLineRespVO;
+import cn.iocoder.yudao.module.mes.controller.admin.dv.maintenrecord.vo.line.MesDvMaintenRecordLineSaveReqVO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.dv.maintenrecord.MesDvMaintenRecordLineDO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.dv.subject.MesDvSubjectDO;
+import cn.iocoder.yudao.module.mes.service.dv.maintenrecord.MesDvMaintenRecordLineService;
+import cn.iocoder.yudao.module.mes.service.dv.subject.MesDvSubjectService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.servlet.http.HttpServletResponse;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import java.io.IOException;
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.apilog.core.enums.OperateTypeEnum.EXPORT;
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+
+@Tag(name = "管理后台 - MES 设备保养记录明细")
+@RestController
+@RequestMapping("/mes/dv/mainten-record-line")
+@Validated
+public class MesDvMaintenRecordLineController {
+
+    @Resource
+    private MesDvMaintenRecordLineService maintenRecordLineService;
+
+    @Resource
+    private MesDvSubjectService subjectService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建设备保养记录明细")
+    @PreAuthorize("@ss.hasPermission('mes:dv-mainten-record:create')")
+    public CommonResult<Long> createMaintenRecordLine(@Valid @RequestBody MesDvMaintenRecordLineSaveReqVO createReqVO) {
+        return success(maintenRecordLineService.createMaintenRecordLine(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新设备保养记录明细")
+    @PreAuthorize("@ss.hasPermission('mes:dv-mainten-record:update')")
+    public CommonResult<Boolean> updateMaintenRecordLine(@Valid @RequestBody MesDvMaintenRecordLineSaveReqVO updateReqVO) {
+        maintenRecordLineService.updateMaintenRecordLine(updateReqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除设备保养记录明细")
+    @Parameter(name = "id", description = "编号", required = true)
+    @PreAuthorize("@ss.hasPermission('mes:dv-mainten-record:delete')")
+    public CommonResult<Boolean> deleteMaintenRecordLine(@RequestParam("id") Long id) {
+        maintenRecordLineService.deleteMaintenRecordLine(id);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得设备保养记录明细")
+    @Parameter(name = "id", description = "编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('mes:dv-mainten-record:query')")
+    public CommonResult<MesDvMaintenRecordLineRespVO> getMaintenRecordLine(@RequestParam("id") Long id) {
+        MesDvMaintenRecordLineDO maintenRecordLine = maintenRecordLineService.getMaintenRecordLine(id);
+        if (maintenRecordLine == null) {
+            return success(null);
+        }
+        return success(buildMaintenRecordLineRespVOList(Collections.singletonList(maintenRecordLine)).get(0));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得设备保养记录明细分页")
+    @PreAuthorize("@ss.hasPermission('mes:dv-mainten-record:query')")
+    public CommonResult<PageResult<MesDvMaintenRecordLineRespVO>> getMaintenRecordLinePage(@Valid MesDvMaintenRecordLinePageReqVO pageReqVO) {
+        PageResult<MesDvMaintenRecordLineDO> pageResult = maintenRecordLineService.getMaintenRecordLinePage(pageReqVO);
+        return success(new PageResult<>(buildMaintenRecordLineRespVOList(pageResult.getList()), pageResult.getTotal()));
+    }
+
+    @GetMapping("/export-excel")
+    @Operation(summary = "导出设备保养记录明细 Excel")
+    @PreAuthorize("@ss.hasPermission('mes:dv-mainten-record:export')")
+    @ApiAccessLog(operateType = EXPORT)
+    public void exportMaintenRecordLineExcel(@Valid MesDvMaintenRecordLinePageReqVO pageReqVO,
+                                              HttpServletResponse response) throws IOException {
+        pageReqVO.setPageSize(PageParam.PAGE_SIZE_NONE);
+        List<MesDvMaintenRecordLineDO> list = maintenRecordLineService.getMaintenRecordLinePage(pageReqVO).getList();
+        // 导出 Excel
+        ExcelUtils.write(response, "设备保养记录明细.xls", "数据", MesDvMaintenRecordLineRespVO.class,
+                buildMaintenRecordLineRespVOList(list));
+    }
+
+    // ==================== 拼接 VO ====================
+
+    private List<MesDvMaintenRecordLineRespVO> buildMaintenRecordLineRespVOList(List<MesDvMaintenRecordLineDO> list) {
+        if (CollUtil.isEmpty(list)) {
+            return Collections.emptyList();
+        }
+        // 1. 批量获取关联数据
+        Map<Long, MesDvSubjectDO> subjectMap = subjectService.getSubjectMap(
+                convertSet(list, MesDvMaintenRecordLineDO::getSubjectId));
+        // 2. 拼接 VO
+        return BeanUtils.toBean(list, MesDvMaintenRecordLineRespVO.class, vo ->
+                MapUtils.findAndThen(subjectMap, vo.getSubjectId(), subject -> vo
+                        .setSubjectName(subject.getName()).setSubjectContent(subject.getContent())
+                        .setSubjectStandard(subject.getStandard())));
+    }
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.dv.maintenrecord.vo;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.time.LocalDateTime;
+
+import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+@Schema(description = "管理后台 - MES 设备保养记录分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class MesDvMaintenRecordPageReqVO extends PageParam {
+
+    @Schema(description = "保养计划编号", example = "1")
+    private Long planId;
+
+    @Schema(description = "设备编号", example = "1")
+    private Long machineryId;
+
+    @Schema(description = "保养人编号", example = "1")
+    private Long userId;
+
+    @Schema(description = "保养时间")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime[] maintenTime;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.dv.maintenrecord.vo;
+
+import cn.iocoder.yudao.framework.excel.core.annotations.DictFormat;
+import cn.iocoder.yudao.framework.excel.core.convert.DictConvert;
+import cn.iocoder.yudao.module.mes.enums.DictTypeConstants;
+import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
+import cn.idev.excel.annotation.ExcelProperty;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - MES 设备保养记录 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class MesDvMaintenRecordRespVO {
+
+    @Schema(description = "编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @ExcelProperty("编号")
+    private Long id;
+
+    @Schema(description = "计划编号", example = "1")
+    private Long planId;
+
+    @Schema(description = "计划名称", example = "保养计划1")
+    @ExcelProperty("计划名称")
+    private String planName;
+
+    @Schema(description = "计划编码", example = "P001")
+    @ExcelProperty("计划编码")
+    private String planCode;
+
+    @Schema(description = "开始时间")
+    @ExcelProperty("开始时间")
+    private LocalDateTime planStartDate;
+
+    @Schema(description = "结束日期")
+    @ExcelProperty("结束日期")
+    private LocalDateTime planEndDate;
+
+    @Schema(description = "频率类型", example = "1")
+    @ExcelProperty(value = "频率类型", converter = DictConvert.class)
+    @DictFormat(DictTypeConstants.MES_DV_CYCLE_TYPE)
+    private Integer planCycleType;
+
+    @Schema(description = "频率数量", example = "5")
+    @ExcelProperty(value = "频率数量")
+    private Integer planCycleCount;
+
+    @Schema(description = "设备编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Long machineryId;
+
+    @Schema(description = "设备编码", example = "M001")
+    @ExcelProperty("设备编码")
+    private String machineryCode;
+
+    @Schema(description = "设备名称", example = "机床A")
+    @ExcelProperty("设备名称")
+    private String machineryName;
+
+    @Schema(description = "品牌", example = "西门子")
+    @ExcelProperty("品牌")
+    private String machineryBrand;
+
+    @Schema(description = "规格型号", example = "X-100")
+    @ExcelProperty("规格型号")
+    private String machinerySpec;
+
+    @Schema(description = "保养时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("保养时间")
+    private LocalDateTime maintenTime;
+
+    @Schema(description = "用户编号", example = "1")
+    private Long userId;
+
+    @Schema(description = "保养人名称", example = "张三")
+    @ExcelProperty("保养人")
+    private String nickname;
+
+    @Schema(description = "状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "10")
+    @ExcelProperty(value = "状态", converter = DictConvert.class)
+    @DictFormat(DictTypeConstants.MES_MAINTEN_RECORD_STATUS)
+    private Integer status;
+
+    @Schema(description = "备注", example = "测试备注")
+    @ExcelProperty("备注")
+    private String remark;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("创建时间")
+    private LocalDateTime createTime;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.dv.maintenrecord.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import jakarta.validation.constraints.NotNull;
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - MES 设备保养记录新增/修改 Request VO")
+@Data
+public class MesDvMaintenRecordSaveReqVO {
+
+    @Schema(description = "编号", requiredMode = Schema.RequiredMode.NOT_REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "计划编号", example = "1")
+    private Long planId;
+
+    @Schema(description = "设备编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "设备不能为空")
+    private Long machineryId;
+
+    @Schema(description = "保养时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "保养时间不能为空")
+    private LocalDateTime maintenTime;
+
+    @Schema(description = "用户编号", example = "1")
+    private Long userId;
+
+    @Schema(description = "备注", example = "测试备注")
+    private String remark;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.dv.maintenrecord.vo.line;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+@Schema(description = "管理后台 - MES 设备保养记录明细分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class MesDvMaintenRecordLinePageReqVO extends PageParam {
+
+    @Schema(description = "保养记录ID", example = "1")
+    private Long recordId;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.dv.maintenrecord.vo.line;
+
+import cn.iocoder.yudao.framework.excel.core.annotations.DictFormat;
+import cn.iocoder.yudao.framework.excel.core.convert.DictConvert;
+import cn.iocoder.yudao.module.mes.enums.DictTypeConstants;
+import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
+import cn.idev.excel.annotation.ExcelProperty;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - MES 设备保养记录明细 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class MesDvMaintenRecordLineRespVO {
+
+    @Schema(description = "编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @ExcelProperty("编号")
+    private Long id;
+
+    @Schema(description = "保养记录编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Long recordId;
+
+    @Schema(description = "项目编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Long subjectId;
+
+    @Schema(description = "项目名称", example = "检查机油")
+    @ExcelProperty("项目名称")
+    private String subjectName;
+
+    @Schema(description = "项目内容", example = "检查机油是否充足")
+    @ExcelProperty("项目内容")
+    private String subjectContent;
+
+    @Schema(description = "项目标准", example = "无漏油")
+    @ExcelProperty("标准")
+    private String subjectStandard;
+
+    @Schema(description = "保养结果", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @ExcelProperty(value = "保养结果", converter = DictConvert.class)
+    @DictFormat(DictTypeConstants.MES_MAINTEN_STATUS)
+    private Integer status;
+
+    @Schema(description = "异常描述", example = "发现损坏")
+    @ExcelProperty("异常描述")
+    private String result;
+
+    @Schema(description = "备注", example = "测试备注")
+    @ExcelProperty("备注")
+    private String remark;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("创建时间")
+    private LocalDateTime createTime;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.dv.maintenrecord.vo.line;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import jakarta.validation.constraints.NotNull;
+
+@Schema(description = "管理后台 - MES 设备保养记录明细新增/修改 Request VO")
+@Data
+public class MesDvMaintenRecordLineSaveReqVO {
+
+    @Schema(description = "编号", requiredMode = Schema.RequiredMode.NOT_REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "保养记录编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "保养记录不能为空")
+    private Long recordId;
+
+    @Schema(description = "项目编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "项目不能为空")
+    private Long subjectId;
+
+    @Schema(description = "保养结果", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "保养结果不能为空")
+    private Integer status;
+
+    @Schema(description = "异常描述", example = "发现损坏")
+    private String result;
+
+    @Schema(description = "备注", example = "测试备注")
+    private String remark;
+
+}
+/**
+ * MES 设备管理（Device / Equipment Management）：设备类型、设备台账、点检计划与记录、保养记录、维修工单等设备全生命周期管理
+ */
+package cn.iocoder.yudao.module.mes.controller.admin.dv;
+package cn.iocoder.yudao.module.mes.controller.admin.dv.repair;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.apilog.core.annotation.ApiAccessLog;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.collection.MapUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.framework.excel.core.util.ExcelUtils;
+import cn.iocoder.yudao.module.mes.controller.admin.dv.repair.vo.MesDvRepairPageReqVO;
+import cn.iocoder.yudao.module.mes.controller.admin.dv.repair.vo.MesDvRepairRespVO;
+import cn.iocoder.yudao.module.mes.controller.admin.dv.repair.vo.MesDvRepairSaveReqVO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.dv.machinery.MesDvMachineryDO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.dv.repair.MesDvRepairDO;
+import cn.iocoder.yudao.module.mes.service.dv.machinery.MesDvMachineryService;
+import cn.iocoder.yudao.module.mes.service.dv.repair.MesDvRepairService;
+import cn.iocoder.yudao.module.system.api.user.AdminUserApi;
+import cn.iocoder.yudao.module.system.api.user.dto.AdminUserRespDTO;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.Parameters;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.servlet.http.HttpServletResponse;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import java.io.IOException;
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+import java.util.stream.Stream;
+
+import static cn.iocoder.yudao.framework.apilog.core.enums.OperateTypeEnum.EXPORT;
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSetByFlatMap;
+import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
+
+@Tag(name = "管理后台 - MES 维修工单")
+@RestController
+@RequestMapping("/mes/dv/repair")
+@Validated
+public class MesDvRepairController {
+
+    @Resource
+    private MesDvRepairService repairService;
+
+    @Resource
+    private MesDvMachineryService machineryService;
+
+    @Resource
+    private AdminUserApi adminUserApi;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建维修工单")
+    @PreAuthorize("@ss.hasPermission('mes:dv-repair:create')")
+    public CommonResult<Long> createRepair(@Valid @RequestBody MesDvRepairSaveReqVO createReqVO) {
+        return success(repairService.createRepair(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新维修工单")
+    @PreAuthorize("@ss.hasPermission('mes:dv-repair:update')")
+    public CommonResult<Boolean> updateRepair(@Valid @RequestBody MesDvRepairSaveReqVO updateReqVO) {
+        repairService.updateRepair(updateReqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除维修工单")
+    @Parameter(name = "id", description = "编号", required = true)
+    @PreAuthorize("@ss.hasPermission('mes:dv-repair:delete')")
+    public CommonResult<Boolean> deleteRepair(@RequestParam("id") Long id) {
+        repairService.deleteRepair(id);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得维修工单")
+    @Parameter(name = "id", description = "编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('mes:dv-repair:query')")
+    public CommonResult<MesDvRepairRespVO> getRepair(@RequestParam("id") Long id) {
+        MesDvRepairDO repair = repairService.getRepair(id);
+        if (repair == null) {
+            return success(null);
+        }
+        return success(buildRepairRespVOList(Collections.singletonList(repair)).get(0));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得维修工单分页")
+    @PreAuthorize("@ss.hasPermission('mes:dv-repair:query')")
+    public CommonResult<PageResult<MesDvRepairRespVO>> getRepairPage(@Valid MesDvRepairPageReqVO pageReqVO) {
+        PageResult<MesDvRepairDO> pageResult = repairService.getRepairPage(pageReqVO);
+        return success(new PageResult<>(buildRepairRespVOList(pageResult.getList()), pageResult.getTotal()));
+    }
+
+    @GetMapping("/export-excel")
+    @Operation(summary = "导出维修工单 Excel")
+    @PreAuthorize("@ss.hasPermission('mes:dv-repair:export')")
+    @ApiAccessLog(operateType = EXPORT)
+    public void exportRepairExcel(@Valid MesDvRepairPageReqVO pageReqVO,
+                                   HttpServletResponse response) throws IOException {
+        pageReqVO.setPageSize(PageParam.PAGE_SIZE_NONE);
+        List<MesDvRepairDO> list = repairService.getRepairPage(pageReqVO).getList();
+        // 导出 Excel
+        ExcelUtils.write(response, "维修工单.xls", "数据", MesDvRepairRespVO.class,
+                buildRepairRespVOList(list));
+    }
+
+    // DONE @AI：submit=>confirm=>finish（然后里面有是 resultstatus 这样的字段【对齐实体？】）
+
+    @PutMapping("/submit")
+    @Operation(summary = "提交维修工单（草稿→维修中）")
+    @Parameter(name = "id", description = "编号", required = true)
+    @PreAuthorize("@ss.hasPermission('mes:dv-repair:update')")
+    public CommonResult<Boolean> submitRepair(@RequestParam("id") Long id) {
+        repairService.submitRepair(id, getLoginUserId());
+        return success(true);
+    }
+
+    @PutMapping("/confirm")
+    @Operation(summary = "确认维修完成（维修中→待验收）")
+    @PreAuthorize("@ss.hasPermission('mes:dv-repair:update')")
+    public CommonResult<Boolean> confirmRepair(@Valid @RequestBody cn.iocoder.yudao.module.mes.controller.admin.dv.repair.vo.MesDvRepairConfirmReqVO confirmReqVO) {
+        repairService.confirmRepair(confirmReqVO);
+        return success(true);
+    }
+
+    @PutMapping("/finish")
+    @Operation(summary = "完成验收（待验收→已确认）")
+    @Parameters({
+            @Parameter(name = "id", description = "编号", required = true),
+            @Parameter(name = "result", description = "验收结果", required = true)
+    })
+    @PreAuthorize("@ss.hasPermission('mes:dv-repair:update')")
+    public CommonResult<Boolean> finishRepair(@RequestParam("id") Long id,
+                                              @RequestParam("result") Integer result) {
+        repairService.finishRepair(id, result, getLoginUserId());
+        return success(true);
+    }
+
+    // ==================== 拼接 VO ====================
+
+    private List<MesDvRepairRespVO> buildRepairRespVOList(List<MesDvRepairDO> list) {
+        if (CollUtil.isEmpty(list)) {
+            return Collections.emptyList();
+        }
+        // 1.1 批量获取关联数据
+        Map<Long, MesDvMachineryDO> machineryMap = machineryService.getMachineryMap(
+                convertSet(list, MesDvRepairDO::getMachineryId));
+        // 1.2 收集所有用户 ID（维修人 + 验收人）
+        Map<Long, AdminUserRespDTO> userMap = adminUserApi.getUserMap(convertSetByFlatMap(list,
+                repair -> Stream.of(repair.getAcceptedUserId(), repair.getConfirmUserId())));
+        // 2. 拼接 VO
+        return BeanUtils.toBean(list, MesDvRepairRespVO.class, vo -> {
+            MapUtils.findAndThen(machineryMap, vo.getMachineryId(), machinery -> vo
+                    .setMachineryCode(machinery.getCode()).setMachineryName(machinery.getName())
+                    .setMachineryBrand(machinery.getBrand()).setMachinerySpec(machinery.getSpec()));
+            MapUtils.findAndThen(userMap, vo.getAcceptedUserId(),
+                    user -> vo.setAcceptedUserNickname(user.getNickname()));
+            MapUtils.findAndThen(userMap, vo.getConfirmUserId(),
+                    user -> vo.setConfirmUserNickname(user.getNickname()));
+        });
+    }
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.dv.repair;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.apilog.core.annotation.ApiAccessLog;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.collection.MapUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.framework.excel.core.util.ExcelUtils;
+import cn.iocoder.yudao.module.mes.controller.admin.dv.repair.vo.line.MesDvRepairLinePageReqVO;
+import cn.iocoder.yudao.module.mes.controller.admin.dv.repair.vo.line.MesDvRepairLineRespVO;
+import cn.iocoder.yudao.module.mes.controller.admin.dv.repair.vo.line.MesDvRepairLineSaveReqVO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.dv.repair.MesDvRepairLineDO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.dv.subject.MesDvSubjectDO;
+import cn.iocoder.yudao.module.mes.service.dv.repair.MesDvRepairLineService;
+import cn.iocoder.yudao.module.mes.service.dv.subject.MesDvSubjectService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.servlet.http.HttpServletResponse;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import java.io.IOException;
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.apilog.core.enums.OperateTypeEnum.EXPORT;
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+
+@Tag(name = "管理后台 - MES 维修工单行")
+@RestController
+@RequestMapping("/mes/dv/repair-line")
+@Validated
+public class MesDvRepairLineController {
+
+    @Resource
+    private MesDvRepairLineService repairLineService;
+
+    @Resource
+    private MesDvSubjectService subjectService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建维修工单行")
+    @PreAuthorize("@ss.hasPermission('mes:dv-repair:create')")
+    public CommonResult<Long> createRepairLine(@Valid @RequestBody MesDvRepairLineSaveReqVO createReqVO) {
+        return success(repairLineService.createRepairLine(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新维修工单行")
+    @PreAuthorize("@ss.hasPermission('mes:dv-repair:update')")
+    public CommonResult<Boolean> updateRepairLine(@Valid @RequestBody MesDvRepairLineSaveReqVO updateReqVO) {
+        repairLineService.updateRepairLine(updateReqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除维修工单行")
+    @Parameter(name = "id", description = "编号", required = true)
+    @PreAuthorize("@ss.hasPermission('mes:dv-repair:delete')")
+    public CommonResult<Boolean> deleteRepairLine(@RequestParam("id") Long id) {
+        repairLineService.deleteRepairLine(id);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得维修工单行")
+    @Parameter(name = "id", description = "编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('mes:dv-repair:query')")
+    public CommonResult<MesDvRepairLineRespVO> getRepairLine(@RequestParam("id") Long id) {
+        MesDvRepairLineDO repairLine = repairLineService.getRepairLine(id);
+        if (repairLine == null) {
+            return success(null);
+        }
+        return success(buildRepairLineRespVOList(Collections.singletonList(repairLine)).get(0));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得维修工单行分页")
+    @PreAuthorize("@ss.hasPermission('mes:dv-repair:query')")
+    public CommonResult<PageResult<MesDvRepairLineRespVO>> getRepairLinePage(@Valid MesDvRepairLinePageReqVO pageReqVO) {
+        PageResult<MesDvRepairLineDO> pageResult = repairLineService.getRepairLinePage(pageReqVO);
+        return success(new PageResult<>(buildRepairLineRespVOList(pageResult.getList()), pageResult.getTotal()));
+    }
+
+    @GetMapping("/export-excel")
+    @Operation(summary = "导出维修工单行 Excel")
+    @PreAuthorize("@ss.hasPermission('mes:dv-repair:export')")
+    @ApiAccessLog(operateType = EXPORT)
+    public void exportRepairLineExcel(@Valid MesDvRepairLinePageReqVO pageReqVO,
+                                       HttpServletResponse response) throws IOException {
+        pageReqVO.setPageSize(PageParam.PAGE_SIZE_NONE);
+        List<MesDvRepairLineDO> list = repairLineService.getRepairLinePage(pageReqVO).getList();
+        // 导出 Excel
+        ExcelUtils.write(response, "维修工单行.xls", "数据", MesDvRepairLineRespVO.class,
+                buildRepairLineRespVOList(list));
+    }
+
+    // ==================== 拼接 VO ====================
+
+    private List<MesDvRepairLineRespVO> buildRepairLineRespVOList(List<MesDvRepairLineDO> list) {
+        if (CollUtil.isEmpty(list)) {
+            return Collections.emptyList();
+        }
+        // 1. 批量获取关联数据
+        Map<Long, MesDvSubjectDO> subjectMap = subjectService.getSubjectMap(
+                convertSet(list, MesDvRepairLineDO::getSubjectId));
+        // 2. 拼接 VO
+        return BeanUtils.toBean(list, MesDvRepairLineRespVO.class, vo ->
+                MapUtils.findAndThen(subjectMap, vo.getSubjectId(), subject -> vo
+                        .setSubjectName(subject.getName()).setSubjectContent(subject.getContent())
+                        .setSubjectStandard(subject.getStandard())));
+    }
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.dv.repair.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import jakarta.validation.constraints.NotNull;
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - MES 维修工单确认完成 Request VO")
+@Data
+public class MesDvRepairConfirmReqVO {
+
+    @Schema(description = "编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "维修工单编号不能为空")
+    private Long id;
+
+    @Schema(description = "维修完成日期", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "维修完成日期不能为空")
+    private LocalDateTime finishDate;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.dv.repair.vo;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.time.LocalDateTime;
+
+import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+@Schema(description = "管理后台 - MES 维修工单分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class MesDvRepairPageReqVO extends PageParam {
+
+    @Schema(description = "维修工单编码", example = "REP2024001")
+    private String code;
+
+    @Schema(description = "维修工单名称", example = "注塑机维修")
+    private String name;
+
+    @Schema(description = "设备编号", example = "1")
+    private Long machineryId;
+
+    @Schema(description = "维修结果", example = "1")
+    private Integer result;
+
+    @Schema(description = "状态", example = "10")
+    private Integer status;
+
+    @Schema(description = "报修日期")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime[] requireDate;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.dv.repair.vo;
+
+import cn.iocoder.yudao.framework.excel.core.annotations.DictFormat;
+import cn.iocoder.yudao.framework.excel.core.convert.DictConvert;
+import cn.iocoder.yudao.module.mes.enums.DictTypeConstants;
+import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
+import cn.idev.excel.annotation.ExcelProperty;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - MES 维修工单 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class MesDvRepairRespVO {
+
+    @Schema(description = "编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @ExcelProperty("编号")
+    private Long id;
+
+    @Schema(description = "维修工单编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "REP2024001")
+    @ExcelProperty("维修工单编码")
+    private String code;
+
+    @Schema(description = "维修工单名称", example = "注塑机液压系统维修")
+    @ExcelProperty("维修工单名称")
+    private String name;
+
+    @Schema(description = "设备编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Long machineryId;
+
+    @Schema(description = "设备编码", example = "M001")
+    @ExcelProperty("设备编码")
+    private String machineryCode;
+
+    @Schema(description = "设备名称", example = "注塑机")
+    @ExcelProperty("设备名称")
+    private String machineryName;
+
+    @Schema(description = "品牌", example = "西门子")
+    @ExcelProperty("品牌")
+    private String machineryBrand;
+
+    @Schema(description = "规格型号", example = "X-100")
+    @ExcelProperty("规格型号")
+    private String machinerySpec;
+
+    @Schema(description = "报修日期")
+    @ExcelProperty("报修日期")
+    private LocalDateTime requireDate;
+
+    @Schema(description = "维修完成日期")
+    @ExcelProperty("维修完成日期")
+    private LocalDateTime finishDate;
+
+    @Schema(description = "验收日期")
+    @ExcelProperty("验收日期")
+    private LocalDateTime confirmDate;
+
+    @Schema(description = "维修结果", example = "1")
+    @ExcelProperty(value = "维修结果", converter = DictConvert.class)
+    @DictFormat(DictTypeConstants.MES_DV_REPAIR_RESULT)
+    private Integer result;
+
+    @Schema(description = "维修人用户编号", example = "1")
+    private Long acceptedUserId;
+
+    @Schema(description = "维修人名称", example = "张三")
+    @ExcelProperty("维修人")
+    private String acceptedUserNickname;
+
+    @Schema(description = "验收人用户编号", example = "1")
+    private Long confirmUserId;
+
+    @Schema(description = "验收人名称", example = "李四")
+    @ExcelProperty("验收人")
+    private String confirmUserNickname;
+
+    @Schema(description = "来源单据类型", example = "1")
+    private Integer sourceDocType;
+
+    @Schema(description = "来源单据编号", example = "1")
+    private Long sourceDocId;
+
+    @Schema(description = "来源单据编码", example = "DOC001")
+    private String sourceDocCode;
+
+    @Schema(description = "状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "10")
+    @ExcelProperty(value = "状态", converter = DictConvert.class)
+    @DictFormat(DictTypeConstants.MES_DV_REPAIR_STATUS)
+    private Integer status;
+
+    @Schema(description = "备注", example = "测试备注")
+    @ExcelProperty("备注")
+    private String remark;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("创建时间")
+    private LocalDateTime createTime;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.dv.repair.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - MES 维修工单新增/修改 Request VO")
+@Data
+public class MesDvRepairSaveReqVO {
+
+    @Schema(description = "编号", requiredMode = Schema.RequiredMode.NOT_REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "维修工单编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "REP2024001")
+    @NotBlank(message = "维修工单编码不能为空")
+    private String code;
+
+    @Schema(description = "维修工单名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "注塑机液压系统维修")
+    @NotBlank(message = "维修工单名称不能为空")
+    private String name;
+
+    @Schema(description = "设备编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "设备不能为空")
+    private Long machineryId;
+
+    @Schema(description = "报修日期", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "报修日期不能为空")
+    private LocalDateTime requireDate;
+
+    @Schema(description = "维修完成日期")
+    private LocalDateTime finishDate;
+
+    @Schema(description = "验收日期")
+    private LocalDateTime confirmDate;
+
+    @Schema(description = "维修结果", example = "1")
+    private Integer result;
+
+    @Schema(description = "维修人用户编号", example = "1")
+    private Long acceptedUserId;
+
+    @Schema(description = "验收人用户编号", example = "1")
+    private Long confirmUserId;
+
+    @Schema(description = "来源单据类型", example = "1")
+    private Integer sourceDocType;
+
+    @Schema(description = "来源单据编号", example = "1")
+    private Long sourceDocId;
+
+    @Schema(description = "来源单据编码", example = "DOC001")
+    private String sourceDocCode;
+
+    @Schema(description = "备注", example = "测试备注")
+    private String remark;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.dv.repair.vo.line;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+@Schema(description = "管理后台 - MES 维修工单行分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class MesDvRepairLinePageReqVO extends PageParam {
+
+    @Schema(description = "维修工单编号", example = "1")
+    private Long repairId;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.dv.repair.vo.line;
+
+import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
+import cn.idev.excel.annotation.ExcelProperty;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - MES 维修工单行 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class MesDvRepairLineRespVO {
+
+    @Schema(description = "编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @ExcelProperty("编号")
+    private Long id;
+
+    @Schema(description = "维修工单编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Long repairId;
+
+    @Schema(description = "点检保养项目编号", example = "1")
+    private Long subjectId;
+
+    @Schema(description = "项目名称", example = "检查机油")
+    @ExcelProperty("项目名称")
+    private String subjectName;
+
+    @Schema(description = "项目内容", example = "检查机油是否充足")
+    @ExcelProperty("项目内容")
+    private String subjectContent;
+
+    @Schema(description = "项目标准", example = "无漏油")
+    @ExcelProperty("标准")
+    private String subjectStandard;
+
+    @Schema(description = "故障描述", requiredMode = Schema.RequiredMode.REQUIRED, example = "液压系统漏油")
+    @ExcelProperty("故障描述")
+    private String malfunction;
+
+    @Schema(description = "故障图片 URL", example = "https://example.com/image.png")
+    private String malfunctionUrl;
+
+    @Schema(description = "维修描述", example = "更换密封圈")
+    @ExcelProperty("维修描述")
+    private String description;
+
+    @Schema(description = "备注", example = "测试备注")
+    @ExcelProperty("备注")
+    private String remark;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("创建时间")
+    private LocalDateTime createTime;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.dv.repair.vo.line;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+
+@Schema(description = "管理后台 - MES 维修工单行新增/修改 Request VO")
+@Data
+public class MesDvRepairLineSaveReqVO {
+
+    @Schema(description = "编号", requiredMode = Schema.RequiredMode.NOT_REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "维修工单编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "维修工单不能为空")
+    private Long repairId;
+
+    @Schema(description = "点检保养项目编号", example = "1")
+    private Long subjectId;
+
+    @Schema(description = "故障描述", requiredMode = Schema.RequiredMode.REQUIRED, example = "液压系统漏油")
+    @NotBlank(message = "故障描述不能为空")
+    private String malfunction;
+
+    @Schema(description = "故障图片 URL", example = "https://example.com/image.png")
+    private String malfunctionUrl;
+
+    @Schema(description = "维修描述", example = "更换密封圈")
+    private String description;
+
+    @Schema(description = "备注", example = "测试备注")
+    private String remark;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.dv.subject;
+
+import cn.iocoder.yudao.framework.apilog.core.annotation.ApiAccessLog;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.framework.excel.core.util.ExcelUtils;
+import cn.iocoder.yudao.module.mes.controller.admin.dv.subject.vo.MesDvSubjectPageReqVO;
+import cn.iocoder.yudao.module.mes.controller.admin.dv.subject.vo.MesDvSubjectRespVO;
+import cn.iocoder.yudao.module.mes.controller.admin.dv.subject.vo.MesDvSubjectSaveReqVO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.dv.subject.MesDvSubjectDO;
+import cn.iocoder.yudao.module.mes.service.dv.subject.MesDvSubjectService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.servlet.http.HttpServletResponse;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import java.io.IOException;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.apilog.core.enums.OperateTypeEnum.EXPORT;
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+
+@Tag(name = "管理后台 - MES 点检保养项目")
+@RestController
+@RequestMapping("/mes/dv/subject")
+@Validated
+public class MesDvSubjectController {
+
+    @Resource
+    private MesDvSubjectService subjectService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建点检保养项目")
+    @PreAuthorize("@ss.hasPermission('mes:dv-subject:create')")
+    public CommonResult<Long> createSubject(@Valid @RequestBody MesDvSubjectSaveReqVO createReqVO) {
+        return success(subjectService.createSubject(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新点检保养项目")
+    @PreAuthorize("@ss.hasPermission('mes:dv-subject:update')")
+    public CommonResult<Boolean> updateSubject(@Valid @RequestBody MesDvSubjectSaveReqVO updateReqVO) {
+        subjectService.updateSubject(updateReqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除点检保养项目")
+    @Parameter(name = "id", description = "编号", required = true)
+    @PreAuthorize("@ss.hasPermission('mes:dv-subject:delete')")
+    public CommonResult<Boolean> deleteSubject(@RequestParam("id") Long id) {
+        subjectService.deleteSubject(id);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得点检保养项目")
+    @Parameter(name = "id", description = "编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('mes:dv-subject:query')")
+    public CommonResult<MesDvSubjectRespVO> getSubject(@RequestParam("id") Long id) {
+        MesDvSubjectDO subject = subjectService.getSubject(id);
+        return success(BeanUtils.toBean(subject, MesDvSubjectRespVO.class));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得点检保养项目分页")
+    @PreAuthorize("@ss.hasPermission('mes:dv-subject:query')")
+    public CommonResult<PageResult<MesDvSubjectRespVO>> getSubjectPage(@Valid MesDvSubjectPageReqVO pageReqVO) {
+        PageResult<MesDvSubjectDO> pageResult = subjectService.getSubjectPage(pageReqVO);
+        return success(BeanUtils.toBean(pageResult, MesDvSubjectRespVO.class));
+    }
+
+    @GetMapping("/simple-list")
+    @Operation(summary = "获得点检保养项目精简列表", description = "主要用于前端的下拉选项")
+    @PreAuthorize("@ss.hasPermission('mes:dv-subject:query')")
+    public CommonResult<List<MesDvSubjectRespVO>> getSubjectSimpleList() {
+        List<MesDvSubjectDO> list = subjectService.getSubjectList();
+        return success(BeanUtils.toBean(list, MesDvSubjectRespVO.class));
+    }
+
+    @GetMapping("/export-excel")
+    @Operation(summary = "导出点检保养项目 Excel")
+    @PreAuthorize("@ss.hasPermission('mes:dv-subject:export')")
+    @ApiAccessLog(operateType = EXPORT)
+    public void exportSubjectExcel(@Valid MesDvSubjectPageReqVO pageReqVO,
+                                    HttpServletResponse response) throws IOException {
+        pageReqVO.setPageSize(PageParam.PAGE_SIZE_NONE);
+        List<MesDvSubjectDO> list = subjectService.getSubjectPage(pageReqVO).getList();
+        // 导出 Excel
+        ExcelUtils.write(response, "点检保养项目.xls", "数据", MesDvSubjectRespVO.class,
+                BeanUtils.toBean(list, MesDvSubjectRespVO.class));
+    }
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.dv.subject.vo;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+@Schema(description = "管理后台 - MES 点检保养项目分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class MesDvSubjectPageReqVO extends PageParam {
+
+    @Schema(description = "项目编码", example = "CHK001")
+    private String code;
+
+    @Schema(description = "项目名称", example = "注塑机外观检查")
+    private String name;
+
+    @Schema(description = "项目类型", example = "1")
+    private Integer type;
+
+    @Schema(description = "状态", example = "0")
+    private Integer status;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.dv.subject.vo;
+
+import cn.iocoder.yudao.framework.excel.core.annotations.DictFormat;
+import cn.iocoder.yudao.framework.excel.core.convert.DictConvert;
+import cn.iocoder.yudao.module.mes.enums.DictTypeConstants;
+import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
+import cn.idev.excel.annotation.ExcelProperty;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - MES 点检保养项目 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class MesDvSubjectRespVO {
+
+    @Schema(description = "编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @ExcelProperty("编号")
+    private Long id;
+
+    @Schema(description = "项目编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "CHK001")
+    @ExcelProperty("项目编码")
+    private String code;
+
+    @Schema(description = "项目名称", example = "注塑机外观检查")
+    @ExcelProperty("项目名称")
+    private String name;
+
+    @Schema(description = "项目类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @ExcelProperty(value = "项目类型", converter = DictConvert.class)
+    @DictFormat(DictTypeConstants.MES_DV_SUBJECT_TYPE)
+    private Integer type;
+
+    @Schema(description = "项目内容", requiredMode = Schema.RequiredMode.REQUIRED, example = "检查注塑机外壳是否有裂纹")
+    @ExcelProperty("项目内容")
+    private String content;
+
+    @Schema(description = "标准", example = "外观完好，无明显损伤")
+    @ExcelProperty("标准")
+    private String standard;
+
+    @Schema(description = "状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "0")
+    @ExcelProperty(value = "状态", converter = DictConvert.class)
+    @DictFormat("common_status")
+    private Integer status;
+
+    @Schema(description = "备注", example = "备注")
+    @ExcelProperty("备注")
+    private String remark;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("创建时间")
+    private LocalDateTime createTime;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.dv.subject.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+@Schema(description = "管理后台 - MES 点检保养项目新增/修改 Request VO")
+@Data
+public class MesDvSubjectSaveReqVO {
+
+    @Schema(description = "编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "项目编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "CHK001")
+    @NotEmpty(message = "项目编码不能为空")
+    private String code;
+
+    @Schema(description = "项目名称", example = "注塑机外观检查")
+    private String name;
+
+    @Schema(description = "项目类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "项目类型不能为空")
+    private Integer type;
+
+    @Schema(description = "项目内容", requiredMode = Schema.RequiredMode.REQUIRED, example = "检查注塑机外壳是否有裂纹")
+    @NotEmpty(message = "项目内容不能为空")
+    private String content;
+
+    @Schema(description = "标准", example = "外观完好，无明显损伤")
+    private String standard;
+
+    @Schema(description = "状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "0")
+    @NotNull(message = "状态不能为空")
+    private Integer status;
+
+    @Schema(description = "备注", example = "备注")
+    private String remark;
+
+    }
+package cn.iocoder.yudao.module.mes.controller.admin.home;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.module.mes.controller.admin.home.vo.MesHomeProductionTrendRespVO;
+import cn.iocoder.yudao.module.mes.controller.admin.home.vo.MesHomeSummaryRespVO;
+import cn.iocoder.yudao.module.mes.controller.admin.home.vo.MesHomeWorkOrderStatusRespVO;
+import cn.iocoder.yudao.module.mes.service.home.MesHomeStatisticsService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.constraints.Max;
+import jakarta.validation.constraints.Min;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+
+@Tag(name = "管理后台 - MES 首页统计")
+@RestController
+@RequestMapping("/mes/home-statistics")
+@Validated
+public class MesHomeStatisticsController {
+
+    @Resource
+    private MesHomeStatisticsService homeStatisticsService;
+
+    @GetMapping("/summary")
+    @Operation(summary = "获得首页汇总统计")
+    @PreAuthorize("@ss.hasPermission('mes:home:query')")
+    public CommonResult<MesHomeSummaryRespVO> getHomeSummary() {
+        return success(homeStatisticsService.getHomeSummary());
+    }
+
+    @GetMapping("/work-order-status")
+    @Operation(summary = "获得工单状态分布")
+    @PreAuthorize("@ss.hasPermission('mes:home:query')")
+    public CommonResult<List<MesHomeWorkOrderStatusRespVO>> getWorkOrderStatusDistribution() {
+        return success(homeStatisticsService.getWorkOrderStatusDistribution());
+    }
+
+    @GetMapping("/production-trend")
+    @Operation(summary = "获得生产趋势")
+    @Parameter(name = "days", description = "天数", example = "7")
+    @PreAuthorize("@ss.hasPermission('mes:home:query')")
+    public CommonResult<List<MesHomeProductionTrendRespVO>> getProductionTrend(
+            @RequestParam(value = "days", defaultValue = "7") @Min(1) @Max(90) Integer days) {
+        return success(homeStatisticsService.getProductionTrend(days));
+    }
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.home.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.math.BigDecimal;
+
+@Schema(description = "管理后台 - MES 首页生产趋势 Response VO")
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+public class MesHomeProductionTrendRespVO {
+
+    @Schema(description = "日期", requiredMode = Schema.RequiredMode.REQUIRED, example = "2026-04-05")
+    private String date;
+
+    @Schema(description = "产量", requiredMode = Schema.RequiredMode.REQUIRED, example = "1234")
+    private BigDecimal quantity;
+
+    @Schema(description = "合格品数量", requiredMode = Schema.RequiredMode.REQUIRED, example = "1200")
+    private BigDecimal qualifiedQuantity;
+
+    @Schema(description = "不良品数量", requiredMode = Schema.RequiredMode.REQUIRED, example = "34")
+    private BigDecimal unqualifiedQuantity;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.home.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+
+@Schema(description = "管理后台 - MES 首页汇总统计 Response VO")
+@Data
+public class MesHomeSummaryRespVO {
+
+    // ========== 工单统计 ==========
+
+    @Schema(description = "进行中工单数", requiredMode = Schema.RequiredMode.REQUIRED, example = "12")
+    private Long workOrderActiveCount;
+
+    @Schema(description = "待排产工单数(草稿)", requiredMode = Schema.RequiredMode.REQUIRED, example = "5")
+    private Long workOrderPrepareCount;
+
+    @Schema(description = "已完成工单数", requiredMode = Schema.RequiredMode.REQUIRED, example = "30")
+    private Long workOrderFinishedCount;
+
+    // ========== 产量统计 ==========
+
+    @Schema(description = "今日报工总产量", requiredMode = Schema.RequiredMode.REQUIRED, example = "1234")
+    private BigDecimal todayOutput;
+
+    @Schema(description = "昨日报工总产量", requiredMode = Schema.RequiredMode.REQUIRED, example = "1100")
+    private BigDecimal yesterdayOutput;
+
+    // ========== 质量统计 ==========
+
+    @Schema(description = "今日合格品数量", requiredMode = Schema.RequiredMode.REQUIRED, example = "1200")
+    private BigDecimal todayQualifiedQuantity;
+
+    @Schema(description = "今日不良品数量", requiredMode = Schema.RequiredMode.REQUIRED, example = "34")
+    private BigDecimal todayUnqualifiedQuantity;
+
+    // ========== 设备统计 ==========
+
+    @Schema(description = "设备总数", requiredMode = Schema.RequiredMode.REQUIRED, example = "20")
+    private Long machineryTotal;
+
+    @Schema(description = "运行中设备数", requiredMode = Schema.RequiredMode.REQUIRED, example = "15")
+    private Long machineryProducing;
+
+    @Schema(description = "停机设备数", requiredMode = Schema.RequiredMode.REQUIRED, example = "3")
+    private Long machineryStop;
+
+    @Schema(description = "维护中设备数", requiredMode = Schema.RequiredMode.REQUIRED, example = "2")
+    private Long machineryMaintenance;
+
+    // ========== 异常/待办统计 ==========
+
+    @Schema(description = "未处置安灯报警数", requiredMode = Schema.RequiredMode.REQUIRED, example = "3")
+    private Long andonActiveCount;
+
+    @Schema(description = "未完成维修工单数", requiredMode = Schema.RequiredMode.REQUIRED, example = "2")
+    private Long repairActiveCount;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.home.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+@Schema(description = "管理后台 - MES 首页工单状态分布 Response VO")
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+public class MesHomeWorkOrderStatusRespVO {
+
+    @Schema(description = "状态值", requiredMode = Schema.RequiredMode.REQUIRED, example = "0")
+    private Integer status;
+
+    @Schema(description = "状态名", requiredMode = Schema.RequiredMode.REQUIRED, example = "草稿")
+    private String statusName;
+
+    @Schema(description = "工单数量", requiredMode = Schema.RequiredMode.REQUIRED, example = "12")
+    private Long count;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.md.autocode;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.mes.controller.admin.md.autocode.vo.part.MesMdAutoCodePartRespVO;
+import cn.iocoder.yudao.module.mes.controller.admin.md.autocode.vo.part.MesMdAutoCodePartSaveReqVO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.md.autocode.MesMdAutoCodePartDO;
+import cn.iocoder.yudao.module.mes.service.md.autocode.MesMdAutoCodePartService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+
+@Tag(name = "管理后台 - MES 编码规则组成")
+@RestController
+@RequestMapping("/mes/md/auto-code-part")
+@Validated
+public class MesMdAutoCodePartController {
+
+    @Resource
+    private MesMdAutoCodePartService partService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建规则组成")
+    @PreAuthorize("@ss.hasPermission('mes:auto-code-rule:update')")
+    public CommonResult<Long> createAutoCodePart(@Valid @RequestBody MesMdAutoCodePartSaveReqVO createReqVO) {
+        return success(partService.createAutoCodePart(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新规则组成")
+    @PreAuthorize("@ss.hasPermission('mes:auto-code-rule:update')")
+    public CommonResult<Boolean> updateAutoCodePart(@Valid @RequestBody MesMdAutoCodePartSaveReqVO updateReqVO) {
+        partService.updateAutoCodePart(updateReqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除规则组成")
+    @Parameter(name = "id", description = "编号", required = true)
+    @PreAuthorize("@ss.hasPermission('mes:auto-code-rule:update')")
+    public CommonResult<Boolean> deleteAutoCodePart(@RequestParam("id") Long id) {
+        partService.deleteAutoCodePart(id);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得规则组成")
+    @Parameter(name = "id", description = "编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('mes:auto-code-rule:query')")
+    public CommonResult<MesMdAutoCodePartRespVO> getAutoCodePart(@RequestParam("id") Long id) {
+        MesMdAutoCodePartDO part = partService.getAutoCodePart(id);
+        return success(BeanUtils.toBean(part, MesMdAutoCodePartRespVO.class));
+    }
+
+    @GetMapping("/list-by-rule-id")
+    @Operation(summary = "根据规则 ID 获得规则组成列表")
+    @Parameter(name = "ruleId", description = "规则 ID", required = true, example = "1")
+    @PreAuthorize("@ss.hasPermission('mes:auto-code-rule:query')")
+    public CommonResult<List<MesMdAutoCodePartRespVO>> getAutoCodePartListByRuleId(@RequestParam("ruleId") Long ruleId) {
+        List<MesMdAutoCodePartDO> list = partService.getAutoCodePartListByRuleId(ruleId);
+        return success(BeanUtils.toBean(list, MesMdAutoCodePartRespVO.class));
+    }
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.md.autocode;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.module.mes.controller.admin.md.autocode.vo.record.MesMdAutoCodeGenerateReqVO;
+import cn.iocoder.yudao.module.mes.service.md.autocode.MesMdAutoCodeRecordService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+
+@Tag(name = "管理后台 - MES 编码生成记录")
+@RestController
+@RequestMapping("/mes/md/auto-code-record")
+@Validated
+public class MesMdAutoCodeRecordController {
+
+    @Resource
+    private MesMdAutoCodeRecordService autoCodeRecordService;
+
+    @PostMapping("/generate")
+    @Operation(summary = "生成编码")
+    @PreAuthorize("@ss.hasPermission('mes:auto-code-rule:query')")
+    public CommonResult<String> generateAutoCode(@Valid @RequestBody MesMdAutoCodeGenerateReqVO generateReqVO) {
+        String code = autoCodeRecordService.generateAutoCode(generateReqVO.getRuleCode(), generateReqVO.getInputChar());
+        return success(code);
+    }
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.md.autocode;
+
+import cn.iocoder.yudao.framework.apilog.core.annotation.ApiAccessLog;
+import cn.iocoder.yudao.framework.common.enums.CommonStatusEnum;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.framework.excel.core.util.ExcelUtils;
+import cn.iocoder.yudao.module.mes.controller.admin.md.autocode.vo.rule.MesMdAutoCodeRulePageReqVO;
+import cn.iocoder.yudao.module.mes.controller.admin.md.autocode.vo.rule.MesMdAutoCodeRuleRespVO;
+import cn.iocoder.yudao.module.mes.controller.admin.md.autocode.vo.rule.MesMdAutoCodeRuleSaveReqVO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.md.autocode.MesMdAutoCodeRuleDO;
+import cn.iocoder.yudao.module.mes.service.md.autocode.MesMdAutoCodeRuleService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.servlet.http.HttpServletResponse;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import java.io.IOException;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.apilog.core.enums.OperateTypeEnum.EXPORT;
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+
+@Tag(name = "管理后台 - MES 编码规则")
+@RestController
+@RequestMapping("/mes/md/auto-code-rule")
+@Validated
+public class MesMdAutoCodeRuleController {
+
+    @Resource
+    private MesMdAutoCodeRuleService ruleService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建编码规则")
+    @PreAuthorize("@ss.hasPermission('mes:auto-code-rule:create')")
+    public CommonResult<Long> createAutoCodeRule(@Valid @RequestBody MesMdAutoCodeRuleSaveReqVO createReqVO) {
+        return success(ruleService.createAutoCodeRule(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新编码规则")
+    @PreAuthorize("@ss.hasPermission('mes:auto-code-rule:update')")
+    public CommonResult<Boolean> updateAutoCodeRule(@Valid @RequestBody MesMdAutoCodeRuleSaveReqVO updateReqVO) {
+        ruleService.updateAutoCodeRule(updateReqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除编码规则")
+    @Parameter(name = "id", description = "编号", required = true)
+    @PreAuthorize("@ss.hasPermission('mes:auto-code-rule:delete')")
+    public CommonResult<Boolean> deleteAutoCodeRule(@RequestParam("id") Long id) {
+        ruleService.deleteAutoCodeRule(id);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得编码规则")
+    @Parameter(name = "id", description = "编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('mes:auto-code-rule:query')")
+    public CommonResult<MesMdAutoCodeRuleRespVO> getAutoCodeRule(@RequestParam("id") Long id) {
+        MesMdAutoCodeRuleDO rule = ruleService.getAutoCodeRule(id);
+        return success(BeanUtils.toBean(rule, MesMdAutoCodeRuleRespVO.class));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得编码规则分页")
+    @PreAuthorize("@ss.hasPermission('mes:auto-code-rule:query')")
+    public CommonResult<PageResult<MesMdAutoCodeRuleRespVO>> getAutoCodeRulePage(@Valid MesMdAutoCodeRulePageReqVO pageReqVO) {
+        PageResult<MesMdAutoCodeRuleDO> pageResult = ruleService.getAutoCodeRulePage(pageReqVO);
+        return success(BeanUtils.toBean(pageResult, MesMdAutoCodeRuleRespVO.class));
+    }
+
+    @GetMapping("/simple-list")
+    @Operation(summary = "获得编码规则精简列表", description = "只包含被开启的编码规则，主要用于前端的下拉选项")
+    public CommonResult<List<MesMdAutoCodeRuleRespVO>> getAutoCodeRuleSimpleList() {
+        List<MesMdAutoCodeRuleDO> list = ruleService.getAutoCodeRuleListByStatus(CommonStatusEnum.ENABLE.getStatus());
+        return success(convertList(list, rule -> new MesMdAutoCodeRuleRespVO()
+                .setId(rule.getId()).setName(rule.getName()).setCode(rule.getCode())));
+    }
+
+    @GetMapping("/export-excel")
+    @Operation(summary = "导出编码规则 Excel")
+    @PreAuthorize("@ss.hasPermission('mes:auto-code-rule:export')")
+    @ApiAccessLog(operateType = EXPORT)
+    public void exportAutoCodeRuleExcel(@Valid MesMdAutoCodeRulePageReqVO pageReqVO,
+                                 HttpServletResponse response) throws IOException {
+        pageReqVO.setPageSize(PageParam.PAGE_SIZE_NONE);
+        List<MesMdAutoCodeRuleDO> list = ruleService.getAutoCodeRulePage(pageReqVO).getList();
+        List<MesMdAutoCodeRuleRespVO> data = BeanUtils.toBean(list, MesMdAutoCodeRuleRespVO.class);
+        ExcelUtils.write(response, "编码规则.xls", "数据", MesMdAutoCodeRuleRespVO.class, data);
+    }
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.md.autocode.vo.part;
+
+import cn.iocoder.yudao.framework.excel.core.annotations.DictFormat;
+import cn.iocoder.yudao.framework.excel.core.convert.DictConvert;
+import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
+import cn.idev.excel.annotation.ExcelProperty;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - MES 编码规则组成 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class MesMdAutoCodePartRespVO {
+
+    @Schema(description = "分段 ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @ExcelProperty("分段 ID")
+    private Long id;
+
+    @Schema(description = "规则 ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @ExcelProperty("规则 ID")
+    private Long ruleId;
+
+    @Schema(description = "分段序号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @ExcelProperty("分段序号")
+    private Integer sort;
+
+    @Schema(description = "分段类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @ExcelProperty(value = "分段类型", converter = DictConvert.class)
+    @DictFormat("mes_auto_code_part_type")
+    private Integer type;
+
+    @Schema(description = "分段长度", requiredMode = Schema.RequiredMode.REQUIRED, example = "4")
+    @ExcelProperty("分段长度")
+    private Integer length;
+
+    @Schema(description = "日期格式", example = "yyyyMMdd")
+    @ExcelProperty("日期格式")
+    private String dateFormat;
+
+    @Schema(description = "固定字符", example = "ITEM_")
+    @ExcelProperty("固定字符")
+    private String fixCharacter;
+
+    @Schema(description = "流水号起始值", example = "1")
+    @ExcelProperty("流水号起始值")
+    private Integer serialStartNo;
+
+    @Schema(description = "流水号步长", example = "1")
+    @ExcelProperty("流水号步长")
+    private Integer serialStep;
+
+    @Schema(description = "流水号是否循环", example = "true")
+    @ExcelProperty("流水号是否循环")
+    private Boolean cycleFlag;
+
+    @Schema(description = "循环方式", example = "3")
+    @ExcelProperty(value = "循环方式", converter = DictConvert.class)
+    @DictFormat("mes_auto_code_cycle_method")
+    private Integer cycleMethod;
+
+    @Schema(description = "备注", example = "备注")
+    @ExcelProperty("备注")
+    private String remark;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("创建时间")
+    private LocalDateTime createTime;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.md.autocode.vo.part;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+@Schema(description = "管理后台 - MES 编码规则组成新增/修改 Request VO")
+@Data
+public class MesMdAutoCodePartSaveReqVO {
+
+    @Schema(description = "分段 ID", example = "1024")
+    private Long id;
+
+    @Schema(description = "规则 ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "规则 ID 不能为空")
+    private Long ruleId;
+
+    @Schema(description = "分段序号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "分段序号不能为空")
+    private Integer sort;
+
+    @Schema(description = "分段类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "分段类型不能为空")
+    private Integer type;
+
+    @Schema(description = "分段长度", requiredMode = Schema.RequiredMode.REQUIRED, example = "4")
+    @NotNull(message = "分段长度不能为空")
+    private Integer length;
+
+    @Schema(description = "日期格式", example = "yyyyMMdd")
+    private String dateFormat;
+
+    @Schema(description = "固定字符", example = "ITEM_")
+    private String fixCharacter;
+
+    @Schema(description = "流水号起始值", example = "1")
+    private Integer serialStartNo;
+
+    @Schema(description = "流水号步长", example = "1")
+    private Integer serialStep;
+
+    @Schema(description = "流水号是否循环", example = "true")
+    private Boolean cycleFlag;
+
+    @Schema(description = "循环方式", example = "3")
+    private Integer cycleMethod;
+
+    @Schema(description = "备注", example = "备注")
+    private String remark;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.md.autocode.vo.record;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import lombok.Data;
+
+@Schema(description = "管理后台 - MES 编码生成 Request VO")
+@Data
+public class MesMdAutoCodeGenerateReqVO {
+
+    @Schema(description = "规则编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "ITEM_CODE")
+    @NotEmpty(message = "规则编码不能为空")
+    private String ruleCode;
+
+    @Schema(description = "输入字符", example = "A")
+    private String inputChar;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.md.autocode.vo.rule;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.time.LocalDateTime;
+
+import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+@Schema(description = "管理后台 - MES 编码规则分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class MesMdAutoCodeRulePageReqVO extends PageParam {
+
+    @Schema(description = "规则编码", example = "ITEM_CODE")
+    private String code;
+
+    @Schema(description = "规则名称", example = "物料编码规则")
+    private String name;
+
+    @Schema(description = "状态", example = "0")
+    private Integer status;
+
+    @Schema(description = "创建时间")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime[] createTime;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.md.autocode.vo.rule;
+
+import cn.iocoder.yudao.framework.excel.core.annotations.DictFormat;
+import cn.iocoder.yudao.framework.excel.core.convert.DictConvert;
+import cn.iocoder.yudao.module.system.enums.DictTypeConstants;
+import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
+import cn.idev.excel.annotation.ExcelProperty;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - MES 编码规则 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class MesMdAutoCodeRuleRespVO {
+
+    @Schema(description = "规则 ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @ExcelProperty("规则 ID")
+    private Long id;
+
+    @Schema(description = "规则编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "ITEM_CODE")
+    @ExcelProperty("规则编码")
+    private String code;
+
+    @Schema(description = "规则名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "物料编码规则")
+    @ExcelProperty("规则名称")
+    private String name;
+
+    @Schema(description = "描述", example = "用于生成物料编码")
+    @ExcelProperty("描述")
+    private String description;
+
+    @Schema(description = "最大长度", example = "20")
+    @ExcelProperty("最大长度")
+    private Integer maxLength;
+
+    @Schema(description = "是否补齐", example = "true")
+    @ExcelProperty("是否补齐")
+    private Boolean padded;
+
+    @Schema(description = "补齐字符", example = "0")
+    @ExcelProperty("补齐字符")
+    private String paddedChar;
+
+    @Schema(description = "补齐方式", example = "1")
+    @ExcelProperty(value = "补齐方式", converter = DictConvert.class)
+    @DictFormat("mes_auto_code_padded_method")
+    private Integer paddedMethod;
+
+    @Schema(description = "状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "0")
+    @ExcelProperty(value = "状态", converter = DictConvert.class)
+    @DictFormat(DictTypeConstants.COMMON_STATUS)
+    private Integer status;
+
+    @Schema(description = "备注", example = "备注")
+    @ExcelProperty("备注")
+    private String remark;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("创建时间")
+    private LocalDateTime createTime;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.md.autocode.vo.rule;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+@Schema(description = "管理后台 - MES 编码规则新增/修改 Request VO")
+@Data
+public class MesMdAutoCodeRuleSaveReqVO {
+
+    @Schema(description = "规则 ID", example = "1024")
+    private Long id;
+
+    @Schema(description = "规则编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "ITEM_CODE")
+    @NotEmpty(message = "规则编码不能为空")
+    private String code;
+
+    @Schema(description = "规则名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "物料编码规则")
+    @NotEmpty(message = "规则名称不能为空")
+    private String name;
+
+    @Schema(description = "描述", example = "用于生成物料编码")
+    private String description;
+
+    @Schema(description = "最大长度", example = "20")
+    private Integer maxLength;
+
+    @Schema(description = "是否补齐", example = "true")
+    private Boolean padded;
+
+    @Schema(description = "补齐字符", example = "0")
+    private String paddedChar;
+
+    @Schema(description = "补齐方式", example = "1")
+    private Integer paddedMethod;
+
+    @Schema(description = "状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "0")
+    @NotNull(message = "状态不能为空")
+    private Integer status;
+
+    @Schema(description = "备注", example = "备注")
+    private String remark;
+
+}
+package cn.iocoder.yudao.module.mes.controller.admin.md.client;
+
+import cn.iocoder.yudao.framework.apilog.core.annotation.ApiAccessLog;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.framework.excel.core.util.ExcelUtils;
+import cn.iocoder.yudao.module.mes.controller.admin.md.client.vo.MesMdClientImportExcelVO;
+import cn.iocoder.yudao.module.mes.controller.admin.md.client.vo.MesMdClientImportRespVO;
+import cn.iocoder.yudao.module.mes.controller.admin.md.client.vo.MesMdClientPageReqVO;
+import cn.iocoder.yudao.module.mes.controller.admin.md.client.vo.MesMdClientRespVO;
+import cn.iocoder.yudao.module.mes.controller.admin.md.client.vo.MesMdClientSaveReqVO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.md.client.MesMdClientDO;
+import cn.iocoder.yudao.module.mes.service.md.client.MesMdClientService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.Parameters;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.servlet.http.HttpServletResponse;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+import org.springframework.web.multipart.MultipartFile;
+
+import java.io.IOException;
+import java.util.Collections;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.apilog.core.enums.OperateTypeEnum.EXPORT;
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+
+
+@Tag(name = "管理后台 - MES 客户")
+@RestController
+@RequestMapping("/mes/md-client")
+@Validated
+public class MesMdClientController {
+
+    @Resource
+    private MesMdClientService clientService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建客户")
+    @PreAuthorize("@ss.hasPermission('mes:md-client:create')")
+    public CommonResult<Long> createClient(@Valid @RequestBody MesMdClientSaveReqVO createReqVO) {
+        return success(clientService.createClient(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新客户")
+    @PreAuthorize("@ss.hasPermission('mes:md-client:update')")
+    public CommonResult<Boolean> updateClient(@Valid @RequestBody MesMdClientSaveReqVO updateReqVO) {
+        clientService.updateClient(updateReqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除客户")
+    @Parameter(name = "id", description = "编号", required = true)
+    @PreAuthorize("@ss.hasPermission('mes:md-client:delete')")
+    public CommonResult<Boolean> deleteClient(@RequestParam("id") Long id) {
+        clientService.deleteClient(id);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得客户")
+    @Parameter(name = "id", description = "编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('mes:md-client:query')")
+    public CommonResult<MesMdClientRespVO> getClient(@RequestParam("id") Long id) {
+        MesMdClientDO client = clientService.getClient(id);
+        return success(BeanUtils.toBean(client, MesMdClientRespVO.class));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得客户分页")
+    @PreAuthorize("@ss.hasPermission('mes:md-client:query')")
+    public CommonResult<PageResult<MesMdClientRespVO>> getClientPage(@Valid MesMdClientPageReqVO pageReqVO) {
+        PageResult<MesMdClientDO> pageResult = clientService.getClientPage(pageReqVO);
+        return success(BeanUtils.toBean(pageResult, MesMdClientRespVO.class));
+    }
+
+    @GetMapping("/export-excel")
+    @Operation(summary = "导出客户 Excel")
+    @PreAuthorize("@ss.hasPermission('mes:md-client:export')")
+    @ApiAccessLog(operateType = EXPORT)
+    public void exportClientExcel(@Valid MesMdClientPageReqVO pageReqVO,
+                                  HttpServletResponse response) throws IOException {
+        pageReqVO.setPageSize(PageParam.PAGE_SIZE_NONE);
+        List<MesMdClientDO> list = clientService.getClientPage(pageReqVO).getList();
+        // 导出 Excel
+        ExcelUtils.write(response, "客户.xls", "数据", MesMdClientRespVO.class,
+                BeanUtils.toBean(list, MesMdClientRespVO.class));
+    }
+
+    @GetMapping("/get-import-template")
+    @Operation(summary = "获得客户导入模板")
+    public void importTemplate(HttpServletResponse response) throws IOException {
+        // 手动创建导出 demo
+        List<MesMdClientImportExcelVO> list = Collections.singletonList(
+                MesMdClientImportExcelVO.builder().code("C001").name("示例客户").nickname("示例")
+                        .type(1).telephone("13800138000").status(0).build()
+        );
+        // 输出
+        ExcelUtils.write(response, "客户导入模板.xls", "客户列表", MesMdClientImportExcelVO.class, list);
+    }
+
+    @PostMapping("/import")
+    @Operation(summary = "导入客户")
+    @Parameters({
+            @Parameter(name = "file", description = "Excel 文件", required = true),
+            @Parameter(name = "updateSupport", description = "是否支持更新，默认为 false", example = "true")
+    })
+    @PreAuthorize("@ss.hasPermission('mes:md-client:import')")
+    public CommonResult<MesMdClientImportRespVO> importExcel(@RequestParam("file") MultipartFile file,
+                                                              @RequestParam(value = "updateSupport", required = false,
+                                                                      defaultValue = "false") Boolean updateSupport) throws Exception {
+        List<MesMdClientImportExcelVO> list = ExcelUtils.read(file, MesMdClientImportExcelVO.class);
+        return success(clientService.importClientList(list, updateSupport));
+    }
+
+}