排班执行模块由 yudao-module-mes 后端模块的 cal.plan、cal.calendar 包实现。基于班组和节假日配置，编排具体的排班计划和工厂日历。

本文涉及两个子模块：

• 排班计划：用户需要设置每个班组类型的排班方式，包括计划时间范围、轮班方式（单白班/两班倒/三班倒）、倒班周期、每个班次的开始和结束时间、参与的班组。确认后自动生成排班日历。
• 排班日历：系统根据排班计划自动生成每个班组类型、每个班组、每个人的排班表，并以日历方式展示。节假日设置独立维护，当前不参与排班日历生成逻辑，仅影响查询展示。

本文涉及表如下图所示：

1. 排班计划

排班计划，由 MesCalPlanController 提供接口。

1.1 表结构

省略 creator/create_time/updater/update_time/deleted/tenant_id 等通用字段

CREATE TABLE `mes_cal_plan` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '编号',
  `code` varchar(64) NOT NULL COMMENT '计划编码',
  `name` varchar(255) DEFAULT NULL COMMENT '计划名称',
    
  `calendar_type` tinyint DEFAULT NULL COMMENT '日历类型',

  `start_date` datetime DEFAULT NULL COMMENT '开始日期',
  `end_date` datetime DEFAULT NULL COMMENT '结束日期',

  `shift_type` tinyint DEFAULT NULL COMMENT '轮班方式',
  `shift_method` tinyint DEFAULT NULL COMMENT '倒班方式',
  `shift_count` int DEFAULT NULL COMMENT '班次数量',

  `status` tinyint NOT NULL DEFAULT '0' COMMENT '状态',
  `remark` varchar(500) DEFAULT NULL COMMENT '备注',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB COMMENT='MES 排班计划';

① start_date、end_date 定义排班的生效时间范围。

② shift_type 为轮班方式，枚举 MesCalShiftTypeEnum：

枚举值	名称	默认班次
1	单白班	白班 08:00-18:00
2	两班倒	白班 08:00-20:00、夜班 20:00-08:00
3	三班倒	白班 08:00-16:00、中班 16:00-00:00、夜班 00:00-08:00

创建计划时，选择轮班方式后系统会自动生成默认班次设置，用户可在此基础上修改。

③ shift_method 为倒班方式，枚举 MesCalShiftMethodEnum（1=按季度，2=按月，3=按周，4=按天）。shift_count 为按天倒班时的倒班天数（如值为 2 表示每 2 天轮换一次班次）。

④ status 为计划状态，枚举 MesCalPlanStatusEnum（0=草稿，1=已确认）。确认后自动生成排班日历。

---

该表包含两个子表：

• mes_cal_plan_shift（班次设置）：定义每个班次的名称和时间段。
• mes_cal_plan_team（参与班组）：定义参与该排班计划的班组。

1.2 管理后台

对应 [MES 系统 -> 排班管理 -> 排班计划] 菜单，对应 yudao-ui-admin-vue3 项目的 @/views/mes/cal/plan 目录。

列表

支持按计划编码、名称、状态等条件搜索。

新增

点击【新增】或【编辑】按钮，弹出排班计划表单。用户需要设置“计划编码”、“计划名称”、“计划的开始/结束日期”、“班组类型”、“轮班方式”、“倒班周期”。选择轮班方式后自动填充默认班次设置。表单下方展示班次设置和参与班组列表。

修改

点击编码链接或【编辑】按钮，弹出修改表单。表单下方展示子表数据：

★ 班次设置（编辑弹窗下方）：由 mes_cal_plan_shift 表存储，定义每个班次的具体时间。由 MesCalPlanShiftController 提供接口。

mes_cal_plan_shift 表结构

CREATE TABLE `mes_cal_plan_shift` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '编号',

  `plan_id` bigint NOT NULL COMMENT '计划ID',
    
  `sort` int DEFAULT NULL COMMENT '排序',
  `name` varchar(64) DEFAULT NULL COMMENT '班次名称',
  `start_time` varchar(10) DEFAULT NULL COMMENT '开始时间',
  `end_time` varchar(10) DEFAULT NULL COMMENT '结束时间',

  `remark` varchar(500) DEFAULT NULL COMMENT '备注',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB COMMENT='MES 班次设置';

① plan_id 关联主表 mes_cal_plan 的 id 字段。

② name 为班次名称（如白班、夜班、中班）。start_time、end_time 为时间字符串（如 "08:00"、"18:00"）。

★ 参与班组（编辑弹窗下方）：由 mes_cal_plan_team 表存储，定义哪些班组参与该计划。由 MesCalPlanTeamController 提供接口。

mes_cal_plan_team 表结构

CREATE TABLE `mes_cal_plan_team` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '编号',

  `plan_id` bigint NOT NULL COMMENT '计划ID',
  `team_id` bigint NOT NULL COMMENT '班组ID',

  `remark` varchar(500) DEFAULT NULL COMMENT '备注',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB COMMENT='MES 排班参与班组';

① plan_id 关联主表 mes_cal_plan 的 id 字段。

② team_id 关联 mes_cal_team 表的 id 字段（详见 《【排班】班组设置、节假日设置》）。

确认

点击【确认】按钮，系统校验班组数量与轮班方式是否匹配（如两班倒至少需要 2 个班组），然后通过 confirmPlan 方法更新状态为「已确认」，并调用 generateTeamShiftRecords 自动生成排班日历（mes_cal_team_shift）——根据时间范围逐日循环，按倒班周期分配班组与班次的对应关系。

2. 排班日历

排班日历，由 MesCalCalendarController 提供接口。由排班计划确认后自动生成，展示每天、每个班组对应的班次安排。

2.1 表结构

CREATE TABLE `mes_cal_team_shift` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '编号',

  `plan_id` bigint NOT NULL COMMENT '计划ID',
  `team_id` bigint NOT NULL COMMENT '班组ID',
  `shift_id` bigint NOT NULL COMMENT '班次ID',
    
  `day` datetime NOT NULL COMMENT '日期',
  `sort` int DEFAULT NULL COMMENT '排序',

  `remark` varchar(500) DEFAULT NULL COMMENT '备注',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB COMMENT='MES 排班日历';

① plan_id 关联排班计划，team_id 关联班组，shift_id 关联班次设置。

② day 为具体日期。一条记录表示"某一天某个班组执行某个班次"。

2.2 管理后台

对应 [MES 系统 -> 排班管理 -> 排班日历] 菜单，对应 yudao-ui-admin-vue3 项目的 @/views/mes/cal/calendar 目录。

页面通过「按分类」「按班组」「按个人」三个 Tab 展示排班结果，以日历视图呈现每天的班次安排。