Merge pull request #9 from pierrick-fonquerne/FRO-45-Service-d-email-centralise

Fro 45 service d email centralise

Author: pierrick-fonquerne

.github/workflows/ci.yml

@@ -44,7 +44,7 @@ jobs:
 
       - name: Test
         if: steps.check.outputs.exists == 'true'
-        run: dotnet test --no-build --configuration Release --verbosity normal
+        run: dotnet test --no-build --configuration Release --verbosity normal --filter "Category!=Email"
 
       - name: Skip (no backend yet)
         if: steps.check.outputs.exists == 'false'

src/backend/src/FantasyRealm.Api/FantasyRealm.Api.csproj

@@ -1,9 +1,10 @@
-<Project Sdk="Microsoft.NET.Sdk.Web">
+<Project Sdk="Microsoft.NET.Sdk.Web">
 
   <PropertyGroup>
     <TargetFramework>net8.0</TargetFramework>
     <Nullable>enable</Nullable>
     <ImplicitUsings>enable</ImplicitUsings>
+    <UserSecretsId>007759ae-ee7a-4987-a1c3-cc316e317846</UserSecretsId>
   </PropertyGroup>
 
   <ItemGroup>

src/backend/src/FantasyRealm.Api/appsettings.json

@@ -12,5 +12,14 @@
   },
   "MongoDB": {
     "DatabaseName": "fantasyrealm"
+  },
+  "Email": {
+    "Host": "ssl0.ovh.net",
+    "Port": 587,
+    "UseSsl": true,
+    "Username": "noreply@fantasy-realm.com",
+    "Password": "",
+    "FromAddress": "noreply@fantasy-realm.com",
+    "FromName": "FantasyRealm"
   }
 }

src/backend/src/FantasyRealm.Application/Interfaces/.gitkeep

@@ -0,0 +1,79 @@
+namespace FantasyRealm.Application.Interfaces
+{
+    /// <summary>
+    /// Defines the contract for email sending operations.
+    /// </summary>
+    public interface IEmailService
+    {
+        /// <summary>
+        /// Sends a welcome email to a newly registered user.
+        /// </summary>
+        /// <param name="toEmail">The recipient's email address.</param>
+        /// <param name="pseudo">The user's display name.</param>
+        /// <param name="cancellationToken">A cancellation token.</param>
+        /// <returns>A task representing the asynchronous operation.</returns>
+        Task SendWelcomeEmailAsync(string toEmail, string pseudo, CancellationToken cancellationToken = default);
+
+        /// <summary>
+        /// Sends a password reset email with a reset link.
+        /// </summary>
+        /// <param name="toEmail">The recipient's email address.</param>
+        /// <param name="pseudo">The user's display name.</param>
+        /// <param name="resetToken">The password reset token.</param>
+        /// <param name="cancellationToken">A cancellation token.</param>
+        /// <returns>A task representing the asynchronous operation.</returns>
+        Task SendPasswordResetEmailAsync(string toEmail, string pseudo, string resetToken, CancellationToken cancellationToken = default);
+
+        /// <summary>
+        /// Sends a notification when a character has been approved by an employee.
+        /// </summary>
+        /// <param name="toEmail">The recipient's email address.</param>
+        /// <param name="pseudo">The user's display name.</param>
+        /// <param name="characterName">The name of the approved character.</param>
+        /// <param name="cancellationToken">A cancellation token.</param>
+        /// <returns>A task representing the asynchronous operation.</returns>
+        Task SendCharacterApprovedEmailAsync(string toEmail, string pseudo, string characterName, CancellationToken cancellationToken = default);
+
+        /// <summary>
+        /// Sends a notification when a character has been rejected by an employee.
+        /// </summary>
+        /// <param name="toEmail">The recipient's email address.</param>
+        /// <param name="pseudo">The user's display name.</param>
+        /// <param name="characterName">The name of the rejected character.</param>
+        /// <param name="reason">The reason for rejection.</param>
+        /// <param name="cancellationToken">A cancellation token.</param>
+        /// <returns>A task representing the asynchronous operation.</returns>
+        Task SendCharacterRejectedEmailAsync(string toEmail, string pseudo, string characterName, string reason, CancellationToken cancellationToken = default);
+
+        /// <summary>
+        /// Sends a notification when a comment has been approved.
+        /// </summary>
+        /// <param name="toEmail">The recipient's email address.</param>
+        /// <param name="pseudo">The user's display name.</param>
+        /// <param name="characterName">The name of the character that was commented on.</param>
+        /// <param name="cancellationToken">A cancellation token.</param>
+        /// <returns>A task representing the asynchronous operation.</returns>
+        Task SendCommentApprovedEmailAsync(string toEmail, string pseudo, string characterName, CancellationToken cancellationToken = default);
+
+        /// <summary>
+        /// Sends a notification when a comment has been rejected.
+        /// </summary>
+        /// <param name="toEmail">The recipient's email address.</param>
+        /// <param name="pseudo">The user's display name.</param>
+        /// <param name="characterName">The name of the character that was commented on.</param>
+        /// <param name="reason">The reason for rejection.</param>
+        /// <param name="cancellationToken">A cancellation token.</param>
+        /// <returns>A task representing the asynchronous operation.</returns>
+        Task SendCommentRejectedEmailAsync(string toEmail, string pseudo, string characterName, string reason, CancellationToken cancellationToken = default);
+
+        /// <summary>
+        /// Sends a notification when the user's account has been suspended.
+        /// </summary>
+        /// <param name="toEmail">The recipient's email address.</param>
+        /// <param name="pseudo">The user's display name.</param>
+        /// <param name="reason">The reason for suspension.</param>
+        /// <param name="cancellationToken">A cancellation token.</param>
+        /// <returns>A task representing the asynchronous operation.</returns>
+        Task SendAccountSuspendedEmailAsync(string toEmail, string pseudo, string reason, CancellationToken cancellationToken = default);
+    }
+}

src/backend/src/FantasyRealm.Application/Interfaces/IEmailService.cs

@@ -1,3 +1,5 @@
+using FantasyRealm.Application.Interfaces;
+using FantasyRealm.Infrastructure.Email;
 using FantasyRealm.Infrastructure.Persistence;
 using Microsoft.EntityFrameworkCore;
 using Microsoft.Extensions.Configuration;
@@ -39,6 +41,10 @@ public static IServiceCollection AddInfrastructure(this IServiceCollection servi
                 });
             }
 
+            services.Configure<EmailSettings>(configuration.GetSection(EmailSettings.SectionName));
+            services.AddSingleton<ISmtpClientFactory, SmtpClientFactory>();
+            services.AddScoped<IEmailService, SmtpEmailService>();
+
             return services;
         }
     }

src/backend/src/FantasyRealm.Infrastructure/DependencyInjection.cs

@@ -0,0 +1,48 @@
+namespace FantasyRealm.Infrastructure.Email
+{
+    /// <summary>
+    /// Configuration settings for the SMTP email service.
+    /// </summary>
+    public class EmailSettings
+    {
+        /// <summary>
+        /// The configuration section name in appsettings.json.
+        /// </summary>
+        public const string SectionName = "Email";
+
+        /// <summary>
+        /// Gets or sets the SMTP server hostname.
+        /// </summary>
+        public string Host { get; set; } = string.Empty;
+
+        /// <summary>
+        /// Gets or sets the SMTP server port.
+        /// </summary>
+        public int Port { get; set; } = 587;
+
+        /// <summary>
+        /// Gets or sets whether to use SSL/TLS for the connection.
+        /// </summary>
+        public bool UseSsl { get; set; } = true;
+
+        /// <summary>
+        /// Gets or sets the SMTP authentication username.
+        /// </summary>
+        public string Username { get; set; } = string.Empty;
+
+        /// <summary>
+        /// Gets or sets the SMTP authentication password.
+        /// </summary>
+        public string Password { get; set; } = string.Empty;
+
+        /// <summary>
+        /// Gets or sets the sender email address.
+        /// </summary>
+        public string FromAddress { get; set; } = string.Empty;
+
+        /// <summary>
+        /// Gets or sets the sender display name.
+        /// </summary>
+        public string FromName { get; set; } = string.Empty;
+    }
+}