【生产】工作记录

来源：https://cloud.iocoder.cn/mes/pro/work-record/

工作记录模块，由 yudao-module-mes 后端模块的 pro.workrecord 包实现，用于管理车间操作人员与工作站之间的上工/下工绑定关系。

操作人员进入产线前，通过【上工】操作将自己绑定到某个工作站，表示"我现在在这个工位上工作"；离开时通过【下工】操作标记为已下工状态（快照表保留上一次工作站信息，不会清空）。
系统会记录每一次上下工事件，形成完整的人员出勤流水，便于管理人员追踪哪些人在哪些工位上工作过、何时上工/下工。

模块采用快照 + 流水的双表架构：

当前绑定状态：快照表，每个用户最多一条记录，反映该用户最近一次操作的工作站及当前上工/下工状态。下工后 workstation_id 不会被清空，仍保留上一次工作站信息。
上下工记录流水：流水表，记录每一次上工/下工操作，形成完整的历史时间线。

本文涉及表如下图所示：

工作记录模块

1. 当前绑定状态（快照表）

当前绑定状态表用于存储每个用户最新的工作站绑定快照，由 MesProWorkRecordServiceImpl 内部维护，不由前端直接增删改。

1.1 表结构

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

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

  `user_id` bigint NOT NULL COMMENT '用户编号',

  `workstation_id` bigint NOT NULL COMMENT '工作站编号',

  `type` tinyint NOT NULL COMMENT '当前状态（1=上工 2=下工）',

  `clock_in_time` datetime DEFAULT NULL COMMENT '上工时间',
  `clock_out_time` datetime DEFAULT NULL COMMENT '下工时间',

  `remark` varchar(500) DEFAULT '' COMMENT '备注',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_user_id` (`user_id`)
) ENGINE=InnoDB COMMENT='MES 当前绑定状态快照';

① user_id 关联 system_users 表的 id 字段，通过唯一索引 uk_user_id 保证每个用户最多一条记录。首次上工时插入，后续上工/下工均为更新。

② workstation_id 关联 mes_md_workstation 表的 id 字段，记录用户最近一次操作的工作站，详见《【基础】车间设置、工作站设置》。下工时不会清空该字段，仅更新 type 和 clock_out_time。

③ type 为当前状态，枚举 MesProWorkRecordTypeEnum（1=上工，2=下工）。上工时设置为 1，下工时设置为 2。

④ clock_in_time 和 clock_out_time 记录最近一次上工/下工的时间。上工时系统更新 clock_in_time，clock_out_time 保留上一次下工时间不变；下工时系统写入 clock_out_time。

2. 上下工记录流水

上下工记录流水，由 MesProWorkRecordController 提供接口。每一次上工/下工操作都会在流水表中追加一条记录，构成完整的历史时间线。

2.1 表结构

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

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

  `user_id` bigint NOT NULL COMMENT '用户编号',

  `workstation_id` bigint NOT NULL COMMENT '工作站编号',

  `type` tinyint NOT NULL COMMENT '操作类型（1=上工 2=下工）',

  `remark` varchar(500) DEFAULT '' COMMENT '备注',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB COMMENT='MES 上下工记录流水';

① user_id 关联 system_users 表的 id 字段，标识执行上工/下工操作的用户。

② workstation_id 关联 mes_md_workstation 表的 id 字段，标识本次操作关联的工作站，详见《【基础】车间设置、工作站设置》。

③ type 为操作类型，枚举 MesProWorkRecordTypeEnum（1=上工，2=下工）。

上工/下工业务流程

用户A 上工(工作站X) ──→ 快照表：插入/更新为上工状态
                      流水表：追加一条「上工」记录

用户A 下工 ──────────→ 快照表：更新为下工状态
                      流水表：追加一条「下工」记录

用户A 再次上工(工作站Y) → 快照表：更新工作站为Y，状态为上工
                        流水表：追加一条「上工」记录

上工（clockInWorkRecord）：校验工作站存在 → 校验用户未处于上工状态（防止重复上工） → 写入上工流水 → 更新快照表（首次则插入，非首次则更新工作站、状态、clock_in_time，clock_out_time 保留不变）。
下工（clockOutWorkRecord）：校验用户处于上工状态 → 写入下工流水 → 更新快照表状态为下工，记录 clock_out_time。

2.2 管理后台

对应 [MES 系统 -> 生产管理 -> 工作记录] 菜单，对应 yudao-ui-admin-vue3 项目的 @/views/mes/pro/workrecord 目录。

我的工作站状态栏

页面顶部有一个横向状态栏（WorkRecordStatusBar.vue），显示当前登录用户的工作站绑定状态：

已上工：显示绑定的工作站编码和名称（绿色标签），以及上工时间。右侧提供【下工】按钮，点击后二次确认即可解绑。
未上工：显示「当前未上工」（灰色标签）。右侧提供【上工】按钮，点击后弹出工作站选择器，选择目标工作站后点击【确认上工】完成绑定。

上工/下工操作完成后，状态栏会自动刷新，同时触发下方流水列表重新加载。

管理后台 - 工作记录状态栏

列表

状态栏下方为上下工记录流水列表。支持按用户、工作站、操作类型、操作时间范围等条件搜索。列表展示编号、用户、工作站编码、工作站名称、操作类型（上工/下工）、创建时间等信息。

管理后台 - 工作记录列表