Files
slp-modular-cms/docs/release-checklist-productie.md
T
SluijsensandClaude Sonnet 5.5 0bea72202b
Continuous Integration / config-sls (pull_request) Successful in 7s
Continuous Integration / config-asf (pull_request) Successful in 7s
Continuous Integration / changes (pull_request) Successful in 14s
Continuous Integration / frontend-prepare (pull_request) Successful in 26s
Continuous Integration / backend-build (pull_request) Successful in 2m0s
Continuous Integration / vulnerability-scan (pull_request) Successful in 2m3s
Continuous Integration / frontend-build (pull_request) Successful in 42s
Continuous Integration / frontend-lint (pull_request) Successful in 36s
Continuous Integration / frontend-test (pull_request) Successful in 2m23s
Continuous Integration / compile-sites (pull_request) Successful in 8m2s
Continuous Integration / backend-test (pull_request) Successful in 2m19s
Continuous Integration / publish-sls-test (pull_request) Skipped
Continuous Integration / publish-sls-production (pull_request) Skipped
Continuous Integration / deploy-sls-test (pull_request) Skipped
Continuous Integration / deploy-sls-production (pull_request) Skipped
Continuous Integration / publish-asf-test (pull_request) Skipped
Continuous Integration / deploy-asf-test (pull_request) Skipped
Continuous Integration / smoke-sls-test (pull_request) Skipped
Continuous Integration / smoke-asf-test (pull_request) Skipped
Docs: Hero afgesloten (Build and Test, release-checklist 4b, aannamelijst met besluiten van 2026-11-17)
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-17 10:30:18 +01:00

7.2 KiB

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, captcha-providers.md, privacy-gegevens-contactformulier.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).
  • Migratie RemoveHeroScheduleAndSwitch (Hero-database): laat de kolommen StartsAt, EndsAt en IsActive van de hero vallen (de planning en de hero-brede aan/uit bestaan niet meer; Bryan, 2026-11-17). Hij draait bij het opstarten; controleer vooraf dat er een recente back-up is. De per-slide aan/uit blijft.
  • Uploadgrootte van de proxy: client_max_body_size (nginx) staat boven de uploadlimiet van de hero (standaard 10 MB per foto); de proxy-timeout (proxy_read_timeout) hoeft niet hoog: een upload slaat alleen het origineel op en de varianten worden op de achtergrond gemaakt.
  • Per site: Hero__TextOnlyRegion=true en Hero__TitlePrefix voor een site zonder hero-afbeeldingen (SLP Software: staan in de committed instellingen); ASF laat beide leeg. Hero__MaxPublishedSlides alleen aanpassen als 50 niet past.
  • Na de eerste start staat in het log Hero image renderer started. en de samenvattingsregel Hero image renderer: N images, X waiting for their variants, Y lacking the full-frame preview.; bij X>0 verdwijnt dat binnen enkele minuten (op de Pi rekenen met ongeveer een minuut per grote foto).
  • Vraag in de admin (Hero, Afbeeldingen) na de seed of alle foto's klaar zijn ("Verwerking afgerond"); een foto die blijft hangen heeft een knop Opnieuw proberen.

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 (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 <url> 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.