/**
 * @ProjectName: 智慧评标-主观分助手
 * @Package: com.zhpb.gdyd_zhpb_zgf.service
 * @ClassName: ComparisonService
 * @Description: 供应商对比分析服务接口
 * @Author: 张志锋
 * @Date: 2025-11-04
 * @Version: 1.0
 * @Copyright: © 2025 智慧评标-主观分助手
 */
package com.zhpb.gdyd_zhpb_zgf.service;

import com.zhpb.gdyd_zhpb_zgf.dto.ComparisonRequest;
import com.zhpb.gdyd_zhpb_zgf.dto.ComparisonResponse;

/**
 * 供应商对比分析服务接口
 */
public interface ComparisonService {

    /**
     * 获取指定项目的供应商数据
     *
     * @param projectId 项目ID
     * @return 供应商数据
     */
    ComparisonResponse.VendorsData getProjectVendors(String projectId);

    /**
     * 启动供应商对比分析任务
     *
     * @param request 对比分析请求
     * @return 任务启动结果
     */
    ComparisonResponse.StartTaskData startComparison(ComparisonRequest request);

    /**
     * 获取用户在指定项目的对比任务历史
     *
     * @param projectId 项目ID
     * @param userId 用户ID
     * @return 任务历史列表
     */
    ComparisonResponse.TaskHistoryData getComparisonHistory(String projectId, String userId);

    /**
     * 获取对比任务结果
     *
     * @param taskId 任务ID
     * @return 对比结果
     */
    ComparisonResponse.ComparisonResultData getComparisonResult(String taskId);
}
