Plan: ASF production on IIS and the production pipeline (plan only)

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-11-18 09:57:19 +01:00
co-authored by Claude Sonnet 5.5
parent 440a298cc7
commit 0d08d1524b
3 changed files with 165 additions and 0 deletions
@@ -0,0 +1,10 @@
# AI-DLC state: asf-production-iis
- Feature: ASF production on IIS and the production pipeline (plus the privacy statement as JSON)
- Branch: feature/asf-production-iis (from origin/master, 2026-11-18)
- Lane: Feature
- Stage: Inception, plan written ([plan.md](plan.md)); nothing executed
- Language: documentation in Dutch for this plan (instruction of the owner via SLP Software - SLS - Main); conversation in Dutch
- Extensions: none enabled for this plan
- Origin: written by SLP Software - SLS - Main while "Andrea Slop Fotografie - ASF - Main" was offline and the owner away; the ASF session can continue from this
- Open: questions V1-V10 and assumptions A1-A8 in plan.md
@@ -0,0 +1,5 @@
# Audit: asf-production-iis
## 2026-11-18 Plan written
**User Input** (relayed): "ASF productie op IIS en de pipeline fixen; privacyverklaring en JSON meenemen; Bryan is niet bij de computer; stel een plan op."
**AI Response**: Read the CI workflow, deploy docs, go-live and joint-release checklists, the contact-form and frontend-shell operations records, the CMS workflow and the media-library production rollout. Recorded what is wrong with the production path (static FTPS design from before the host-as-single-entry decision, missing FTP secrets, no ASF production path in the CMS pipeline) in plan.md with assumptions and questions. No workflow file changed, nothing deployed.
@@ -0,0 +1,150 @@
# Plan: ASF in productie op IIS en de productiepipeline
Status (2026-11-18): **alleen een plan**. Niets uitgevoerd, niets naar productie, geen release-branch, geen workflow-bestand gewijzigd. Opgesteld door SLP Software - SLS - Main omdat de ASF-sessie offline was en Bryan niet bij de computer; de ASF-sessie kan hierop doorbouwen. Alles wat onbekend is staat als **aanname, te controleren** (A1, A2, ...), de vragen voor Bryan staan onderaan (V1, V2, ...).
Uitgangspunten (Bryan): de pipeline-fix gebeurt in een feature-branch (`feature/asf-production-iis`), nooit in een release-branch tenzij Bryan dat vraagt. Productie alleen op zijn expliciete go. De CMS-host is het enige ingangspunt van de website (besluit 2026-11-15, `docs/cms-integration.md`, "Hosting").
## 1. Wat er nu staat (met bewijs)
| Onderdeel | Stand | Bewijs |
| --- | --- | --- |
| ASF-test | Werkt: master-push bouwt `dist-test`, uploadt naar de Pi (scp), controleert na deploy. De CMS-host op de Pi bedient site, `/admin` en `/api/v1`. | Laatste runs 782 t/m 789 op master/dispatch zijn groen. Run 761 faalde één keer op `lighthouse` (performance op de Pi, daarna groen). |
| ASF-productie (ASF-repo) | Job `deploy-production` bestaat: handmatig, alleen vanaf `release/*`, upload van `dist` met **FTPS** (`web/deploy/upload-production.sh`) en een gegenereerde `web/deploy/iis/web.config` die **zelf statische bestanden serveert**. | `.gitea/workflows/continuous_integration.yaml` (job `deploy-production`), `web/deploy/iis/web.config` (rewrite naar `{R:1}.html`, 404.html, geen doorgeven aan de host). |
| Strijdig met het besluit | Dat ontwerp is van vóór 2026-11-15: de host moet álle verzoeken krijgen (pagina's, `/admin`, `/api/v1`), IIS doet alleen redirects en pass-through. Zonder dat toont productie de ingebakken snapshot en geeft elke pageview een 404 voor de API. | `docs/cms-integration.md` ("Production: not in place yet"), `docs/go-live-checklist.md` ("Packages and banners"). |
| Geheimen/variabelen | Aanwezig: secrets `PI_MAIN_*`; variabelen `DEPLOY_PATH_TEST`, `HEALTH_CHECK_URL_TEST`, `HEALTH_CHECK_URL_PRODUCTION`, `FTP_REMOTE_DIR`, `ASF_OFFERINGS_URL_TEST`. **Ontbreekt:** `FTP_HOST`, `FTP_USERNAME`, `FTP_PASSWORD`. De productiejob kan dus niet draaien. | Gitea API-lijst van secrets en variabelen (alleen namen). |
| CMS-pipeline (CMS-repo) | Inputs `deploy_sls_test`, `deploy_sls_production`, `deploy_asf_test`. Er is **geen** `deploy_asf_production`: "Test only: there is no production path for ASF". Publiceren is `linux-arm64`, `--self-contained false`; uitrollen is `deploy-scp.yaml` (SSH, `releases/`, symlink `current`, systemd user-unit). Voor IIS is geen van drie bruikbaar. | CMS `master`, `.gitea/workflows/continuous_integration.yaml` (`PUBLISH_RID: linux-arm64`, `publish-asf-test`, `deploy-asf-test`). |
| Twee repo's, twee pipelines | De ASF-repo bouwt de site (`dist`), de CMS-repo bouwt de host. Op test regelt de ASF-pipeline dat `dist-test` in de prerendered-map van de host landt. Voor productie is niet beschreven hoe en in welke volgorde beide op de IIS-host komen. | `joint-release-checklist.md` (SLS `aidlc-docs/_shared`): "ASF IIS publish pipeline exists (own feature: self-contained win-x64 publish, FTP upload, web.config, the CMS host as the single entry)". |
| Productie-artefact | `dist` uit job `check`: zonder `OFFERINGS_URL` (snapshot), zonder `VITE_SITE_URL`, formulier dicht. Bewust zo. | `docs/deploy-and-ci.md`. |
Samengevat: de testpijplijn is gezond; wat ontbreekt of verkeerd is, is het hele productiepad (ontwerp, repo-overstijgende volgorde, secrets, CMS-kant, verificatie).
## 2. Doelarchitectuur op IIS (MijnHostingPartner)
```mermaid
flowchart LR
B[Bezoeker] -->|HTTPS| I[IIS, redirects www en HTTPS]
I -->|alle verzoeken| H[CMS-host Api.AndreaSlopFotografie]
H --> P[prerendered dist, host injecteert pakketten, banners, hero]
H --> A["/admin en /api/v1"]
H --> D[(Database)]
H --> M[Mediamap]
H --> S[SMTP, captcha uit]
classDef edge fill:#f6e05e,stroke:#c05621,color:#000;
classDef host fill:#63b3ed,stroke:#2b6cb0,color:#000;
classDef data fill:#9ae6b4,stroke:#2f855a,color:#000;
class I edge;
class H,P,A host;
class D,M,S data;
```
Tekstalternatief: de bezoeker komt bij IIS, dat alleen redirects doet en alles doorgeeft aan de CMS-host; de host serveert de pagina's, de admin en de API en gebruikt database, mediamap en mail.
- **Host publiceren:** self-contained `win-x64` (de host hoeft dan geen runtime geïnstalleerd te hebben) met `web.config` voor de ASP.NET Core Module. In-process of out-of-process hangt af van wat het pakket biedt (A1).
- **Site (`dist`)** gaat naar de prerendered-map van de host (op test `wwwroot-web`; op IIS een map naast de app, A2). De host injecteert de live data (cache 60 s); een inhoudswijziging vraagt geen rebuild.
- **IIS-`web.config`:** nog steeds gegenereerd door `web/config/serverConfig.ts` (nooit met de hand), maar nieuw: alleen redirect www -> apex, HTTP -> HTTPS, en doorgeven aan de host. De bestaande canonieke redirects (`index`, hoofdletters, slash) doet de host op test ook; de eerste stap is te controleren welke de host al doet en wat IIS moet blijven doen. Beveiligingsheaders komen van de host, zoals op test.
- **Geheimen:** als environment-variabelen, niet in de repo. Op IIS is dat `web.config` of het hostingpaneel; wie FTP-toegang heeft ziet ze (risico R3). Aanname A3: het paneel ondersteunt dat.
- **Database:** de CMS-host gebruikt MariaDB/MySQL. Aanname A4: het hostingpakket levert een MariaDB/MySQL-database en een back-upmogelijkheid. Is dat niet zo, dan is dit een blokkade en komt er een alternatief (V3).
- **Mediamap:** schrijfbare map buiten de gedeployde release, zodat een deploy foto's niet wist (zoals `shared/` op de Pi). Hier is een persistent pad nodig (A2).
- **Mail:** SMTP van MijnHostingPartner, afzender in `Email:AllowedFromAddresses`, ontvanger via de omgeving, SPF/DKIM controleren met een echte mail (go-live-checklist).
- **Captcha:** blijft **uit** bij go-live tot er een betaald Friendly Captcha-plan is; het formulier blijft dicht (`VITE_CONTACT_FORM_ENABLED` niet gezet) tot Bryans go.
- **HTTPS:** certificaat via het hostingpakket, HSTS pas na een geslaagde proefperiode (A5).
- **Client-IP/ratelimit:** `ForwardedHeaders:KnownProxies` en `ClientPartitionKey` voor de IIS-situatie (bestaande eis uit `contact-api-contract.md`).
## 3. Pipeline-wijzigingen stap voor stap
Alles in feature-branches, geen release-branch. Elke stap die iets op productie raakt wacht op Bryans go.
**Stap 0 - hostingfeiten vaststellen (geen code).** Beantwoord A1 t/m A6 en V1 t/m V4 door het pakket te bekijken of een proef-upload te doen. De joint-release-checklist zegt: "open hosting questions are answered by trying it with ASF". Een proef op een tijdelijk subdomein (bijvoorbeeld `staging.andreaslop.nl`) is de veiligste manier (V2).
**Stap 1 - CMS-repo (SMC, eigen feature-branch).**
1. Publiceer-job `publish-asf-production`: `dotnet publish -r win-x64 --self-contained true`, adminbouw met `VITE_APP_ENV=production`, `VITE_THEME=asf`, `VITE_DEFAULT_LANGUAGE=nl`.
2. Deploy-job voor IIS: FTPS-upload in rondes (zoals `upload-production.sh`), met `app_offline.htm` tijdens het vervangen van de host-bestanden en een kopie van de vorige release voor terugdraaien.
3. Nieuwe input `deploy_asf_production`, gate zoals SLS-productie (V5: `release/*` of vervangen door een goedkeuringsstap).
4. `scripts/smoke-site.sh` uitbreiden met een `asf-production`-modus.
5. Voorlopig uit via een variabele (zoals `ASF_TEST_DEPLOY_ENABLED`) zodat niets verandert tot alles klaar is.
**Stap 2 - ASF-repo (deze branch, `feature/asf-production-iis`).**
1. `serverConfig.ts` en de gegenereerde `web/deploy/iis/web.config` omzetten naar "redirects + pass-through"; de test die gegenereerd en gecommit vergelijkt blijft gelden.
2. Job `deploy-production` herschrijven: `dist` via FTPS naar de prerendered-map van de host (assets eerst, HTML als laatste, daarna opruimen; bestaand idee van `upload-production.sh`, nieuw doelpad en géén `web.config`-kopie), daarna `verify-deployment.sh ... --cms` tegen de productie-URL (genormaliseerd vergelijken zoals op test).
3. Secrets/variabelen laten aanmaken door Bryan of SLS (feature-sessies wijzigen repo-variabelen niet): `FTP_HOST`, `FTP_USERNAME`, `FTP_PASSWORD`, `FTP_REMOTE_DIR`, `HEALTH_CHECK_URL_PRODUCTION`.
4. Docs bijwerken in dezelfde wijziging (`docs/deploy-and-ci.md`, `docs/go-live-checklist.md`, `docs/cms-integration.md`), zoals `AGENTS.md` eist.
5. Lighthouse op de Pi is flaky (run 761). Voorstel: performance blijft "melden" zoals nu; de overige categorieën blokkeren.
**Stap 3 - repetitie op de proefomgeving (zonder productie).**
1. Beide pipelines draaien naar de proefomgeving (A6) met testwaarden (testpakketten, `noindex`).
2. Controleren: `/health`, `/admin`, een echte pagina, injectie van pakketten/banners/hero, headers (CSP), redirects, een upload (ook HEIC op win-x64, R4), een mail.
3. Terugdraaien oefenen (sectie 6).
**Stap 4 - go-live (alleen met Bryans go, in de gezamenlijke release).** Volgorde uit de `joint-release-checklist.md`: SLS-CMS-productie, daarna de SLS-website, daarna ASF. Zie sectie 7.
## 4. Hoe de mediabibliotheek-uitrol erin past
- CMS PR #29 (gemerged op master van het CMS, op test gedeployed): bij de start doet de host de kopie `HeroImages -> MediaAssets`, controleert streng en dropt pas daarna; bij een weigering start de app niet (Critical-regel). Productie van SLS gaat dus in één release (`production-rollout.md` in de CMS-repo).
- **ASF-productie begint zonder database (A7):** er is nog geen ASF-productie-CMS met hero-foto's. De migraties lopen op een lege database en `HeroImages` is leeg; de guard laat een lege tabel door. Voor ASF is er dus **geen** kopie en geen drop met data. Het "verse herstelpunt" uit `production-rollout.md` geldt voor **SLS-productie**; voor ASF is een database-back-up vóór de eerste echte beheerdersdata genoeg, maar de back-upprocedure moet er wel zijn (V3).
- **Seeden:** daarna eerst beheerder aanmaken (setup-token, verwijderen na gebruik), echte pakketten invoeren, hero seeden en `offerings.snapshot.json` vullen met de echte pakketten (go-live-checklist).
- **Volgorde:** de productie-CMS moet de echte pakketten hebben vóór er verkeer komt; het productie-artefact bevat de testprijzen nooit.
## 5. Privacyverklaring en JSON
- **Tekst:** het goedgekeurde concept van 17-11-2026 staat in `aidlc-docs/_shared/privacyverklaring-asf-concept-2026-11-17.txt` (SLS-repo). Andrea controleert het nog; het is de basis voor livegang (Bryan, 2026-11-17).
- **Code:** op `master` is `/privacyverklaring` nog een placeholder. De opzet (`privacyContent.ts`, `PrivacyNote`, tests) staat op `feature/privacy-statement` (2 commits voor, 59 achter op master). Stap: die wijzigingen op master laten aansluiten en overnemen in deze branch.
- **JSON:** `privacyContent.ts` wordt een JSON-bestand (bijvoorbeeld `web/src/content/privacy.nl.json`), samen met de definitieve tekst. Behouden: de `PLACEHOLDER_MARK`-controle (`unresolvedPlaceholders()`), de captcha-sectie (`onlyWithCaptcha`, verborgen zolang captcha uit staat) en hun tests; plus een vormtest voor het JSON-bestand. Privacy blijft een eigen bestand en komt niet in `nl.json`, omdat het juridische tekst met een eigen reviewproces is (A8).
- **Voorwaarden voor livegang** (go-live-checklist): Bryan en Andrea keuren de tekst goed; MijnHostingPartner is vastgelegd als verwerker met verwerkersovereenkomst en verwerking in Nederland; de reactietermijn is bevestigd (het concept zegt "binnen vier weken"); de captcha-alinea klopt met de captchabeslissing; geen `[OPEN:`-markers; de bewaartermijnen kloppen met de server (1 jaar, 30 dagen spam).
- **KvK-nummer:** staat niet in het concept en moet zichtbaar zijn op de site (V6).
## 6. Terugdraaien
| Wat | Hoe |
| --- | --- |
| Site (`dist`) | Vorige `dist` terugzetten (artefacten blijven 7 dagen in Gitea; hoe lang we ze apart bewaren: V7). HTML wordt als laatste geüpload, dus een mislukte asset-ronde laat de oude site intact. |
| Host-app | Vorige release terugzetten (kopie van de vorige map) en `app_offline.htm` weghalen. Migraties zijn additief; voor terugdraaien van migraties geldt het databaseherstelpunt. |
| Database | Back-up vóór de eerste uitrol met data; terugzetten met de functie van de hoster (A4). |
| Formulier | `VITE_CONTACT_FORM_ENABLED` weglaten en opnieuw deployen, of `Contact:Enabled` uit op de server. |
| DNS/cutover | Zie V8: oude site bewaren tot de nieuwe site verifieerbaar werkt. |
## 7. Open punten (uit de go-live- en gezamenlijke releasechecklist)
- Echte HEIC-test (upload en verwerking op win-x64, R4).
- Captcha-provider kiezen (Gitea-issue #14 in de CMS-repo); tot dan uit.
- Gezamenlijke release: SLS-CMS -> SLS-site -> ASF, elke stap met go; daarna Sentry, smoke-tests, deelafbeelding, sitemap, een echt formulierbericht (alleen als het formulier open staat), cookies/statistiek zoals in de privacyverklaring.
- KvK-nummer zichtbaar op de site.
- Verwerkersovereenkomst met MijnHostingPartner.
- Eerste ASF-beheerder aanmaken en het setup-token verwijderen.
- `offerings.snapshot.json` met echte pakketten; testprijzen nooit in het productie-artefact.
- Productie-CMS bevat de echte hero (zonder seed toont productie de ingebakken hero uit `heroContent.ts`).
## 8. Risico's
| # | Risico | Maatregel |
| --- | --- | --- |
| R1 | Het hostingpakket kan de .NET-host niet draaien (A1). | Stap 0 vóór alle bouwwerk; alternatief: host elders (bijvoorbeeld de Pi, zoals SLS) en IIS alleen als reverse proxy. |
| R2 | Twee losse uploads (host en site) lopen even uit de pas. | Volgorde: host eerst met `app_offline.htm`, dan site, dan `app_offline` weg; smoke-test erna. |
| R3 | Geheimen leesbaar voor wie FTP-toegang heeft. | Environment-variabelen via het paneel indien mogelijk; geen geheimen in repo of logs. |
| R4 | HEIC-verwerking werkt anders op Windows (native bibliotheken). | Echte HEIC-test op de proefomgeving vóór go-live. |
| R5 | Lighthouse-performance op de Pi is wisselend en blokkeert productie. | Performance blijft "melden"; andere categorieën blokkeren. |
| R6 | SEO-verlies bij de overstap van de oude site. | Redirectlijst van oude URL's (V8). |
| R7 | Een foute deploy raakt de testsites (zelfde CMS-pipeline). | Productiestappen achter een variabele en een eigen input; test blijft ongewijzigd. |
## 9. Aannames (te controleren)
- **A1** MijnHostingPartner draait ASP.NET Core 10 (self-contained) achter IIS met de ASP.NET Core Module. Onbekend: `cms-api-foundation/requirements.md` zegt "whether the production host runs .NET is unknown".
- **A2** Er is een persistent, schrijfbaar pad buiten de release voor media en een map voor de prerendered pages.
- **A3** Omgevingsvariabelen zijn instelbaar via het paneel of de `web.config` van de host.
- **A4** Het pakket bevat een MariaDB/MySQL-database met back-up en terugzetten.
- **A5** Certificaat en HSTS regelt de hoster.
- **A6** Een tijdelijk subdomein voor een proef is mogelijk.
- **A7** Er bestaat nog geen ASF-productie-CMS met gegevens.
- **A8** Privacytekst blijft een eigen JSON-bestand (niet in `nl.json`).
## 10. Vragen voor Bryan
1. **V1** Wat is het hostingpakket precies (Windows/IIS, .NET 10 en de ASP.NET Core Module, FTP/FTPS, SSH)? Is er een paneel of documentatie die ik moet zien?
2. **V2** Mag er een tijdelijk subdomein (bijvoorbeeld `staging.andreaslop.nl`) voor een proef-uitrol, en mag dat kosten?
3. **V3** Welke database en welke back-upprocedure heeft het pakket; kunnen we daar een herstelpunt maken zoals op de Pi?
4. **V4** Welke SMTP-gegevens en welk afzenderadres voor het formulier?
5. **V5** Productie-gate: houden we `release/*` (zoals SLS) of vervangen we dat door een handmatige goedkeuringsstap op master? Je wilde de pipeline in een feature-branch; een `release/*`-branch zou dan alleen op jouw verzoek voor de uitvoering bestaan.
6. **V6** Welk KvK-nummer en waar op de site (footer of contact)?
7. **V7** Hoe lang bewaren we `dist`-artefacten van productieruns buiten Gitea (voor terugdraaien)?
8. **V8** Wat draait er nu op andreaslop.nl (WordPress, waar?), en wanneer en hoe schakelen we DNS om? Is er een redirectlijst van oude URL's nodig?
9. **V9** Controleert Andrea de privacytekst voordat de definitieve tekst en JSON klaar zijn, en wie levert de verwerkersovereenkomst?
10. **V10** Captcha: laten we het uit bij go-live (formulier dicht), of eerst Friendly Captcha betaald?