From 6ff415e1bcb560eb83a618ba689dfde5a2867b4a Mon Sep 17 00:00:00 2001 From: Sluijsens Date: Sun, 15 Nov 2026 00:07:51 +0100 Subject: [PATCH] Documents the CMS packages, banners, deploy flow and go-live conditions Adds docs/cms-integration.md, docs/deploy-and-ci.md and docs/go-live-checklist.md, fills in the README (set-up and commands) and points AGENTS.md at the docs so they are kept up to date. Co-Authored-By: Claude Sonnet 5.5 --- AGENTS.md | 1 + README.md | 29 +++++++++++++++++++-- aidlc-docs/active-features.md | 30 ++++++++++----------- docs/cms-integration.md | 49 +++++++++++++++++++++++++++++++++++ docs/deploy-and-ci.md | 42 ++++++++++++++++++++++++++++++ docs/go-live-checklist.md | 40 ++++++++++++++++++++++++++++ 6 files changed, 174 insertions(+), 17 deletions(-) create mode 100644 docs/cms-integration.md create mode 100644 docs/deploy-and-ci.md create mode 100644 docs/go-live-checklist.md diff --git a/AGENTS.md b/AGENTS.md index b5b00be..0592a6c 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -5,3 +5,4 @@ This file is the entry point for AI coding agents working in this repository. Pr ## Index - [.ai/layout-conventions.md](.ai/layout-conventions.md) — how to build and update the Mermaid diagrams in [LAYOUT.md](LAYOUT.md). +- [README.md](README.md) and [docs/](docs/) — set-up and commands, [CMS integration](docs/cms-integration.md), [deploy and CI](docs/deploy-and-ci.md) and the [go-live checklist](docs/go-live-checklist.md). Update them in the same change when you alter the packages or banners, the use of the CMS API, the workflow (inputs, jobs, triggers), the server config or the go-live conditions. Work that is not built through AI-DLC is documented there, not only in a commit message. diff --git a/README.md b/README.md index 727fd0d..1cfa206 100644 --- a/README.md +++ b/README.md @@ -1,9 +1,34 @@ # Andrea Slop Fotografie -Photography website made with .Net and React for Andrea Slop Fotografie. + +Photography website made with .NET and React for Andrea Slop Fotografie. The site (in [web/](web/)) is a React single-page app (Vite, TanStack Start prerendering, Chakra UI v3) that is prerendered to static HTML at build time. On the test host it is served by the SLP CMS host (.NET), on production by IIS (planned). ## Set-up ### Pre-requisites +- Node.js 24 and pnpm (run every command in [web/](web/)). +- Chrome for the end-to-end checks (`pnpm e2e` uses the installed Chrome; CI uses Playwright's Chromium). + +### Commands (in `web/`) + +| Command | What it does | +| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `pnpm install` | Installs the dependencies (also generates the Chakra types). | +| `pnpm dev` | Dev server. Set `API_PROXY_TARGET` (for example the ASF test host) to forward `/api` to a CMS host, so the contact form and the live packages work. | +| `pnpm build` | Fetches the packages and banners from the CMS (see [docs/cms-integration.md](docs/cms-integration.md)), type-checks, builds and prerenders into `dist/`. | +| `pnpm preview` | Serves `dist/` like the host does (headers, redirects). `--contact-stub` answers the contact and offerings API with a stub, as CI does. | +| `pnpm test` | Unit, component, property and axe tests with coverage (100% required for `src/lib/**`). | +| `pnpm e2e` | Real-browser checks against a built `dist/`. | +| `pnpm check` | Everything CI runs: lint, format, tests, build, e2e, audit and Lighthouse. | +| `pnpm server-config` | Regenerates `web/deploy/iis/web.config` and `web/deploy/nginx/*.conf`. Do not edit those by hand. | + ## Lay-out -Lay-out of the website and its pages can be found in a sepoarate document [LAYOUT.md](LAYOUT.md) \ No newline at end of file + +Lay-out of the website and its pages can be found in a separate document [LAYOUT.md](LAYOUT.md). + +## Documentation + +- [docs/cms-integration.md](docs/cms-integration.md): packages and banners from the CMS, the API, the build step, live refresh and the reverse proxy. +- [docs/deploy-and-ci.md](docs/deploy-and-ci.md): the pipeline, the workflow inputs, deploying to test, the nightly build and the TEST ONLY commit. +- [docs/go-live-checklist.md](docs/go-live-checklist.md): what must be true before the CMS features and the contact form go to production. +- [aidlc-docs/](aidlc-docs/): the AI-DLC records per feature (requirements, design, decisions, audit). [aidlc-docs/active-features.md](aidlc-docs/active-features.md) lists them. diff --git a/aidlc-docs/active-features.md b/aidlc-docs/active-features.md index 44c029f..3f509c9 100644 --- a/aidlc-docs/active-features.md +++ b/aidlc-docs/active-features.md @@ -1,17 +1,17 @@ # Active Features -| Type | Name | Status | Branch | Affected Components | Session Start | -|------|------|--------|--------|---------------------|---------------| -| Bug | [hero-carousel-announce-and-pause](bugs/hero-carousel-announce-and-pause/bug-fix.md) | ✅ Complete | fix/hero-carousel-announce-and-pause | web/src/components/Hero (Hero, HeroArrows, useHeroSlider) | 2026-10-19 | -| Feature | frontend-shell | ✅ Complete | feature/frontend-shell | web/src (AppShell, NavigationBar, Footer, Hero socials, new BackToTop/SkipLink/404/error pages, routes, theme.ts, main.tsx), web/vite.config.js, web/package.json | 2026-10-14 | -| Feature | homepage-sections | ✅ Complete | feature/homepage-sections | web/src/routes/index.tsx, new homepage section components, web/src/content (types + static content), possibly web/config/securityHeaders.ts (contact form) | 2026-10-19 | -| Feature | over-mij-page | ✅ Complete | feature/over-mij-page | web/src/routes/over-mij.tsx, web/src/content, possibly shared components (PageIntro, FramedImage, SectionHeading) and web/src/seo.ts | 2026-10-22 | -| Feature | soorten-fotoshoots-page | ✅ Complete | feature/soorten-fotoshoots-page | web/src/routes/soorten-fotoshoots.tsx, new web/src/content/shootTypes.ts, new web/src/assets/shoots/, new shared CallToAction, MediaText (reverse prop), Pricing (id="prijzen" only), siteContent (service area), own entries in sitePages.ts / lighthouserc.cjs, JSON-LD via the shared webPage() helper in seo.ts | 2026-10-24 | -| Feature | contact-page | ✅ Complete | feature/contact-page | web/src/routes/contact.tsx, web/src/content, possibly ContactForm/ContactSection, PageIntro, MediaText/FramedImage, web/src/seo.ts, sitePages/sitemap | 2026-10-24 | -| Feature | portfolio-page | ✅ Complete | feature/portfolio-page (based on master after over-mij merge; worktree ../AndreaSlopFotografie-portfolio) | web/src/routes/portfolio.tsx, web/src/content, new PortfolioGrid + Lightbox, InstagramGrid (moved to shared), own entries in sitePages.ts / lighthouserc.cjs, ImageGallery JSON-LD via the shared webPage() helper | 2026-10-24 | -| Feature | shoot-type-pages | ✅ Complete (content follow-up: [content-pending.md](features/shoot-type-pages/content-pending.md)) | feature/shoot-type-pages (worktree ../AndreaSlopFotografie-shoot-type-pages) | new route(s) per shoot type under web/src/routes, web/src/content (shootTypes.ts extension, timeline content), shared Timeline component, links from soorten-fotoshoots, seo.ts (webPage helper), sitePages.ts / sitemap, lighthouserc.cjs | 2026-10-29 | -| Feature | prerendering | ✅ Complete (merged, PR #14) | feature/prerendering (worktree ../AndreaSlopFotografie-prerendering) | web/vite.config.ts, web/src/main.tsx, web/index.html, web/config/serverConfig.ts + web/deploy, CI workflow, web/lighthouserc.cjs, possibly Reveal/useReveal and hooks using media queries | 2026-10-31 | -| Feature | testimonials-redesign | ✅ Complete (merged, PR #16) | feature/testimonials-redesign (worktree ../AndreaSlopFotografie-testimonials-redesign) | web/src/components/home/Testimonials (Testimonials, TestimonialSlide, TestimonialCarousel), web/src/recipes/carouselControl.ts, web/src/content (Testimonial type, testimonials.ts), possibly SectionHeading, LAYOUT.md, unit/e2e tests that reference the dots | 2026-11-05 | -| Feature | cms-api-foundation | ✅ Complete (merged PR #17, 2026-11-10; follow-ups: ASF production, contact feature) | feature/cms-api-foundation (worktree ../AndreaSlopFotografie-cms-api-foundation) | Cross-repo: feature briefs for the SlpModularCms repo (new Api.AndreaSlopFotografie client, per-site theming, per-site module set); in this repo only docs, later web integration (CMS serves the site) | 2026-11-05 | -| Feature | contact-form-cms | 🔵 Inception | feature/contact-form-cms (worktree ../AndreaSlopFotografie-contact-form) | web/src/components/ContactForm, ContactFormGate, web/src/contact (submitContactForm), new web/src/cms-client (copied headless package), web/config/securityHeaders.ts, content/siteContent contactForm switch | 2026-11-10 | -| Feature | asf-packages-cms | 🔵 Construction | feature/asf-packages-cms (worktree ../AndreaSlopFotografie-packages, based on feature/contact-form-cms) | web/config (offerings, fetchOfferings), web/src/content (packages, snapshot, types), Pricing + PriceBanner, CI Build env | 2026-11-12 | +| Type | Name | Status | Branch | Affected Components | Session Start | +| ------- | ------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------- | +| Bug | [hero-carousel-announce-and-pause](bugs/hero-carousel-announce-and-pause/bug-fix.md) | ✅ Complete | fix/hero-carousel-announce-and-pause | web/src/components/Hero (Hero, HeroArrows, useHeroSlider) | 2026-10-19 | +| Feature | frontend-shell | ✅ Complete | feature/frontend-shell | web/src (AppShell, NavigationBar, Footer, Hero socials, new BackToTop/SkipLink/404/error pages, routes, theme.ts, main.tsx), web/vite.config.js, web/package.json | 2026-10-14 | +| Feature | homepage-sections | ✅ Complete | feature/homepage-sections | web/src/routes/index.tsx, new homepage section components, web/src/content (types + static content), possibly web/config/securityHeaders.ts (contact form) | 2026-10-19 | +| Feature | over-mij-page | ✅ Complete | feature/over-mij-page | web/src/routes/over-mij.tsx, web/src/content, possibly shared components (PageIntro, FramedImage, SectionHeading) and web/src/seo.ts | 2026-10-22 | +| Feature | soorten-fotoshoots-page | ✅ Complete | feature/soorten-fotoshoots-page | web/src/routes/soorten-fotoshoots.tsx, new web/src/content/shootTypes.ts, new web/src/assets/shoots/, new shared CallToAction, MediaText (reverse prop), Pricing (id="prijzen" only), siteContent (service area), own entries in sitePages.ts / lighthouserc.cjs, JSON-LD via the shared webPage() helper in seo.ts | 2026-10-24 | +| Feature | contact-page | ✅ Complete | feature/contact-page | web/src/routes/contact.tsx, web/src/content, possibly ContactForm/ContactSection, PageIntro, MediaText/FramedImage, web/src/seo.ts, sitePages/sitemap | 2026-10-24 | +| Feature | portfolio-page | ✅ Complete | feature/portfolio-page (based on master after over-mij merge; worktree ../AndreaSlopFotografie-portfolio) | web/src/routes/portfolio.tsx, web/src/content, new PortfolioGrid + Lightbox, InstagramGrid (moved to shared), own entries in sitePages.ts / lighthouserc.cjs, ImageGallery JSON-LD via the shared webPage() helper | 2026-10-24 | +| Feature | shoot-type-pages | ✅ Complete (content follow-up: [content-pending.md](features/shoot-type-pages/content-pending.md)) | feature/shoot-type-pages (worktree ../AndreaSlopFotografie-shoot-type-pages) | new route(s) per shoot type under web/src/routes, web/src/content (shootTypes.ts extension, timeline content), shared Timeline component, links from soorten-fotoshoots, seo.ts (webPage helper), sitePages.ts / sitemap, lighthouserc.cjs | 2026-10-29 | +| Feature | prerendering | ✅ Complete (merged, PR #14) | feature/prerendering (worktree ../AndreaSlopFotografie-prerendering) | web/vite.config.ts, web/src/main.tsx, web/index.html, web/config/serverConfig.ts + web/deploy, CI workflow, web/lighthouserc.cjs, possibly Reveal/useReveal and hooks using media queries | 2026-10-31 | +| Feature | testimonials-redesign | ✅ Complete (merged, PR #16) | feature/testimonials-redesign (worktree ../AndreaSlopFotografie-testimonials-redesign) | web/src/components/home/Testimonials (Testimonials, TestimonialSlide, TestimonialCarousel), web/src/recipes/carouselControl.ts, web/src/content (Testimonial type, testimonials.ts), possibly SectionHeading, LAYOUT.md, unit/e2e tests that reference the dots | 2026-11-05 | +| Feature | cms-api-foundation | ✅ Complete (merged PR #17, 2026-11-10; follow-ups: ASF production, contact feature) | feature/cms-api-foundation (worktree ../AndreaSlopFotografie-cms-api-foundation) | Cross-repo: feature briefs for the SlpModularCms repo (new Api.AndreaSlopFotografie client, per-site theming, per-site module set); in this repo only docs, later web integration (CMS serves the site) | 2026-11-05 | +| Feature | contact-form-cms | 🔵 Inception | feature/contact-form-cms (worktree ../AndreaSlopFotografie-contact-form) | web/src/components/ContactForm, ContactFormGate, web/src/contact (submitContactForm), new web/src/cms-client (copied headless package), web/config/securityHeaders.ts, content/siteContent contactForm switch | 2026-11-10 | +| Feature | asf-packages-cms | 🔵 Construction | feature/asf-packages-cms (worktree ../AndreaSlopFotografie-packages, based on feature/contact-form-cms) | web/config (offerings, fetchOfferings), web/src/content (packages, snapshot, types), Pricing + PriceBanner + PriceTopBar (two banners, centred card rows), PackagesProvider (live refresh), CI build-test job and nightly test build, docs/ (CMS integration, deploy and CI, go-live checklist) | 2026-11-12 | diff --git a/docs/cms-integration.md b/docs/cms-integration.md new file mode 100644 index 0000000..0408dc1 --- /dev/null +++ b/docs/cms-integration.md @@ -0,0 +1,49 @@ +# CMS integration + +The site talks to the SLP CMS host through its API. On the test host the CMS host serves the site itself, so every call is same-origin (`/api/v1/*`, CSP `connect-src 'self'`, no CORS). Three things come from the CMS: the shoot packages, two banners and the contact form. + +## Shoot packages + +Source: `GET /api/v1/offerings`. One list feeds the price cards on the home page and on the pages for each shoot type, the "welke shoot" choices of the contact form and the `?pakket=` check, so they can never disagree. + +- **Any number of packages.** The cards are a wrapping flex row. On desktop (`lg` and up) every card is a third of the row (`calc((100% - 2 * gap) / 3)`) and every row is centred, so an incomplete last row (4, 5, 7, 8, 10 cards, ...) sits in the middle. There is no styling per number of cards. On phone and tablet the cards are one column; there is no swipe row. +- **Mapping** (`web/src/lib/offerings.ts`, pure functions): `slug` is the package id (kept `zwangerschap`, `newborn`, `gezin`: they appear in `?pakket=` and the form), `title` the name, the free price text is read as whole euros ("€ 175", "€ 1.250", "175,-"). A card with an unreadable price, no features or a bad slug is skipped. Order follows `displayOrder`. Empty `description`, `priceNote` and `ctaLabel` are accepted and left out of the card. +- **Where the data comes from, in order:** + 1. At build time `web/config/fetchOfferings.ts` (the first step of `pnpm build`) asks `OFFERINGS_URL` (10 s timeout, 2 attempts) and writes the gitignored `web/src/content/offerings.generated.json`. The packages are baked into the prerendered HTML (search engines see the prices, no layout jump). + 2. Without `OFFERINGS_URL`, with a CMS that is down or with an unusable answer, the committed `web/src/content/offerings.snapshot.json` is used. The build never fails and never shows empty prices; the log says which source was used. Tests always use the snapshot. + 3. After hydration `PackagesProvider` (`web/src/components/PackagesProvider/`) asks the CMS once and replaces the baked list only if the answer differs. A network error, time-out (8 s), bad status or invalid answer keeps what was baked. A change in the CMS therefore shows at once; the nightly build only matters for search engines. +- **Keep the snapshot current** when the real packages change (prices, features), because production builds use it (see "Reverse proxy" below). + +## Banners (OfferingBanner) + +Source: `GET /api/v1/offerings/banner?position=top|bottom`. No parameter means `bottom`; `204` means no active banner; an invalid value is `400`. Answer fields: `title` (at most 100 characters), `text` (at most 300 for bottom, 120 for top), `linkLabel`, `linkUrl` (both or neither; `https://` or a path on the site with one `/`) and `position`. Both banners may be active and visible at the same time. + +| | Under the cards (`bottom`) | Above the cards (`top`) | +| --------- | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | +| Component | `PriceBanner` | `PriceTopBar` | +| Look | Light band, thin heidegroen top rule, section-heading title, ornament, sprig, deep-green link button | Slim white bar, same hairline and top rule, one line: small capitals title, diamond, text, small underlined link | +| Required | title | title or text (title may be empty) | +| Mapping | `mapBanner` | `mapTopBanner` | + +Both follow the same rules as the packages: baked into the HTML at build time, replaced live after hydration, empty fields are hidden, an error or invalid answer keeps what was baked. A `204` hides that banner (the one deliberate exception to "keep what was baked"); the two banners are independent of each other. Neither banner is a package: not in the form choices, not in the package count. + +**Layout shift:** a banner that was not active at the last build is not in the HTML. When it appears live, the content below it moves down by its height once (for the top bar, the cards move). Rebuilding with the banner active (the nightly test build does this) removes the shift. The same holds in reverse when a baked banner is switched off. + +## Contact form + +`GET /api/v1/contact-messages/token` and `POST /api/v1/contact-messages` through the headless `web/src/cms-client`. The form is behind the switch `contactForm.enabled` in `web/src/content/siteContent.ts` (off means the "Binnenkort" gate and no request to the server). Details and the go-live conditions are in `aidlc-docs/features/contact-form-cms/` and [go-live-checklist.md](go-live-checklist.md). Friendly Captcha is off at go-live. + +## Reverse proxy for `/api/v1/*` + +- **Test (ASF):** nginx on the proxy Pi forwards everything for `test.andreaslop.nl` to the CMS host (`web/deploy/nginx/test.andreaslop.nl.proxy.conf`), which serves the site files and the API. Nothing to add. +- **Production (IIS): not in place yet.** The generated `web/deploy/iis/web.config` only serves static files, so `/api/v1/*` answers 404 there. Production needs either a reverse-proxy rule (URL Rewrite with ARR) from `/api/v1/*` to a production CMS host for ASF, or the CMS host serving the site as on test. This is a separate follow-up together with ASF production hosting. Until then the production build uses the committed snapshot and the live calls fail safely (the baked list stays; the browser console shows the 404). Change the rule in `web/config/serverConfig.ts` and run `pnpm server-config`; never edit the generated files. + +## Environment and variables + +| Name | Where | Meaning | +| ------------------------ | ------------------- | ------------------------------------------------------------------------------------------------------ | +| `OFFERINGS_URL` | build env | Site address that serves the API (for example `https://test.andreaslop.nl`). Unset gives the snapshot. | +| `ASF_OFFERINGS_URL_TEST` | Gitea repo variable | Value of `OFFERINGS_URL` for the test build. Set by SLS, not by feature sessions. | +| `API_PROXY_TARGET` | dev env | Forwards `/api` in `pnpm dev` to a CMS host. | + +The production artifact is built without `OFFERINGS_URL` on purpose: production must never carry the prices of the test CMS. diff --git a/docs/deploy-and-ci.md b/docs/deploy-and-ci.md new file mode 100644 index 0000000..f79572d --- /dev/null +++ b/docs/deploy-and-ci.md @@ -0,0 +1,42 @@ +# Deploy and CI + +Pipeline: [.gitea/workflows/continuous_integration.yaml](../.gitea/workflows/continuous_integration.yaml). Branch strategy and rollback are in `aidlc-docs/features/frontend-shell/operations/deployment/` and `aidlc-docs/features/prerendering/`. + +## Triggers + +| Trigger | Result | +| ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Pull request | Checks only, no deploy. | +| Push to `master` | Checks, then deploy to test. | +| Every night, 03:15 UTC (`schedule`) | Test build with the packages and banners from the test CMS, deploy to test, no Lighthouse. Gitea runs schedules only from the default branch, so this works after the packages feature is merged to `master`. Never production. | +| Manual (`workflow_dispatch`), any branch | Checks, and a deploy to test if `deploy_test` is on. | +| Manual from a `release/*` branch | Deploy to production if `deploy_production` is on. | + +## Workflow inputs + +- `deploy_test` (boolean, default false): "Deploy to Test". Builds the test artifact and deploys it to ASF test. +- `deploy_production` (boolean, default false): "Deploy to Production". Only works from a `release/*` branch and only with Bryan's explicit go. + +Dispatch from the CLI (the token comes from your git credentials, never print it): `POST /api/v1/repos/SLP_Software/AndreaSlopFotografie/actions/workflows/continuous_integration.yaml/dispatches` with `{"ref": "", "inputs": {"deploy_test": "true"}}`. + +## Jobs + +1. `check`: lint, format, unit/property/axe tests (coverage threshold 100% on `src/lib/**`), build **without** `OFFERINGS_URL` (so with the committed snapshot), audit. Uploads artifact `dist` (this is what production gets). +2. `build-test`: builds again with `OFFERINGS_URL=${{ vars.ASF_OFFERINGS_URL_TEST }}` (packages and banners from the test CMS) and uploads `dist-test`. +3. `deploy-test`: needs `check` and `build-test`, downloads `dist-test`, uploads to the ASF test host and runs the deployment check (served by the CMS host, admin files, POST status). +4. `lighthouse`: against the built site with the preview stub (`--audit-route --contact-stub`); skipped on `schedule`. +5. `deploy-production`: manual, from `release/*` only, uses artifact `dist`. + +There is one Raspberry Pi runner plus a desktop runner, so jobs can wait in the queue for a long time (for example 30 minutes before `build-test`); a deploy that only just started is not hung. Check `started_at` (UTC) before cancelling anything. + +## Deploying a feature branch to test + +Committing, pushing and deploying a feature branch to test is allowed for the sessions that work on it. Merging, deploying to production and changing repo variables are not (Bryan decides). After a test deploy, check the page in a real browser against the real test CMS; `web/e2e/` holds the checks that run in CI. + +## TEST ONLY commit (must go before the merge) + +`feature/contact-form-cms` carries commit **`d449e76` "TEST ONLY: enable the contact form for the ASF test deploy"**, which sets `contactForm.enabled: true` in `web/src/content/siteContent.ts` so the ASF test host shows the real form. It must not reach `master` (the form stays off in production until Bryan gives an explicit go). Before merging, revert it (`git revert d449e76`, or drop it from the branch) and confirm `enabled` is `false` again. The packages branch is based on the contact-form branch, so the merge order is `contact-form-cms` first, then `asf-packages-cms`. Both merges need Bryan's go. + +## Generated files + +`web/deploy/iis/web.config` and `web/deploy/nginx/*.conf` are generated by `pnpm server-config` from `web/config/serverConfig.ts`. Change the generator, rerun it and commit the result; a test checks that they match. diff --git a/docs/go-live-checklist.md b/docs/go-live-checklist.md new file mode 100644 index 0000000..5350a6b --- /dev/null +++ b/docs/go-live-checklist.md @@ -0,0 +1,40 @@ +# Go-live checklist + +What must be true before the CMS-driven parts of the site go to production. Bryan gives the explicit go for each; nothing here is done by merging alone. The per-feature record is in `aidlc-docs/features/contact-form-cms/operations/production-readiness-checklist.md` and `aidlc-docs/features/asf-packages-cms/`. + +## Before merging to master + +- [ ] Revert the TEST ONLY commit `d449e76` and check `contactForm.enabled` is `false` ([deploy-and-ci.md](deploy-and-ci.md)). +- [ ] Merge order: `feature/contact-form-cms`, then `feature/asf-packages-cms`. +- [ ] The nightly test build only starts after the packages feature is on `master` (schedules run from the default branch). + +## Packages and banners + +- [ ] Production hosting (IIS) in place and `/api/v1/*` reverse-proxied to a production CMS host for ASF, or the CMS host serving the site ([cms-integration.md](cms-integration.md)). Without it production keeps the committed snapshot and the console shows a 404 per page view. +- [ ] `web/src/content/offerings.snapshot.json` holds the real, current packages (production builds use it). +- [ ] The production CMS holds the real packages. The test CMS prices must never end up in the production artifact (it is built without `OFFERINGS_URL`). + +## Contact form + +- [ ] All conditions in the contact-form production readiness checklist (server module, recipient, sender, retention 1 year / 30 days spam, proxies, CSP `frame-src`, a real mail from the production host). +- [ ] Captcha decision: off at go-live until a paid Friendly Captcha plan exists; the EU endpoint changes the CSP and the privacy text. +- [ ] Then, in its own reviewed change, `siteContent.contactForm.enabled = true`. + +## Privacy statement (page `/privacyverklaring`) + +The statement is a separate feature on branch `feature/privacy-statement` (a draft; nothing of it is live). It may only go live when: + +- [ ] Bryan has approved the text. +- [ ] The hosting and mail provider (MijnHostingPartner) is confirmed as processor, a processing agreement (verwerkersovereenkomst) exists, and data and mail processing in the Netherlands is confirmed. +- [ ] The response time ("binnen een maand") is confirmed. +- [ ] The captcha paragraph matches the captcha decision above (the paragraph is hidden while captcha is off). +- [ ] No `[OPEN:` marker is left in a visible section (`unresolvedPlaceholders()` in `privacyContent.ts` returns an empty list). +- [ ] The retention periods in the statement match the server settings (1 year, 30 days for spam). + +The contact form must not go live before the statement does. + +## Other open items + +- ASF production hosting on IIS (separate feature). +- First ASF administrator and removal of the setup token (CMS). +- Messages created by the Playwright test run in the ASF test CMS are archived by Bryan.