DD.WellWorkover.Cloud/AsbCloudApp/Repositories/IFaqRepository.cs

using AsbCloudApp.Data;
using System.Collections.Generic;
using System.Threading.Tasks;
using System.Threading;
using AsbCloudApp.Requests;
using AsbCloudApp.Services;

namespace AsbCloudApp.Repositories
{
    /// <summary>
    /// репозиторий по работе с faq-вопросами
    /// </summary>
    public interface IFaqRepository 
    {
        /// <summary>
        /// Получить список вопросов
        /// </summary>
        /// <param name="request"></param>
        /// <param name="token"></param>
        /// <returns></returns>
        Task<IEnumerable<FaqDto>> GetFilteredAsync(FaqRequest request, CancellationToken token);

        /// <summary>
        /// Добавить вопрос
        /// </summary>
        /// <param name="faqDto"></param>
        /// <param name="token"></param>
        /// <returns></returns>
        Task<int> InsertAsync(FaqDto faqDto, CancellationToken token);

        /// <summary>
        /// Обновить существующий вопрос
        /// </summary>
        /// <param name="dto"></param>
        /// <param name="token"></param>
        /// <returns></returns>
        Task<int> UpdateAsync(FaqDto dto, CancellationToken token);

        /// <summary>
        /// Объединить 2 вопроса в 1
        /// </summary>
        /// <param name="sourceId1">ключ первого вопроса, подлежащего объединению</param>
        /// <param name="sourceId2">ключ второго вопроса, подлежащего объединению</param>        
        /// <param name="mergeQuestions">Флаг, объединять текст вопросов или нет</param>
        /// <param name="token"></param>
        /// <returns></returns>
        Task<int> MergeAsync(int sourceId1, int sourceId2, bool mergeQuestions, CancellationToken token);

        /// <summary>
        /// Пометить вопрос по id как удаленный
        /// </summary>
        /// <param name="id"></param>
        /// <param name="token"></param>
        /// <returns></returns>
        Task<int> MarkAsDeletedAsync(int id, CancellationToken token);

        /// <summary>
        /// Удалить вопрос по ключу
        /// </summary>
        /// <param name="id"></param>
        /// <param name="token"></param>
        /// <returns></returns>
        Task<int> DeleteAsync(int id, CancellationToken token);
    }
}