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

using EgwCoreLib.Utils;

namespace MP.Data.Repository.Utils
{
    /// <summary>
    /// Interfaccia per le statistiche di dettaglio.
    /// </summary>
    public interface IStatsDetailRepository
    {
        /// <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);
    }
}