hhzz-work-order

工单管理

开始前阅读 ../hhzz-shared/SKILL.md。查询读取目标操作的 --help；写入先读取 hhzz-cli schema work-order <操作>。

何时使用

用户需要查询单张工单的基本、来源、产出、用料、工序计划或下发信息，或者导入、下发工单时使用。

不在本 Skill 范围

• 从新品主数据开始建立生产定义并准备工单时使用 hhzz-production-launch。
• 判断工单能否开工或缺哪些物料时使用 hhzz-work-order-readiness。
• 不负责领料、投料、报工、完工或其他现场生产执行。

目标与完成边界

查询完成于目标工单各视图可查回；导入完成于产出、用料和工序计划与请求一致；下发完成于工单状态和关联任务证据可查。下发或任务生成不代表生产开始。

必要输入或前置条件

需要唯一工单编号或 ID。导入前确认主产出、计划时间和数量有效；使用 BOM 和路线时，还要有成品自制信息、生产单位、目标 BOM 版本和路线状态的查询证据。

命令选择

• 通用筛选使用 work-order list；基本、来源、产出、用料、工序计划和下发信息使用当前 detail 子操作。
• 导入使用 work-order import，下发使用 work-order issue；字段合同只从对应 schema 获取。

关键业务约束

• 导入前确认主产出有且只有一行、计划时间和数量有效。使用 BOM 和工艺路线时，必须先确认主产出物料包含自制业务范围且生产单位有效，显式目标 BOM 版本已启用，BOM 关联路线或主产出指定路线已启用、适用于该成品且节点有效；任一条件无法查证时停止导入。
• 演示和可重复执行时显式填写已验收的 BOM 版本与路线编号，不依赖租户默认版本。BOM 已关联路线时，以该关联路线的回查结果为准。
• 下发前先查询工单当前状态、产出、用料和工序计划；状态不允许下发或生产关系不完整时，向用户说明阻塞项，不执行状态变更。
• 当前没有公开的工单撤回命令。下发会生成生产任务，属于不可逆状态变化；业务审计必须明确展示这一影响并取得用户确认。
• 导入和下发先 --dry-run，授权后 --confirm。

重复执行与错误恢复

• 服务端可能把多项导入校验折叠为通用错误。遇到“工单导入失败”“系统异常”或结果未知时，先按唯一工单编号查询基本信息；已落库则禁止重试，未落库则返回已验证前置和阻塞，不得只据该错误断言接口完全不可用。
• 工单已下发时禁止重复下发；部分完成时从最短未完成步骤继续。

结果与证据

导入后查询基本、产出、用料和工序计划，下发后查询工单状态及生产任务。返回工单编号、计划数量、BOM、路线、状态和下一步；工单已下发或任务已生成都不表示已经领料、投料、报工或完工。