Bozza itnerfacce BuyOrder/OrderRow

2026-04-14 11:40:11 +02:00
parent acf43e8f43
commit ce4a42265e
2 changed files with 185 additions and 0 deletions
@@ -0,0 +1,83 @@
+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>
+        /// 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<BuyOrderModel?> 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(BuyOrderModel 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<BuyOrderModel>> 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<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 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<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);
+    }
+}
@@ -0,0 +1,102 @@
+namespace EgwCoreLib.Lux.Data.Repository.Supplier
+{
+    /// <summary>
+    /// Interfaccia per la gestione delle righe degli ordini.
+    /// </summary>
+    public interface IBuyOrderRowrepository : IBaseRepository
+    {
+        /// <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(BuyOrderRowModel 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(BuyOrderRowModel 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="BuyOrderRowId">L'identificatore della riga d'ordine.</param>
+        /// <returns>La riga d'ordine corrispondente, o null se non esiste.</returns>
+        Task<BuyOrderRowModel?> GetByIdAsync(int BuyOrderRowId);
+
+        /// <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<BuyOrderRowModel>> 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<BuyOrderRowModel>> 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<BuyOrderRowModel>> GetByStateMinAsync(OrderStates reqState, DateTime dtStart, DateTime dtEnd);
+
+        /// <summary>
+        /// Recupera una riga d'ordine per il suo UID.
+        /// </summary>
+        /// <param name="BuyOrderRowUid">L'UID della riga d'ordine.</param>
+        /// <returns>La riga d'ordine corrispondente, o null se non esiste.</returns>
+        Task<BuyOrderRowModel?> GetByUidAsync(string BuyOrderRowUid);
+
+        /// <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<BuyOrderRowModel> 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(BuyOrderRowModel 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<BuyOrderRowModel> list2chk);
+    }
+}