lux/EgwCoreLib.Lux.Data/Repository/Supplier/IBuyOrderRepository.cs

namespace EgwCoreLib.Lux.Data.Repository.Supplier
{
    /// <summary>
    /// Interfaccia per la gestione degli ordini.
    /// </summary>
    public interface IBuyOrderRepository : 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(BuyOrderModel entity);

        /// <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(BuyOrderModel entity);

        /// <summary>
        /// Generazione di un nuovo BuyOrder + righe + associazione fabbisogni da dizionario</MatReqID>
        /// </summary>
        /// <param name="currSelDict">Dizionario selezione CodGroup, List<MatReqID></param>
        /// <returns></returns>
        Task<BuyOrderModel> GenerateFromSelectionAsync(Dictionary<string, List<int>> currSelDict);

        /// <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<BuyOrderModel>> GetAllAsync();

        /// <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<BuyOrderModel?> 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<BuyOrderModel>> GetFiltAsync(DateTime inizio, DateTime fine);

        /// <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<BuyOrderRowModel>> 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<BuyOrderRowModel> 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(BuyOrderModel entity);
    }
}