import type { QualityComponentCatalog } from '#/components/quality';

import { requestClient } from '#/api/request';

export namespace QcReportAiApi {
  /** 一个组件草稿：结构完全扁平，没有 children */
  export interface DraftComponent {
    type?: string;
    /** 组件属性；后端已按积木清单过滤掉未声明的 key */
    props?: Record<string, unknown>;
  }

  /** AI 猜出的纸张配置，可能为空（为空表示沿用当前模板的纸张） */
  export interface DraftPage {
    size?: string;
    orientation?: string;
    margin?: { top?: number; right?: number; bottom?: number; left?: number };
  }

  /**
   * 识别结果：一份模板草稿，**尚未落库**。
   * <p>
   * 需人工到设计器确认并点「保存」，才会写成模板版本。
   */
  export interface DraftResp {
    components?: DraftComponent[];
    page?: DraftPage;
    /** AI 对这份文档的一句话说明 */
    summary?: string;
    /** 软提示：被跳过的页、无法表达的区块等，必须展示给用户 */
    warnings?: string[];
    durationMs?: number;
  }

  export interface DraftReq {
    /**
     * 上传文件对应的 blobId，**顺序即文档页序**。
     * <p>
     * 文件先经 /system/storage-blob/upload 上传取得 blobId；业务模块不自建上传通道。
     */
    blobIds: number[];
    /** 目标模板编号，用于日志留痕与附件归属 */
    templateId: number;
    /** 必须与设计器一致，两端不匹配时后端直接报错 */
    schemaVersion: string;
    /** 积木清单，由 buildQualityComponentCatalog() 从活注册表生成 */
    catalog: QualityComponentCatalog[];
    /** 用户补充说明，拼进提示词帮助模型理解文档 */
    hint?: string;
  }
}

/**
 * 识别文件生成模板草稿。
 * <p>
 * 同步返回且不落库，所以单独放宽超时。这个值必须比后端的耗时预算更宽：
 * 后端 `yudao.qcreport.ai-import.max-duration-seconds`（默认 180 秒，只在两次模型调用之间检查）
 * 加上单次调用超时 `yudao.ai.timeout`（默认 60 秒），最坏 240 秒。
 * 掐得比它早，用户看到的是「请求超时」这种没有指向的报错，
 * 而后端本来能给出「哪一步、为什么、怎么办」的明确提示。
 */
export function generateAiDraft(data: QcReportAiApi.DraftReq) {
  return requestClient.post<QcReportAiApi.DraftResp>(
    '/qc-report/ai-import/draft',
    data,
    { timeout: 300_000 },
  );
}