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

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

namespace AsbCloudApp.Repositories;

/// <summary>
/// Интерфейс для работы с объектами, содержащими историю изменений
/// </summary>
/// <typeparam name="TDto"></typeparam>
/// <typeparam name="TRequest"></typeparam>
public interface IChangeLogQueryBuilder<TDto, TRequest>
    where TDto : IId
{
    /// <summary>
    /// Применение запроса
    /// </summary>
    /// <param name="request">Запрос</param>
    /// <returns></returns>
    IChangeLogQueryBuilderWithKnownTimezone<TDto, TRequest> ApplyRequest(TRequest request);

    /// <summary>
    /// Материализация записей
    /// </summary>
    /// <param name="offset"></param>
    /// <param name="token"></param>
    /// <returns></returns>
    Task<IEnumerable<TDto>> GetData(TimeSpan offset, CancellationToken token);

    /// <summary>
    /// Материализация записей с историей
    /// </summary>
    /// <param name="offset"></param>
    /// <param name="token"></param>
    /// <returns></returns>
    Task<IEnumerable<ChangeLogDto<TDto>>> GetChangeLogData(TimeSpan offset, CancellationToken token);
}

/// <summary>
/// Интерфейс для работы с объектами, содержащими историю изменений. С известной временной зоной
/// </summary>
/// <typeparam name="TDto"></typeparam>
/// <typeparam name="TRequest"></typeparam>
public interface IChangeLogQueryBuilderWithKnownTimezone<TDto, TRequest>: IChangeLogQueryBuilder<TDto, TRequest>
    where TDto : IId
{
    /// <summary>
    /// Материализация записей. Временная зона определяется по запросу из последнего ApplyRequest
    /// </summary>
    /// <param name="token"></param>
    /// <returns></returns>
    Task<IEnumerable<TDto>> GetData(CancellationToken token);

    /// <summary>
    /// Материализация записей с историей. Временная зона определяется по запросу из последнего ApplyRequest
    /// </summary>
    /// <param name="token"></param>
    /// <returns></returns>
    Task<IEnumerable<ChangeLogDto<TDto>>> GetChangeLogData(CancellationToken token);
}