Continuo fix manuale interfacce e commenti

EgwCoreLib.Lux.Data/Repository/Sales/IOrderRepository.cs

@@ -1,31 +1,83 @@
 namespace EgwCoreLib.Lux.Data.Repository.Sales
 {
+    /// <summary>
+    /// Interfaccia per la gestione degli ordini.
+    /// </summary>
     public interface IOrderRepository : IBaseRepository
     {
-        #region Public Methods
-
+        /// <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);
-
-        #endregion Public Methods
     }
 }