Sistema de Notificaciones y Baja One-Click

Backend/MotoresArgentinosV2.Core/Interfaces/INotificationPreferenceService.cs

@@ -0,0 +1,39 @@
+using MotoresArgentinosV2.Core.DTOs;
+
+namespace MotoresArgentinosV2.Core.Interfaces;
+
+/// <summary>
+/// Servicio para gestionar preferencias de notificación por email y tokens de baja.
+/// </summary>
+public interface INotificationPreferenceService
+{
+    /// <summary>
+    /// Retorna las preferencias actuales del usuario (todas las categorías).
+    /// </summary>
+    Task<NotificationPreferencesDto> GetPreferencesAsync(int userId);
+
+    /// <summary>
+    /// Guarda las preferencias enviadas desde el perfil del usuario.
+    /// </summary>
+    Task UpdatePreferencesAsync(int userId, UpdateNotificationPreferencesDto dto);
+
+    /// <summary>
+    /// Verifica si un usuario tiene habilitada una categoría de correo.
+    /// Usa para chequear ANTES de enviar cada notificación del sistema.
+    /// </summary>
+    Task<bool> IsEnabledAsync(int userId, string category);
+
+    /// <summary>
+    /// Genera (o reutiliza) un token de baja firmado para incluir en el footer de un correo.
+    /// </summary>
+    Task<string> GetOrCreateUnsubscribeTokenAsync(int userId, string category);
+
+    /// <summary>
+    /// Procesa la baja del usuario desde el enlace one-click (sin login).
+    /// Valida el token y actualiza la preferencia correspondiente.
+    /// </summary>
+    /// <returns>
+    /// (Success, CategoryLabel) indicando si se procesó OK y el nombre legible de la categoría.
+    /// </returns>
+    Task<(bool Success, string CategoryLabel)> UnsubscribeAsync(string token);
+}