Merge branch 'dev' into j3/feat/filter

This commit is contained in:
mirage
2026-04-02 15:27:32 +02:00
12 changed files with 447 additions and 32 deletions

View File

@@ -0,0 +1,57 @@
namespace Webzine.Business.Contracts.Dto;
/// <summary>
/// Dto transportant les données métier d'un titre saisi en administration.
/// </summary>
public class TitreAdminDTO
{
/// <summary>
/// Identifiant du titre (0 lors d'une création).
/// </summary>
public int Id { get; set; }
/// <summary>
/// Identifiant de l'artiste sélectionné.
/// </summary>
public int IdArtiste { get; set; }
/// <summary>
/// Libellé du titre.
/// </summary>
public string Libelle { get; set; } = string.Empty;
/// <summary>
/// Nom de l'album.
/// </summary>
public string Album { get; set; } = string.Empty;
/// <summary>
/// Texte de la chronique.
/// </summary>
public string Chronique { get; set; } = string.Empty;
/// <summary>
/// Date de sortie du titre.
/// </summary>
public DateTime DateSortie { get; set; }
/// <summary>
/// Durée en secondes.
/// </summary>
public int Duree { get; set; }
/// <summary>
/// URL de la jaquette.
/// </summary>
public string UrlJaquette { get; set; } = string.Empty;
/// <summary>
/// URL d'écoute.
/// </summary>
public string? UrlEcoute { get; set; }
/// <summary>
/// Identifiants des styles sélectionnés.
/// </summary>
public List<int> Styles { get; set; } = new ();
}

View File

@@ -0,0 +1,22 @@
namespace Webzine.Business.Contracts;
using Webzine.Business.Contracts.Dto;
/// <summary>
/// Service responsable des opérations d'administration sur les titres.
/// Orchestre la résolution des dépendances (artiste, styles) et la persistance.
/// </summary>
public interface ITitreAdminService
{
/// <summary>
/// Crée un nouveau titre à partir des données du formulaire d'administration.
/// </summary>
/// <param name="commande">Les données saisies dans le formulaire de création.</param>
void CreerTitre(TitreAdminDTO commande);
/// <summary>
/// Met à jour un titre existant à partir des données du formulaire d'administration.
/// </summary>
/// <param name="commande">Les données saisies dans le formulaire de modification.</param>
void ModifierTitre(TitreAdminDTO commande);
}

View File

@@ -0,0 +1,124 @@
namespace Webzine.Business;
using Microsoft.Extensions.Logging;
using Webzine.Business.Contracts.Dto;
using Webzine.Business.Contracts;
using Webzine.Entity;
using Webzine.Repository.Contracts;
/// <summary>
/// Implémentation de <see cref="ITitreAdminService"/>.
/// Orchestre la résolution des styles, la construction de l'entité
/// et la délégation au repository.
/// </summary>
public class TitreAdminService : ITitreAdminService
{
private readonly ITitreRepository titreRepository;
private readonly IArtisteRepository artisteRepository;
private readonly IStyleRepository styleRepository;
private readonly ILogger<TitreAdminService> logger;
/// <summary>
/// Initializes a new instance of the <see cref="TitreAdminService"/> class.
/// </summary>
/// <param name="titreRepository">Repository des titres.</param>
/// <param name="artisteRepository">Repository des artistes.</param>
/// <param name="styleRepository">Repository des styles.</param>
/// <param name="logger">Service de journalisation.</param>
public TitreAdminService(
ITitreRepository titreRepository,
IArtisteRepository artisteRepository,
IStyleRepository styleRepository,
ILogger<TitreAdminService> logger)
{
this.titreRepository = titreRepository;
this.artisteRepository = artisteRepository;
this.styleRepository = styleRepository;
this.logger = logger;
}
/// <inheritdoc/>
public void CreerTitre(TitreAdminDTO commande)
{
this.logger.LogInformation(
"Création d'un nouveau titre '{Libelle}' pour l'artiste ID {IdArtiste}.",
commande.Libelle,
commande.IdArtiste);
Artiste artiste = this.artisteRepository.Find(commande.IdArtiste);
List<Style> styles = this.ResoudreStyles(commande.Styles);
var titre = new Titre
{
IdArtiste = artiste.IdArtiste,
Artiste = artiste,
Libelle = commande.Libelle,
Album = commande.Album,
Chronique = commande.Chronique,
DateCreation = DateTime.UtcNow,
DateSortie = commande.DateSortie,
Duree = commande.Duree,
UrlJaquette = commande.UrlJaquette,
UrlEcoute = commande.UrlEcoute ?? string.Empty,
Styles = styles,
Commentaires = new List<Commentaire>(),
};
this.titreRepository.Add(titre);
this.logger.LogInformation("Titre '{Libelle}' créé avec succès (ID {IdTitre}).", titre.Libelle, titre.IdTitre);
}
/// <inheritdoc/>
public void ModifierTitre(TitreAdminDTO commande)
{
this.logger.LogInformation("Modification du titre ID {Id} ('{Libelle}').", commande.Id, commande.Libelle);
List<Style> styles = this.ResoudreStyles(commande.Styles);
// On charge le titre existant pour ne pas écraser NbLectures / NbLikes
Titre existant = this.titreRepository.Find(commande.Id);
existant.IdArtiste = commande.IdArtiste;
existant.Libelle = commande.Libelle;
existant.Album = commande.Album;
existant.Chronique = commande.Chronique;
existant.DateSortie = commande.DateSortie;
existant.Duree = commande.Duree;
existant.UrlJaquette = commande.UrlJaquette;
existant.UrlEcoute = commande.UrlEcoute ?? string.Empty;
existant.Styles.Clear();
foreach (var style in styles)
{
existant.Styles.Add(style);
}
this.titreRepository.Update(existant);
this.logger.LogInformation("Titre ID {Id} modifié avec succès.", commande.Id);
}
/// <summary>
/// Résout les entités <see cref="Style"/> à partir d'une liste d'identifiants.
/// Les identifiants introuvables sont ignorés avec un avertissement.
/// </summary>
/// <param name="styleIds">Identifiants des styles sélectionnés.</param>
/// <returns>Liste des styles résolus.</returns>
private List<Style> ResoudreStyles(List<int> styleIds)
{
var styles = new List<Style>();
foreach (int id in styleIds)
{
Style style = this.styleRepository.Find(id);
styles.Add(style);
}
this.logger.LogDebug("{NbResolus}/{NbDemandes} styles résolus avec succès.", styles.Count, styleIds.Count);
return styles;
}
}

View File

@@ -23,7 +23,14 @@
<ItemGroup>
<ProjectReference Include="..\Webzine.Business.Contracts\Webzine.Business.Contracts.csproj" />
<ProjectReference Include="..\Webzine.Entity\Webzine.Entity.csproj" />
<ProjectReference Include="..\Webzine.Repository.Contracts\Webzine.Repository.Contracts.csproj" />
</ItemGroup>
<ItemGroup>
<Reference Include="Microsoft.Extensions.Logging.Abstractions">
<HintPath>..\..\..\..\..\..\..\.nuget\packages\microsoft.extensions.logging.abstractions\10.0.5\lib\net10.0\Microsoft.Extensions.Logging.Abstractions.dll</HintPath>
</Reference>
</ItemGroup>
</Project>

View File

@@ -192,31 +192,14 @@ public class DbTitreRepository : ITitreRepository
try
{
this.logger.LogInformation("Mise à jour du titre avec l'ID: {IdTitre}", titre.IdTitre);
this.logger.LogDebug("Début de la mise à jour du titre en base de données");
var existingTitre = this.context.Titres.Find(titre.IdTitre);
if (existingTitre != null)
{
this.logger.LogDebug("Titre trouvé, mise à jour des propriétés");
this.context.Entry(existingTitre).CurrentValues.SetValues(titre);
// Handle many-to-many relationships
this.logger.LogDebug("Mise à jour des relations many-to-many (Styles)");
this.context.Entry(existingTitre).Collection(t => t.Styles).Load();
existingTitre.Styles.Clear();
foreach (var style in titre.Styles)
{
existingTitre.Styles.Add(style);
}
this.context.SaveChanges();
this.logger.LogDebug("Titre mis à jour avec succès: {IdTitre}", titre.IdTitre);
}
else
{
this.logger.LogWarning("Titre avec l'ID {IdTitre} non trouvé pour la mise à jour", titre.IdTitre);
throw new InvalidOperationException($"Titre avec l'ID {titre.IdTitre} non trouvé.");
this.logger.LogWarning("Aucun titre trouvé avec l'ID: {IdTitre}", titre.IdTitre);
}
this.context.SaveChanges();
this.logger.LogDebug("Titre mis à jour avec succès: {IdTitre}", titre.IdTitre);
}
catch (DbUpdateException ex)
{

View File

@@ -1,10 +1,13 @@
namespace Webzine.WebApplication.Areas.Administration.Controllers;
using Business.Contracts;
using Microsoft.AspNetCore.Mvc;
using Microsoft.AspNetCore.Mvc.Rendering;
using Webzine.Entity;
using Webzine.Repository.Contracts;
using Webzine.Business.Contracts.Dto;
using Webzine.WebApplication.Areas.Administration.ViewModels.Titre;
/// <summary>
@@ -17,6 +20,7 @@ public class TitreController : Controller
private readonly ITitreRepository titreRepository;
private readonly IArtisteRepository artisteRepository;
private readonly IStyleRepository styleRepository;
private readonly ITitreAdminService titreAdminService;
/// <summary>
/// Initializes a new instance of the <see cref="TitreController"/> class.
@@ -26,12 +30,14 @@ public class TitreController : Controller
/// <param name="titreRepository">Repository des titres injecté pour accéder aux données des titres.</param>
/// <param name="artisteRepository">Repository des artistes injecté pour accéder aux données des artistes, nécessaires pour les associations avec les titres.</param>
/// <param name="styleRepository">Repository des styles injecté pour accéder aux données des styles, nécessaires pour les associations avec les titres.</param>
public TitreController(ILogger<TitreController> logger, ITitreRepository titreRepository, IArtisteRepository artisteRepository, IStyleRepository styleRepository)
/// <param name="titreAdminService">Service Titre Administration injecté gérant Edit et Crée.</param>
public TitreController(ILogger<TitreController> logger, ITitreRepository titreRepository, IArtisteRepository artisteRepository, IStyleRepository styleRepository, ITitreAdminService titreAdminService)
{
this.logger = logger;
this.titreRepository = titreRepository;
this.artisteRepository = artisteRepository;
this.styleRepository = styleRepository;
this.titreAdminService = titreAdminService;
}
/// <summary>
@@ -81,6 +87,23 @@ public class TitreController : Controller
return this.View(model);
}
/// <summary>
/// Traite la soumission du formulaire de création d'un titre.
/// </summary>
/// <param name="model">Données saisies dans le formulaire.</param>
/// <returns>Redirection vers Index en cas de succès, réaffichage du formulaire sinon.</returns>
[HttpPost]
public IActionResult Create(TitreAdminDTO model)
{
if (this.ModelState.IsValid)
{
this.titreAdminService.CreerTitre(model);
return this.RedirectToAction("Index");
}
return this.View(model);
}
/// <summary>
/// Affiche le formulaire de modification d'un titre existant dans la vue Edit, en préremplissant les champs avec les données du titre sélectionné. Les listes déroulantes pour les artistes et les styles sont également remplies pour permettre à l'utilisateur de modifier ces associations.
/// </summary>
@@ -121,6 +144,23 @@ public class TitreController : Controller
return this.View(model);
}
/// <summary>
/// Traite la soumission du formulaire de modification d'un titre.
/// </summary>
/// <param name="model">Données saisies dans le formulaire.</param>
/// <returns>Redirection vers Index en cas de succès, réaffichage du formulaire sinon.</returns>
[HttpPost]
public IActionResult Edit(TitreAdminDTO model)
{
if (this.ModelState.IsValid)
{
this.titreAdminService.ModifierTitre(model);
return this.RedirectToAction("Index");
}
return this.View(model);
}
/// <summary>
/// Affiche la vue de confirmation de suppression d'un titre, en récupérant les détails du titre à supprimer à partir de l'identifiant fourni. Le ViewModel contient les informations essentielles du titre, telles que le libellé et le nom de l'artiste, pour permettre à l'utilisateur de confirmer la suppression.
/// </summary>
@@ -157,8 +197,9 @@ public class TitreController : Controller
if (titre != null)
{
this.titreRepository.Delete(titre);
return this.RedirectToAction("Index");
}
return this.RedirectToAction("Index");
return this.View(model);
}
}

View File

@@ -0,0 +1,13 @@
namespace Webzine.WebApplication.Configuration;
/// <summary>
/// Options de seuil pour la détection des opérations EF Core lentes.
/// </summary>
public class EfPerformanceOptions
{
/// <summary>
/// Obtient ou définit le seuil en millisecondes au-delà duquel une commande SQL est journalisée.
/// Valeur par défaut : 200 ms.
/// </summary>
public int SeuilMs { get; set; } = 200;
}

View File

@@ -52,6 +52,8 @@ namespace Webzine.WebApplication.Controllers
return this.RedirectToAction("Index");
}
this.titreRepository.IncrementNbLectures(titre);
var vm = new TitreDetail
{
Details = new TitreContent
@@ -111,10 +113,11 @@ namespace Webzine.WebApplication.Controllers
if (titre == null)
{
this.logger.LogWarning("Impossible d'ajouter un like. Titre ID {Id} introuvable.", model.IdTitre);
return this.RedirectToAction("Index");
}
titre.NbLikes++;
else
{
this.titreRepository.IncrementNbLikes(titre);
}
return this.RedirectToAction("Details", new { id = model.IdTitre });
}

View File

@@ -0,0 +1,146 @@
namespace Webzine.WebApplication.Interceptors;
using System.Data.Common;
using System.Diagnostics;
using Configuration;
using Microsoft.EntityFrameworkCore.Diagnostics;
using Microsoft.Extensions.Options;
/// <summary>
/// Intercepteur EF Core qui journalise uniquement les commandes SQL dépassant le seuil configuré.
/// Remonte la pile d'appels pour identifier la méthode repository (<c>Webzine.Repository.*</c>) à l'origine de la requête.
/// </summary>
/// <remarks>
/// <para>
/// <b>Références :</b>
/// <list type="bullet">
/// <item>
/// EF Core interceptors (doc officielle) :
/// <see href="https://learn.microsoft.com/en-us/ef/core/logging-events-diagnostics/interceptors"/>
/// </item>
/// <item>
/// <see cref="DbCommandInterceptor"/> API :
/// <see href="https://learn.microsoft.com/en-us/dotnet/api/microsoft.entityframeworkcore.diagnostics.dbcommandinterceptor"/>
/// </item>
/// <item>
/// Exemple de slow-query interceptor (SO) :
/// <see href="https://medium.com/@sudipdevdev/how-to-detect-and-log-slow-queries-in-entity-framework-core-e2ab71024849"/>
/// </item>
/// <item>
/// <see cref="System.Diagnostics.StackTrace"/> pour remonter l'appelant :
/// <see href="https://learn.microsoft.com/en-us/dotnet/api/system.diagnostics.stacktrace"/>
/// </item>
/// <item>
/// Enregistrement via <c>AddInterceptors</c> :
/// <see href="https://learn.microsoft.com/en-us/ef/core/logging-events-diagnostics/interceptors#registering-interceptors"/>
/// </item>
/// </list>
/// </para>
/// </remarks>
public class EfSlowQueryInterceptor : DbCommandInterceptor
{
private readonly ILogger<EfSlowQueryInterceptor> logger;
private readonly int seuilMs;
/// <summary>
/// Initializes a new instance of the <see cref="EfSlowQueryInterceptor"/> class.
/// </summary>
/// <param name="logger">Le service de journalisation injecté pour suivre les opérations de l'intercepteur.</param>
/// <param name="options">Les options de performance EF injectées pour récupérer le seuil de lenteur configuré.</param>
public EfSlowQueryInterceptor(ILogger<EfSlowQueryInterceptor> logger, IOptions<EfPerformanceOptions> options)
{
this.logger = logger;
this.seuilMs = options.Value.SeuilMs;
this.logger.LogDebug("[EfSlowQueryInterceptor] Constructeur appelé — seuil : {SeuilMs} ms.", this.seuilMs);
}
/// <inheritdoc/>
public override DbDataReader ReaderExecuted(DbCommand command, CommandExecutedEventData eventData, DbDataReader result)
{
this.JournaliserSiLent(eventData.Duration);
return result;
}
/// <inheritdoc/>
public override ValueTask<DbDataReader> ReaderExecutedAsync(DbCommand command, CommandExecutedEventData eventData, DbDataReader result, CancellationToken cancellationToken = default)
{
this.JournaliserSiLent(eventData.Duration);
return ValueTask.FromResult(result);
}
/// <inheritdoc/>
public override int NonQueryExecuted(DbCommand command, CommandExecutedEventData eventData, int result)
{
this.JournaliserSiLent(eventData.Duration);
return result;
}
/// <inheritdoc/>
public override ValueTask<int> NonQueryExecutedAsync(DbCommand command, CommandExecutedEventData eventData, int result, CancellationToken cancellationToken = default)
{
this.JournaliserSiLent(eventData.Duration);
return ValueTask.FromResult(result);
}
/// <inheritdoc/>
public override object? ScalarExecuted(DbCommand command, CommandExecutedEventData eventData, object? result)
{
this.JournaliserSiLent(eventData.Duration);
return result;
}
/// <inheritdoc/>
public override ValueTask<object?> ScalarExecutedAsync(DbCommand command, CommandExecutedEventData eventData, object? result, CancellationToken cancellationToken = default)
{
this.JournaliserSiLent(eventData.Duration);
return ValueTask.FromResult(result);
}
/// <summary>
/// Remonte la pile d'appels pour trouver la première méthode dans <c>Webzine.Repository</c>.
/// Toutes les requêtes EF Core du projet transitent par ce namespace, ce qui garantit
/// un résultat pertinent sans parcourir l'intégralité de la stack.
/// </summary>
/// <returns>Chaîne <c>Classe.Méthode</c> ou <c>"inconnu"</c> si rien trouvé.</returns>
/// <remarks>
/// <see cref="StackTrace"/> est instancié uniquement quand le seuil est dépassé,
/// ce qui évite tout impact sur le chemin nominal.
/// Ref : <see href="https://learn.microsoft.com/en-us/dotnet/api/system.diagnostics.stacktrace"/>.
/// </remarks>
private static string TrouverAppelantRepository()
{
// skipFrames: 1 pour sauter TrouverAppelantRepository elle-même
// fNeedFileInfo: false — on ne veut pas les numéros de ligne (coût supplémentaire inutile)
var frames = new StackTrace(skipFrames: 1, fNeedFileInfo: false).GetFrames();
foreach (var frame in frames)
{
var methode = frame.GetMethod();
if (methode?.DeclaringType?.Namespace?.StartsWith("Webzine.Repository", StringComparison.Ordinal) == true)
{
return $"{methode.DeclaringType.Name}.{methode.Name}";
}
}
return "inconnu";
}
private void JournaliserSiLent(TimeSpan duree)
{
if (duree.TotalMilliseconds > this.seuilMs)
{
var appelant = TrouverAppelantRepository();
this.logger.LogWarning(
"[EfSlowQueryInterceptor] Opération EF Core lente détectée — durée réelle : {DureeMs} ms — seuil : {SeuilMs} ms — dépassement : +{Depassement} ms.{NewLine}Appelant : {Appelant}",
duree.TotalMilliseconds.ToString("F2"),
this.seuilMs,
(duree.TotalMilliseconds - this.seuilMs).ToString("F2"),
Environment.NewLine,
appelant);
}
}
}

View File

@@ -15,6 +15,7 @@ using Webzine.Repository;
using Webzine.Repository.Contracts;
using Webzine.WebApplication.Configuration;
using Webzine.WebApplication.Extensions;
using Webzine.WebApplication.Interceptors;
// Initiation du logger NLog pour la classe courante afin de pouvoir l'utiliser pour logger des messages d'information, d'erreur, etc avant la construction de l'application.
var logger = LogManager.Setup().LoadConfigurationFromAppSettings().GetCurrentClassLogger();
@@ -37,6 +38,12 @@ try
builder.Logging.ClearProviders();
builder.Host.UseNLog();
builder.Services.Configure<EfPerformanceOptions>(options =>
{
options.SeuilMs = builder.Configuration.GetValue<int>("EfPerformance:SeuilMs");
});
builder.Services.AddSingleton<EfSlowQueryInterceptor>();
// En fonction de la configuration, utilise soit les repositories basés sur une base de données, soit les repositories basés sur des listes locales.
var repositoryType = builder.Configuration.GetValue<RepositoryType>("Repository");
var seederType = builder.Configuration.GetValue<SeederType>("Seeder");
@@ -45,13 +52,21 @@ try
{
if (builder.Environment.IsProduction())
{
builder.Services.AddDbContext<WebzineDbContext>(options =>
options.UseNpgsql(builder.Configuration.GetConnectionString("PostGreSQLConnection")));
builder.Services.AddDbContext<WebzineDbContext>((serviceProvider, options) =>
{
options
.UseNpgsql(builder.Configuration.GetConnectionString("PostGreSQLConnection"))
.AddInterceptors(serviceProvider.GetRequiredService<EfSlowQueryInterceptor>());
});
}
else
{
builder.Services.AddDbContext<WebzineDbContext>(options =>
options.UseSqlite(builder.Configuration.GetConnectionString("SqliteConnection")));
builder.Services.AddDbContext<WebzineDbContext>((serviceProvider, options) =>
{
options
.UseSqlite(builder.Configuration.GetConnectionString("SqliteConnection"))
.AddInterceptors(serviceProvider.GetRequiredService<EfSlowQueryInterceptor>());
});
}
builder.Services.AddScoped<DbEntityRepository>();
@@ -70,6 +85,7 @@ try
}
builder.Services.AddScoped<IDashboardService, DashboardService>();
builder.Services.AddScoped<ITitreAdminService, TitreAdminService>();
// https://learn.microsoft.com/fr-fr/aspnet/core/performance/response-compression?view=aspnetcore-10.0#configuration
// Ajoute le service de compression des réponses HTTP pour réduire la taille des données envoyées au client et améliorer les performances de l'application.

View File

@@ -13,5 +13,8 @@
"SqliteConnection": "Data Source=Data/webzine.sqlite",
"PostGreSQLConnection": "Host=localhost;Port=5432;Username=admin;Password=admin123;Database=webzine_db"
},
"AllowedHosts": "*"
"AllowedHosts": "*",
"EfPerformance": {
"SeuilMs": 10
}
}

View File

@@ -22,7 +22,7 @@
layout="${longdate}|${level:uppercase=true}|${logger}|${message} ${exception:format=tostring}|${aspnet-request-url:whenEmpty=NoRequest}" />
<!-- Console pour debug immédiat -->
<target xsi:type="Console" name="console"
<target xsi:type="Console" name="Info"
layout="${longdate}|${level:uppercase=true}|${logger}|${message}" />
</targets>