F-152 — Tech Spec

Principios

Best-effort: un email fallido o SMTP no configurado nunca debe fallar el registro ni el webhook de pagos. Se loguea y se continúa.
Reusar infraestructura existente: SMTP desde store_settings (smtp_host/port/secure/user/pass/from), mismo patrón que SettingsPasswordResetMailer y sendOrderStatusEmail.
Boundaries: identity no importa orders/payments a nivel de dominio; el wiring del order-confirmation email se hace en el route handler de payments (posee deps.pool), reusando sendOrderStatusEmail exportado públicamente por orders/index.ts.

orders/index.ts: exportar sendOrderStatusEmail (y ORDER_STATE_LABELS).
payments/api/payments.routes.ts: en el handler de /payments/webhook, tras const outcome = await service.handleWebhook(event), si event.type === 'PaymentSucceeded' && event.orderId && outcome.kind === 'processed', fetch customer email (identity_users.email via orders_orders.user_id) y sendOrderStatusEmail(deps.pool, { to, orderId: event.orderId, state: 'PAID' }) dentro de try/catch; log de advertencia si falla SMTP/no-config.

identity/domain/ports.ts: nuevo puerto WelcomeMailer con sendWelcome(input: { email: string; name?: string }): Promise<void> (name es opcional: User no almacena nombre en el dominio actual).
identity/infrastructure/settings-welcome-mailer.ts: SettingsWelcomeMailer(pool) modelado en SettingsPasswordResetMailer — lee SMTP de store_settings, usa nodemailer, y una función pura buildWelcomeEmail (verificable sin SMTP). El subject (¡Bienvenido a Mercado de Vida!) coincide con la plantilla account_created de notificaciones. Lanza si SMTP no está configurado.
identity/api/identity.routes.ts: IdentityRoutesDeps.welcomeMailer?: WelcomeMailer; en el handler de POST /auth/register, tras registerUser.execute exitoso, se despacha el welcome email fire-and-forget (void mailer.sendWelcome(...).catch( request.log.warn(...))). Best-effort: un fallo SMTP se loguea (warning) y se traga; el registro nunca se rompe por email. RegisterUser se mantiene sin depender de email (puro orquestación de dominio).
identity/index.ts: re-exporta SettingsWelcomeMailer (y SettingsPasswordResetMailer) para que build-app.ts los importe desde el index en lugar de deep-importar infra (cumple R2 de boundaries).
notifications/domain/notification.ts + notifications/api/notifications.routes.ts: añadir account_created al union EmailTemplate, a los mapas SUBJECTS/BODIES de LoggingEmailProvider y al enum del schema de POST /notifications/dispatch.

Claves existentes: smtp_host, smtp_port, smtp_secure, smtp_user, smtp_pass, smtp_from. El welcome mailer reusa exactamente estas claves.

settings-welcome-mailer.test.ts: buildWelcomeEmail (greeting, nombre, XSS), SettingsWelcomeMailer.sendWelcome (nodemailer mockeado: sendmail called once con recipient == email y subject == plantilla account_created), y lanza cuando SMTP no está configurado (SMTP is not configured).
orders/tests/orders-index.test.ts: el barrel de orders/index.ts re-exporta sendOrderStatusEmail, buildOrderStatusEmail, ORDER_STATE_LABELS.
order-status-mailer.test.ts ya existe cubriendo buildOrderStatusEmail (PAID pertenece a ORDER_STATE_LABELS).
tsc --noEmit limpio; prettier --check y eslint limpios en los archivos tocados; suite completa de vitest verde (197 tests); lint:boundaries sin nuevas violaciones.
verify.sh green.