Architecture
Wrkbelt is a multi-tenant platform built as an NX monorepo: a NestJS API horizontally scaled across multiple ECS tasks, a Next.js 15 (App Router) application deployed on AWS via SST + OpenNext, and an embeddable React scheduler widget that customer marketing sites inject as a script tag.
Tenants
The org model is a four-level hierarchy. Every authenticated request resolves to a tenant, and every authorization check runs against both the actor's identity and the target organization.
| Type | Purpose |
|---|---|
PLATFORM | Wrkbelt's own org — superadmin authority |
PORTFOLIO | Holding company / aggregator that owns multiple Brands |
PARTNER | Franchise or agency operating on behalf of Brands |
BRAND | Operating service business — the unit of booking flows and integrations |
Where to go next
The full architectural reference lives in the Architecture section. Use these entry points:
- Architecture overview — the tour. Start here.
- Current state — how the platform is built today, with code anchors:
- Future state — where the architecture is going (not where it is)
- Decisions — why the platform is shaped this way