CMS: één bannerlijst met Locatie, SLP-thema, thema-schakelaar, documentatie
- Banner-admin: één lijst met Locatie-badge (Boven/Onder), Locatie-keuzeveld in het formulier, "Live" en "Wordt niet getoond" per locatie, aan/uit per rij - Thema slpsoftware: Archivo, bordeaux #7A1414 (WCAG AA licht en donker), <SLP/>-logo, favicon, mail-logo; VITE_THEME in de SLP-builds (test en productie-config) - Thema-schakelaar: eerste klik wisselt altijd het getoonde thema (klasse op <html> als bron van waarheid, gedeelde status, startscript valideert opslag) + tests - Docs: README, docs/cms-themas.md, docs/deploy-en-testomgevingen.md, docs/privacy-gegevens-contactformulier.md, aidlc-docs (offering-banners, bug theme-toggle-first-click) Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,40 @@
|
||||
# CMS-thema's per site
|
||||
|
||||
De admin (frontend) kan bij het bouwen een eigen uiterlijk krijgen. De standaardadmin blijft ongewijzigd als er geen thema is gekozen.
|
||||
|
||||
## Hoe het werkt
|
||||
|
||||
| Onderdeel | Waar | Gedrag |
|
||||
|---|---|---|
|
||||
| Keuze | omgevingsvariabele `VITE_THEME` bij `pnpm build` | Leeg of afwezig = standaardadmin. Een onbekende naam laat de build falen (geen stille terugval). |
|
||||
| Beschikbare thema's | mappen in `frontend/themes/` met een `theme.css` | `asf`, `slpsoftware` |
|
||||
| Kleuren, radius, lettertype | `themes/<naam>/theme.css` | Alleen design-tokens (CSS-variabelen), geen layout- of componentwijzigingen. Lettertypen zelf gehost via `@fontsource` (de admin-CSP staat alleen `font-src 'self'` toe). |
|
||||
| Favicon | `themes/<naam>/favicon.png` | Wordt als `favicon-theme.png` uitgeleverd en in de pagina gelinkt. |
|
||||
| Logo | `themes/<naam>/logo-on-light.png` en `logo-on-dark.png` | Beide of geen. Getoond via `BrandLogo` (licht/donker). Zonder logo valt de admin terug op de applicatienaam. |
|
||||
| Mail-logo | `themes/<naam>/logo-mail.png` (optioneel) | Logo op een witte afgeronde badge voor e-mailkoppen. |
|
||||
| Titel | `VITE_APP_TITLE` | Zet alleen `document.title`. |
|
||||
| Taal | `VITE_DEFAULT_LANGUAGE` (`nl`/`en`) | Standaardtaal zolang de gebruiker nog niets koos. |
|
||||
|
||||
Code: `frontend/themes/resolveTheme.ts` (met tests), `frontend/vite.config.ts`, `frontend/src/lib/brand.ts`, `frontend/src/components/layout/BrandLogo.tsx`.
|
||||
|
||||
## Welke site gebruikt welk thema (CI)
|
||||
|
||||
| Site | Build | Thema |
|
||||
|---|---|---|
|
||||
| SLP Software | publish-test en publish-production in `.gitea/workflows/continuous_integration.yaml` | `slpsoftware`, titel `SLP Software` |
|
||||
| Andrea Slop Fotografie | stap "Build admin frontend (ASF theme)" | `asf`, taal `nl` |
|
||||
| Andere hosts | geen `VITE_THEME` | standaardadmin |
|
||||
|
||||
## Thema `slpsoftware`
|
||||
|
||||
- **Merk:** tekst `<SLP/>` in Archivo, bordeaux `#7A1414` (website-variant B).
|
||||
- **Bestanden:** `theme.css` (tokens licht en donker), `logo-on-light.png`, `logo-on-dark.png`, `logo-mail.png`, `logo.svg` (alleen bron/archief), `favicon.png` (kopie van `icon-192.png` van de SLP-website; dat toont "/S" op bordeaux, niet `<SLP/>`).
|
||||
- **Contrast (WCAG AA):** alle paren in `theme.css` halen AA in licht en donker; de uitkomsten staan in het commentaarblok bovenin het bestand en zijn te herberekenen met `contrast.py`. Laagste waarde: primary op card in donker, 4,93.
|
||||
- **Logo opnieuw maken:** `python make-logo.py` in `frontend/themes/slpsoftware/` (Pillow en fonttools; lettertype uit `node_modules/@fontsource/archivo`, gewicht 800).
|
||||
- **Donker:** lichter bordeaux als primary (`#e0646c`) zodat tekst en randen AA houden.
|
||||
|
||||
## Nieuw thema toevoegen
|
||||
|
||||
1. Map `frontend/themes/<naam>/` met minstens `theme.css`; optioneel favicon en logo-paar.
|
||||
2. Tests in `frontend/themes/resolveTheme.test.ts` uitbreiden.
|
||||
3. `VITE_THEME: <naam>` zetten in de build-stap van de betreffende site in de CI.
|
||||
@@ -0,0 +1,96 @@
|
||||
# Deploy en testomgevingen
|
||||
|
||||
Compact overzicht van hoe code op de testomgevingen en productie komt. Bron: `.gitea/workflows/continuous_integration.yaml` (hierna `ci`) en `.gitea/workflows/deploy-scp.yaml` (hierna `deploy`), gecontroleerd op 2026-11-15. De installatie van de host zelf staat niet hier maar in `aidlc-docs/features/gitea-deployment-workflow/operations/deployment/deployment-instructions.md` en `aidlc-docs/features/andreaslop-site-hosting/operations/deployment/deployment-instructions.md`.
|
||||
|
||||
## Omgevingen
|
||||
|
||||
| Omgeving | Wat | Publieke URL en health | Deploy-job |
|
||||
|---|---|---|---|
|
||||
| SlpSoftware test | `SlpModularCms.Api.SlpSoftware` | `https://test.slpsoftware.nl`, health `https://test.slpsoftware.nl/health` | `deploy-test` |
|
||||
| SlpSoftware productie | `SlpModularCms.Api.SlpSoftware` | `https://slpsoftware.nl`, health `https://slpsoftware.nl/health` | `deploy-production` |
|
||||
| ASF test (Andrea Slop Fotografie) | `SlpModularCms.Api.AndreaSlopFotografie` (website + admin met thema `asf`) | `https://test.andreaslop.nl`, health `https://test.andreaslop.nl/health` | `deploy-asf-test` |
|
||||
|
||||
De werkelijke health-URL's komen uit de Gitea-variabelen `HEALTH_CHECK_URL_TEST`, `HEALTH_CHECK_URL_PRODUCTION` en `HEALTH_CHECK_URL_ASF_TEST`; de waarden staan niet in de repository. De hostnamen hierboven komen uit de feature-documentatie (`deployment-instructions.md` van `gitea-deployment-workflow` en `andreaslop-site-hosting`) en zijn niet uit de workflows zelf af te leiden. Er is geen productie-deploy voor ASF in deze pipeline (de ASF-productie draait apart op IIS, zie `aidlc-docs/active-features.md`).
|
||||
|
||||
## Wanneer draait wat
|
||||
|
||||
| Trigger | Wat er gebeurt |
|
||||
|---|---|
|
||||
| `pull_request` (opened, synchronize, reopened) | De poorten (build, tests, kwetsbaarheidscontrole, frontend build/test/lint) en daarna `publish-test`: bouwt een testartefact. Er wordt **niet** gedeployed. Een nieuwe push naar dezelfde PR annuleert de lopende run (alleen bij PR's). |
|
||||
| `push` op `master` | Dezelfde poorten, daarna automatisch `deploy-test` (SlpSoftware test) en, als `ASF_TEST_DEPLOY_ENABLED` op `true` staat, ook `deploy-asf-test`. Nooit productie. |
|
||||
| `workflow_dispatch` (handmatig, op elke gekozen branch) | Alle poorten draaien altijd volledig (het pad-filter meldt dan backend en frontend als gewijzigd). Deployen gebeurt alleen voor de aangevinkte invoer, zie hieronder. |
|
||||
|
||||
Poorten (jobs): `changes` (pad-filter), `backend-build`, `backend-test` (met een MariaDB-servicecontainer op poort 3308), `vulnerability-scan`, `frontend-prepare`, `frontend-build`, `frontend-test`, `frontend-lint`. Een poort die overgeslagen is (omdat die kant van de repo niet wijzigde) blokkeert niet; een poort die faalt of wordt geannuleerd blokkeert elke publish. Pad-filter bij push/PR: backend = `src/**`, `tests/**`, `*.sln`, `**/*.csproj` en de workflowbestanden; frontend = `frontend/**` en de workflowbestanden. Een run die geen van beide raakt publiceert niets.
|
||||
|
||||
### Invoer van `workflow_dispatch`
|
||||
|
||||
| Invoer | Standaard | Effect |
|
||||
|---|---|---|
|
||||
| `deploy_test` | uit | Bouwt (`publish-test`) en deployt naar SlpSoftware test |
|
||||
| `deploy_production` | uit | Bouwt (`publish-production`) en deployt naar SlpSoftware productie, met databaseback-up vooraf |
|
||||
| `deploy_asf_test` | uit | Bouwt (`publish-asf-test`) en deployt naar ASF test; alleen als ook `ASF_TEST_DEPLOY_ENABLED` op `true` staat |
|
||||
|
||||
Zonder een van de drie aangevinkt draaien alleen de poorten (handig als losse CI-run). Meerdere tegelijk aanvinken kan. Let op: `deploy_production` is aan de `master`-branch niet gebonden in de workflow: de conditie van `deploy-production` controleert alleen de gebeurtenis en de invoer, niet de branch (zie `ci`, job `deploy-production`).
|
||||
|
||||
## Een branch naar test deployen
|
||||
|
||||
1. Gitea, repository, Actions, workflow "Continuous Integration", "Run workflow".
|
||||
2. Kies de branch (de workflow bouwt en deployt de code van de gekozen ref; `actions/checkout` zonder `ref`).
|
||||
3. Vink `deploy_test` aan (SlpSoftware test) en/of `deploy_asf_test` (ASF test). Laat `deploy_production` uit.
|
||||
4. Na een groene run controleert de deploy zelf `/health`; kijk daarna zelf op de testhost.
|
||||
|
||||
Aandachtspunten:
|
||||
|
||||
- De selectie van een branch in de Gitea-interface en het uitvoeren op een andere branch dan `master` is door mij niet in de interface uitgeprobeerd (niet geverifieerd); de workflow zelf kent geen beperking tot `master` voor de testdeploys.
|
||||
- Naar verwachting gebruikt Gitea het workflowbestand van de gekozen branch; dan moet de invoer `deploy_asf_test` daar in de workflow staan (niet geverifieerd).
|
||||
- De testdatabase blijft bestaan. Bij het opstarten past de applicatie migraties toe (`MigrateCoreDatabase()` voor Identity/Core, en per module `Database.Migrate()`, zie README). Deploy je later weer `master`, dan staan de migraties van de branch nog in die database; dat gaat alleen goed als migraties voorwaarts-compatibel zijn (zo beschreven in `rollback-plan.md`).
|
||||
- Een volgende push naar `master` overschrijft wat er op test staat.
|
||||
- De testdeploys maken geen databaseback-up (`run_db_backup: false`).
|
||||
|
||||
## Wat `deploy` doet (per release)
|
||||
|
||||
1. Controleert dat `deploy_path`, `service_name` en `health_check_url` niet leeg zijn; anders stopt de deploy voordat de host wordt aangeraakt.
|
||||
2. Zet SSH klaar: met de sleutel in `PI_MAIN_SSH_KEY` als die is ingesteld en werkt, anders met wachtwoord (`sshpass`).
|
||||
3. Alleen productie: `bash ~/scripts/backup-slpsoftware-db.sh <omgeving>` op de host (het script staat niet in deze repository).
|
||||
4. Uploadt het artefact naar `<deploy_path>/releases/<UTC-tijdstempel>`.
|
||||
5. Koppelt de blijvende websitemap `shared/wwwroot-web` als `wwwroot/web` in de release, en eventuele `shared/modules/*.dll`.
|
||||
6. Zet de symlink `<deploy_path>/current` in één stap om naar de nieuwe release en herstart de `systemd --user`-service (`service_name`).
|
||||
7. Controleert `health_check_url` met `curl -f`, 10 pogingen met 3 seconden pauze. Slaagt dat niet, dan faalt de job.
|
||||
8. Alleen na een geslaagde health-check: verwijdert oude releases, zodat `current` en één vorige release overblijven (`ls -1t | tail -n +3`).
|
||||
9. Verwijdert de tijdelijke sleutel (ook bij falen).
|
||||
|
||||
## Rollback voor zover in de workflows beschreven
|
||||
|
||||
- Er is **geen automatische rollback**. Faalt de health-check, dan blijft `current` naar de nieuwe release wijzen en wordt er niet opgeruimd; de vorige release staat dan nog op schijf (opmerkingen in `deploy`).
|
||||
- Handmatig terug: op de host `current` naar de vorige release in `releases/` zetten en de service herstarten. De exacte stappen staan in `aidlc-docs/features/gitea-deployment-workflow/operations/deployment/rollback-plan.md`.
|
||||
- Verder terug dan de vorige release: een eerdere commit opnieuw deployen via de pijplijn (push naar `master`, of dispatch). Of de databasemigraties dat toelaten hangt af van die migraties (zie hierboven).
|
||||
- Productie heeft een databaseback-up vooraf; terugzetten staat in dezelfde `rollback-plan.md`.
|
||||
|
||||
## Vereiste Gitea-secrets en -variabelen (alleen namen)
|
||||
|
||||
Secrets (SSH naar de host):
|
||||
|
||||
| Naam | Gebruik |
|
||||
|---|---|
|
||||
| `PI_MAIN_ADDRESS`, `PI_MAIN_PORT`, `PI_MAIN_USERNAME` | Adres, poort en deploy-account |
|
||||
| `PI_MAIN_PASSWORD` | Wachtwoord (terugval; werkt vanaf de runner die op de host mag inloggen met wachtwoord) |
|
||||
| `PI_MAIN_SSH_KEY` | Optioneel: privésleutel van het deploy-account, nodig voor runners die niet met wachtwoord mogen |
|
||||
|
||||
Variabelen:
|
||||
|
||||
| Naam | Voor |
|
||||
|---|---|
|
||||
| `DEPLOY_PATH_TEST`, `SERVICE_NAME_TEST`, `HEALTH_CHECK_URL_TEST` | SlpSoftware test. De `config`-job faalt als een van deze drie leeg is (dat geldt voor elke run, ook een PR) |
|
||||
| `DEPLOY_PATH_PRODUCTION`, `SERVICE_NAME_PRODUCTION`, `HEALTH_CHECK_URL_PRODUCTION` | SlpSoftware productie |
|
||||
| `ASF_TEST_DEPLOY_ENABLED` | Schakelaar voor alle ASF-jobs; alleen de waarde `true` zet ze aan |
|
||||
| `DEPLOY_PATH_ASF_TEST`, `SERVICE_NAME_ASF_TEST`, `HEALTH_CHECK_URL_ASF_TEST` | ASF test; `config-asf` faalt als er een leeg is (terwijl de schakelaar aan staat) |
|
||||
| `VITE_SENTRY_DSN` | Sentry-DSN voor de SlpSoftware-adminbuild (test en productie) |
|
||||
| `VITE_SENTRY_DSN_ASF` | Sentry-DSN voor de ASF-adminbuild |
|
||||
| `VITE_UMAMI_SCRIPT_URL`, `VITE_UMAMI_WEBSITE_ID_TEST`, `VITE_UMAMI_WEBSITE_ID_PRODUCTION` | Umami voor de SlpSoftware-adminbuild (ASF gebruikt geen Umami) |
|
||||
| `SECURITY_ALLOWED_SCRIPT_ORIGINS_TEST`, `SECURITY_ALLOWED_SCRIPT_ORIGINS_PRODUCTION` | Alleen gebruikt als controle in `publish-test`/`publish-production` wanneer `VITE_UMAMI_SCRIPT_URL` gevuld is: de Umami-origin moet in deze lijst staan, en de lijst moet overeenkomen met `SecurityHeaders__AllowedScriptOrigins__0` op de host |
|
||||
|
||||
Runtime-instellingen van de applicatie (verbindingsstring, JWT, mail, `Contact__*`, Sentry) zitten niet in de workflow maar in het omgevingsbestand op de host (`shared/env`, zie README en de hostdocumentatie).
|
||||
|
||||
## Runners
|
||||
|
||||
Alle jobs draaien op het label `linux`, zodat elke runner (de Pi en de desktop-runner) ze kan oppakken. Gebouwd wordt voor `linux-arm64` (`PUBLISH_RID`), framework-dependent. Artefacten worden 1 dag bewaard.
|
||||
@@ -0,0 +1,127 @@
|
||||
# Privacy-gegevens van het contactformulier
|
||||
|
||||
Doel: feitelijke invoer voor de privacyverklaring van een website die de contactmodule gebruikt. Alles hieronder is gecontroleerd tegen de code op 2026-11-15 (branch `feature/contact-forms-module`, nog niet gemerged). Per feit staat het bronbestand; paden zijn relatief aan `src/`. Wat in de code niet te zien is (hostconfiguratie, mailserver, de website zelf) staat apart onder "Niet geverifieerd".
|
||||
|
||||
Dit is geen juridisch advies; het beschrijft alleen wat de software doet.
|
||||
|
||||
## 1. Wanneer is het formulier actief
|
||||
|
||||
| Feit | Bron |
|
||||
|---|---|
|
||||
| Het formulier werkt alleen als twee schakelaars aan staan: de hostschakelaar `Contact:Enabled` (omgevingsvariabele `Contact__Enabled`) en de CMS-schakelaar die een beheerder bij Berichten zet. Standaard staan beide uit. | `SlpModularCms.Modules.Contact/Services/ContactSettingsAndGates.cs`, `Controllers/ContactRouteFilter.cs`, `ContactModule.cs` |
|
||||
| Is het formulier niet open, dan bestaan de routes niet (404). | `Controllers/ContactRouteFilter.cs` |
|
||||
| In de meegeleverde `appsettings.json` staat `Contact:Enabled` op `false` voor `Api.SlpSoftware` (`SiteId` `slpsoftware`) en `Api.AndreaSlopFotografie` (`SiteId` `andreaslop`). Of het op een echte host aan staat, volgt uit de omgevingsvariabelen daar. | `SlpModularCms.Api.SlpSoftware/appsettings.json`, `SlpModularCms.Api.AndreaSlopFotografie/appsettings.json` |
|
||||
|
||||
## 2. Welke gegevens worden bij een bericht opgeslagen
|
||||
|
||||
Tabel `ContactMessages` (entiteit `ContactMessage`). Een bericht wordt alleen opgeslagen als alle velden geldig zijn (anders `400` en niets opgeslagen).
|
||||
|
||||
| Gegeven | Kolom | Grenzen | Opmerking |
|
||||
|---|---|---|---|
|
||||
| Naam | `Name` | max 100 tekens | Ingevuld door bezoeker, getrimd |
|
||||
| E-mailadres | `Email` | max 254 tekens | Ingevuld door bezoeker; alleen een vormcontrole (`x@y.zz`) |
|
||||
| Onderwerp | `Subject` | max 100 tekens | Bedoeld als door de website gekozen waarde (pakket-id, slug of `other`, zo staat het in de code); de API controleert alleen lengte en tekens, dus ook een vrije tekst wordt geaccepteerd |
|
||||
| Bericht | `Message` | max 2000 tekens | Vrije tekst |
|
||||
| Tijdstip van ontvangst | `ReceivedAt` | | Server-tijd (UTC) |
|
||||
| Site | `SiteId` | | Uit configuratie (`Contact:SiteId`), nooit uit het verzoek |
|
||||
| Status | `Status` | | `New`, `Read`, `Archived`, `Spam`, `Converted` |
|
||||
| Mailstatus | `MailStatus`, `MailAttempts`, `NextMailAttemptAt`, `MailError` | `MailError` max 100 | Alleen een korte foutcode (bijv. `auth_failed`, `disabled`, `recipient_not_configured`), nooit een adres of tekst |
|
||||
| Bewaren tot | `RetentionUntil` | | Zie hoofdstuk 3 |
|
||||
|
||||
Bron: `SlpModularCms.Modules.Contact/Data/Entities/ContactMessage.cs`, `Data/ContactDbContext.cs`, `Services/ContactValidator.cs`, `Services/ContactSubmissionService.cs`, `Services/ContactSeams.cs`.
|
||||
|
||||
**Wat niet wordt opgeslagen** (gecontroleerd: deze velden komen niet in `ContactMessage` of een andere tabel van de module voor):
|
||||
|
||||
- Geen IP-adres, geen hash van een IP-adres, geen user agent, geen referrer, geen cookies. (Ook de handoff-notitie zegt dit: `aidlc-docs/features/contact-forms-module/construction/phase-1-handoff.md`, regel "Privacy".)
|
||||
- De honeypot-waarde en het captcha-antwoord worden niet bewaard; ze beslissen alleen of een bericht als spam wordt gemarkeerd.
|
||||
- Het tijdtoken wordt niet opgeslagen (zie hoofdstuk 5).
|
||||
- Er is in `ContactDbContext` geen veldversleuteling te zien: de velden staan als gewone tekst in de database.
|
||||
|
||||
Overige tabellen van de module:
|
||||
|
||||
| Tabel | Inhoud | Bron |
|
||||
|---|---|---|
|
||||
| `ContactIdempotency` | `SiteId`, `Key` (een door de website gegenereerde GUID uit de header `Idempotency-Key`), `CreatedAt`, `StatusCode`. Geen inhoud van het bericht. Voorkomt dubbele verwerking bij herhaald verzenden; wordt na 24 uur verwijderd. | `Data/Entities/ContactMessage.cs` (`IdempotencyRecord`), `Services/ContactRetentionService.cs` |
|
||||
| `ContactSettings` | Eén rij: CMS-schakelaar, het door een beheerder ingestelde ontvangstadres voor meldingen (`RecipientEmail`), `UpdatedAt`, `UpdatedByUserId` | `Data/Entities/ContactMessage.cs` (`ContactSettings`) |
|
||||
|
||||
## 3. Bewaartermijnen en opschonen
|
||||
|
||||
| Onderwerp | Waarde | Configuratiesleutel | Bron |
|
||||
|---|---|---|---|
|
||||
| Bewaartermijn echt bericht | 12 maanden na ontvangst (vast per rij op het moment van opslaan; een latere wijziging van de instelling geldt niet met terugwerkende kracht) | `Contact:RetentionMonths` (standaard 12) | `Config/ContactOptions.cs`, `Services/ContactSubmissionService.cs` |
|
||||
| Bewaartermijn spam | 30 dagen | `Contact:SpamRetentionDays` (standaard 30) | idem |
|
||||
| Maximum spamrijen | 200 per site per UTC-dag; daarboven wordt spam beantwoord als normaal, maar niet opgeslagen | `Contact:MaxSpamRowsPerDay` (standaard 200) | idem |
|
||||
| Idempotentie-gegevens | 24 uur | niet instelbaar | `Services/ContactRetentionService.cs`, `Services/ContactSubmissionService.cs` |
|
||||
| Spam alsnog als echt markeren (status naar nieuw/gelezen/gearchiveerd) | de bewaartermijn start opnieuw: nu + `RetentionMonths` | | `Services/ContactAdminService.cs` (`SetStatusAsync`) |
|
||||
|
||||
Opschoon-job (`ContactRetentionService`, een achtergrondservice):
|
||||
|
||||
- Draait bij het opstarten van de applicatie en daarna elke 24 uur.
|
||||
- Verwijdert alle berichten waarvan `RetentionUntil` verstreken is, **ongeacht status** (ook gelezen, gearchiveerd of geconverteerd), in batches van 500, en idempotentie-rijen ouder dan 24 uur. Het aantal verwijderde rijen wordt gelogd, geen inhoud.
|
||||
- Doet niets (en raakt de database niet aan) zolang `Contact:Enabled` uit staat. Gevolg: zet je de hostschakelaar later uit, dan blijven opgeslagen berichten staan tot je hem weer aanzet.
|
||||
- Een beheerder kan een bericht ook direct en definitief verwijderen (`DELETE /api/v1/contact-messages/{id}`).
|
||||
- Er is in de code geen functie om berichten van één persoon te exporteren of op e-mailadres te zoeken; verwijderen gaat per bericht via de beheerlijst.
|
||||
|
||||
Bron: `Services/ContactRetentionService.cs`, `Repositories/ContactRepository.cs`, `Controllers/ContactAdminControllers.cs`.
|
||||
|
||||
**Back-ups:** vóór elke productie-deploy maakt de pipeline een databaseback-up via een script op de host (`backup-slpsoftware-db.sh`, `run_db_backup: true` in `.gitea/workflows/continuous_integration.yaml`). Volgens de feature-documentatie bewaart dat script de 7 meest recente back-ups per omgeving (`aidlc-docs/features/gitea-deployment-workflow/operations/deployment/deployment-instructions.md`, § 4). Het script zelf staat niet in deze repository: niet geverifieerd. Een verwijderd bericht kan dus nog in een back-up staan tot die roteert. Test-deploys (`test`) maken geen back-up in de pipeline.
|
||||
|
||||
## 4. Rate limiting (gegevens per bezoeker)
|
||||
|
||||
| Feit | Bron |
|
||||
|---|---|
|
||||
| Er zijn drie limieten: `ContactForm` (bericht versturen) 5 per 600 s, `ContactToken` (token ophalen) 20 per 600 s, `ContactResend` (opnieuw mailen door beheerder) 5 per 600 s. Instelbaar met `RateLimiting:ContactForm`, `RateLimiting:ContactToken`, `RateLimiting:ContactResend` (`PermitLimit`, `WindowSeconds`). | `ContactModule.cs`, `SlpModularCms.Api.SlpSoftware/appsettings.json` |
|
||||
| De teller is per clientadres: het IP-adres zoals de applicatie het ziet (`ClientPartitionKey`). Dat is het echte bezoekersadres als `ForwardedHeaders:KnownProxies` is ingesteld; zonder die instelling deelt iedereen het adres van de proxy. | `SlpModularCms.Core/Hosting/Proxy/ClientPartitionKey.cs`, `Services/ContactSeams.cs` |
|
||||
| De tellers staan alleen in het geheugen van het proces (ASP.NET Core `RateLimiter`, vast venster). Ze worden niet in de database opgeslagen en verdwijnen bij een herstart. | `ContactModule.cs` (`RateLimitPartition.GetFixedWindowLimiter`) |
|
||||
| Bij een geweigerd verzoek (429) wordt in het log alleen de naam van de limiet en het pad vastgelegd, niet het IP-adres. | `SlpModularCms.Core/Hosting/ServiceCollectionExtensions.cs` (`OnRejected`), `Observability/SecurityEvents.cs` |
|
||||
|
||||
## 5. Anti-spam
|
||||
|
||||
| Maatregel | Werking | Bron |
|
||||
|---|---|---|
|
||||
| Honeypot | Een verborgen veld `hpCheck`; is het ingevuld, dan geldt het bericht als spam. | `Services/ContactSubmissionService.cs` |
|
||||
| Minimumtijd | De bezoeker haalt eerst een token op (`GET /api/v1/contact-messages/token`); een bericht binnen `Contact:MinSeconds` (standaard 3 s) na dat token geldt als spam. Het token is geldig `Contact:TokenLifetimeMinutes` (standaard 120). Het token is een met ASP.NET Data Protection versleutelde tijdstempel, gebonden aan de `SiteId`; er wordt niets over bewaard. | `Services/ContactTokenService.cs`, `Config/ContactOptions.cs` |
|
||||
| Captcha (optioneel) | Friendly Captcha v2, aan met `Contact:Captcha:Enabled`. De server stuurt alleen het captcha-antwoord en de site key naar de verificatie-URL (`global.frcapi.com` of, met `Contact:Captcha:Region=eu`, `eu.frcapi.com`), met de API-sleutel in een header; het IP-adres van de bezoeker en de berichtinhoud worden door de server niet meegestuurd. Ontbreekt het captcha-antwoord terwijl het captcha aan staat, dan geldt het bericht als spam. Bereikt de server de aanbieder niet (time-out, netwerkfout, 5xx, eigen verkeerde sleutel), dan wordt de bezoeker doorgelaten. | `Services/FriendlyCaptchaVerifier.cs`, `Config/ContactOptions.cs` |
|
||||
| Spam wordt stil afgehandeld | Echt, spam en herhaling krijgen dezelfde `202`; spam wordt 30 dagen bewaard (zie hoofdstuk 3) en niet gemaild. | `Services/ContactSubmissionService.cs` |
|
||||
| Maximale grootte verzoek | `Contact:MaxBodyBytes` (standaard 16384), anders `413`. | `Controllers/ContactRouteFilter.cs` |
|
||||
|
||||
Captcha en privacy: de widget in de browser van de bezoeker praat rechtstreeks met Friendly Captcha. Volgens de aantekening in de handoff-notitie (verwijzend naar de verklaringen van de aanbieder, niet door ons geverifieerd) kan bij regio `global` het IP-adres buiten de EU worden verwerkt en blijft het bij regio `eu` (betaald plan) binnen de EU; de privacyverklaring moet de aanbieder en de gebruikte regio noemen (`aidlc-docs/features/contact-forms-module/construction/phase-1-handoff.md`). De widget zelf zit in de website, niet in deze repository: niet geverifieerd.
|
||||
|
||||
## 6. E-mailmeldingen
|
||||
|
||||
| Feit | Bron |
|
||||
|---|---|
|
||||
| Voor elk echt bericht (niet voor spam) wordt een melding gemaild naar één ontvangstadres. Dat is het door een beheerder ingestelde adres (admin, Berichten), anders `Contact:RecipientEmail` (omgevingsvariabele `Contact__RecipientEmail`), anders niets. Zonder geldig adres of zonder werkende mailconfiguratie wordt niet gemaild; het bericht blijft bewaard en toont de reden. | `Services/ContactSettingsAndGates.cs`, `Services/ContactMailSender.cs` |
|
||||
| De mail bevat naam, e-mailadres, onderwerp en bericht van de bezoeker. Het adres van de bezoeker staat als Reply-To (en de naam, als die geldig is als weergavenaam). In het mailonderwerp en andere headers staat niets dat de bezoeker typte. | `Services/ContactMailSender.cs` |
|
||||
| Verzending gebeurt op de achtergrond (`ContactMailService`): direct na opslaan en daarnaast elke 120 s (`Contact:Mail:SweepSeconds`). Bij een fout nieuwe pogingen na 5 min, 15 min, 1 u, 6 u en 24 u (`Contact:Mail:BackoffMinutes`), maximaal 6 pogingen (`Contact:Mail:MaxAttempts`); daarna blijft het mislukt tot een beheerder het opnieuw verstuurt (maximaal 5 per 10 minuten). Alleen berichten met status Nieuw worden automatisch gemaild. | `Config/ContactOptions.cs`, `Services/ContactMailService.cs`, `Controllers/ContactAdminControllers.cs` |
|
||||
| De mail gaat via de SMTP-instellingen van de host (`Email__Smtp__*`). Wat de mailserver en de mailbox van de ontvanger zelf bewaren valt buiten de applicatie: niet geverifieerd. | `README.md` (E-mail), `Services/ContactMailSender.cs` |
|
||||
|
||||
## 7. Logs en foutrapportage (Sentry)
|
||||
|
||||
| Feit | Bron |
|
||||
|---|---|
|
||||
| De contactmodule logt geen persoonsgegevens: bij een verzending alleen `Contact submission handled: {Outcome} for site {SiteId}` (uitkomst Genuine, Spam, SpamNotStored of Replay). De mailservice logt het bericht-id en een foutcode; fouten alleen met het exceptietype. Ook de Idempotency-Key en het token worden niet gelogd. Een test controleert dit met herkenbare markeringen in alle velden. | `Services/ContactSubmissionService.cs`, `Services/ContactMailSender.cs`, `Services/ContactMailService.cs`, `SlpModularCms.Modules.Contact.Tests/ContactNoPersonalDataInLogsTests.cs` |
|
||||
| Het beheer logt alleen id's en uitkomsten (`Contact message {id} set to ...`, `deleted`, `resent`). | `Services/ContactAdminService.cs` |
|
||||
| Sentry staat alleen aan als `Observability:SentryDsn` is gevuld (omgevingsvariabele `Observability__SentryDsn`); leeg = geen Sentry. | `SlpModularCms.Core/Hosting/Observability/SentryExtensions.cs` |
|
||||
| Naar Sentry gaan gebeurtenissen vanaf niveau Warning; berichten vanaf Information gaan als breadcrumbs mee. `SendDefaultPii` staat aan: bij een gebeurtenis gaan het IP-adres, de user agent, de querystring, het pad en de ingelogde gebruikersnaam mee. | `Observability/SentryExtensions.cs`, `Observability/SentryEventScrubber.cs` (opmerking "retained") |
|
||||
| Vóór verzending worden de headers `Cookie`, `Set-Cookie`, `Authorization` en `X-Master-Api-Key` verwijderd en de request-body wordt nooit meegestuurd (`MaxRequestBodySize = None`, daarnaast `request.Data = null`). De inhoud van het formulier komt daardoor niet via het verzoek in Sentry. De scrub-lijst is bewust niet configureerbaar. | `Observability/SentryEventScrubber.cs`, `Observability/SentryExtensions.cs` |
|
||||
| Sentry kan dus het IP-adres van een bezoeker bevatten als er tijdens zijn verzoek een fout (Warning of hoger) optreedt. Het Sentry-project en de bewaartermijn daar zijn instellingen buiten de repository: niet geverifieerd. | idem |
|
||||
| Logs van de reverse proxy / IIS / systemd-journal (bijv. IP-adressen in toegangslogs) vallen buiten de applicatie: niet geverifieerd. | n.v.t. |
|
||||
|
||||
## 8. Wie heeft toegang
|
||||
|
||||
| Wie | Toegang | Bron |
|
||||
|---|---|---|
|
||||
| Bezoeker | Kan alleen een token ophalen en een bericht versturen; kan niets uitlezen. | `Controllers/ContactMessagesController.cs` |
|
||||
| Beheerders in het CMS | Lijst, detail (naam, e-mail, onderwerp, bericht, mailstatus, bewaren-tot), status wijzigen, verwijderen, opnieuw mailen, ontvangstadres en schakelaar instellen. Beleid `AdminOnly`: rol Administrator of hoger (Owner is hoger). Het ontvangstadres uit de omgeving wordt nooit aan de beheer-UI getoond, alleen de bron (`setting`/`config`). | `Controllers/ContactAdminControllers.cs`, `SlpModularCms.Core/Hosting/ServiceCollectionExtensions.cs` (`AdminOnly`), `SlpModularCms.Core/Identity/Authorization/HierarchicalRoleHandler.cs`, `Models/ContactAdminModels.cs` |
|
||||
| Ontvanger van de meldingsmail | Ziet de inhoud in zijn mailbox (zie hoofdstuk 6). | `Services/ContactMailSender.cs` |
|
||||
| Wie toegang heeft tot de database of host | Alles in dit document; niet af te dwingen vanuit de code. | n.v.t. |
|
||||
|
||||
## Niet geverifieerd (buiten de code)
|
||||
|
||||
- Of `Contact__Enabled` en het captcha op de testhosts of productie werkelijk aan staan.
|
||||
- Retentie van back-ups en de inhoud van het back-upscript op de host.
|
||||
- Mailserver, mailbox van de ontvanger, reverse proxy- en toegangslogs.
|
||||
- Het Sentry-account (project, bewaartermijn, wie toegang heeft).
|
||||
- De website zelf: de widget (captcha), het formulier en de tekst die bezoekers zien staan niet in deze repository.
|
||||
- Of de bijbehorende frontend in `frontend/src` (beheer, Berichten) aanvullende gegevens toont of opslaat; alleen de API is hierboven nagelopen.
|
||||
Reference in New Issue
Block a user