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);
    }
}