using OrpaonVision.Core.Annotation.Contracts;
using OrpaonVision.Core.Results;

namespace OrpaonVision.Core.Annotation;

/// <summary>
/// 标注同步应用服务接口。
/// 
/// 职责：
/// - 发起本地标注任务与 CVAT 任务的同步；
/// - 查询任务同步状态，供配置端界面展示。
/// </summary>
public interface IAnnotationSyncAppService
{
    /// <summary>
    /// 发起同步。
    /// </summary>
    Task<Result> SyncProjectAsync(SyncAnnotationProjectCommand command, CancellationToken cancellationToken = default);

    /// <summary>
    /// 查询同步状态。
    /// </summary>
    Task<Result<AnnotationSyncStatusDto>> GetSyncStatusAsync(Guid projectId, CancellationToken cancellationToken = default);

    /// <summary>
    /// 查询 CVAT 任务详情。
    /// </summary>
    Task<Result<AnnotationTaskDetailDto>> GetTaskDetailAsync(long cvatTaskId, CancellationToken cancellationToken = default);
}