package cn.iocoder.yudao.module.mes.service.pro.feedback;

import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.mes.controller.admin.pro.feedback.vo.MesProFeedbackPageReqVO;
import cn.iocoder.yudao.module.mes.controller.admin.pro.feedback.vo.MesProFeedbackSaveReqVO;
import cn.iocoder.yudao.module.mes.dal.dataobject.pro.feedback.MesProFeedbackDO;
import jakarta.validation.Valid;

import java.math.BigDecimal;
import java.util.Collection;
import java.util.List;

/**
 * MES 生产报工 Service 接口
 *
 * @author 芋道源码
 */
public interface MesProFeedbackService {

    /**
     * 创建生产报工（草稿）
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createFeedback(@Valid MesProFeedbackSaveReqVO createReqVO);

    /**
     * 修改生产报工
     *
     * @param updateReqVO 更新信息
     */
    void updateFeedback(@Valid MesProFeedbackSaveReqVO updateReqVO);

    /**
     * 删除生产报工（仅草稿）
     *
     * @param id 编号
     */
    void deleteFeedback(Long id);

    /**
     * 获得生产报工
     *
     * @param id 编号
     * @return 生产报工
     */
    MesProFeedbackDO getFeedback(Long id);

    /**
     * 校验生产报工存在
     *
     * @param id 编号
     * @return 生产报工
     */
    MesProFeedbackDO validateFeedbackExists(Long id);

    /**
     * 获得生产报工分页
     *
     * @param pageReqVO 分页查询
     * @return 生产报工分页
     */
    PageResult<MesProFeedbackDO> getFeedbackPage(MesProFeedbackPageReqVO pageReqVO);

    /**
     * 按任务编号列表批量获得报工记录（用于任务台账聚合在途/已审批报工量）
     *
     * @param taskIds 任务编号列表
     * @return 报工记录列表
     */
    List<MesProFeedbackDO> getFeedbackListByTaskIds(Collection<Long> taskIds);

    /**
     * 按任务编号获得报工记录列表（报工历史，含草稿/审批中/待检验/已完成）
     *
     * @param taskId 任务编号
     * @return 报工记录列表
     */
    List<MesProFeedbackDO> getFeedbackListByTaskId(Long taskId);

    /**
     * 提交报工（草稿 → 审批中）
     *
     * @param id 编号
     */
    void submitFeedback(Long id);

    /**
     * 驳回报工（审批中 → 草稿）
     *
     * @param id 编号
     */
    void rejectFeedback(Long id);

    /**
     * 审批通过报工单，执行生产入库流程
     *
     * <p>整体流程如下：
     * <ol>
     *   <li>校验报工单状态和数量</li>
     *   <li>生成物料消耗单，扣减线边库物料</li>
     *   <li>根据工序配置（关键工序 & 是否需要检验）分情况处理：
     *     <ul>
     *       <li><b>关键工序 + 需要检验</b>：生成产出单（质量状态=待检验），报工单状态 → 待检验，等待质检完成回调</li>
     *       <li><b>关键工序 + 无需检验</b>：生成产出单（按合格/不合格拆行），执行产品入库，更新任务/工单已生产数量，报工单状态 → 已完成</li>
     *       <li><b>非关键工序</b>：不生成产出单，不更新任务/工单数量，报工单状态 → 已完成</li>
     *     </ul>
     *   </li>
     * </ol>
     *
     * @param id 报工单编号
     * @return true=已完成, false=待检验（需等质检回调）
     */
    boolean approveFeedback(Long id);

    /**
     * IPQC 完成后回调：完成报工单并更新任务/工单进度
     *
     * <p>由 IPQC 检验完成时调用，将报工单状态从待检验改为已完成，
     * 并根据检验结果回写合格/不合格/废品数量，同时更新任务/工单的已生产数量。
     *
     * @param feedbackId          报工记录 ID
     * @param sourceLineId        来源产出行 ID（用于直接定位待检行）
     * @param qualifiedQty        合格品数量
     * @param unqualifiedQty      不合格品数量
     * @param laborScrapQty       工废数量
     * @param materialScrapQty    料废数量
     * @param otherScrapQty       其他废品数量
     */
    void updateProFeedbackWhenIpqcFinish(Long feedbackId, Long sourceLineId,
                                         BigDecimal qualifiedQty, BigDecimal unqualifiedQty,
                                         BigDecimal laborScrapQty, BigDecimal materialScrapQty, BigDecimal otherScrapQty);

}