lux/EgwCoreLib.Lux.Data/Repository/Sales/IOrderRowRepository.cs

namespace EgwCoreLib.Lux.Data.Repository.Sales
{
    /// <summary>
    /// Interfaccia per la gestione delle righe degli ordini.
    /// </summary>
    public interface IOrderRowRepository : 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(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);

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