Technical Architecture — ØSTEN AI
Components
- Frontend: Next.js App Router, Firebase Auth, Axios
apiClient
- Backend: Express/TypeScript on Cloud Run, PostgreSQL (Cloud SQL)
- AI: Vertex AI for plan generation
- Integrations: Google Ads, Meta, TikTok, GA4
Tenancy & Auth
- Firebase ID token → backend auth
x-organization-id header enforced by tenantMiddleware
Resilience
- Service-layer fallbacks (demo accounts, template plans)
- Error handling via
ApiError and Express error middleware
Observability
- Structured logs with org/user context
- Deployment strictness: fixed secret/var names to avoid breakage