Skip to content

Architecture at a Glance — Decision Map

A one-page map of the platform's four planes and the ADRs that ratify each. Use it to jump from a concept to its canonical solution page and the decision record behind it. The generalized resource-plane cluster (ADR-044–054) is the north-star target and is still Proposed — see Solution Design overview for the status caveat.

The four planes

flowchart LR
    subgraph CAT["Catalogue / config plane"]
        direction TB
        SEED["seed definitions<br/>ADR-051"]
        CP["content_package taxonomy<br/>ADR-052"]
        AUTH["AuthorizationPolicy<br/>ADR-053"]
    end

    subgraph DEF["Definition ↔ Instance duality · ADR-050"]
        direction TB
        RD["ResourceDefinition"]
        RI["ResourceInstance (L1)"]
        TR["TimedResource (L2)<br/>ADR-036 · ADR-037"]
    end

    subgraph REC["Reconcile plane"]
        direction TB
        GRF["Generic reconciliation<br/>ADR-047"]
        TOPO["Controller topology<br/>ADR-054"]
        PART["Multi-part sessions<br/>ADR-045"]
        HOST["Pod/Host split<br/>ADR-046"]
    end

    CAT -->|instantiates| DEF
    DEF -->|drives| REC
    REC -.->|observed state| DEF

    style CAT fill:#1e3a5f,color:#fff
    style DEF fill:#0d9488,color:#fff
    style REC fill:#475569,color:#fff

Plane → page → ADR

Plane What it is Canonical page Key ADRs
Catalogue / config The two provisioning_sources (seed, content_package), the content-authoring taxonomy, and the authorization policy model. Definition & Catalogue Model ADR-051, ADR-052, ADR-053
Definition ↔ Instance Every runtime resource is created from a ResourceDefinition; instances split into untimed ResourceInstance (L1) and timed TimedResource (L2). Resource Model ADR-050, ADR-036, ADR-037
Reconcile The generic observe → diff → act → record loop and the controller that owns each resource kind. Resource Model, Unified Resource Management ADR-047, ADR-054
Session delivery Multi-part sessions, the PodType/HostType split, and the Collect → Evaluate → Report automation seam. Session Model, Generic Pattern ADR-045, ADR-046, ADR-044

Reading order

  1. Glossary — canonical vocabulary; read first if any term is unclear.
  2. Solution Overview — services, ownership, C4 context.
  3. Resource Model + Definition & Catalogue Model — the instance and definition sides of the duality.
  4. Session Model → Flow: Session Delivery — the delivery path end to end.