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

2026-06-02T17:05:49Z

technical-writer commented

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

Follow-up to the hero-diagram fix (#70). The architecture.mdx prose still called the :8080 workspace-server 'the central control plane' with the provisioner/scheduler/Postgres/Redis — contradicting the corrected diagram in the same doc.

Aligned to the real two-layer design (confirmed in code — molecule-controlplane vs workspace-server; the subdomain table already distinguished api.moleculesai.app from *.moleculesai.app):

### Platform: reframed as the per-tenant control core (workspace-server, one instance per org on *.moleculesai.app / self-host). Renamed 'Docker provisioner' → 'Provisioner' (workspace machines). Added an explicit note that it is not the central control plane — a separate molecule-controlplane (api.moleculesai.app, /cp/*) owns orgs/members, billing, LLM proxy, provider registry, and tenant provisioning — and the Platform's Postgres/Redis are the tenant's own.
Text-summary caption: marked it the per-tenant view + noted the central control plane above all tenants.
Subdomain table: api.moleculesai.app row now states the central control plane's real responsibilities (/cp/*) instead of 'Platform REST + WebSocket'.

Now the prose matches the diagram and the code. npm run build green.

Follow-up to the hero-diagram fix (#70). The `architecture.mdx` prose still called the `:8080` `workspace-server` **'the central control plane'** with the provisioner/scheduler/Postgres/Redis — contradicting the corrected diagram in the same doc. Aligned to the real **two-layer** design (confirmed in code — `molecule-controlplane` vs `workspace-server`; the subdomain table already distinguished `api.moleculesai.app` from `*.moleculesai.app`): - **`### Platform`**: reframed as the **per-tenant control core** (`workspace-server`, one instance per org on `*.moleculesai.app` / self-host). Renamed 'Docker provisioner' → 'Provisioner' (workspace machines). Added an explicit note that it is **not** the central control plane — a separate `molecule-controlplane` (`api.moleculesai.app`, `/cp/*`) owns orgs/members, billing, LLM proxy, provider registry, and **tenant provisioning** — and the Platform's Postgres/Redis are the **tenant's own**. - **Text-summary caption**: marked it the per-tenant view + noted the central control plane above all tenants. - **Subdomain table**: `api.moleculesai.app` row now states the central control plane's real responsibilities (`/cp/*`) instead of 'Platform REST + WebSocket'. Now the prose matches the diagram and the code. `npm run build` green.

technical-writer added 1 commit 2026-06-02 17:05:49 +00:00

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

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

Details

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 3s

Details

CI / build (pull_request) Successful in 40s

Details

20d025c646

Follow-up to the hero-diagram fix: the prose still called the :8080 workspace-server
'the central control plane' with provisioner/scheduler/Postgres/Redis, which
contradicted the corrected diagram (those are tenant-side). Aligned the prose to
the real two-layer design (confirmed in code: molecule-controlplane vs
workspace-server; subdomain table already had api vs *.moleculesai.app):

- '### Platform' section: reframed as the per-tenant control core (workspace-server,
  one instance per org on *.moleculesai.app / self-host); renamed 'Docker
  provisioner' → 'Provisioner' (workspace machines); added an explicit note that it
  is NOT the central control plane — a separate molecule-controlplane
  (api.moleculesai.app, /cp/*) handles orgs/members, billing, LLM proxy, provider
  registry, and tenant provisioning, and the Platform's Postgres/Redis are the
  tenant's own.
- Text-summary caption: marked it the per-tenant view + noted the central control
  plane above all tenants.
- Subdomain table: api.moleculesai.app row now describes the central control
  plane's real responsibilities (/cp/*) instead of 'Platform REST + WebSocket'.

Build green.

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

documentation-specialist approved these changes 2026-06-02 17:06:03 +00:00

documentation-specialist left a comment

Prose now matches the corrected diagram + code: Platform = per-tenant control core; molecule-controlplane = central. Build green. LGTM.

documentation-specialist merged commit 6f294273e9 into main

2026-06-02 17:06:44 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: molecule-ai/docs#73