Files
AndreaSlopFotografie/aidlc-docs/features/contact-form-cms/operations/deployment/deployment-plan.md
T
SluijsensandClaude Sonnet 5.5 d8847d8c3b Documents build and test, operations and the approved privacy wording
Adds the build and test summary and instructions, the deployment and
monitoring plans, the production readiness checklist with the go-live
conditions, and the approved privacy draft (retention, controller).

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-10 23:40:11 +01:00

2.1 KiB

Deployment plan: contact-form-cms

Scope: the web change only. The server module and host configuration are delivered by other sessions.

Method

The existing Gitea pipeline (continuous_integration.yaml). A push to master deploys the test site and ASF test; production only by manual dispatch. Nothing is merged or deployed without Bryan (a test deploy of the feature branch is allowed on request of Bryan or SLP Software - SLS - Main).

What changes on deploy

  • Site bundle with the form (lazy chunks), cms-client package, captcha widget chunk, new frame-src in the generated server configs (web/deploy/iis/web.config, web/deploy/nginx/*.conf, regenerated with pnpm server-config).
  • siteContent.contactForm.enabled stays false in the merge: the site then asks the server nothing and shows the "Binnenkort" gate.

Server side prerequisites for turning it on (not built here)

Item Owner
Contact module in the ASF host, openapi/andreaslopfotografie.v1.json SLS Software - CMS
Contact__RecipientEmail (env only), sender in Email:AllowedFromAddresses, Contact:Enabled + CMS switch, MinSeconds, retention 12 months / 30 days spam AndreaSlopFotografie (host)
ForwardedHeaders:KnownProxies / ClientPartitionKey on IIS AndreaSlopFotografie (host)
ASF host CSP frame-src: global, global0, global1 (AllowedSiteFrameOrigins__0..2) AndreaSlopFotografie (host)
Captcha: verifier configured with the secret; free key only for tests, paid plan before commercial use Bryan / SLS Software - CMS

Rollback

Set siteContent.contactForm.enabled = false and redeploy (the gate returns, no token request). The server can also close the form (Contact:Enabled off answers 404, which keeps the gate). Captcha problems are handled by the form itself (message plus mail button).

Test deploy steps (on request)

  1. Merge or deploy the feature branch to the ASF test site through the pipeline (switch on only if the test host serves the contact endpoint).
  2. Run the real-browser check from the build and test instructions against the test host.