Feat: Implementa auditoría de envíos de email y mejora la UX
Se introduce un sistema completo de logging para todas las comunicaciones por correo electrónico y se realizan mejoras significativas en la experiencia del usuario, tanto en la retroalimentación del sistema como en la estética de los emails enviados al cliente. ### ✨ Nuevas Características - **Auditoría y Log de Envíos de Email:** - Se ha creado una nueva tabla `com_EmailLogs` en la base de datos para registrar cada intento de envío de correo. - El `EmailService` ahora centraliza toda la lógica de logging, registrando automáticamente la fecha, destinatario, asunto, estado (`Enviado` o `Fallido`), y mensajes de error detallados. - Se implementó un nuevo `EmailLogService` y `EmailLogRepository` para gestionar estos registros. - **Historial de Envíos en la Interfaz de Usuario:** - Se añade un nuevo ícono de "Historial" (<span style="color: #607d8b;">📧</span>) junto a cada factura en la página de "Consulta de Facturas". - Al hacer clic, se abre un modal que muestra una tabla detallada con todos los intentos de envío para esa factura, incluyendo el estado y el motivo del error (si lo hubo). - Esto proporciona una trazabilidad completa y una herramienta de diagnóstico para el usuario final. ### 🔄 Refactorización y Mejoras - **Mensajes de Éxito Dinámicos:** - Se ha mejorado la retroalimentación al enviar una factura por PDF. El sistema ahora muestra un mensaje de éxito específico, como "El email... se ha enviado correctamente a suscriptor@email.com", en lugar de un mensaje técnico genérico. - Se ajustó la cadena de llamadas (`Controller` -> `Service`) para que el email del destinatario esté disponible para la respuesta de la API. - **Diseño Unificado de Emails:** - Se ha rediseñado el template HTML para el "Aviso de Cuenta Mensual" para que coincida con la estética del email de "Envío de Factura PDF". - Ambos correos ahora presentan un diseño profesional y consistente, con cabecera, logo y pie de página, reforzando la imagen de marca. - **Manejo de Errores de Email Mejorado:** - El `EmailService` ahora captura excepciones específicas de la librería `MailKit` (ej. `SmtpCommandException`). - Esto permite registrar en el log errores mucho más precisos y útiles, como rechazos de destinatarios por parte del servidor (`User unknown`), fallos de autenticación, etc., que ahora son visibles en el `Tooltip` del historial.
This commit is contained in:
@@ -2,7 +2,50 @@ namespace GestionIntegral.Api.Services.Comunicaciones
|
||||
{
|
||||
public interface IEmailService
|
||||
{
|
||||
Task EnviarEmailAsync(string destinatarioEmail, string destinatarioNombre, string asunto, string cuerpoHtml, byte[]? attachment = null, string? attachmentName = null);
|
||||
Task EnviarEmailConsolidadoAsync(string destinatarioEmail, string destinatarioNombre, string asunto, string cuerpoHtml, List<(byte[] content, string name)> adjuntos);
|
||||
/// <summary>
|
||||
/// Envía un correo electrónico a un único destinatario, con la posibilidad de adjuntar un archivo.
|
||||
/// Este método también registra automáticamente el resultado del envío en la base de datos.
|
||||
/// </summary>
|
||||
/// <param name="destinatarioEmail">La dirección de correo del destinatario.</param>
|
||||
/// <param name="destinatarioNombre">El nombre del destinatario.</param>
|
||||
/// <param name="asunto">El asunto del correo.</param>
|
||||
/// <param name="cuerpoHtml">El contenido del correo en formato HTML.</param>
|
||||
/// <param name="attachment">Los bytes del archivo a adjuntar (opcional).</param>
|
||||
/// <param name="attachmentName">El nombre del archivo adjunto (requerido si se provee attachment).</param>
|
||||
/// <param name="origen">Identificador del proceso que dispara el email (ej. "EnvioManualPDF"). Para logging.</param>
|
||||
/// <param name="referenciaId">ID de la entidad relacionada (ej. "Factura-59"). Para logging.</param>
|
||||
/// <param name="idUsuarioDisparo">ID del usuario que inició la acción (si aplica). Para logging.</param>
|
||||
Task EnviarEmailAsync(
|
||||
string destinatarioEmail,
|
||||
string destinatarioNombre,
|
||||
string asunto,
|
||||
string cuerpoHtml,
|
||||
byte[]? attachment = null,
|
||||
string? attachmentName = null,
|
||||
string? origen = null,
|
||||
string? referenciaId = null,
|
||||
int? idUsuarioDisparo = null);
|
||||
|
||||
/// <summary>
|
||||
/// Envía un correo electrónico a un único destinatario, con la posibilidad de adjuntar múltiples archivos.
|
||||
/// Este método también registra automáticamente el resultado del envío en la base de datos.
|
||||
/// </summary>
|
||||
/// <param name="destinatarioEmail">La dirección de correo del destinatario.</param>
|
||||
/// <param name="destinatarioNombre">El nombre del destinatario.</param>
|
||||
/// <param name="asunto">El asunto del correo.</param>
|
||||
/// <param name="cuerpoHtml">El contenido del correo en formato HTML.</param>
|
||||
/// <param name="adjuntos">Una lista de tuplas que contienen los bytes y el nombre de cada archivo a adjuntar.</param>
|
||||
/// <param name="origen">Identificador del proceso que dispara el email (ej. "FacturacionMensual"). Para logging.</param>
|
||||
/// <param name="referenciaId">ID de la entidad relacionada (ej. "Suscriptor-3"). Para logging.</param>
|
||||
/// <param name="idUsuarioDisparo">ID del usuario que inició la acción (si aplica). Para logging.</param>
|
||||
Task EnviarEmailConsolidadoAsync(
|
||||
string destinatarioEmail,
|
||||
string destinatarioNombre,
|
||||
string asunto,
|
||||
string cuerpoHtml,
|
||||
List<(byte[] content, string name)> adjuntos,
|
||||
string? origen = null,
|
||||
string? referenciaId = null,
|
||||
int? idUsuarioDisparo = null);
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user