E-Mail-System

E-Mail-System

3-Stufen-Architektur (asynchron)

1. Handler (alle 10s): Prueft auf ausstehende Business-Events
   • TwoFactorCodeHandler — prueft login_attempt auf neue 2FA-Codes
   • WelcomeHandler — prueft auf neue Accounts
2. Preparation Worker (alle 10s): Rendert Templates, erstellt system_message
   • Template-Lookup: Site → Tenant → System (3-Ebenen-Hierarchie)
   • Uebersetzungen aus email_translation_key (Scope: global/tenant/site)
   • Idempotent: NOT EXISTS Pruefung vor Insert
3. Dispatch Worker (alle 10s): Versendet pending Mails
   • Produktion: AWS SES
   • Entwicklung: SMTP (MailHog)
   • Max 3 Retries, trackt sent_at oder failed_at

Templates

Vorhandene Templates (DB-Seeds)

Template	Beschreibung
layout	Basis-HTML-Layout
signature	E-Mail-Signatur
two_factor_code	2FA-Code mit Standort, IP, Geraet
password_reset_code	Reset-Code (Admin-initiiert)
password_changed	Bestaetigung nach Passwort-Aenderung
account_deactivated	Account-Deaktivierung durch Admin
new_device_login	Login von neuem Geraet nach 2FA
contact_notification	Benachrichtigung bei Kontaktanfrage
contact_confirmation	Bestaetigung an Besucher
welcome	Willkommens-E-Mail mit Login-Link

Template-Hierarchie (3 Ebenen)

Ebene	Beschreibung
System-Default	Basis-Templates (von Agency gepflegt)
Tenant-Override	Kunde ueberschreibt fuer seinen Mandanten
Site-Override	Spezifisch pro Website des Kunden

Lookup-Reihenfolge: Site → Tenant → System. Erstes Ergebnis gewinnt.

Uebersetzungen

DE + EN Seeds fuer alle gaengigen Strings (Anrede, Betreff, Footer, etc.). Scope-Hierarchie: Site → Tenant → Global.

E-Mail-Adressen-Modell

Separate email-Tabelle (dedupliziert per SHA-256) mit email_relation-Verknuepfung. account.email existiert nicht — Login laeuft ueber email_relation (type: account_primary).

E-Mail-Typen Stufe 1

Typ	Empfaenger	Ausloeser
2FA-Login-Code	Account-User	Login von unbekanntem Device
Password-Reset-Code	Account-User	Admin loest Reset aus
Password-Changed	Account-User	Passwort geaendert
Account-Deactivated	Account-User	Admin deaktiviert Account
New-Device-Login	Account-User	Login von neuem Geraet
Kontakt-Notification	Tenant-Kontaktadresse	Neue Kontaktanfrage
Kontakt-Bestaetigung	Besucher	Kontaktanfrage abgeschickt
Willkommen	Account-User	Account angelegt