Studio · Yemaya · Database

Purpose#

Aggregator workspace that composes three sibling Yemaya lanes — API, Workers, and Project Workspaces — under one shell, with a Capability Summary heading the page. The page performs no /v1 fetch; each embedded lane runs its own console.

Entry points#

• Studio index quick-actions.
• Breadcrumb chain on this page: Studio › Yemaya Project Workspaces › Database.
• Direct URL / bookmark (signed-in + studio entitlement).

Layout regions#

page.tsx renders ShellLayout active="studio" and:

• Breadcrumbs panel (data-yemaya-database-breadcrumbs): Studio › Yemaya Project Workspaces › Database (current aria-current="page").
• Workspace panel (StudioYemayaDatabaseWorkspace, data-yemaya-database-workspace):
  • <h1> "Yemaya Database Workspace".
  • Summary <p data-yemaya-database-summary>.
  • Capability Summary (data-yemaya-database-capability-summary, <h2>): four data-yemaya-database-capability cards — Persistence Control Plane, Project Data Orchestration, Import/Export and Observability, Security and Parity.
  • API Lane (data-yemaya-database-api-lane, <h2>) — embeds StudioYemayaApiWorkspace (itself a hybrid — see studio-yemaya-api.md).
  • Workers Lane (data-yemaya-database-workers-lane, <h2>) — embeds StudioYemayaWorkersWorkspace.
  • Project Workspaces Lane (data-yemaya-database-project-workspaces-lane, <h2>) — embeds StudioYemayaProjectWorkspacesWorkspace.
• Route Map panel (data-yemaya-database-route-map): <h2> "Route Map" with six entries.
• Quick-action panel: four quickAction links.

States#

The aggregator renders unconditionally; each embedded lane owns its own states:

• API Lane — see studio-yemaya-api.md.
• Workers Lane — see studio-yemaya-workers.md.
• Project Workspaces Lane — see studio-yemaya-project-workspaces.md.

Interactions#

Capability cards (non-interactive)#

• Persistence Control Plane / Project Data Orchestration / Import/Export and Observability / Security and Parity (data-yemaya-database-capability articles).

Embedded lanes#

• API Lane / Workers Lane / Project Workspaces Lane — see their per-view walkthroughs.

Route map#

data-yemaya-database-route-map — six entries:

• /studio/yemaya/database
• /studio/yemaya/database/records/[recordId]
• /studio/yemaya/database/branches/[branchId]
• /studio/yemaya/database/import-export/[exchangeId]
• /studio/yemaya/database/parity/[parityId]
• /studio/yemaya/database/governance/[policyId]

Quick actions#

• "Open Yemaya Project Workspaces workspace" → /studio/yemaya/project-workspaces.
• "Open Yemaya API workspace" → /studio/yemaya/api.
• "Open Yemaya Workers workspace" → /studio/yemaya/workers.
• "Back to Studio workspace index" → /studio.

Data & contracts#

• Reads: none at the page boundary; reads happen inside each embedded lane.
• Writes: none at the page boundary; the embedded lanes own their POSTs.
• Realtime: None.
• Caching: aggregator delegates to embedded lanes.
• Auth/role check: admin-scoped, fail-closed inside each lane; route additionally signed-in + studio via the proxy gate.

Cross-references#

• Workspace source: apps/oshun/web/src/components/studio/StudioYemayaDatabaseWorkspace.tsx
• Route map source: apps/oshun/web/src/components/studio/StudioYemayaDatabaseRouteMap.ts
• Page source: apps/oshun/web/src/app/studio/yemaya/database/page.tsx
• Embedded lanes:
  • apps/oshun/web/src/components/studio/StudioYemayaApiWorkspace.tsx
  • apps/oshun/web/src/components/studio/StudioYemayaWorkersWorkspace.tsx
  • apps/oshun/web/src/components/studio/StudioYemayaProjectWorkspacesWorkspace.tsx
• Studio overview: studio-overview.md
• Feature spec: V1/features.md

Open questions / known gaps#

• The embedded API Lane brings the large legacy API workflow-track shell with it (see studio-yemaya-api.md); confirm whether embedding it whole inside Database is intentional.
• Route-map children (records/branches/import-export/parity/ governance) are a sitemap contract; confirm which dynamic pages exist.