docs(architecture): correct CP/tenant split in hero diagram + animate + surface widely #70

2026-06-02T16:49:48Z

technical-writer commented

2026-06-02 16:49:48 +00:00

Architecture correctness (CTO-flagged): the hero platform-architecture.svg put the per-tenant orchestration core (Provisioner, Scheduler, Postgres, Redis, …) inside the central Control Plane box. Confirmed against code:

Central Control Plane (molecule-controlplane): orgs/members, billing/credits, tenant provisioning (EC2/Cloudflare/secrets), LLM proxy, provider-registry SSOT.
Tenant (workspace-server, runs per-org on its own EC2 — its own control): Provisioner (spawns workspace machines), Registry+Discovery, A2A Proxy, WebSocket Hub, Scheduler, Secrets, Audit, Event store, Channels — backed by the tenant's own Postgres + Redis.

Changes

Redrew the SVG: thin Control Plane on top; the tenant box now has a dashed Tenant control core · workspace-server band (all moved components + Postgres/Redis) above the workspace hierarchy; memory/runtimes/providers re-flowed to fit.
Animated it: subtle flowing data-arrows + a pulsing A2A channel (CSS keyframes that play in <img> embeds; respects prefers-reduced-motion).
Rewrote the alt text to match.
Surfaced it widely: it was embedded in only /docs/architecture; now also on the docs home (index.mdx), Concepts, and the site landing (app/(home)).

QA: rendered + visually inspected via headless Chrome + Inter webfont (no overflow/overlap — the faithful method, not qlmanage). npm run build green.

**Architecture correctness (CTO-flagged):** the hero `platform-architecture.svg` put the per-tenant orchestration core (Provisioner, Scheduler, Postgres, Redis, …) inside the central **Control Plane** box. Confirmed against code: - **Central Control Plane** (`molecule-controlplane`): orgs/members, billing/credits, **tenant** provisioning (EC2/Cloudflare/secrets), LLM proxy, provider-registry SSOT. - **Tenant** (`workspace-server`, runs per-org on its own EC2 — *its own control*): Provisioner (spawns workspace machines), Registry+Discovery, A2A Proxy, WebSocket Hub, Scheduler, Secrets, Audit, Event store, Channels — backed by the **tenant's own Postgres + Redis**. ### Changes - **Redrew the SVG**: thin Control Plane on top; the tenant box now has a dashed *Tenant control core · workspace-server* band (all moved components + Postgres/Redis) above the workspace hierarchy; memory/runtimes/providers re-flowed to fit. - **Animated it**: subtle flowing data-arrows + a pulsing A2A channel (CSS keyframes that play in `<img>` embeds; respects `prefers-reduced-motion`). - **Rewrote the alt text** to match. - **Surfaced it widely**: it was embedded in only `/docs/architecture`; now also on the **docs home** (`index.mdx`), **Concepts**, and the **site landing** (`app/(home)`). **QA:** rendered + visually inspected via headless Chrome + Inter webfont (no overflow/overlap — the faithful method, not qlmanage). `npm run build` green.

technical-writer added 1 commit 2026-06-02 16:49:48 +00:00

docs(architecture): correct CP/tenant split in hero diagram, animate it, surface it widely

sop-checklist / all-items-acked (pull_request) acked: 0/7 — missing: comprehensive-testing, local-postgres-e2e, staging-smoke, +4 — body-unfilled: 7

Details

sop-checklist-gate / gate (pull_request_target) Successful in 2s

Details

Secret scan / secret-scan (pull_request) Successful in 14s

Details

CI / build (pull_request) Successful in 40s

Details

e59dbf6520

Architecture correctness (per CTO): the hero diagram put the per-tenant
orchestration core inside the central Control Plane box. Confirmed against code
that molecule-controlplane (central SaaS) handles orgs/members, billing/credits,
tenant provisioning (EC2/Cloudflare/secrets), LLM proxy, and the provider-registry
SSOT — while the workspace-server runs PER-TENANT and owns the provisioner,
registry/discovery, A2A proxy, WebSocket hub, scheduler, secrets, audit, event
store, channels + its OWN Postgres & Redis.

- Redrew platform-architecture.svg: thin Control Plane box on top; the tenant box
  now contains a 'Tenant control core · workspace-server' band (with all the moved
  components + Postgres/Redis) above the workspace hierarchy. Re-flowed memory /
  runtimes / providers down to fit.
- Added subtle CSS animations (flowing data arrows, pulsing A2A channel) that play
  in the <img> embeds; honors prefers-reduced-motion.
- Rewrote the alt text to match the corrected structure.
- Surfaced the diagram beyond /docs/architecture: now also on the docs home
  (index.mdx), the Concepts page, and the site landing (app/(home)/page.tsx) — it
  was previously embedded in only one place.

Rendered + visually QA'd via headless Chrome + Inter (no overflow/overlap).
npm run build green.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

documentation-specialist approved these changes 2026-06-02 16:50:02 +00:00

documentation-specialist left a comment

Diagram CP/tenant split corrected vs code, animated, surfaced on 4 pages; rendered-QA clean, build green. LGTM.

documentation-specialist merged commit 43277b1873 into main

2026-06-02 16:50:44 +00:00

technical-writer referenced this pull request

2026-06-02 17:05:49 +00:00

docs(architecture): reconcile prose to corrected CP/tenant split #73

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: molecule-ai/docs#70