Skip to content

Commit 94f1371

Browse files
committed
Add a Deployment Scenarios page with per-scenario diagrams.
Four mini-diagrams — templates bundled with the app, resolved by a BFF, shipped with the page, and fetched remotely — each with prose linking to the specification sections involved. The page makes Section 6.3 visual: all four deployments are conforming, the transports pair freely with any of them, and template sources sit outside the protocol. Diagrams are generated from the committed d2 sources in light and dark variants and follow the site palette via Material's only-light/only-dark images.
1 parent e1f57b6 commit 94f1371

14 files changed

Lines changed: 1002 additions & 0 deletions

docs/assets/diagrams/scenario-bff-dark.svg

Lines changed: 111 additions & 0 deletions
Loading

docs/assets/diagrams/scenario-bff-light.svg

Lines changed: 111 additions & 0 deletions
Loading
Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
# Scenario: a BFF resolves and renders server-side (spec §7.5, §6.3).
2+
direction: down
3+
style.fill: transparent
4+
5+
browser: Browser
6+
bff: BFF {
7+
client: VDP client
8+
store: Local template store\n(or cached fetches) {
9+
style.stroke-dash: 4
10+
}
11+
client -> store: {
12+
style.stroke-dash: 4
13+
}
14+
}
15+
api: API
16+
17+
browser -> bff.client: GET /dashboard
18+
bff.client -> api: data +\nview descriptor
19+
bff.client -> browser: rendered HTML —\nno VDP in the browser

docs/assets/diagrams/scenario-bundled-dark.svg

Lines changed: 110 additions & 0 deletions
Loading

docs/assets/diagrams/scenario-bundled-light.svg

Lines changed: 110 additions & 0 deletions
Loading
Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
# Scenario: templates ship inside the app package (spec §6.3).
2+
direction: down
3+
style.fill: transparent
4+
5+
api: API
6+
app: Mobile / desktop app {
7+
client: VDP client
8+
bundle: Templates shipped\nin the app package {
9+
style.stroke-dash: 4
10+
}
11+
client -> bundle: looks up by URL —\nno fetch {
12+
style.stroke-dash: 4
13+
}
14+
}
15+
16+
api -> app.client: data +\nview descriptor

docs/assets/diagrams/scenario-page-dark.svg

Lines changed: 110 additions & 0 deletions
Loading

docs/assets/diagrams/scenario-page-light.svg

Lines changed: 110 additions & 0 deletions
Loading
Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
# Scenario: templates ship with the page itself (spec §6.3).
2+
direction: down
3+
style.fill: transparent
4+
5+
api: API
6+
page: Browser page {
7+
script: VDP client script
8+
reg: <template> elements\ndelivered with the HTML {
9+
style.stroke-dash: 4
10+
}
11+
script -> reg: matches URLs\nagainst the registry {
12+
style.stroke-dash: 4
13+
}
14+
}
15+
16+
api -> page.script: data +\nview descriptor

docs/assets/diagrams/scenario-remote-dark.svg

Lines changed: 103 additions & 0 deletions
Loading

0 commit comments

Comments
 (0)