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>
This commit is contained in:
+36
@@ -0,0 +1,36 @@
|
||||
# Baseline checks: hosting and targets (Step 1, CP0)
|
||||
|
||||
- Commit: `4f32042410a8163b19c2296f99bd85c9ced79538` (branch `feature/prerendering`)
|
||||
- Date: 2026-11-01
|
||||
- Node: v24.16.0; pnpm: 12.11.2
|
||||
- `git status --short`: empty (clean tree; no untracked files reported)
|
||||
|
||||
## Command results
|
||||
|
||||
| Command | Result | Counts and details |
|
||||
|---|---|---|
|
||||
| `pnpm lint` | pass (exit 0) | ESLint: no issues found |
|
||||
| `pnpm format:check` | pass (exit 0) | All matched files use Prettier code style |
|
||||
| `pnpm test` | pass (exit 0) | 130 test files passed (130); 1277 tests passed (1277). Coverage thresholds met: statements 96.12%, branches 94.62%, functions 97.27%, lines 96.59%. fast-check seed: `1618276745` |
|
||||
| `pnpm build && pnpm e2e` | pass (exit 0) | e2e: 9 test files passed (9); 214 tests passed (214); duration 207.73 s. Build completed before the e2e run started (`&&`) |
|
||||
|
||||
Logs: `C:\Users\Bryan\AppData\Local\Temp\claude\k--Development-SlpSoftware-Projects-AndreaSlopFotografie\bb0a550e-5427-462f-b99b-f9db012a172a\scratchpad\b0-test.log` (test run), `C:\Users\Bryan\AppData\Local\Temp\claude\k--Development-SlpSoftware-Projects-AndreaSlopFotografie\bb0a550e-5427-462f-b99b-f9db012a172a\tasks\bbl6g4opx.output` (build and e2e).
|
||||
|
||||
## Tool availability
|
||||
|
||||
- nginx available locally: **no**. `Get-Command nginx` and `where.exe nginx` found nothing; `C:\nginx\nginx.exe` absent; `C:\Users\Bryan\scoop\apps\nginx\current\nginx.exe` absent; `NGINX_BIN` is empty.
|
||||
- scoop: present; `scoop list` shows only `php 8.5.9`.
|
||||
- lftp: **no** (`Get-Command lftp` found nothing).
|
||||
- bash: **yes** (GNU bash 5.2.37, msys; `C:\Users\Bryan\AppData\Local\Microsoft\WindowsApps\bash.exe`).
|
||||
- curl: **yes** (curl 8.12.1 from Git Bash; `C:\WINDOWS\system32\curl.exe` 8.21.0 also present).
|
||||
- podman: machine `podman-machine-default` (wsl) listed, not started (`podman machine list` only, read-only).
|
||||
|
||||
## Checksums (SHA-256)
|
||||
|
||||
- `web/lighthouserc.cjs`: `717c80a2aee64ba534b01bbffcd90b6dceba6fd666dd24fb13d8d4db182bee43`
|
||||
- `web/lighthouserc.desktop.cjs`: `f13d993389babd384177a0a1c601547b356d894ae97ac12177b09229a5318e04`
|
||||
|
||||
## State at the end of Step 1
|
||||
|
||||
- No server or browser left running; port 4173 is free.
|
||||
- Files written by this step: `aidlc-docs/features/prerendering/construction/hosting-and-targets/code/verification-log.md` (V1 to V14 rows, V6 WITHDRAWN) and this file.
|
||||
+22
@@ -0,0 +1,22 @@
|
||||
# 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 |
|
||||
Reference in New Issue
Block a user