klarsprak

Arkitektur

Översikt

Browser
  |
  v
Cloudflare route
  |
  v
src/index.js
  |  host / admin / SEO / response policy
  v
src/worker.js
  |              \
  |               +--> ASSETS (public/)
  |
  +--> D1 (DB)
        +--> publicerad termstate
        +--> submission/review-state

Worker-first boundary

wrangler.jsonc sätter assets.run_worker_first=true. Det är nödvändigt eftersom asset-serving annars kan svara innan Worker-koden hinner tillämpa:

• canonical-host redirect,
• adminrouting,
• SEO/robots-policy,
• security/cache headers.

Att ändra till asset-first är därför en arkitektur- och säkerhetsändring.

Canonical host

Den publika canonical hosten är <din-host>. IDN-aliaset finns som separat route och ska canonicaliseras till huvudhosten innan normal rendering.

Publik läsning

Publik termdata läses från D1 via API. Frontend är presentation och ska inte bära en separat kopia som kan drifta från databasen.

Submission

POST /api/submit representerar publik ingress för förslag.

Flödet ska:

1. validera requesten;
2. upprätthålla Turnstile-gränsen;
3. skriva submission-state;
4. inte publicera posten automatiskt.

Review och publicering

Adminytan arbetar mot review-state. Godkännande/publicering är explicita stateövergångar. Det gör att:

• inkommet material kan granskas innan det blir publikt;
• publikt termstate förblir skiljt från submissionhistorik;
• frontend inte behöver avgöra vad som är publicerbart.

Trust boundaries

• Internet → Worker: host/routing/response-policy.
• Publik submission → review state: Turnstile + server-side validering.
• Admin → review/publicering: avsedd adminauktorisering.
• Worker → D1: canonical application state.
• Worker → ASSETS: presentation, aldrig auktoritet för termdata.

Klientkod och CSP

Publik applikationslogik och adminlogik ligger i separata first-party assets (/app.js respektive /admin.js) i stället för inline-script. Response-CSP tillåter därför inte generell inline-JavaScript. script-src får en unik nonce per response; Cloudflare kan då bära samma nonce på sin edge-injicerade JavaScript Detection-snippet utan att 'unsafe-inline' återinförs. Turnstile är den enda externa script/frame-originen som explicit tillåts och är avgränsad till https://challenges.cloudflare.com.

Caching och indexering

Publika indexerbara sidor får canonical/robots metadata. Admin- och andra icke-publika ytor ska inte bli indexerbara eller cacheas som allmän publik data.

Failure model

Vid fel i termvisning:

1. verifiera host/Worker-route;
2. verifiera API-response;
3. verifiera D1-read/state;
4. kontrollera frontend/assets sist.

Vid submissionsproblem:

1. requestvalidering;
2. Turnstile;
3. D1-write;
4. review/adminflöde.

This site is open source. Improve this page.