Web tier la sou Vercel

Konsepsyon an nan docs/architecture/23-ops.md, seksyon 5. Vercel kouri web tier la sèlman. Tout lòt sèvis yo kouri sou yon host konpayon ou opere, epi yo pa opsyonèl.

Estati nan vèsyon sa a

Konfigirasyon an pare (apps/web/vercel.json, preset Nitro vercel ak verifikasyon demaraj yo). Vercel bezwen depo fichye pataje (QUIRE_STORAGE_DRIVER=s3 oswa azure), driver reyalite-a-kounye a ki mache nan plizyè enstans fonksyon (QUIRE_REALTIME_DRIVER=sse oswa centrifugo) ak yon founisè imèl HTTP. San yo, web tier la refize kòmanse, epi log li bay non chak paramèt ki manke.

Konpozan yo

Konpozan	Kote li kouri
`web`	Vercel Functions, anviwònman Node: paj, REST, MCP, LTI ak webhook li resevwa
`worker`, `scheduler`, `collab`, `content`	Yon host konpayon: Fly, Railway, ECS oswa host Docker pa w ki sèvi ak `docker/compose.yaml`
Postgres	Deyò, dèyè yon pooler transaction: Neon, Supabase oswa RDS ak PgBouncer
Fichye	S3 oswa R2. Pa gen disk ki dire lontan
Travay an aryè-plan	Yo mete nan ke ak pg-boss anndan transaction demann nan, epi worker konpayon an kouri yo. Si worker konpayon an gen `QUIRE_QUEUE_DRIVER=vercel`, travay lejè yo (notifikasyon san lòd ak livrezon webhook) pase nan Vercel Queues (`VERCEL_QUEUE_REGION`, `VERCEL_QUEUE_TOKEN`), konsa Postgres ki nan pool lan pa sonde pou travay sa yo
Travay peryodik	Scheduler konpayon an. Pa gen route Vercel Cron paske yon cron k ap fè travay anndan yon fonksyon ta fini pa ekspire
Trase	OpenTelemetry pou collector pa w la, `OTEL_EXPORTER_OTLP_ENDPOINT`

Sa sib sa a pa kapab fè

Web tier la verifye sa lè li kòmanse epi li refize konfigirasyon ki pa mache, pandan li bay non chak pwoblèm. Konsa, li pa tann jiskaske premye imèl li pa ka voye a:

Pa gen SMTP. Vercel bloke SMTP k ap soti. Mete QUIRE_EMAIL_PROVIDER_CONFIG sou yon founisè HTTP (Postmark, SES, Mailgun, SendGrid oswa Resend). Yo refize QUIRE_SMTP_URL.
Pa gen disk lokal. Yo refize QUIRE_STORAGE_DRIVER=local.
Pa gen memwa pataje ant envokasyon. Yo refize QUIRE_REALTIME_DRIVER=inprocess. Evènman ki soti nan sèvè sèvi ak fonksyon ki gen limit tan an; client la rekonekte ak yon cursor pou okenn evènman pa pèdi, men pa gen enfòmasyon prezans.
Kantite tenant bazdone fikse limite a anviwon uit paske chak lòt tenant ajoute yon pool koneksyon nan yon anviwònman ki pa kapab pataje pool yo.

Deplwaye

Kreye yon pwojè Vercel apati repozitwa a avèk Root Directory apps/web. apps/web/vercel.json fikse kòmand pou enstalasyon ak konstriksyon (NITRO_PRESET=vercel) epi sèvi /sw.js san kach.
Mete varyab anviwònman yo. Soti nan docker/.env.example, mete omwen: QUIRE_DEPLOY_TARGET=vercel, QUIRE_APP_ORIGIN, QUIRE_CONTENT_ORIGIN, QUIRE_PLATFORM_DOMAINS, QUIRE_SECRET_KEY, QUIRE_MASTER_KEY, DATABASE_URL (adrès pooler la), QUIRE_REPORT_DATABASE_URL, QUIRE_AUDIT_DATABASE_URL, QUIRE_DATABASE_ID, QUIRE_EMAIL_PROVIDER_CONFIG, QUIRE_MAIL_FROM, paramèt depo yo, ansanm ak QUIRE_COLLAB_URL ak QUIRE_COLLAB_SIGNING_KEY ki montre sèvis collab host konpayon an. QUIRE_REPORT_DATABASE_URL dwe konekte ak bazdone fizik DATABASE_URL nonmen an. Pou chak lòt bazdone anrejistre, ajoute pwòp URL koneksyon quire_report pa li nan anviwònman web ak worker yo, epi anrejistre non varyab anviwònman sa a kòm env:NAME nan konsole platfòm nan. Analytics pa mache si URL rapò bazdone sa a manke.
Sou host konpayon an, kouri docker/compose.yaml san sèvis web, ak menm docker/.env la:
```
docker compose -f docker/compose.yaml up -d migrate init worker scheduler collab content
```
Migration yo kouri la anvan yo deplwaye chak nouvo vèsyon Vercel.
Deplwaye. Si konfigirasyon an refize, log fonksyon an kòmanse ak “The web tier did not start on vercel” epi li bay lis paramèt pou chanje.

Mete ajou

Premyèman fè migration apati host konpayon an, answit aktive nouvo deplwaman Vercel la, epi apre sa fè worker konpayon yo woule nan nouvo vèsyon an: se lòd ki nan upgrade.md. Retounen tousuit nan yon deplwaman Vercel se retounen nan kòd anndan menm vèsyon an, epi sa toujou san danje.