using OrpaonVision.Core.Results;
using OrpaonVision.Core.Training.Contracts;
using OrpaonVision.Core.Training.Contracts.Commands;
using OrpaonVision.Core.Training.Contracts.Queries;

namespace OrpaonVision.Core.Training;

/// <summary>
/// 数据集应用服务接口。
/// </summary>
public interface IDatasetAppService
{
    /// <summary>
    /// 构建数据集版本。
    /// </summary>
    /// <param name="command">构建数据集命令。</param>
    /// <param name="cancellationToken">取消令牌。</param>
    /// <returns>数据集版本ID。</returns>
    Task<Result<Guid>> BuildDatasetAsync(BuildDatasetCommand command, CancellationToken cancellationToken = default);

    /// <summary>
    /// 获取数据集版本详情。
    /// </summary>
    /// <param name="datasetVersionId">数据集版本ID。</param>
    /// <param name="cancellationToken">取消令牌。</param>
    /// <returns>数据集版本详情。</returns>
    Task<Result<DatasetVersionDetailDto>> GetDetailAsync(Guid datasetVersionId, CancellationToken cancellationToken = default);

    /// <summary>
    /// 获取数据集版本分页列表。
    /// </summary>
    /// <param name="query">查询条件。</param>
    /// <param name="cancellationToken">取消令牌。</param>
    /// <returns>数据集版本分页列表。</returns>
    Task<Result<PagedResult<DatasetVersionListItemDto>>> GetPagedListAsync(DatasetVersionQueryDto query, CancellationToken cancellationToken = default);
}