L2 — Architecture

The "how" at the system level. Data models, auth flows, service contracts, deployment pipeline, and quota systems. Changes when architectural decisions are made, but not frequently.

Sections

Platform

• Platform Architecture — Three-tier model, data model, deployment

- Three-Tier Model — Core → Orchestrator → Projects
- Data Model — Master accounts, per-app sharding, shared quotas
- Deployment — Plesk, webhooks, CI/CD

Core Services

• Auth Architecture — Account model, sessions, tokens, scopes, security, SSO


• Storage Protocol — core.storage, S3, pools, sharding, ownership, soft delete


• AI Protocol — core.ai, provider abstraction, tool use, execution tracing, conversations, cost tracking


• Hypermedia Pipeline — core.hypermedia, conversion, compression


• Asset System — core.assets, CDN, versioning, branding


• Console Architecture — core.console, API gateway, management plane