docs: architecture diagrams as code (reference + Azure); wiki built around them #303

Merged

plat merged 3 commits from docs/architecture-diagram into main

2026-10-13 17:52:22 +00:00

plat commented

2026-10-13 16:36:40 +00:00

Owner

Two diagrams for clients, the wiki and the site, generated from docs/architecture/ on one engine (lib.ts) with a collision check: no line crosses a box or label, no label overlaps another, no text outgrows its box.

Reference architecture (diagram.ts → wiki/open-platform-architecture*.svg): the platform on any Kubernetes; traffic, contribution, identity and integration flows; the model provider as a role; apps marked portable (repo + image + chart run on any cluster).
Azure deployment view (azure.ts → wiki/open-platform-azure*.svg): what deploy/azure/main.bicep provisions in aks mode, the federated identities, the operator's steps in order, pilot hardening, and the vms mode strip.

Light and dark SVGs live in wiki/ so they publish with the pages and ship in the seed; PNG (2×) and vector PDF in docs/architecture/ for email and review packs.

The wiki is rebuilt around the reference picture: Architecture opens with it and follows its zones and numbered flows; Home, Security Model, Platform Internals, CI and Builds, Preview Environments and Grow Your Own Platform point at the diagrams in their vocabulary; deploy/azure/README.md embeds the Azure view; the README embeds the reference.

Every string on both diagrams was checked against the wiki, the app template, the production edge manifests and the Bicep; docs/architecture/README.md maps each claim to its source and lists what the diagrams deliberately do not claim.

🤖 Generated with Claude Code

Two diagrams for clients, the wiki and the site, generated from `docs/architecture/` on one engine (`lib.ts`) with a collision check: no line crosses a box or label, no label overlaps another, no text outgrows its box. - **Reference architecture** (`diagram.ts` → `wiki/open-platform-architecture*.svg`): the platform on any Kubernetes; traffic, contribution, identity and integration flows; the model provider as a role; apps marked portable (repo + image + chart run on any cluster). - **Azure deployment view** (`azure.ts` → `wiki/open-platform-azure*.svg`): what `deploy/azure/main.bicep` provisions in aks mode, the federated identities, the operator's steps in order, pilot hardening, and the vms mode strip. Light and dark SVGs live in `wiki/` so they publish with the pages and ship in the seed; PNG (2×) and vector PDF in `docs/architecture/` for email and review packs. The wiki is rebuilt around the reference picture: `Architecture` opens with it and follows its zones and numbered flows; Home, Security Model, Platform Internals, CI and Builds, Preview Environments and Grow Your Own Platform point at the diagrams in their vocabulary; `deploy/azure/README.md` embeds the Azure view; the README embeds the reference. Every string on both diagrams was checked against the wiki, the app template, the production edge manifests and the Bicep; `docs/architecture/README.md` maps each claim to its source and lists what the diagrams deliberately do not claim. 🤖 Generated with [Claude Code](https://claude.com/claude-code)

plat added 2 commits

2026-10-13 16:36:41 +00:00

gitignore: the typesafe api key 17801b3a3e

docs: reference architecture diagram as code; wiki built around it

guard-ppt / no-ppt (push) Has been cancelled

Details

guard-ppt / no-ppt (pull_request) Successful in 1m41s

Details

d8529b5e53

plat changed title from ~~docs: reference architecture diagram as code; wiki built around it~~ to docs: architecture diagrams as code (reference + Azure); wiki built around them

2026-10-13 17:01:31 +00:00

plat added 1 commit

2026-10-13 17:01:32 +00:00

docs: Azure deployment view, portable workloads, one diagram engine

guard-ppt / no-ppt (push) Successful in 1m45s

Details

guard-ppt / no-ppt (pull_request) Successful in 2m49s

Details

810025e6be

plat merged commit 323f7fb7fb into main

2026-10-13 17:52:22 +00:00

plat referenced this pull request from a commit