shopit-back/app/Domains/Notification/documentacion
ncoronel dc33e5dc09 fix: consolidate purchase confirmation emails 2026-08-26 11:29:53 -03:00
..
README.md fix: consolidate purchase confirmation emails 2026-08-26 11:29:53 -03:00

README.md

Dominio Notification

Propósito

Orquesta notificaciones de negocio por correo a partir de eventos de otros dominios.

Eventos atendidos

  • UserRegistered: dispara el correo de bienvenida.
  • PasswordResetRequested: envía el código de recuperación si el intento sigue pendiente.
  • PurchasePaid: envía la confirmación de compra y adjunta los tickets generados, cuando corresponde.

Componentes

Los listeners SendWelcomeEmail, SendPasswordResetEmail y SendPurchaseConfirmedEmail delegan en NotificationMailService. Este servicio carga el contexto necesario, renderiza las vistas y envía mediante Integration/MailService.

API y dependencias

No expone rutas HTTP. Consume datos de Auth, Tenant, Purchase y Ticket, y delega la entrega al dominio Integration.

Consideraciones

  • Los listeners reciben identificadores y vuelven a cargar los modelos, evitando transportar entidades obsoletas.
  • La recuperación no se envía si el intento dejó de estar pendiente.
  • Los correos de cuenta (bienvenida y recuperación de contraseña) usan la identidad visual del WebsiteType asociado al tenant, con fallback al tenant si no tiene uno configurado.
  • El correo transaccional de compra confirmada usa la identidad visual del tenant y adjunta un único PDF cuando la compra generó tickets.
  • Los handlers deben permanecer idempotentes o tolerantes a reintentos de cola.