73 — Lifecycle-Mails

Lifecycle-Mails sind automatisch ausgelöste Benachrichtigungen bei wichtigen Status-Wechseln im Tenant- und Subscription-Lifecycle.

Trigger-Übersicht

Tenant-Lifecycle

Event	Trigger	Mail an
TenantCreated	Signup oder Plattform-Provisioning	Tenant-Owner (Welcome + Onboarding-Checkliste)
TenantSuspended	Plattform-Admin setzt suspended	Tenant-Owner (Hinweis + Kontakt)
TenantReactivated	Plattform-Admin reaktiviert	Tenant-Owner (Bestätigung)

Subscription-Lifecycle (über Stripe)

Event	Mail-Versand
trial → active	Keine Mail (positiv, kein User-Stress)
active → past_due	Warnung an Owner: „Letzte Abbuchung fehlgeschlagen — Stripe versucht in 24 h erneut"
past_due → unpaid	Härtere Warnung: „Subscription pausiert — bitte Zahlungsmethode aktualisieren"
→ canceled	Bestätigung: „Subscription gekündigt — Zugang bleibt bis Periodenende, Daten 30 Tage"
past_due → active	Recovery-Bestätigung: „Vielen Dank, die Zahlung war erfolgreich"
trial → 3 Tage vor Ende	Reminder: „Trial endet bald — bitte Zahlungsmethode hinterlegen"

Sonstiges

• Partner-Welcome: Nach Aktivierung.
• Partner-Invite: Bei Admin-Einladung.
• Payout-Notification: Bei Approval einer Gutschrift.
• Newsletter Approval/Rejection: Bei Tenant-Genehmigung/-Ablehnung von Partner-Newslettern.

Bewusst keine Mail bei harmlosen Wechseln

Bei Übergängen wie trialing → active (positiver Auto-Charge) wird keine Mail gesendet — vermeidet Mail-Müdigkeit. Der User sieht den Status sowieso im Admin-Portal.

Anti-Spam

• Max. 1 Mail pro Trigger und Tenant pro 24 h (über Idempotenz-Hashes).
• Bei mehreren Status-Wechseln in kurzer Zeit (z. B. past_due → unpaid → active innerhalb Stunden) wird nur die finale relevante Mail gesendet.

Sprache

Lifecycle-Mails nutzen die Tenant.defaultLocale für Tenant-Mails, Partner.language für Partner-Mails.

Customization

Tenant-Owner kann den Inhalt der Lifecycle-Mails nicht anpassen — sie sind System-Mails. Aber:

• Logo und Brand-Color kommen aus dem Tenant-Branding.
• From-Address aus den Email-Settings.
• Footer aus dem 3-Mode-Pattern.

Für anpassbare Mails nutzen Sie das Notification-System (siehe 70) mit Template-Editor.

Superadmin-Broadcast

Plattform-Owner kann zusätzlich plattformweite Mails an alle Tenant-Owner senden (z. B. Wartungsfenster-Ankündigung):

• Admin → „Broadcast".
• Filter: nach Tier, nach Subscription-Status.
• Versand in Chunks von 50.

Verwandte Kapitel

• 70 — Notification-System
• 71 — Email-Whitelabel
• 72 — Email-Templates
• 100 — Billing-Pläne
• 101 — Trial & Subscription-Status

---

Technische Tiefen-Doku: ../099-tenant-lifecycle-events.md, ../104-daily-scheduler.md