package cn.iocoder.yudao.module.mes.api.workorder;

import cn.iocoder.yudao.module.mes.api.workorder.dto.MesProWorkOrderCreateReqDTO;

/**
 * MES 生产工单 API 接口
 *
 * <p>供 CRM 模块调用，实现合同指令「下发」真实跨模块联动：执行指令时确认目标工单、
 * 取消指令时取消目标工单，使 CRM 合同指令不再只是记录与状态流转。
 *
 * <p>同时供 BI 决策支持模块调用，实现「负荷预测」联动创建运维/发电/检修类工单。
 *
 * @author 超级管理员
 */
public interface MesProWorkOrderApi {

    /**
     * 确认工单（草稿 → 已确认）
     *
     * <p>用于合同指令「下发表」执行时，将指令关联的工单从草稿状态下发为已确认。
     *
     * @param id 工单编号
     */
    void confirmWorkOrder(Long id);

    /**
     * 取消工单（已确认 → 已取消）
     *
     * <p>用于合同指令取消时，同步取消已下发的目标工单。
     *
     * @param id 工单编号
     */
    void cancelWorkOrder(Long id);

    /**
     * 创建工单（草稿状态）
     *
     * <p>用于决策支持「负荷预测」联动创建运维/发电/检修类生产工单。
     *
     * @param reqDTO 创建请求
     * @return 工单编号
     */
    Long createWorkOrder(MesProWorkOrderCreateReqDTO reqDTO);

}