32 lines
1.3 KiB
Markdown
32 lines
1.3 KiB
Markdown
# 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.
|
|
|
|
```mermaid
|
|
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.
|