package cn.iocoder.yudao.module.qcreport.service.template;

import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.qcreport.controller.admin.template.vo.QcReportTemplatePageReqVO;
import cn.iocoder.yudao.module.qcreport.controller.admin.template.vo.QcReportTemplateSaveReqVO;
import cn.iocoder.yudao.module.qcreport.dal.dataobject.template.QcReportTemplateDO;

import java.util.Collection;
import java.util.List;

/**
 * 智能质检报告模板 Service 接口
 */
public interface QcReportTemplateService {

    /**
     * 创建报告模板
     *
     * @param createReqVO 创建信息
     * @return 模板编号
     */
    Long createTemplate(QcReportTemplateSaveReqVO createReqVO);

    /**
     * 更新报告模板
     *
     * @param updateReqVO 更新信息
     */
    void updateTemplate(QcReportTemplateSaveReqVO updateReqVO);

    /**
     * 删除报告模板（同时删除其下所有版本）
     *
     * @param id 模板编号
     */
    void deleteTemplate(Long id);

    /**
     * 复制报告模板：复制模板元数据，并把当前最新版本的 Schema 复制为副本的 v1.0 草稿
     *
     * @param id 被复制的模板编号
     * @return 新模板编号
     */
    Long copyTemplate(Long id);

    /**
     * 校验模板存在，并返回
     *
     * @param id 模板编号
     * @return 模板
     */
    QcReportTemplateDO validateTemplateExists(Long id);

    /**
     * 获得报告模板
     *
     * @param id 模板编号
     * @return 模板
     */
    QcReportTemplateDO getTemplate(Long id);

    /**
     * 获得报告模板分页
     *
     * @param pageReqVO 分页查询
     * @return 模板分页
     */
    PageResult<QcReportTemplateDO> getTemplatePage(QcReportTemplatePageReqVO pageReqVO);

    /**
     * 获得模板列表
     *
     * @param ids 模板编号集合
     * @return 模板列表
     */
    List<QcReportTemplateDO> getTemplateList(Collection<Long> ids);

    /**
     * 获得「可用于出件」的模板列表：指定报告类型、模板已启用、且当前版本处于已发布状态。
     * <p>
     * 供质检单「出报告」弹窗选模板用。多查这一层版本状态，是为了不把
     * 「选出来必然被拒」的模板摆到用户面前——模板的 current_version 可能指向一个已停用的版本，
     * 停用版本不会清空 current_version，这种模板一旦被选，出件必报 1_070_101_003。
     *
     * @param reportType 报告类型，即 mes_qc_type 的数值字符串，如 "1"
     * @return 可用模板列表
     */
    List<QcReportTemplateDO> getSelectableTemplates(String reportType);

    /**
     * 更新模板的当前版本号
     *
     * @param id      模板编号
     * @param version 版本号
     */
    void updateCurrentVersion(Long id, String version);

}