# 生产任务报工人限制 - 前端联调方案 ## 涉及页面 - MES 生产任务(新增/编辑弹窗) - 生产工作台(任务列表、工作站选择弹窗) - MES 生产报工(新增/修改/提交、快捷报工、批量报工、导入) ## 业务流程与数据带入 1. 生产任务新增/编辑时选择「报工人」(可多选),保存后写入任务表。 2. 工作台按当前登录人过滤待报工任务:只显示报工人包含当前登录人的任务。 3. 报工时后端再次校验:仅任务的报工人可以创建、修改、提交报工单。 4. 新建任务未指定报工人时,自动取该工作站配置人员(岗位下启用用户)作为报工人;一键排产等自动生成任务同样适用。 5. 任务没有报工人(工作站未配置人员)时,任何人在工作台都看不到、也无法报工。 ## API | 方法 | 路径 | 说明 | |------|------|------| | POST | /mes/pro/task/create | 创建任务,新增 `assigneeUserIds` | | PUT | /mes/pro/task/update | 更新任务,新增 `assigneeUserIds` | | GET | /mes/pro/task/get | 任务详情,响应新增 `assigneeUserIds`、`assigneeUserNames` | | GET | /mes/pro/task/page | 任务分页,响应新增 `assigneeUserIds`、`assigneeUserNames` | | GET | /mes/pro/task/pending-feedback-page | 待报工台账,新增 `onlyMine` 参数 | | GET | /mes/pro/task/pending-count-by-workstation | 按工作站统计待报工数,新增 `onlyMine` 参数 | **任务保存请求参数新增:** | 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | assigneeUserIds | Long[] | 否 | 报工人用户编号列表;新增时不传或传空表示不限制;更新时传 null 表示不修改,传空数组表示清空限制 | **任务响应字段新增:** | 字段 | 类型 | 说明 | |------|------|------| | assigneeUserIds | Long[] | 报工人用户编号列表,空数组表示不限制 | | assigneeUserNames | String | 报工人姓名,多个用顿号“、”分隔 | **待报工台账请求参数新增:** | 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | onlyMine | Boolean | 否 | 为 true 时仅返回当前登录人可报工的任务(含未配置报工人的任务) | **请求示例:** ``` GET /mes/pro/task/pending-feedback-page?workstationId=10&pageNo=1&pageSize=200&onlyMine=true GET /mes/pro/task/pending-count-by-workstation?onlyMine=true ``` **响应示例:** ```json { "code": 0, "data": { "list": [ { "id": 1001, "code": "PT202611070001", "assigneeUserIds": [1024, 1025], "assigneeUserNames": "张三、李四" } ], "total": 1 } } ``` ## 字段展示规则 | 字段 | 展示位置 | 说明 | |------|----------|------| | assigneeUserIds | 任务新增/编辑弹窗 | 多选下拉,选项来源为工作站人员;编辑时回显 | | assigneeUserNames | 任务列表(可选) | 逗号/顿号分隔的姓名串,纯展示 | ## 业务规则说明 | 场景 | 规则 | |------|------| | 任务未配置报工人 | 无人可报工,不在任何人的工作台显示 | | 任务已配置报工人 | 仅列表内人员可以创建、修改、提交报工单 | | 新建任务未指定报工人 | 自动取工作站配置人员作为报工人 | | 批量一键排产 | 创建任务时自动带工作站配置人员作为报工人 | | 工作台任务列表 | 调用 `pending-feedback-page` 时传 `onlyMine=true`,仅显示报工人含自己的任务 | | 工作台工作站卡片 | 调用 `pending-count-by-workstation` 时传 `onlyMine=true`,任务数口径与列表一致 | | 管理端任务台账 | 不传 `onlyMine`,查看全部任务 | | 报工导入 | 复用创建/修改校验,导入人需为任务报工人 | ## 注意事项 - 新增错误码 `1_040_506_018`:「您不是该生产任务的报工人,无法报工」,前端可直接展示后端 message。 - `assigneeUserIds` 更新语义:`null` 不修改,空数组清空报工人(清空后该任务无人可报工),非空数组覆盖。 - 任务表需先执行迁移脚本 `scripts/task-reporter-20261107/01_ddl.sql` 增加 `assignee_user_ids` 列。 - 历史任务已通过 `scripts/task-reporter-20261107/02_backfill.sql` 按工作站人员回填报工人;工作站未配置人员(岗位)的任务仍为空,这些任务在补齐报工人前不会出现在工作台。 - 工作站人员取自「工作站-岗位」配置(`mes_md_workstation_worker`)下所有启用用户。