namespace EgwCoreLib.Lux.Data.Repository.Sales
{
    /// <summary>
    /// Interfaccia per la gestione delle righe delle offerte.
    /// </summary>
    public interface IOfferRowRepository : IBaseRepository
    {
        /// <summary>
        /// Inserisce una nuova riga d'offerta nel database e adegua i numeri di riga successivi.
        /// </summary>
        /// <param name="entity">La riga d'offerta da inserire.</param>
        /// <returns>True se l'inserimento ha successo, false altrimenti.</returns>
        Task<bool> AddAsync(OfferRowModel entity);

        /// <summary>
        /// Elimina una riga d'offerta e adegua i numeri di riga successivi.
        /// </summary>
        /// <param name="entity">La riga d'offerta da eliminare.</param>
        /// <returns>True se l'eliminazione ha successo, false altrimenti.</returns>
        Task<bool> DeleteAsync(OfferRowModel entity);

        /// <summary>
        /// Recupera l'elenco degli elementi BOM (Bill of Materials).
        /// </summary>
        /// <returns>L'elenco degli elementi BOM.</returns>
        Task<List<ItemModel>> GetBomItemsAsync();

        /// <summary>
        /// Recupera una riga d'offerta per il suo identificatore.
        /// </summary>
        /// <param name="offerRowId">L'identificatore della riga d'offerta.</param>
        /// <returns>La riga d'offerta corrispondente, o null se non esiste.</returns>
        Task<OfferRowModel?> GetByIdAsync(int offerRowId);

        /// <summary>
        /// Recupera tutte le righe d'offerta per un'offerta specifica.
        /// </summary>
        /// <param name="offerId">L'identificatore dell'offerta.</param>
        /// <returns>L'elenco delle righe d'offerta associate all'offerta.</returns>
        Task<List<OfferRowModel>> GetByParentAsync(int offerId);

        /// <summary>
        /// Recupera una riga d'offerta per il suo UID.
        /// </summary>
        /// <param name="offerRowUid">L'UID della riga d'offerta.</param>
        /// <returns>La riga d'offerta corrispondente, o null se non esiste.</returns>
        Task<OfferRowModel?> GetByUidAsync(string offerRowUid);

        /// <summary>
        /// Recupera l'elenco dei gruppi di articoli.
        /// </summary>
        /// <returns>L'elenco dei gruppi di articoli.</returns>
        Task<List<ItemGroupModel>> GetItemGroupsAsync();

        /// <summary>
        /// Aggiorna in batch le righe d'offerta.
        /// </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<OfferRowModel> rows);

        /// <summary>
        /// Aggiorna una riga d'offerta esistente.
        /// </summary>
        /// <param name="entity">La riga d'offerta aggiornata.</param>
        /// <returns>True se l'aggiornamento ha successo, false altrimenti.</returns>
        Task<bool> UpdateAsync(OfferRowModel entity);
    }
}