Files
slp-modular-cms/aidlc-docs/features/identity-email-notifications/operations/deployment/rollback-plan.md
T
SluijsensandClaude Sonnet 5.5 3a9e4ae7aa E-mailfeature Operations: deployment, monitoring, productiegereedheid; configuratiefouten als Error-log
Mislukte mails door een configuratieprobleem (auth_failed, rejected_sender, tls_failed, not_configured) worden
als Error gelogd zodat Sentry een alert stuurt; timeouts en ontvangerproblemen blijven Warning.
Documentatie: uitrol per host met de hand in shared/env, rollback, monitoringplan, checklist; ASF-productie op
IIS als open punt voor een latere feature.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-09 09:24:19 +01:00

1.4 KiB

Rollback plan - identity-email-notifications

Decision (Q7 A).

  1. Switch mail off quickly (no code change): remove Email__Smtp__Host from the host's environment file and restart the unit. The admin hides every mail feature (emailEnabled=false), invitations work by copying the link, the two anonymous endpoints answer 404. Nothing is lost.
  2. Bad release: use the existing previous-release switch of the deploy (re-point current to the previous release and restart; see the andreaslop-site-hosting rollback plan for the Pi). The three database changes of this feature (SiteSettings table, Users.PreferredLanguage, Invitations.Language) are additive and nullable; the previous code simply ignores them, so no database change is needed to go back.
  3. After a rollback of the code: access tokens issued by the newer release carry a security-stamp claim that the old code ignores; they keep working. Tokens issued by the old code lack the claim and are refused once by a newer release (the silent refresh fixes that).
  4. A documented way to drop the new columns and table is deliberately not part of the plan (Bryan chose option A); it would only be needed for a full restore.
  5. IIS (later, ASF production): the same two switches exist in another form (remove the variable and recycle the app pool; keep the previous release folder and switch the physical path).