Adds the recipient setting and the ASF test host details to the operations docs

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-11-10 23:42:17 +01:00
co-authored by Claude Sonnet 5.5
parent d8847d8c3b
commit 3f59492f50
2 changed files with 8 additions and 1 deletions
@@ -16,6 +16,7 @@ The existing Gitea pipeline (continuous_integration.yaml). A push to master depl
| `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) |
| Recipient address: later from the CMS site settings (CMS-U11, in preparation) with the environment variable as fallback | SLS Software - CMS |
| Captcha: verifier configured with the secret; free key only for tests, paid plan before commercial use | Bryan / SLS Software - CMS |
## Rollback
@@ -24,3 +25,8 @@ Set `siteContent.contactForm.enabled = false` and redeploy (the gate returns, no
## 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.
## ASF test host (Pi-Main)
- Environment file: `/home/gitea-workflow/apps/andreaslopfotografie/test/shared/env`; restart through the systemd user unit `andreaslopfotografie-test`. Details in the SlpSoftware repo, `construction/contact-form/operations/host-config-checklist.md` (read only; owned by SLP Software - SLS - Main).
- `ForwardedHeaders:KnownProxies` for ASF test is already `192.168.1.102` (the proxy Pi).
- A test deploy of the feature branch and a pull request are NOT requested yet: Bryan has not finished the local ASF test. SLP Software - SLS - Main reports when he wants a test host deploy.
@@ -15,7 +15,8 @@ Status: web side ready for a test deploy; NOT ready for production (go-live cond
## Go-live conditions (all must be true; Bryan decides)
- [ ] **Full ASF privacy statement published** (separate feature; the form text in `privacy-statement-draft.md` is input; mail provider and widget data still to check). Not needed for testing, required before go-live.
- [ ] **Captcha decision**: off at go-live until a paid Friendly Captcha plan exists (free key is for testing only); with the EU endpoint the CSP gets eu, eu0, eu1 and the privacy text changes.
- [ ] Server: contact module deployed on the ASF host, recipient and sender configured, retention 12 months / 30 days spam, proxies/partition key set, host CSP `frame-src` set.
- [ ] Server: recipient address from the CMS site settings (CMS-U11, in preparation) with the environment fallback; contact module deployed on the ASF host, recipient and sender configured, retention 12 months / 30 days spam, proxies/partition key set, host CSP `frame-src` set.
- [ ] ASF test host (Pi-Main): env file `/home/gitea-workflow/apps/andreaslopfotografie/test/shared/env` set, systemd user unit `andreaslopfotografie-test` restarted, `KnownProxies` 192.168.1.102 (already set).
- [ ] A real mail from the production host checked (SPF/DKIM, "toon origineel") and the message visible in the ASF CMS.
- [ ] Test of the form on the deployed ASF test host with the real server (after the CMS branch is merged and deployed).
- [ ] ASF production hosting (IIS) in place (separate feature).