persistence/Persistence.Client/Clients/IChangeLogClient.cs

using Microsoft.AspNetCore.Mvc;
using Persistence.Models;
using Persistence.Models.Requests;
using Refit;

namespace Persistence.Client.Clients;

/// <summary>
/// Интерфейс для тестирования API, предназначенного для работы с записями ChangeLod
/// </summary>
public interface IChangeLogClient
{
	private const string BaseRoute = "/api/ChangeLog";

    //[Get($"{BaseRoute}/current")]
    /// <summary>
    /// Импорт с заменой: удаление старых строк и добавление новых
    /// </summary>
    /// <param name="idDiscriminator"></param>
    /// <param name="dtos"></param>
    /// <returns></returns>
    [Post($"{BaseRoute}/replace")]
    Task<IApiResponse<int>> ClearAndInsertRange(Guid idDiscriminator, IEnumerable<DataWithWellDepthAndSectionDto> dtos);

    ///// <summary>
    ///// Получение данных на текущую дату (с пагинацией)
    ///// </summary>
    ///// <param name="idDiscriminator"></param>
    ///// <param name="request">параметры запроса</param>
    ///// <param name="token"></param>
    ///// <returns></returns>
    //Task<IActionResult> GetCurrent(Guid idDiscriminator, SectionPartRequest request, CancellationToken token);

    /// <summary>
    /// Получение данных на определенную дату (с пагинацией)
    /// </summary>
    /// <param name="idDiscriminator"></param>
    /// <param name="moment"></param>
    /// <param name="request">параметры запроса</param>
    /// <param name="token"></param>
    /// <returns></returns>
    [Get($"{BaseRoute}/moment")]
    Task<IApiResponse<PaginationContainer<DataWithWellDepthAndSectionDto>>> GetByDate(Guid idDiscriminator, DateTimeOffset moment, [Query]SectionPartRequest request);

    /// <summary>
    /// Получение исторических данных за определенный период времени
    /// </summary>
    /// <param name="idDiscriminator"></param>
    /// <param name="dateBegin"></param>
    /// <param name="dateEnd"></param>
    /// <param name="token"></param>
    /// <returns></returns>
    [Get($"{BaseRoute}/history")]
    Task<IApiResponse<IEnumerable<ChangeLogDto>>> GetChangeLogForDate(Guid idDiscriminator, DateTimeOffset dateBegin, DateTimeOffset dateEnd);

    /// <summary>
    /// Добавить одну запись 
    /// </summary>
    /// <param name="idDiscriminator"></param>
    /// <param name="dto"></param>
    /// <returns></returns>
    [Post($"{BaseRoute}")]
    Task<IApiResponse<int>> Add(Guid idDiscriminator, DataWithWellDepthAndSectionDto dto);

    /// <summary>
    /// Добавить несколько записей
    /// </summary>
    /// <param name="idDiscriminator"></param>
    /// <param name="dtos"></param>
    /// <param name="token"></param>
    /// <returns></returns>
    [Post($"{BaseRoute}/range")]
    Task<IApiResponse<int>> AddRange(Guid idDiscriminator, IEnumerable<DataWithWellDepthAndSectionDto> dtos);

    /// <summary>
    /// Обновить одну запись
    /// </summary>
    /// <param name="idDiscriminator"></param>
    /// <param name="dto"></param>
    /// <returns></returns>
    [Put($"{BaseRoute}")]
    Task<IApiResponse<int>> Update(Guid idDiscriminator, DataWithWellDepthAndSectionDto dto);

    /// <summary>
    /// Обновить несколько записей
    /// </summary>
    /// <param name="idDiscriminator"></param>
    /// <param name="dtos"></param>
    /// <param name="token"></param>
    /// <returns></returns>
    [Put($"{BaseRoute}/range")]
    Task<IApiResponse<int>> UpdateRange(Guid idDiscriminator, IEnumerable<DataWithWellDepthAndSectionDto> dtos);

    /// <summary>
    /// Удалить одну запись
    /// </summary>
    /// <param name="id"></param>
    /// <param name="token"></param>
    /// <returns></returns>
    [Delete($"{BaseRoute}")]
    Task<IApiResponse<int>> Delete(Guid id);

    /// <summary>
    /// Удалить несколько записей
    /// </summary>
    /// <param name="ids"></param>
    /// <param name="token"></param>
    /// <returns></returns>
    [Delete($"{BaseRoute}/range")]
    Task<IApiResponse<int>> DeleteRange([Body] IEnumerable<Guid> ids);

    /// <summary>
    /// Получение списка дат, в которые происходили изменения (день, месяц, год, без времени)
    /// </summary>
    /// <param name="idDiscriminator"></param>
    /// <param name="token"></param>
    /// <returns></returns>
    [Get($"{BaseRoute}/datesRange")]
    Task<IApiResponse<DatesRangeDto?>> GetDatesRange(Guid idDiscriminator);

}