# Gezamenlijke productie-checklist (CMS, SlpSoftware en Andrea Slop Fotografie) Levend document (2026-11-16). Dit is de checklist voor het moment waarop Bryan de productie-release vrijgeeft. Operations van de features `contact-forms-module`, `offering-banners`, `offering-schedule`, `website-seo`, `ci-master-pipeline`, `asf-host-injection` en `translation-files` is **meegenomen in deze checklist**: er zijn geen aparte Operations-stappen per feature. Er wordt pas iets naar productie gezet na Bryans expliciete go; een push naar `master` deployt alleen naar de testomgevingen. Achtergrond per onderwerp: [deploy-en-testomgevingen.md](deploy-en-testomgevingen.md), [captcha-providers.md](captcha-providers.md), [privacy-gegevens-contactformulier.md](privacy-gegevens-contactformulier.md), [translation-files.md](translation-files.md). ## 0. Voorwaarden - [ ] Bryan heeft de release vrijgegeven (per site: SLP en ASF kunnen apart). - [ ] De commit die naar productie gaat, is eerder groen geweest op de testhost van die site (CI-run met rooktest `smoke-sls-test` / `smoke-asf-test`). - [ ] Er is een recente databaseback-up van productie. De migraties draaien bij het opstarten van de host. ## 1. Volgorde 1. **CMS eerst**: PR `feature/contact-forms-module` naar `master`, na de aanpassing van de branch protection (zie 2). Een push naar `master` deployt alleen naar TEST. 2. **Daarna ASF**: de website-PR van Andrea Slop Fotografie pas na de CMS-merge, en pas nadat het testcommit **d449e76 is verwijderd** (zie 3). 3. **Productie**: pas daarna, per site, met een handmatige dispatch (`deploy_sls_production` voor SLP) **op een branch `release/*`** (bijvoorbeeld `release/2026-11-20`, gemaakt van de geteste `master`-commit; de pipeline negeert de productie-invoer op elke andere branch). Nooit als bijproduct van een merge. ## 2. Branch protection (Gitea) - [ ] Verplichte checks op `master`: alleen `backend-test (pull_request)` en `frontend-test (pull_request)`. - [ ] `publish-test (pull_request)` is verwijderd uit de verplichte checks (de job draait niet meer op pull requests). Pas dit vlak vóór de merge aan, niet eerder. - [ ] `compile-sites` is bedoeld als informatieve check en niet verplicht. ## 3. ASF - [ ] Het testcommit **d449e76** (ASF-testconfiguratie) staat niet in wat naar productie gaat. - [ ] ASF draait met `Website:Mode=PrerenderedPages` (staat in de eigen `appsettings.json`) en `Website__PublicBaseUrl` op het productieadres. - [ ] De ASF-productiepipeline (self-contained win-x64 naar IIS) is een apart, nog niet gestart plan; zie het voorstel `iis-publish-pipeline` zodra dat bestaat. ## 4. SLP-productie: instellingen | Instelling | Waarde in productie | Waarom | |---|---|---| | `Website__NoIndex` | `false` | Testhosts staan op `noindex`; zonder deze wijziging blijft productie voor zoekmachines dicht. Pas pas aan op het release-moment, niet eerder. | | `Website__PublicBaseUrl` | het publieke productieadres, zonder slash achteraan | Canonical, `og:image`, sitemap, robots en `siteUrl` in de pagina-data volgen dit adres. | | `Contact__Captcha__Enabled` | `false` | Er is nog geen captcha-aanbieder gekozen (zie captcha-providers.md). Sleutels komen anders alleen via omgevingsvariabelen. | | `Contact__Enabled` | pas `true` als het formulier live moet | Het contactformulier staat standaard uit. | | `Texts__DefaultLanguage` | `nl` (standaard) | De vaste teksten van de backend zijn Nederlands. | ## 4b. Hero (module `Hero`) - [ ] `Media__Directory` staat in de omgeving van de productiehost, de map bestaat buiten de release en de webroot en is beschrijfbaar door het service-account (Pi: `shared/media`; ASF op IIS: een gegevensmap naast de site, schrijfrechten voor de application pool: **door Bryan met ASF getest voor de release**). - [ ] De map zit in de back-up van de site (het database-back-upscript neemt hem niet mee). - [ ] Het log toont na de start `Image library Magick.NET self-test passed`; zo niet, dan zijn uploads uitgezet. - [ ] De hero staat in het CMS van productie (seed alleen met Bryans go: `scripts/Seed-Hero.ps1`), de focuspunten kloppen en de ASF-foto's zijn gecontroleerd. - [ ] De websites zijn gebouwd met de markers (`CMS:HERO-HTML`, `CMS:HERO-PRELOAD`, `CMS:DATA`); de rooktest slaagt en de LCP van de gerenderde pagina is niet slechter dan die van de ingebakken pagina (Lighthouse, mobiel). - [ ] Het deployartefact past binnen de uploadlimiet van de proxy (de beeldbibliotheek voegt ongeveer 35 MB toe). ## 5. Contact-retentie en privacy - [ ] `Contact:RetentionMonths` (standaard 12) en `Contact:SpamRetentionDays` (standaard 30) kloppen met de privacyverklaring van de site. - [ ] De opschoon-job (`ContactRetentionService`) draait na de eerste start en logt aantallen, geen inhoud. - [ ] De privacytekst op de website komt overeen met [privacy-gegevens-contactformulier.md](privacy-gegevens-contactformulier.md) (bewaartermijnen, ontvanger, mailkopie). - [ ] Retentie van databaseback-ups: apart besluit van Bryan; staat nog open. ## 6. Na de release - [ ] Rooktest op productie: `scripts/smoke-site.sh sls-test` is bedoeld voor testhosts; voor productie handmatig `/health`, de openbare aanbiedingen, de modulelijst in `/api/v1/System/capabilities` en dat `X-Robots-Tag: noindex` er **niet** meer staat. - [ ] **Sentry nalopen** (nieuwe issues sinds de release, het release-label, de alertregels) en UptimeRobot-monitors. - [ ] Een testbericht via het contactformulier en de binnenkomst in de admin (Berichten) en in de mailbox van de eigenaar, daarna het testbericht verwijderen. - [ ] Controleer in de admin dat banners en pakketten (planning aan/uit, positie) zichtbaar worden in de website. - [ ] Rollback: zie het rollbackplan van de deploy (`aidlc-docs/features/gitea-deployment-workflow/operations/deployment/rollback-plan.md`). Een migratie wordt niet automatisch teruggedraaid. ## 7. Niet doen zonder nieuwe go van Bryan Productie-deploys, variabelen voor productie zetten, `NoIndex` wijzigen, captcha aanzetten, `Contact__Enabled` op productie aanzetten.