Architecture (as-built)

Implemented

This section describes the system as it exists in code today — not the design intent. For the forward-looking design documents (proposals, decisions, future shapes), see the source tree at doc/architecture/ (exposed under /source/architecture/ in this portal).

Pages

Page	What it covers
System context (C4)	High-level boxes-and-arrows: external actors, control plane, workers, data plane, fleet
Domain ownership	Which service package owns which tables, events, and state machines
Allocation lifecycle	The state machine, who drives transitions, what events fire
Outbox & event flow	How writes become NATS events; consumer matrix
GPU slice (as-built)	The slice path end-to-end, code-grounded
Billing & ledger	Immutable ledger, accrual loop, force-release
Position vs other clouds	Factual comparison vs hyperscalers / boutique clouds

Reading order

flowchart LR
    A[System context] --> B[Domain ownership]
    B --> C[Allocation lifecycle]
    C --> D[Outbox & events]
    D --> E[GPU slice]
    D --> F[Billing & ledger]
    A --> G[Position vs other clouds]