How traffic moves through HaloRT surfaces.
SaaS (resident / admin)
Browser → Next.js ([[Surfaces/Platform Web]])
→ Eden Treaty client + tenant headers
→ Elysia ([[Surfaces/Platform API]])
→ Prisma → MariaDB (tenant-scoped)
Headers commonly used: X-Halort-Tenant-Slug, host/X-Forwarded-Host for subdomain resolution. See Multi-tenancy and Tenant.
Marketing contact form
www ([[Surfaces/Marketing Web]]) /api/contact
→ [[Surfaces/Notifications]] POST /v1/emails/send
→ X-Halort-Internal-Key
Notifications pipeline
Caller (platform or web)
→ Express API (:8090 / notifications.halort.com)
→ BullMQ + Redis
→ Worker → SMTP / provider
→ PostgreSQL delivery logs & templates
Mobile
iOS / Android → HTTPS [[Surfaces/Platform API]]
→ same auth + tenant slug as web
See Surfaces/Mobile iOS · Surfaces/Mobile Android · Auth.