nholtware/service-template-react
Template
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

feat: JSON access log in the platform logging contract

Browse source
This commit is contained in:
nholtware 2026-11-05 10:54:10 -06:00
parent 20b204da4d
commit 00de7c4d3d
5 changed files with 46 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

1
CLAUDE.md
View file

@ -5,5 +5,6 @@
- Routes: table in `src/routes.tsx`, one component per file in `src/routes/`, loaders exported next to their component.
- Runtime config: read only via `getConfig()` (`src/lib/config.ts`). A new browser-visible env var must be added to `VARS` in `docker-entrypoint.d/10-config.sh`, `AppConfig`, and the gitops Deployment. No secrets: config.js is public.
- Backend calls: `apiGet()` in `src/lib/api.ts`, relative to `API_BASE_URL` (`/api` same-host ingress path, stripped before the backend). No CORS.
- Logging: nginx access log is JSON in the platform logging contract (`log_format contract` in `nginx/default.conf`; `$app_name`/`$git_sha` from `conf.d/service-vars.conf` written by `10-config.sh`). Keep field names identical to the backend template's pino-http lines.
- Serving contract: port 8080, `/healthz` 200, SPA fallback, immutable `/assets/`, no-cache `index.html`/`config.js` (`nginx/default.conf`).
- Deploy: push to `main` -> Forgejo CI -> image -> gitops bump -> ArgoCD. Never `kubectl apply` by hand.