5.9 KiB
5.9 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
- CMS eerst: PR
feature/contact-forms-modulenaarmaster, na de aanpassing van de branch protection (zie 2). Een push naarmasterdeployt alleen naar TEST. - Daarna ASF: de website-PR van Andrea Slop Fotografie pas na de CMS-merge, en pas nadat het testcommit d449e76 is verwijderd (zie 3).
- Productie: pas daarna, per site, met een handmatige dispatch (
deploy_sls_productionvoor SLP) op een branchrelease/*(bijvoorbeeldrelease/2026-11-20, gemaakt van de getestemaster-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: alleenbackend-test (pull_request)enfrontend-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-sitesis 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 eigenappsettings.json) enWebsite__PublicBaseUrlop het productieadres. - De ASF-productiepipeline (self-contained win-x64 naar IIS) is een apart, nog niet gestart plan; zie het voorstel
iis-publish-pipelinezodra 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__Directorystaat 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) enContact: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-testis bedoeld voor testhosts; voor productie handmatig/health, de openbare aanbiedingen, de modulelijst in/api/v1/System/capabilitiesen datX-Robots-Tag: noindexer 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.