De web tier op Vercel

It ûntwerp stiet yn docs/architecture/23-ops.md seksje 5. Vercel draait allinnich de web tier. Al it oare draait op in begeliedende host dy’tst sels behearst; dy is ferplichte.

Steat yn dizze release

De konfiguraasje is oanwêzich (apps/web/vercel.json, de Nitro-preset vercel en de startkontrôles). Vercel hat dielde bestânsopslach nedich (QUIRE_STORAGE_DRIVER=s3 of azure), in realtime-driver dy’t oer funksje-ynstânsjes hinne wurket (QUIRE_REALTIME_DRIVER=sse of centrifugo) en in HTTP-e-mailprovider. Sûnder dy ynstellingen wegeret de web tier te begjinnen en neamt it logboek elk ûntbrekkend item.

De ûnderdielen

Underdiel	Wêr’t it draait
`web`	Vercel Functions, Node-runtime: siden, REST, MCP, LTI en ûntfongen webhooks
`worker`, `scheduler`, `collab`, `content`	Begeliedende host: Fly, Railway, ECS of dyn eigen Docker-host mei `docker/compose.yaml`
Postgres	Ekstern, efter in transaksjepooler: Neon, Supabase of RDS mei PgBouncer
Bestannen	S3 of R2. Der is gjin permaninte skiif
Eftergrûntaken	Yn de transaksje fan it fersyk mei pg-boss op de wachtrige set, útfierd troch de begeliedende worker. Mei `QUIRE_QUEUE_DRIVER=vercel` op dy worker geane de lichte taken (net-oardere meidielingen en webhookleveringen) fia Vercel Queues (`VERCEL_QUEUE_REGION`, `VERCEL_QUEUE_TOKEN`), sadat Postgres se net poallet
Weromkommende taken	De begeliedende scheduler. Der is gjin Vercel Cron-route, om’t wurk yn in funksje útfiere ta in timeout liedt
Tracing	OpenTelemetry nei dyn collector, `OTEL_EXPORTER_OTLP_ENDPOINT`

Wat dizze target net kin

De web tier kontrolearret dit by it starten en wegeret, mei elke reden neamd, ynstee fan letter te mislearjen by de earste e-mail dy’t net ferstjoerd wurdt:

Gjin SMTP. Vercel blokkearret útgeand SMTP. Stel QUIRE_EMAIL_PROVIDER_CONFIG yn op in HTTP-provider (Postmark, SES, Mailgun, SendGrid of Resend). QUIRE_SMTP_URL wurdt wegere.
Gjin lokale skiif. QUIRE_STORAGE_DRIVER=local wurdt wegere.
Gjin dielde ûnthâld tusken oproppen. QUIRE_REALTIME_DRIVER=inprocess wurdt wegere. Server-sent events binne beheind troch de funksjetimeout; de client ferbynt opnij mei in cursor, sadat gjin barren ferlern giet, mar oanwêzigens is net beskikber.
It tal fêstsette tenant-databases is beheind ta sa’n acht, om’t elk in ekstra ferbiningspool freget yn in omjouwing dêr’t pools net dield wurde kinne.

Ynsette

Meitsje út it repository in Vercel-projekt mei Root Directory apps/web. apps/web/vercel.json stelt ynstallaasje- en boukommando’s yn (NITRO_PRESET=vercel) en tsjinnet /sw.js sûnder cache.
Stel omjouwingsfariabelen yn. Brûk op syn minst út docker/.env.example: QUIRE_DEPLOY_TARGET=vercel, QUIRE_APP_ORIGIN, QUIRE_CONTENT_ORIGIN, QUIRE_PLATFORM_DOMAINS, QUIRE_SECRET_KEY, QUIRE_MASTER_KEY, DATABASE_URL (adres fan de pooler), QUIRE_REPORT_DATABASE_URL, QUIRE_AUDIT_DATABASE_URL, QUIRE_DATABASE_ID, QUIRE_EMAIL_PROVIDER_CONFIG, QUIRE_MAIL_FROM, opslachynstellingen en QUIRE_COLLAB_URL en QUIRE_COLLAB_SIGNING_KEY dy’t nei de collab-tsjinst fan de begeliedende host wize. QUIRE_REPORT_DATABASE_URL heart by de fysike database dy’t DATABASE_URL neamt. Foegje foar elke ekstra registrearre database de eigen quire_report-ferbinings-URL ta oan de omjouwings fan web en worker; registrearje dêrnei de fariabelenamme yn it platfoarmkonsole as env:NAME. Analytics wegeret wurk as dy database gjin rapport-URL hat.
Draai op de begeliedende host docker/compose.yaml sûnder web-tsjinst, mei deselde docker/.env:
```
docker compose -f docker/compose.yaml up -d migrate init worker scheduler collab content
```
Migrations rinne dêr, foardat elke Vercel-ynset aktyf makke wurdt.
Set yn. By wegere konfiguraasje begjint it funksjelogboek mei “The web tier did not start on vercel” en list it elke ynstelling dy’t feroare wurde moat.

Upgrade

Migrearje earst fan de begeliedende host ôf, set dêrnei de nije Vercel-ynset aktyf en fernij as lêste de workers dêre: folgje de folchoarder yn upgrade.md. In direkte Vercel-rollback is in koaderollback en is binnen in release altyd feilich.