1.3 KiB
Architecture overview
This Mermaid view is a repository-local implementation projection. The
PASS_SCOPED reviewer evidence applies to the canonical draw.io diagram named
in review-ledger.json, not automatically to edits in this file.
flowchart LR
Bootstrap[bootstrap / composition root] --> Presentation[presentation]
Bootstrap --> Adapters[adapters]
Presentation --> Shell[app shell and route surfaces]
Shell --> Providers[session and theme providers]
Presentation --> Application[application]
Adapters --> Application
Application --> Domain[domain]
Contracts[contract registries] --> Bootstrap
Contracts --> Adapters
Contracts --> Presentation
Dependencies point inward. Presentation calls application use cases, adapters implement application ports, and only the composition root selects concrete adapters. Contract registries are the single named source for routes, API operations, environment values, storage keys, errors, queries, telemetry, and release tokens.
The executable route tree is mounted only after runtime configuration and release-manifest coherence pass. It receives the composed query client, credential-opaque session port, storage port, telemetry port, and immutable build ID. Visible starter pages depend on those ports and contracts, never on a concrete adapter or the removable sample fixture.