ITaskTemplateRepository.cs 2.42 KB
using System.Collections.Generic;
using System.Threading;
using System.Threading.Tasks;
using Rcs.Domain.Entities;

namespace Rcs.Domain.Repositories
{
    /// <summary>
    /// 任务模板仓储接口
    /// </summary>
    public interface ITaskTemplateRepository : IRepository<TaskTemplate>
    {
        /// <summary>
        /// 根据模板编码获取模板
        /// </summary>
        Task<TaskTemplate?> GetByTemplateCodeAsync(
            string templateCode,
            CancellationToken cancellationToken = default);

        /// <summary>
        /// 获取所有启用的模板
        /// </summary>
        Task<IEnumerable<TaskTemplate>> GetEnabledAsync(
            CancellationToken cancellationToken = default);

        /// <summary>
        /// 根据机器人类型获取模板列表
        /// </summary>
        Task<IEnumerable<TaskTemplate>> GetByRobotTypeAsync(
            RobotType robotType,
            CancellationToken cancellationToken = default);

        /// <summary>
        /// 获取包含所有步骤的模板
        /// </summary>
        Task<TaskTemplate?> GetWithStepsAsync(
            Guid templateId,
            CancellationToken cancellationToken = default);

        /// <summary>
        /// 根据模板编码获取包含所有步骤的模板
        /// </summary>
        Task<TaskTemplate?> GetWithStepsByCodeAsync(
            string templateCode,
            CancellationToken cancellationToken = default);

        /// <summary>
        /// 获取包含所有详细信息的模板(步骤、属性、动作)
        /// </summary>
        Task<TaskTemplate?> GetWithFullDetailsAsync(
            Guid templateId,
            CancellationToken cancellationToken = default);

        /// <summary>
        /// 获取指定机器人类型和制造商的默认模板
        /// @author zzy
        /// </summary>
        /// <param name="robotType">机器人类型</param>
        /// <param name="manufacturer">制造商</param>
        /// <param name="excludeTemplateId">排除的模板ID(用于更新时排除自身)</param>
        /// <param name="cancellationToken">取消令牌</param>
        /// <returns>默认模板,如果不存在则返回null</returns>
        Task<TaskTemplate?> GetDefaultTemplateAsync(
            RobotType robotType,
            string? manufacturer,
            Guid? excludeTemplateId = null,
            CancellationToken cancellationToken = default);
    }
}