U1 mail-foundation (backend): verzender, opties, sjabloon, SiteSettings met toegestane afzenderlijst

IEmailSender met MailKit-implementatie (StartTls, timeout, fouten als waarde), opties met
startvalidatie, nl/en sjabloon, taalkeuze, tabel SiteSettings (additieve migratie),
SiteSettings-API (Beheerder leest, Eigenaar wijzigt) en emailEnabled/defaultLanguage in de
capabilities. Zonder SMTP-host verandert er niets.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-11-08 18:22:26 +01:00
co-authored by Claude Sonnet 5.5
parent 1a2fb56e1e
commit 745f0b2203
27 changed files with 2069 additions and 2 deletions
+15
View File
@@ -69,6 +69,21 @@ De API gebruikt een beveiligde flow voor authenticatie:
- **Rate Limiting**: Login endpoints hebben rate limiting (Fixed window 5/min, Sliding window 20/min). De limieten gelden **per clientadres**. Achter een reverse proxy is dat alleen het echte bezoekersadres als `ForwardedHeaders__KnownProxies__0` (en volgende) het IP van de proxy bevat; zonder die instelling worden `X-Forwarded-*`-headers genegeerd en delen alle bezoekers het adres van de proxy (één bucket, het gedrag van vóór deze optie). Alleen de opgegeven proxies worden vertrouwd (één hop); een onparseerbaar of wildcard-adres (`0.0.0.0`, `::`) laat de host bij **opstarten** falen.
- **Error Handling**: Foutmeldingen volgen de RFC 9457 `ProblemDetails` standaard.
## E-mail (uitnodigingen, wachtwoord opnieuw instellen, meldingen)
E-mail staat standaard UIT: zolang `Email:Smtp:Host` leeg is, werkt alles zoals voorheen (de beheerder kopieert de uitnodigingslink). Aanzetten per omgeving met omgevingsvariabelen (geheimen nooit in een bestand in de repo):
| Variabele | Voorbeeld |
|---|---|
| `Email__Smtp__Host` | `mail.slpsoftware.nl` (zet e-mail aan) |
| `Email__Smtp__Port` / `Email__Smtp__EnableSsl` | `587` / `true` (STARTTLS) |
| `Email__Smtp__Username` / `Email__Smtp__Password` | geheimen, alleen in `shared/env` (mode 600) |
| `App__PublicBaseUrl` | `https://test.andreaslop.nl` (https, zonder pad; http alleen voor localhost) |
| `Email__FromAddress` / `Email__FromName` | `no-reply@slpsoftware.nl` / sitenaam |
| `Email__AllowedFromAddresses__0` | extra afzenderadressen die de eigenaar bij Instellingen mag kiezen |
Lokaal: smtp4dev op `localhost:25` (`Email__Smtp__Host=localhost`, `Email__Smtp__Port=25`, `Email__Smtp__EnableSsl=false`). De opstart weigert een onjuiste mailconfiguratie met een duidelijke melding (zonder geheimen). Afzenderadres en -naam stelt de eigenaar in bij Instellingen, Mail; het adres kan alleen uit de toegestane lijst worden gekozen (SPF/DKIM). Details: `aidlc-docs/features/identity-email-notifications/`.
## Frontend Development (CMS Admin UI)
De frontend is een Vite + React 19 + TypeScript single-page application in de map `frontend/`. Hij gebruikt TanStack Router, Tailwind v4 (hoofdkleur `#ac0000`) met shadcn/ui-stijl componenten, react-i18next (NL/EN), en MSW voor mocking in tests.