DD.WellWorkover.Cloud/AsbCloudApp/Services/IWellOperationService.cs

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

namespace AsbCloudApp.Services
{
#nullable enable
    /// <summary>
    /// сервис операций по скважине
    /// </summary>
    public interface IWellOperationService
    {
        /// <summary>
        /// список названий операций
        /// </summary>
        /// <returns></returns>
        IEnumerable<WellOperationCategoryDto> GetCategories();

        // TODO: объединить параметры в объект запроса
        /// <summary>
        /// Получить список операций
        /// </summary>
        /// <param name="request"></param>
        /// <param name="token"></param>
        /// <returns></returns>
        Task<PaginationContainer<WellOperationDto>> GetOperationsAsync(
                    WellOperationRequest request,
                    CancellationToken token);

        /// <summary>
        /// Получить статистику операции по скважине с группировкой по категориям
        /// </summary>
        /// <param name="request"></param>
        /// <param name="token"></param>
        /// <returns></returns>
        Task<IEnumerable<WellGroupOpertionDto>> GetGroupOperationsStatAsync(
                    WellOperationRequest request,
                    CancellationToken token);

        /// <summary>
        /// Получить операцию по id
        /// </summary>
        /// <param name="id"></param>
        /// <param name="token"></param>
        /// <returns></returns>
        Task<WellOperationDto?> GetOrDefaultAsync(int id, CancellationToken token);

        /// <summary>
        /// Добавить несколько операций за один раз
        /// </summary>
        /// <param name="wellOperationDtos"></param>
        /// <param name="token"></param>
        /// <returns></returns>
        Task<int> InsertRangeAsync(
            IEnumerable<WellOperationDto> wellOperationDtos, CancellationToken token);

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

        /// <summary>
        /// Удалить операции по id
        /// </summary>
        /// <param name="ids"></param>
        /// <param name="token"></param>
        /// <returns></returns>
        Task<int> DeleteAsync(IEnumerable<int> ids, CancellationToken token);

        /// <summary>
        /// Список секций
        /// </summary>
        /// <returns></returns>
        IDictionary<int, string> GetSectionTypes();

        /// <summary>
        /// дата/время первой операции по скважине
        /// </summary>
        /// <param name="idWell"></param>
        /// <returns></returns>
        DateTimeOffset? FirstOperationDate(int idWell);
    }
#nullable disable
}