klarsprak

Drift

Lokal utveckling

npm install
npm run dev

Repositoryt har inget package-lock.json, så npm ci är inte den verifierade installationsvägen.

Verifiering före PR/deploy

npm test
npx wrangler d1 migrations apply DB --local
npx wrangler deploy --dry-run

Verifiera dessutom berörda flöden manuellt när ändringen påverkar routing, submission eller admin.

D1

Produktionsmigrationer körs med:

npm run migrate:production

Regler:

• schemaändringar ska vara versionsstyrda;
• gör inte ad hoc-schemaändringar i produktion;
• verifiera migrationsordning och kompatibilitet med aktuell Worker-kod;
• uppdatera project-context när state ownership eller schemaansvar ändras.

D1 data locality och read replication

Produktionsdatabasen ska skapas med jurisdiction=eu. Cloudflare-jurisdiction är creation-time providerkonfiguration och kan inte läggas till på en befintlig D1-databas; replacement görs därför genom verifierad export/import till en ny EU-databas före binding-cutover.

Klarspråks D1-requestväg använder Sessions API. Read replication får därför vara auto på EU-databasen; replikerna hålls inom den konfigurerade EU-jurisdictionen.

Produktionsmigrationer ska gå via bindingen:

npm run migrate:production

Deployment

npm run deploy

Deploy använder wrangler deploy --strict. Vanlig PR-verifiering ska inte implicit deploya.

Efter avsedd produktiondeploy:

npm run verify:production

Verifieringsmatris

Host/routing

Kontrollera canonical host och IDN-alias, inklusive redirect och Worker-first-beteende.

Publik termläsning

Verifiera att API:t läser publicerad data från D1 och att frontend återger samma state.

Submission

Verifiera validering, Turnstile och att ett förslag hamnar i review-state utan automatisk publicering. Response-CSP ska explicit tillåta https://challenges.cloudflare.com för Turnstiles script/frame och ska inte återinföra 'unsafe-inline' för script-src. script-src ska innehålla en unik nonce-... per response; efter production deploy ska Cloudflares injicerade JavaScript Detection-script bära samma nonce så att det inte blockeras av CSP.

Admin/review

Verifiera behörighetsgräns och explicita stateövergångar för godkännande/publicering/arkivering.

SEO/cache

Verifiera att publika sidor har avsedd canonical/robots metadata och att adminytor inte blir indexerbara eller publikt cacheade.

Felsökning

Tom eller felaktig publik termlista

1. host/route,
2. Worker/API,
3. D1-read/publicerad state,
4. frontend.

Submission misslyckas

1. requestdata,
2. Turnstile,
3. D1-write,
4. serverlogg.

Adminproblem

Kontrollera auth/route före dataändringar. Försök inte lösa accessproblem genom att göra admin-API mer publikt.

Observability

Persistent logs/traces är aktiverade med sampling och query-string-redaction. Redaction ska behållas även under felsökning; lägg inte känsliga requestparametrar i loggar.

This site is open source. Improve this page.