package cn.iocoder.yudao.module.mes.service.pd.techconfirm;

import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.mes.controller.admin.pd.techconfirm.vo.ProductTechConfirmPageReqVO;
import cn.iocoder.yudao.module.mes.controller.admin.pd.techconfirm.vo.ProductTechConfirmSaveReqVO;
import cn.iocoder.yudao.module.mes.dal.dataobject.pd.techconfirm.ProductTechConfirmDO;

import java.util.Set;

/**
 * MES 产品技术确认函 Service 接口
 *
 * 状态流转完全由业务流程驱动，不接受前端直接指定状态：
 * <pre>
 *   0 草稿 --提交审核--> 1 待审核 --审核通过--> 2 已审核 --客户确认--> 3 客户已确认
 *      ^                    |
 *      |                    +--审核不通过--> 4 审核不通过
 *      |                                        |
 *      +----------------------------------------+  审核不通过可修改后重新提交
 * </pre>
 * 只有草稿与审核不通过状态允许修改业务字段，待审核 / 已审核 / 客户已确认为锁定或终态。
 *
 * @author 超级管理员
 */
public interface ProductTechConfirmService {

    /**
     * 创建技术确认函
     *
     * 状态固定为草稿，编制人 / 编制时间取当前登录用户与当前时间。
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createTechConfirm(ProductTechConfirmSaveReqVO createReqVO);

    /**
     * 修改技术确认函
     *
     * 仅草稿与审核不通过状态允许修改，其余状态一律拒绝。
     *
     * @param updateReqVO 修改信息
     */
    void updateTechConfirm(ProductTechConfirmSaveReqVO updateReqVO);

    /**
     * 删除技术确认函
     *
     * 仅草稿与审核不通过状态允许删除。
     *
     * @param id 编号
     */
    void deleteTechConfirm(Long id);

    /**
     * 获得技术确认函
     *
     * @param id 编号
     * @return 技术确认函
     */
    ProductTechConfirmDO getTechConfirm(Long id);

    /**
     * 获得技术确认函分页
     *
     * @param pageReqVO 分页查询
     * @return 技术确认函分页
     */
    PageResult<ProductTechConfirmDO> getTechConfirmPage(ProductTechConfirmPageReqVO pageReqVO);

    /**
     * 提交审核（草稿 / 审核不通过 → 待审核）
     *
     * 审核人由「系统管理 - 审批配置」按业务类型统一配置（业务编码 pd_tech_confirm_approve），
     * 提交时无需指定；未启用审批或未配置有效审核人时抛出业务异常。
     *
     * @param id 编号
     */
    void submitTechConfirmAudit(Long id);

    /**
     * 获得技术确认函审核的审核人编号集合
     *
     * 供前端判断当前登录用户是否应展示「审核」按钮；未配置时返回空集合。
     *
     * @return 审核人用户编号集合
     */
    Set<Long> getTechConfirmApproverUserIds();

    /**
     * 审核技术确认函（待审核 → 已审核 / 审核不通过）
     *
     * 仅业务编码 pd_tech_confirm_approve 配置的审核人可操作（多人时或签），且仅在待审核状态下允许。
     * 审核通过记录审核人与审核时间；审核不通过必须填写不通过原因，
     * 使单据退回可修改状态，由编制人修改后重新提交。
     *
     * @param id           编号
     * @param pass         是否通过，true=通过 / false=不通过
     * @param reviewRemark 审核意见，审核不通过时必填
     */
    void auditTechConfirm(Long id, Boolean pass, String reviewRemark);

    /**
     * 客户确认（已审核 → 客户已确认）
     *
     * 由业务员代客户执行，记录客户确认人与客户确认时间。
     *
     * @param id                  编号
     * @param customerConfirmUser 客户确认人姓名
     */
    void confirmTechConfirmByCustomer(Long id, String customerConfirmUser);

}