package com.klp.service;

import com.klp.domain.bo.ImageRecognitionBo;
import com.klp.domain.vo.ImageRecognitionVo;

import java.util.List;
import java.util.Map;

/**
 * 图片识别服务接口
 *
 * @author klp
 * @date 2025-01-27
 */
public interface IImageRecognitionService {

    /**
     * 识别图片内容
     *
     * @param bo 识别请求参数
     * @return 识别结果
     */
    ImageRecognitionVo recognizeImage(ImageRecognitionBo bo);

    /**
     * 批量识别图片
     *
     * @param boList 识别请求参数列表
     * @return 识别结果列表
     */
    List<ImageRecognitionVo> recognizeImages(List<ImageRecognitionBo> boList);

    /**
     * 识别BOM内容
     *
     * @param bo 识别请求参数
     * @return BOM识别结果
     */
    ImageRecognitionVo recognizeBom(ImageRecognitionBo bo);

    /**
     * 识别文字内容
     *
     * @param bo 识别请求参数
     * @return 文字识别结果
     */
    ImageRecognitionVo recognizeText(ImageRecognitionBo bo);

    /**
     * 测试AI连接
     *
     * @return 连接测试结果
     */
    Map<String, Object> testAiConnection();

    /**
     * 获取识别配置
     *
     * @return 配置信息
     */
    Map<String, Object> getRecognitionConfig();

    /**
     * 更新识别配置
     *
     * @param config 配置信息
     */
    void updateRecognitionConfig(Map<String, Object> config);

    /**
     * 获取识别历史
     *
     * @param pageQuery 分页查询参数
     * @return 识别历史列表
     */
    Map<String, Object> getRecognitionHistory(Map<String, Object> pageQuery);
}