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

import cn.iocoder.yudao.module.mes.controller.admin.pro.feedback.vo.MesProFeedbackSaveReqVO;
import cn.iocoder.yudao.module.mes.controller.admin.pro.worktime.vo.MesProWorktimeCalcReqVO;
import cn.iocoder.yudao.module.mes.controller.admin.pro.worktime.vo.MesProWorktimeCalcRespVO;
import cn.iocoder.yudao.module.mes.dal.dataobject.pro.feedback.MesProFeedbackAuxDO;
import cn.iocoder.yudao.module.mes.dal.dataobject.pro.feedback.MesProFeedbackDO;
import jakarta.validation.Valid;

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

/**
 * MES 标准工时计算 Service 接口
 *
 * <p>标准工时只用于工时考核对比，不参与工资计算；工资始终按实际报工工时/数量计算。
 *
 * @author 超级管理员
 */
public interface MesProWorktimeService {

    /**
     * 按生产任务 + 生产长度 + 辅助项次数试算标准工时
     */
    MesProWorktimeCalcRespVO calculate(@Valid MesProWorktimeCalcReqVO reqVO);

    /**
     * 计算报工单的标准工时快照，并生成辅助工时明细（未入库）
     *
     * <p>计算条件缺失时不阻断报工，标准工时记 0 并在 stdCalcNote 写明原因。
     *
     * @return 待随报工一起保存的辅助工时明细（已填好 minutes）
     */
    List<MesProFeedbackAuxDO> calculateForFeedback(MesProFeedbackDO feedback,
                                                   List<MesProFeedbackSaveReqVO.AuxValue> auxValues);

    /**
     * 生成工时超出阈值的提示文案
     *
     * @return 未超阈值或无法比较时返回 null
     */
    String buildWarnMessage(BigDecimal actualHours, BigDecimal standardHours);

}