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 ITrainingJobAppService
{
    /// <summary>
    /// 提交训练任务。
    /// </summary>
    /// <param name="command">提交训练任务命令。</param>
    /// <param name="cancellationToken">取消令牌。</param>
    /// <returns>训练任务ID。</returns>
    Task<Result<Guid>> SubmitAsync(SubmitTrainingJobCommand command, CancellationToken cancellationToken = default);

    /// <summary>
    /// 取消训练任务。
    /// </summary>
    /// <param name="command">取消训练任务命令。</param>
    /// <param name="cancellationToken">取消令牌。</param>
    /// <returns>操作结果。</returns>
    Task<Result> CancelAsync(CancelTrainingJobCommand command, CancellationToken cancellationToken = default);

    /// <summary>
    /// 获取训练任务详情。
    /// </summary>
    /// <param name="trainingJobId">训练任务ID。</param>
    /// <param name="cancellationToken">取消令牌。</param>
    /// <returns>训练任务详情。</returns>
    Task<Result<TrainingJobDetailDto>> GetDetailAsync(Guid trainingJobId, CancellationToken cancellationToken = default);

    /// <summary>
    /// 获取训练任务分页列表。
    /// </summary>
    /// <param name="query">查询条件。</param>
    /// <param name="cancellationToken">取消令牌。</param>
    /// <returns>训练任务分页列表。</returns>
    Task<Result<PagedResult<TrainingJobListItemDto>>> GetPagedListAsync(TrainingJobQueryDto query, CancellationToken cancellationToken = default);
}