Files
AndreaSlopFotografie/aidlc-docs/features/prerendering/construction/hosting-and-targets/code/verification-log.md
T
SluijsensandClaude Opus 5.5 33334b889d Generates the nginx rules for prerendered pages
Pages now map to their html file, other forms get one redirect, unknown URLs
get a real 404 and responses are compressed. A browser-free test suite runs the
rules against a real nginx, in CI only so far.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-01 03:00:07 +01:00

5.4 KiB

Verification log: hosting and targets (unit 3)

Source of the points: construction/hosting-and-targets/infrastructure-design/infrastructure-design.md § 12. Settled-in step: § 3.2 of the code generation plan.

Status values: OK, BLOCKED, DEVIATION, WITHDRAWN, OPEN.

V# Point Step Outcome Evidence Status
V1 The generated nginx file loads in a real nginx (nginx -t) as an http-level include without any other directive from the Pi; map before server works in conf.d. Every directive is checked against the nginx 1.30 documentation (the Pi runs 1.30.6; CI has 1.24) 3 (documentation), 6 (real nginx) Documentation part OK; real-nginx part OPEN (no nginx locally; waits for the CI run) Checked against nginx.org docs on 2026-11-01: map (context http only; exact string beats regex, first regex in file order wins; ~* case-insensitive; no default gives empty), if/return/rewrite (server, location; rewrite permanent = 301, original args appended unless replacement ends in ?), try_files (server, location), error_page (http, server, location; without = keeps the status), internal (location), absolute_redirect (http, server, location; since 1.11.8, default on), autoindex (http, server, location; default off), gzip/gzip_vary/gzip_proxied/gzip_http_version/gzip_comp_level/gzip_min_length/gzip_types (http, server, location; text/html always compressed). The generated file puts map at http level (conf.d include) and all others in server or location. NOT documented by nginx.org: escaping of the rewrite replacement (BR-HST-06 relies on it; settled only by the real nginx test on //evil.example/ and /evil.example/); the safety of if with only return comes from the nginx wiki, not the page. OPEN
V2 Server-level if ... return 301 and rewrite ... permanent responses carry all five headers and Cache-Control with real nginx; absolute_redirect off gives a relative Location; / works without an index directive 6, 16 open
V3 /soorten-fotoshoots (file) and /soorten-fotoshoots/ (directory) behave as in section 3.1 on nginx and preview; /assets and /assets/ as well 6, 8, 16 open
V4 /404 and /404.html give 404 with the page and the five headers on nginx; error_page keeps the status; HEAD works 6, 16 open
V5 A HTTP/1.0 request with Accept-Encoding: gzip to the generated block gets Content-Encoding: gzip for .html, .js, .css, .svg, .json, .xml (all sizes above 256 bytes) and not for .woff2/images 6, 16 open
V6 Withdrawn for this unit (IIS needs a host). The checks move to the "Before go-live" list, U1 to U6 WITHDRAWN (no host) WITHDRAWN
V7 previewServer.ts: the new resolveRequest contract (redirect result, query handling, --audit-route); unit 1 tests for BR-SRV-07 are updated (the "interim" rules become final); pageFiles.ts stays the single path to file mapping 7, 8 open
V8 The 301 is followed by Chrome with the query string intact for ?pakket= and ?shoot= links, and the hydrated page has 1 title (extend the existing "URL die de server niet kent en de router wel" e2e) 17 open
V9 One Lighthouse run of the 404 page on the preview audit route, and (as comparison) /404.html with ignoreStatusCode; record best-practices for both, then keep the simpler passing option (O2) 23 (measurement-final.md) open
V10 lftp: dry run against a file: target proves that pass 1 skips all nested *.html and web.config, pass 2 uploads them, pass 3 deletes only stale files 14 open
V11 verify-deployment.sh fails against a copy of the old nginx config (home page for /over-mij) and passes against the new one 13 open
V12 CI: the lighthouse job (or a new server-rules job) installs nginx, pnpm e2e includes serverRules.e2e.ts, and the job fails if nginx is missing 5, 16 CI step added (lighthouse job): apt-get install nginx lftp, service nginx stop, nginx -v; Browsertests step has CI=true; serverRules.e2e.ts fails with "nginx ontbreekt in CI (BR-HST-24)" when nginx is missing. Gate proven locally with CI=true and no nginx (1 failed, as intended) and without CI (skip line, exit 0). The real CI run is still to come. e2e/serverRules.e2e.ts; .gitea/workflows/continuous_integration.yaml; CI run pending OPEN
V13 lighthouserc.cjs: the exception table is empty on delivery unless an owner decision exists; P-HST-11 passes; pnpm lighthouse still starts the preview with --audit-route and Local appears for startServerReadyPattern 11, 12 open
V14 The generated header comment fits the Pi: install path /etc/nginx/conf.d/andreaslop-test.conf (included from nginx.conf:38), no sites-enabled, no global nginx.conf change; the file works for a first install and for an update of an existing file 3 Header comment rewritten: install path /etc/nginx/conf.d/andreaslop-test.conf, included in http {} from nginx.conf, no sites-enabled, no global nginx.conf change, own gzip block because the Pi has none, works behind an HTTP/1.0 proxy, 444 from 00-default.conf for an unknown host (old WordPress remark removed), server_name and root adaptable, no default_server. The same file serves a first install and an update (it replaces the existing file in place). Generated deploy/nginx/andreaslop-test.conf (lines 1-12); equals nginxTestConf() (serverConfig.test.ts sync test green) OK