persistence/DD.Persistence/Repositories/ITimestampedValuesRepository.cs

using DD.Persistence.Models;
using DD.Persistence.RepositoriesAbstractions;

namespace DD.Persistence.Repositories;

/// <summary>
/// Репозиторий для работы с временными данными
/// </summary>
public interface ITimestampedValuesRepository : ISyncRepository, ITimeSeriesBaseRepository
{ 
    /// <summary>
    /// Добавление записей
    /// </summary>
    /// <param name="idDiscriminator">Дискриминатор (идентификатор) набора</param>
    /// <param name="dtos"></param>
    /// <param name="token"></param>
    /// <returns></returns>
    Task<int> AddRange(Guid idDiscriminator, IEnumerable<TimestampedValuesDto> dtos, CancellationToken token);

    /// <summary>
    /// Количество записей по указанному набору в БД. Для пагинации
    /// </summary>
    /// <param name="idDiscriminator">Дискриминатор (идентификатор) набора</param>
    /// <param name="token"></param>
    /// <returns></returns>
    Task<int> Count(Guid idDiscriminator, CancellationToken token);

    /// <summary>
    /// Получение данных с фильтрацией. Значение фильтра null - отключен
    /// </summary>
    /// <param name="idDiscriminator">Дискриминатор (идентификатор) набора</param>
    /// <param name="geTimestamp">Фильтр позднее даты</param>
    /// <param name="columnNames">Фильтр свойств набора. Можно запросить только некоторые свойства из набора</param>
    /// <param name="skip"></param>
    /// <param name="take"></param>
    /// <param name="token"></param>
    /// <returns></returns>
    Task<IEnumerable<Tuple<DateTimeOffset, object[]>>> Get(Guid idDiscriminator,
        DateTimeOffset? geTimestamp,
        IEnumerable<string>? columnNames,
        int skip,
        int take,
        CancellationToken token);

    /// <summary>
    /// Получение данных с начала
    /// </summary>
    /// <param name="discriminatorId">Дискриминатор (идентификатор) набора</param>
    /// <param name="takeCount">Количество</param>
    /// <param name="token"></param>
    /// <returns></returns>
    Task<IEnumerable<Tuple<DateTimeOffset, object[]>>> GetFirst(Guid discriminatorId, int takeCount, CancellationToken token);

    /// <summary>
    /// Получение данных с конца
    /// </summary>
    /// <param name="discriminatorId">Дискриминатор (идентификатор) набора</param>
    /// <param name="takeCount">Количество</param>
    /// <param name="token"></param>
    /// <returns></returns>
    Task<IEnumerable<Tuple<DateTimeOffset, object[]>>> GetLast(Guid discriminatorId, int takeCount, CancellationToken token);
}