This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

OpenSpec

1 - Infrastructure architecture Specification

Describe the maintained infrastructure diagrams owned by infra/arch. The baseline is checked-in source at revision 550d7e79b1f5fdbc2b6017b75178471d6914082f, observed on 2026-09-08. These diagrams describe their source document; they do not establish live inventory, deployment, or health.

Requirement: Canonical multi-page architecture source

The project SHALL use arch.drawio as the canonical source for its maintained SVG diagrams and SHALL expose the source through the //infra/arch editor target. The named render mapping SHALL preserve the 14 remaining source pages, including the five pages classified as archives. The T3code page moved to this owner’s Mermaid diagram under users/simeonwarren/host_bot, so infra/arch no longer renders it.

Sources: project documentation, target and page definitions, and Drawio source.

Scenario: Render the maintained page set

  • WHEN the //infra/arch:rendered target processes the canonical document
  • THEN it produces the SVG output mapped to each of the 14 named pages, including separate outputs for archived pages.

The project SHALL render diagrams through the repository’s pinned Drawio, headless Chrome, and font inputs. The //infra/arch:update target SHALL update the maintained SVGs, and //infra/arch:update_tests SHALL compare them with freshly rendered output. Rendering SHALL use local assets and report missing pages or export failures.

Sources: rendering guarantees and render and update targets.

  • WHEN a source edit changes a rendered SVG without updating its maintained copy
  • THEN the freshness test reports a mismatch, and the update target provides the regenerated source file.

Documentation SHALL display the maintained SVGs with links to their full-size images and SHALL retain the source’s Archive classification. The diagrams SHALL remain documentation artifacts rather than evidence of live service availability.

Source: diagram documentation.

Scenario: Consult a historical architecture page

  • WHEN a reader opens the Proxmox architecture section
  • THEN it is labeled Archive/Proxmox and links to the maintained SVG.