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

import cn.iocoder.yudao.module.mes.api.qc.dto.MesQcReportRespDTO;

/**
 * MES 质检单（来料/过程/出货/退货检验）数据 API 接口
 * <p>
 * 供智能质检报告平台（qcreport 模块）把质检单渲染成报告使用。
 * <p>
 * 只暴露「一张质检单的完整可报告数据」，不暴露 MES 的任何 DO / Mapper：
 * 调用方拿到的是自解释的业务数据（名称已解析成中文），不需要认识 mes_qc_* 表结构。
 * 换句话说，MES 数据模型怎么改，都只影响本接口的实现，不影响调用方。
 */
public interface MesQcReportApi {

    /**
     * 获取一张质检单的可报告数据
     * <p>
     * 不在这里做「能不能出报告」的业务校验（未完成、未判定等），只如实返回数据：
     * 校验与拒绝文案属于报告平台的口径，由调用方按 status / checkResult 判断。
     *
     * @param qcType 质检类型，见 MesQcTypeEnum：1 来料 2 过程 3 出货 4 退货
     * @param qcId   质检单编号
     * @return 质检单数据；单据不存在时返回 null
     */
    MesQcReportRespDTO getQcReportData(Integer qcType, Long qcId);

}