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

import cn.iocoder.yudao.module.qcreport.controller.admin.aiimport.vo.QcReportAiDraftReqVO;
import cn.iocoder.yudao.module.qcreport.controller.admin.aiimport.vo.QcReportAiDraftRespVO;

/**
 * AI 导入 Service 接口：读文件 → 出模板草稿。
 *
 * <h3>为什么是同步接口</h3>
 * 一次导入要等 10～60 秒。做成异步需要任务表 + 轮询 + 线程池，而它换来的只是「用户可以先去干别的」——
 * 但草稿只作参考，用户等结果和去干别的再回来，拿到的行为完全一样。为一个不改变结果的体验
 * 引入一张表和一个线程池，不划算。
 *
 * <h3>为什么不落库</h3>
 * 草稿只给人在设计器里确认，不需要一个能按 ID 回查的实体。不落库意味着失败、重试、放弃
 * 都不留下任何需要清理的行；而「保存」仍然是既有的 {@code createVersion} / {@code updateVersion}，
 * Schema 校验（含判定规则）那道闸门自动生效，不存在第二条落库路径。
 */
public interface QcReportAiImportService {

    /**
     * 识别文件，返回模板草稿。
     *
     * @param reqVO 请求参数（文件 blobId、组件清单、补充说明）
     * @return 模板草稿，含软提示
     */
    QcReportAiDraftRespVO generateDraft(QcReportAiDraftReqVO reqVO);

}