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
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
73 lines
7.2 KiB
Markdown
73 lines
7.2 KiB
Markdown
# 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).
|
|
- [ ] **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](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.
|