OrderHub.Core/Interfaces/IOrderRepository.cs - dev - azarayaos/OrderHub

OrderHub.Core/Interfaces/IOrderRepository.cs

47 строк2 KB

Azaray AOS

Создания начального проекта с базовым функицоналом

29 июн 2026, 22:47

29 июн 2026, 22:47213f989

using OrderHub.Core.Models;

namespace OrderHub.Core.Interfaces;

/// <summary>
/// Репозиторий для работы с заказами.
/// </summary>
public interface IOrderRepository
{
    /// <summary>
    /// Получает заказ по идентификатору.
    /// </summary>
    /// <param name="id">Идентификатор заказа.</param>
    /// <param name="cancellationToken">Токен отмены операции.</param>
    /// <returns>Заказ или null, если не найден.</returns>
    Task<Order?> GetByIdAsync(Guid id, CancellationToken cancellationToken = default);

    /// <summary>
    /// Получает список заказов с пагинацией и фильтрацией по статусу.
    /// </summary>
    /// <param name="skip">Количество пропускаемых записей.</param>
    /// <param name="take">Количество возвращаемых записей.</param>
    /// <param name="status">Фильтр по статусу (опционально).</param>
    /// <param name="cancellationToken">Токен отмены операции.</param>
    /// <returns>Кортеж: список заказов и общее количество.</returns>
    Task<(List<Order> Orders, int TotalCount)> GetOrdersAsync(int skip, int take, OrderStatus? status = null, CancellationToken cancellationToken = default);

    /// <summary>
    /// Добавляет новый заказ в хранилище.
    /// </summary>
    /// <param name="order">Заказ для добавления.</param>
    /// <param name="cancellationToken">Токен отмены операции.</param>
    Task AddAsync(Order order, CancellationToken cancellationToken = default);

    /// <summary>
    /// Обновляет существующий заказ.
    /// </summary>
    /// <param name="order">Заказ с обновлёнными данными.</param>
    /// <param name="cancellationToken">Токен отмены операции.</param>
    Task UpdateAsync(Order order, CancellationToken cancellationToken = default);

    /// <summary>
    /// Сохраняет все изменения в хранилище.
    /// </summary>
    /// <param name="cancellationToken">Токен отмены операции.</param>
    Task SaveChangesAsync(CancellationToken cancellationToken = default);
}