Files
lux/EgwCoreLib.Lux.Data/Repository/Sales/IOrderRepository.cs
T
2026-03-25 17:23:42 +01:00

83 lines
3.4 KiB
C#

namespace EgwCoreLib.Lux.Data.Repository.Sales
{
/// <summary>
/// Interfaccia per la gestione degli ordini.
/// </summary>
public interface IOrderRepository : IBaseRepository
{
/// <summary>
/// Inserisce un nuovo ordine nel database.
/// </summary>
/// <param name="entity">L'ordine da inserire.</param>
/// <returns>True se l'inserimento ha successo, false altrimenti.</returns>
Task<bool> AddAsync(OrderModel entity);
/// <summary>
/// Esegue il cloning completo di un'Offerta e di tutte le relative righe.
/// </summary>
/// <param name="rec2clone">L'offerta da clonare.</param>
/// <returns>L'ordine creato, o null se l'offerta non esiste.</returns>
Task<OrderModel?> CloneOfferAsync(OfferModel rec2clone);
/// <summary>
/// Elimina un ordine dal database.
/// </summary>
/// <param name="entity">L'ordine da eliminare.</param>
/// <returns>True se l'eliminazione ha successo, false altrimenti.</returns>
Task<bool> DeleteAsync(OrderModel entity);
/// <summary>
/// Recupera l'elenco di tutti gli ordini.
/// </summary>
/// <returns>L'elenco di tutti gli ordini con clienti, rivenditori e righe associate.</returns>
Task<List<OrderModel>> GetAllAsync();
/// <summary>
/// Recupera l'elenco degli elementi BOM (Bill of Materials) utilizzati negli ordini.
/// </summary>
/// <returns>L'elenco degli elementi BOM.</returns>
Task<List<ItemModel>> GetBomItemsAsync();
/// <summary>
/// Recupera un ordine per il suo identificatore.
/// </summary>
/// <param name="recId">L'identificatore dell'ordine.</param>
/// <returns>L'ordine corrispondente, o null se non esiste.</returns>
Task<OrderModel?> GetByIdAsync(int recId);
/// <summary>
/// Recupera gli ordini inseriti in un intervallo di date specifico.
/// </summary>
/// <param name="inizio">La data di inizio del periodo.</param>
/// <param name="fine">La data di fine del periodo.</param>
/// <returns>L'elenco degli ordini nell'intervallo specificato.</returns>
Task<List<OrderModel>> GetFiltAsync(DateTime inizio, DateTime fine);
/// <summary>
/// Recupera l'elenco dei gruppi di articoli.
/// </summary>
/// <returns>L'elenco dei gruppi di articoli.</returns>
Task<List<ItemGroupModel>> GetItemGroupsAsync();
/// <summary>
/// Recupera le righe dell'ordine per un ordine specifico.
/// </summary>
/// <param name="recId">L'identificatore dell'ordine.</param>
/// <returns>L'elenco delle righe dell'ordine.</returns>
Task<List<OrderRowModel>> GetRowsAsync(int recId);
/// <summary>
/// Aggiorna in batch le righe di un ordine.
/// </summary>
/// <param name="rows">L'elenco delle righe da aggiornare.</param>
/// <returns>True se l'aggiornamento ha successo, false altrimenti.</returns>
Task<bool> SaveRowsAsync(List<OrderRowModel> rows);
/// <summary>
/// Aggiorna un ordine esistente nel database.
/// </summary>
/// <param name="entity">L'ordine aggiornato.</param>
/// <returns>True se l'aggiornamento ha successo, false altrimenti.</returns>
Task<bool> UpdateAsync(OrderModel entity);
}
}