mapo-core/MP.Data/Repository/Utils/IStatsDetailRepository.cs

using EgwCoreLib.Utils;
using MP.Data.DbModels.Utils;
using System;
using System.Collections.Generic;
using System.Threading.Tasks;

namespace MP.Data.Repository.Utils
{
    /// <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>
        /// Elenco record in modalità pareto
        /// </summary>
        /// <param name="dtStart"></param>
        /// <param name="dtEnd"></param>
        /// <param name="maxRec"></param>
        /// <param name="sDest"></param>
        /// <param name="sType"></param>
        /// <returns></returns>
        Task<List<StatsDetailModel>> GetParetoAsync(DateTime dtStart, DateTime dtEnd, int maxRec, string sDest = "", 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
    }
}