From f3143573be781dfdc60f99e6c422fa22ed654fb8 Mon Sep 17 00:00:00 2001
From: "Samuele E. Locatelli (W11-AI)" <samuele.locatelli@egalware.com>
Date: Wed, 25 Mar 2026 17:23:42 +0100
Subject: [PATCH] Continuo fix manuale interfacce e commenti

---
 .../Repository/Sales/IOfferRowRepository.cs   | 50 +++++++++++-
 .../Repository/Sales/IOrderRepository.cs      | 60 ++++++++++++++-
 .../Repository/Sales/IOrderRowRepository.cs   | 77 +++++++++++++++++--
 .../Repository/Sales/OfferRowRepository.cs    |  9 +++
 .../Repository/Sales/OrderRepository.cs       | 16 ++--
 .../Repository/Sales/OrderRowRepository.cs    | 12 +++
 .../Repository/Stats/IStatsAggrRepository.cs  | 23 +++++-
 .../Stats/IStatsDetailRepository.cs           | 27 ++++++-
 .../Repository/Stats/StatsAggrRepository.cs   | 19 +----
 .../Repository/Stats/StatsDetailRepository.cs | 23 +-----
 10 files changed, 254 insertions(+), 62 deletions(-)

diff --git a/EgwCoreLib.Lux.Data/Repository/Sales/IOfferRowRepository.cs b/EgwCoreLib.Lux.Data/Repository/Sales/IOfferRowRepository.cs
index d8662fad..028638c3 100644
--- a/EgwCoreLib.Lux.Data/Repository/Sales/IOfferRowRepository.cs
+++ b/EgwCoreLib.Lux.Data/Repository/Sales/IOfferRowRepository.cs
@@ -1,27 +1,69 @@
 namespace EgwCoreLib.Lux.Data.Repository.Sales
 {
+    /// <summary>
+    /// Interfaccia per la gestione delle righe delle offerte.
+    /// </summary>
     public interface IOfferRowRepository : IBaseRepository
     {
-        #region Public Methods
-
+        /// <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);
-
-        #endregion Public Methods
     }
 }
\ No newline at end of file
diff --git a/EgwCoreLib.Lux.Data/Repository/Sales/IOrderRepository.cs b/EgwCoreLib.Lux.Data/Repository/Sales/IOrderRepository.cs
index b5bbc3df..2632d50f 100644
--- a/EgwCoreLib.Lux.Data/Repository/Sales/IOrderRepository.cs
+++ b/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
     }
 }
\ No newline at end of file
diff --git a/EgwCoreLib.Lux.Data/Repository/Sales/IOrderRowRepository.cs b/EgwCoreLib.Lux.Data/Repository/Sales/IOrderRowRepository.cs
index ea3b5f46..4e35e7d9 100644
--- a/EgwCoreLib.Lux.Data/Repository/Sales/IOrderRowRepository.cs
+++ b/EgwCoreLib.Lux.Data/Repository/Sales/IOrderRowRepository.cs
@@ -1,35 +1,102 @@
 namespace EgwCoreLib.Lux.Data.Repository.Sales
 {
+    /// <summary>
+    /// Interfaccia per la gestione delle righe degli ordini.
+    /// </summary>
     public interface IOrderRowRepository : IBaseRepository
     {
-        #region Public Methods
-
+        /// <summary>
+        /// Inserisce una nuova riga d'ordine nel database.
+        /// </summary>
+        /// <param name="entity">La riga d'ordine da inserire.</param>
+        /// <returns>True se l'inserimento ha successo, false altrimenti.</returns>
         Task<bool> AddAsync(OrderRowModel entity);
 
+        /// <summary>
+        /// Elimina una riga d'ordine e adegua i numeri di riga successivi.
+        /// </summary>
+        /// <param name="entity">La riga d'ordine da eliminare.</param>
+        /// <returns>True se l'eliminazione ha successo, false altrimenti.</returns>
         Task<bool> DeleteAsync(OrderRowModel 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'ordine per il suo identificatore.
+        /// </summary>
+        /// <param name="OrderRowId">L'identificatore della riga d'ordine.</param>
+        /// <returns>La riga d'ordine corrispondente, o null se non esiste.</returns>
         Task<OrderRowModel?> GetByIdAsync(int OrderRowId);
 
-        Task<List<OrderRowModel>> GetByParentAsync(int offerId);
+        /// <summary>
+        /// Recupera tutte le righe d'ordine per un ordine specifico.
+        /// </summary>
+        /// <param name="orderId">L'identificatore dell'ordine.</param>
+        /// <returns>L'elenco delle righe d'ordine associate all'ordine.</returns>
+        Task<List<OrderRowModel>> GetByParentAsync(int orderId);
 
+        /// <summary>
+        /// Recupera le righe d'ordine per stato e intervallo di date.
+        /// </summary>
+        /// <param name="reqState">Lo stato richiesto della riga.</param>
+        /// <param name="dtStart">La data di inizio del periodo.</param>
+        /// <param name="dtEnd">La data di fine del periodo.</param>
+        /// <returns>L'elenco delle righe d'ordine con lo stato e le date specificate.</returns>
         Task<List<OrderRowModel>> GetByStateAsync(OrderStates reqState, DateTime dtStart, DateTime dtEnd);
 
+        /// <summary>
+        /// Recupera le righe d'ordine per stato minimo e intervallo di date.
+        /// </summary>
+        /// <param name="reqState">Lo stato minimo richiesto.</param>
+        /// <param name="dtStart">La data di inizio del periodo.</param>
+        /// <param name="dtEnd">La data di fine del periodo.</param>
+        /// <returns>L'elenco delle righe d'ordine con stato >= a quello specificato.</returns>
         Task<List<OrderRowModel>> GetByStateMinAsync(OrderStates reqState, DateTime dtStart, DateTime dtEnd);
 
+        /// <summary>
+        /// Recupera una riga d'ordine per il suo UID.
+        /// </summary>
+        /// <param name="OrderRowUid">L'UID della riga d'ordine.</param>
+        /// <returns>La riga d'ordine corrispondente, o null se non esiste.</returns>
         Task<OrderRowModel?> GetByUidAsync(string OrderRowUid);
 
+        /// <summary>
+        /// Recupera l'elenco dei gruppi di articoli.
+        /// </summary>
+        /// <returns>L'elenco dei gruppi di articoli.</returns>
         Task<List<ItemGroupModel>> GetItemGroupsAsync();
 
+        /// <summary>
+        /// Aggiorna la stima di produzione per una riga d'ordine.
+        /// </summary>
+        /// <param name="uID">L'UID della riga d'ordine.</param>
+        /// <param name="prodEstim">La nuova stima di produzione.</param>
+        /// <returns>True se l'aggiornamento ha successo, false altrimenti.</returns>
         Task<bool> SaveProdEstAsync(string uID, string prodEstim);
 
+        /// <summary>
+        /// Aggiorna in batch le righe d'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 una riga d'ordine esistente.
+        /// </summary>
+        /// <param name="entity">La riga d'ordine aggiornata.</param>
+        /// <returns>True se l'aggiornamento ha successo, false altrimenti.</returns>
         Task<bool> UpdateAsync(OrderRowModel entity);
 
+        /// <summary>
+        /// Convalida un elenco di righe d'ordine e aggiorna lo stato se necessario.
+        /// </summary>
+        /// <param name="list2chk">L'elenco delle righe da convalidare.</param>
+        /// <returns>Il numero di righe elaborate correttamente.</returns>
         Task<int> ValidateAsync(List<OrderRowModel> list2chk);
-
-        #endregion Public Methods
     }
 }
\ No newline at end of file
diff --git a/EgwCoreLib.Lux.Data/Repository/Sales/OfferRowRepository.cs b/EgwCoreLib.Lux.Data/Repository/Sales/OfferRowRepository.cs
index 7de3ac86..326ce8d5 100644
--- a/EgwCoreLib.Lux.Data/Repository/Sales/OfferRowRepository.cs
+++ b/EgwCoreLib.Lux.Data/Repository/Sales/OfferRowRepository.cs
@@ -12,6 +12,7 @@
 
         #region Public Methods
 
+        /// <inheritdoc />
         public async Task<bool> AddAsync(OfferRowModel entity)
         {
             await using var dbCtx = await CreateContextAsync(); await using var tx = await dbCtx.Database.BeginTransactionAsync();
@@ -45,6 +46,7 @@
             }
         }
 
+        /// <inheritdoc />
         public async Task<bool> DeleteAsync(OfferRowModel entity)
         {
             await using var dbCtx = await CreateContextAsync();
@@ -89,6 +91,7 @@
             }
         }
 
+        /// <inheritdoc />
         public async Task<List<ItemModel>> GetBomItemsAsync()
         {
             await using var dbCtx = await CreateContextAsync();
@@ -97,6 +100,7 @@
                 .ToListAsync();
         }
 
+        /// <inheritdoc />
         public async Task<OfferRowModel?> GetByIdAsync(int offerRowId)
         {
             await using var dbCtx = await CreateContextAsync();
@@ -105,6 +109,7 @@
                                 .FirstOrDefaultAsync(x => x.OfferRowID == offerRowId);
         }
 
+        /// <inheritdoc />
         public async Task<List<OfferRowModel>> GetByParentAsync(int offerId)
         {
             await using var dbCtx = await CreateContextAsync();
@@ -115,6 +120,7 @@
                                 .ToListAsync();
         }
 
+        /// <inheritdoc />
         public async Task<OfferRowModel?> GetByUidAsync(string offerRowUid)
         {
             await using var dbCtx = await CreateContextAsync();
@@ -123,12 +129,14 @@
                                 .FirstOrDefaultAsync(x => x.OfferRowUID == offerRowUid);
         }
 
+        /// <inheritdoc />
         public async Task<List<ItemGroupModel>> GetItemGroupsAsync()
         {
             await using var dbCtx = await CreateContextAsync();
             return await dbCtx.DbSetItemGroup.ToListAsync();
         }
 
+        /// <inheritdoc />
         public async Task<bool> SaveRowsAsync(List<OfferRowModel> rows)
         {
             // Add validation for null or empty list
@@ -157,6 +165,7 @@
             }
         }
 
+        /// <inheritdoc />
         public async Task<bool> UpdateAsync(OfferRowModel entity)
         {
             await using var dbCtx = await CreateContextAsync();
diff --git a/EgwCoreLib.Lux.Data/Repository/Sales/OrderRepository.cs b/EgwCoreLib.Lux.Data/Repository/Sales/OrderRepository.cs
index 79ae5765..4a5812cf 100644
--- a/EgwCoreLib.Lux.Data/Repository/Sales/OrderRepository.cs
+++ b/EgwCoreLib.Lux.Data/Repository/Sales/OrderRepository.cs
@@ -12,6 +12,7 @@
 
         #region Public Methods
 
+        /// <inheritdoc />
         public async Task<bool> AddAsync(OrderModel entity)
         {
             await using var dbCtx = await CreateContextAsync();
@@ -19,11 +20,7 @@
             return await dbCtx.SaveChangesAsync() > 0;
         }
 
-        /// <summary>
-        /// Esegue il cloning completo di un Offerta e di TUTTE le relative righe...
-        /// </summary>
-        /// <param name="rec2clone"></param>
-        /// <returns></returns>
+        /// <inheritdoc />
         public async Task<OrderModel?> CloneOfferAsync(OfferModel rec2clone)
         {
             OrderModel? newRec = null;
@@ -170,6 +167,7 @@
             return newRec;
         }
 
+        /// <inheritdoc />
         public async Task<bool> DeleteAsync(OrderModel entity)
         {
             await using var dbCtx = await CreateContextAsync();
@@ -177,6 +175,7 @@
             return await dbCtx.SaveChangesAsync() > 0;
         }
 
+        /// <inheritdoc />
         public async Task<List<OrderModel>> GetAllAsync()
         {
             await using var dbCtx = await CreateContextAsync();
@@ -188,6 +187,7 @@
                             .ToListAsync();
         }
 
+        /// <inheritdoc />
         public async Task<List<ItemModel>> GetBomItemsAsync()
         {
             await using var dbCtx = await CreateContextAsync();
@@ -196,12 +196,14 @@
                 .ToListAsync();
         }
 
+        /// <inheritdoc />
         public async Task<OrderModel?> GetByIdAsync(int recId)
         {
             await using var dbCtx = await CreateContextAsync();
             return await dbCtx.DbSetOrder.FirstOrDefaultAsync(x => x.OrderID == recId);
         }
 
+        /// <inheritdoc />
         public async Task<List<OrderModel>> GetFiltAsync(DateTime inizio, DateTime fine)
         {
             await using var dbCtx = await CreateContextAsync();
@@ -214,12 +216,14 @@
                             .ToListAsync();
         }
 
+        /// <inheritdoc />
         public async Task<List<ItemGroupModel>> GetItemGroupsAsync()
         {
             await using var dbCtx = await CreateContextAsync();
             return await dbCtx.DbSetItemGroup.ToListAsync();
         }
 
+        /// <inheritdoc />
         public async Task<List<OrderRowModel>> GetRowsAsync(int recId)
         {
             await using var dbCtx = await CreateContextAsync();
@@ -228,6 +232,7 @@
                                 .ToListAsync();
         }
 
+        /// <inheritdoc />
         public async Task<bool> SaveRowsAsync(List<OrderRowModel> rows)
         {
             // Add validation for null or empty list
@@ -256,6 +261,7 @@
             }
         }
 
+        /// <inheritdoc />
         public async Task<bool> UpdateAsync(OrderModel entity)
         {
             await using var dbCtx = await CreateContextAsync();
diff --git a/EgwCoreLib.Lux.Data/Repository/Sales/OrderRowRepository.cs b/EgwCoreLib.Lux.Data/Repository/Sales/OrderRowRepository.cs
index 4922ab00..86c1a449 100644
--- a/EgwCoreLib.Lux.Data/Repository/Sales/OrderRowRepository.cs
+++ b/EgwCoreLib.Lux.Data/Repository/Sales/OrderRowRepository.cs
@@ -14,6 +14,7 @@ namespace EgwCoreLib.Lux.Data.Repository.Sales
 
         #region Public Methods
 
+        /// <inheritdoc />
         public async Task<bool> AddAsync(OrderRowModel entity)
         {
             await using var dbCtx = await CreateContextAsync();
@@ -21,6 +22,7 @@ namespace EgwCoreLib.Lux.Data.Repository.Sales
             return await dbCtx.SaveChangesAsync() > 0;
         }
 
+        /// <inheritdoc />
         public async Task<bool> DeleteAsync(OrderRowModel entity)
         {
             await using var dbCtx = await CreateContextAsync();
@@ -65,6 +67,7 @@ namespace EgwCoreLib.Lux.Data.Repository.Sales
             }
         }
 
+        /// <inheritdoc />
         public async Task<List<ItemModel>> GetBomItemsAsync()
         {
             await using var dbCtx = await CreateContextAsync();
@@ -73,6 +76,7 @@ namespace EgwCoreLib.Lux.Data.Repository.Sales
                 .ToListAsync();
         }
 
+        /// <inheritdoc />
         public async Task<OrderRowModel?> GetByIdAsync(int OrderRowId)
         {
             await using var dbCtx = await CreateContextAsync();
@@ -81,6 +85,7 @@ namespace EgwCoreLib.Lux.Data.Repository.Sales
                                 .FirstOrDefaultAsync(x => x.OrderRowID == OrderRowId);
         }
 
+        /// <inheritdoc />
         public async Task<List<OrderRowModel>> GetByParentAsync(int orderId)
         {
             await using var dbCtx = await CreateContextAsync();
@@ -91,6 +96,7 @@ namespace EgwCoreLib.Lux.Data.Repository.Sales
                                 .ToListAsync();
         }
 
+        /// <inheritdoc />
         public async Task<List<OrderRowModel>> GetByStateAsync(OrderStates reqState, DateTime dtStart, DateTime dtEnd)
         {
             await using var dbCtx = await CreateContextAsync();
@@ -101,6 +107,7 @@ namespace EgwCoreLib.Lux.Data.Repository.Sales
                                 .ToListAsync();
         }
 
+        /// <inheritdoc />
         public async Task<List<OrderRowModel>> GetByStateMinAsync(OrderStates reqState, DateTime dtStart, DateTime dtEnd)
         {
             await using var dbCtx = await CreateContextAsync();
@@ -111,6 +118,7 @@ namespace EgwCoreLib.Lux.Data.Repository.Sales
                                 .ToListAsync();
         }
 
+        /// <inheritdoc />
         public async Task<OrderRowModel?> GetByUidAsync(string OrderRowUid)
         {
             await using var dbCtx = await CreateContextAsync();
@@ -119,12 +127,14 @@ namespace EgwCoreLib.Lux.Data.Repository.Sales
                                 .FirstOrDefaultAsync(x => x.OrderRowUID == OrderRowUid);
         }
 
+        /// <inheritdoc />
         public async Task<List<ItemGroupModel>> GetItemGroupsAsync()
         {
             await using var dbCtx = await CreateContextAsync();
             return await dbCtx.DbSetItemGroup.ToListAsync();
         }
 
+        /// <inheritdoc />
         public async Task<bool> SaveRowsAsync(List<OrderRowModel> rows)
         {
             await using var dbCtx = await CreateContextAsync();
@@ -150,6 +160,7 @@ namespace EgwCoreLib.Lux.Data.Repository.Sales
             }
         }
 
+        /// <inheritdoc />
         public async Task<bool> UpdateAsync(OrderRowModel entity)
         {
             await using var dbCtx = await CreateContextAsync();
@@ -339,6 +350,7 @@ namespace EgwCoreLib.Lux.Data.Repository.Sales
             }
         }
 
+        /// <inheritdoc />
         public async Task<int> ValidateAsync(List<OrderRowModel> list2chk)
         {
             int numDone = 0;
diff --git a/EgwCoreLib.Lux.Data/Repository/Stats/IStatsAggrRepository.cs b/EgwCoreLib.Lux.Data/Repository/Stats/IStatsAggrRepository.cs
index 76c96fc6..c5313f17 100644
--- a/EgwCoreLib.Lux.Data/Repository/Stats/IStatsAggrRepository.cs
+++ b/EgwCoreLib.Lux.Data/Repository/Stats/IStatsAggrRepository.cs
@@ -2,16 +2,31 @@
 
 namespace EgwCoreLib.Lux.Data.Repository.Stats
 {
+    /// <summary>
+    /// Interfaccia per le statistiche aggregate.
+    /// </summary>
     public interface IStatsAggrRepository
     {
-        #region Public Methods
-
+        /// <summary>
+        /// Recupera l'elenco delle statistiche aggregate per un periodo specifico.
+        /// </summary>
+        /// <param name="dtStart">La data di inizio del periodo.</param>
+        /// <param name="dtEnd">La data di fine del periodo.</param>
+        /// <returns>L'elenco delle statistiche aggregate ordinate cronologicamente.</returns>
         Task<List<StatsAggregatedModel>> GetFiltAsync(DateTime dtStart, DateTime dtEnd);
 
+        /// <summary>
+        /// Recupera l'intervallo temporale disponibile nel database per le statistiche aggregate.
+        /// </summary>
+        /// <returns>L'intervallo di date (minima e massima ora presente).</returns>
         Task<DtUtils.Periodo> GetRangeAsync();
 
+        /// <summary>
+        /// Inserisce o aggiorna in blocco le statistiche aggregate nel database.
+        /// </summary>
+        /// <param name="listRecords">L'elenco dei record da inserire.</param>
+        /// <param name="removeOld">Se true, elimina preventivamente i record nel periodo richiesto.</param>
+        /// <returns>Il numero di record inseriti.</returns>
         Task<int> UpsertManyAsync(List<StatsAggregatedModel> listRecords, bool removeOld);
-
-        #endregion Public Methods
     }
 }
\ No newline at end of file
diff --git a/EgwCoreLib.Lux.Data/Repository/Stats/IStatsDetailRepository.cs b/EgwCoreLib.Lux.Data/Repository/Stats/IStatsDetailRepository.cs
index b3256cdf..78b38fc4 100644
--- a/EgwCoreLib.Lux.Data/Repository/Stats/IStatsDetailRepository.cs
+++ b/EgwCoreLib.Lux.Data/Repository/Stats/IStatsDetailRepository.cs
@@ -2,16 +2,35 @@
 
 namespace EgwCoreLib.Lux.Data.Repository.Stats
 {
+    /// <summary>
+    /// Interfaccia per le statistiche di dettaglio.
+    /// </summary>
     public interface IStatsDetailRepository
     {
-        #region Public Methods
-
+        /// <summary>
+        /// Recupera l'elenco delle statistiche di dettaglio per un periodo specifico, con filtri opzionali.
+        /// </summary>
+        /// <param name="dtStart">La data di inizio del periodo.</param>
+        /// <param name="dtEnd">La data di fine del periodo.</param>
+        /// <param name="sEnvir">Filtro opzionale per l'ambiente (es. "DEV", "PROD").</param>
+        /// <param name="sType">Filtro opzionale per il tipo di statistica.</param>
+        /// <returns>L'elenco delle statistiche di dettaglio ordinate cronologicamente.</returns>
         Task<List<StatsDetailModel>> GetFiltAsync(DateTime dtStart, DateTime dtEnd, string sEnvir = "", string sType = "");
 
+        /// <summary>
+        /// Recupera l'intervallo temporale disponibile nel database per le statistiche di dettaglio.
+        /// </summary>
+        /// <param name="sEnvir">Filtro opzionale per l'ambiente.</param>
+        /// <param name="sType">Filtro opzionale per il tipo.</param>
+        /// <returns>L'intervallo di date (minima e massima ora presente).</returns>
         Task<DtUtils.Periodo> GetRangeAsync(string sEnvir, string sType);
 
+        /// <summary>
+        /// Inserisce o aggiorna in blocco le statistiche di dettaglio nel database.
+        /// </summary>
+        /// <param name="listRecords">L'elenco dei record da inserire.</param>
+        /// <param name="removeOld">Se true, elimina preventivamente i record nel periodo richiesto.</param>
+        /// <returns>Il numero di record inseriti.</returns>
         Task<int> UpsertManyAsync(List<StatsDetailModel> listRecords, bool removeOld);
-
-        #endregion Public Methods
     }
 }
\ No newline at end of file
diff --git a/EgwCoreLib.Lux.Data/Repository/Stats/StatsAggrRepository.cs b/EgwCoreLib.Lux.Data/Repository/Stats/StatsAggrRepository.cs
index 433f9ab5..5503730c 100644
--- a/EgwCoreLib.Lux.Data/Repository/Stats/StatsAggrRepository.cs
+++ b/EgwCoreLib.Lux.Data/Repository/Stats/StatsAggrRepository.cs
@@ -14,12 +14,7 @@ namespace EgwCoreLib.Lux.Data.Repository.Stats
 
         #region Public Methods
 
-        /// <summary>
-        /// Elenco da DB delel stats aggregate dato periodo inizio/fine
-        /// </summary>
-        /// <param name="dtStart"></param>
-        /// <param name="dtEnd"></param>
-        /// <returns></returns>
+        /// <inheritdoc />
         public async Task<List<StatsAggregatedModel>> GetFiltAsync(DateTime dtStart, DateTime dtEnd)
         {
             await using var dbCtx = await CreateContextAsync();
@@ -31,10 +26,7 @@ namespace EgwCoreLib.Lux.Data.Repository.Stats
                             .ToListAsync();
         }
 
-        /// <summary>
-        /// Range periodo per chiamate aggregate
-        /// </summary>
-        /// <returns></returns>
+        /// <inheritdoc />
         public async Task<DtUtils.Periodo> GetRangeAsync()
         {
             await using var dbCtx = await CreateContextAsync();
@@ -48,12 +40,7 @@ namespace EgwCoreLib.Lux.Data.Repository.Stats
             return answ;
         }
 
-        /// <summary>
-        /// Esegue insert statistiche aggregate sul DB
-        /// </summary>
-        /// <param name="listRecords">Elenco dei record da inserire</param>
-        /// <param name="removeOld">Se true preventivamente elimina record nel periodo richiesto</param>
-        /// <returns></returns>
+        /// <inheritdoc />
         public async Task<int> UpsertManyAsync(List<StatsAggregatedModel> listRecords, bool removeOld)
         {
             int answ = 0;
diff --git a/EgwCoreLib.Lux.Data/Repository/Stats/StatsDetailRepository.cs b/EgwCoreLib.Lux.Data/Repository/Stats/StatsDetailRepository.cs
index 363c43a7..77ffce36 100644
--- a/EgwCoreLib.Lux.Data/Repository/Stats/StatsDetailRepository.cs
+++ b/EgwCoreLib.Lux.Data/Repository/Stats/StatsDetailRepository.cs
@@ -14,14 +14,7 @@ namespace EgwCoreLib.Lux.Data.Repository.Stats
 
         #region Internal Methods
 
-        /// <summary>
-        /// Recupera dati stats di dettaglio dato filtro envir/tipo (opzionali) e periodo
-        /// </summary>
-        /// <param name="dtStart"></param>
-        /// <param name="dtEnd"></param>
-        /// <param name="sEnvir"></param>
-        /// <param name="sType"></param>
-        /// <returns></returns>
+        /// <inheritdoc />
         public async Task<List<StatsDetailModel>> GetFiltAsync(DateTime dtStart, DateTime dtEnd, string sEnvir = "", string sType = "")
         {
             await using var dbCtx = await CreateContextAsync();
@@ -47,12 +40,7 @@ namespace EgwCoreLib.Lux.Data.Repository.Stats
             return answ;
         }
 
-        /// <summary>
-        /// Range periodo x chiamate detail eventualmente filtrate
-        /// </summary>
-        /// <param name="sEnvir"></param>
-        /// <param name="sType"></param>
-        /// <returns></returns>
+        /// <inheritdoc />
         public async Task<DtUtils.Periodo> GetRangeAsync(string sEnvir, string sType)
         {
             await using var dbCtx = await CreateContextAsync();
@@ -73,12 +61,7 @@ namespace EgwCoreLib.Lux.Data.Repository.Stats
             return answ;
         }
 
-        /// <summary>
-        /// Esegue insert statistiche di dettaglio sul DB
-        /// </summary>
-        /// <param name="listRecords">Elenco dei record da inserire</param>
-        /// <param name="removeOld">Se true preventivamente elimina record nel periodo richiesto</param>
-        /// <returns></returns>
+        /// <inheritdoc />
         public async Task<int> UpsertManyAsync(List<StatsDetailModel> listRecords, bool removeOld)
         {
             int answ = 0;