Studio · Yemaya · Enterprise Analytics

Purpose#

Admin lane console for descriptive statistics. It wires the real @yemaya/d3-visualizations statistical transforms via /v1/admin/yemaya/enterprise-analytics: supply a numeric series and compute its statistical summary — mean, median, standard deviation, quartiles and IQR — plus an interpolated percentile.

Entry points#

• No breadcrumb panel on this page.
• Reachable from the Studio index and from the Compliance and Audit quick-action (which links here).
• Direct URL / bookmark (signed-in + studio entitlement).

Layout regions#

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

• Workspace panel (StudioYemayaEnterpriseAnalyticsWorkspace, data-yemaya-enterprise-analytics-workspace):
  • <h1> "Yemaya Enterprise Analytics Workspace" (WorkspaceHeading).
  • Summary paragraph (data-yemaya-enterprise-analytics-summary).
  • The summary-computation form lane (loading / unauthorized / error / ready-form / result, see States).
• Route Map panel (data-yemaya-enterprise-analytics-route-map): <h2> "Route Map" + five STUDIO_YEMAYA_ENTERPRISE_ANALYTICS_ROUTE_MAP entries.
• Quick-action panel: two quickAction links.

States#

• Loading — data-yemaya-ea-loading "Loading analytics…" while the GET catalog fetch is in flight.
• Unauthorized — data-yemaya-ea-unauthorized "Access restricted." on a 401/403 admin-scope failure (fail-closed).
• Error — data-yemaya-ea-error "Could not load enterprise analytics." on a non-OK / malformed catalog response.
• Ready-form — data-yemaya-ea-summary-form once the catalog (summaryFields) resolves.
• Result — data-yemaya-ea-result with data-yemaya-ea-central, data-yemaya-ea-spread, data-yemaya-ea-quartiles, and an optional data-yemaya-ea-percentile; or a validation message data-yemaya-ea-summary-error.

Interactions#

Summary form (data-yemaya-ea-summary-form)#

• Numeric series — input data-yemaya-ea-field-series (aria-label "numeric series"); comma- or space-separated numbers.
• Percentile (optional) — input data-yemaya-ea-field-percentile (aria-label "percentile"), 0–100.
• Submit — button data-yemaya-ea-summary-submit "Compute summary" → POST /v1/admin/yemaya/enterprise-analytics/summary with { values, percentile? }.

Route map#

data-yemaya-enterprise-analytics-route-map — five entries:

• /studio/yemaya/enterprise-analytics
• /studio/yemaya/enterprise-analytics/scenes/[sceneId]
• /studio/yemaya/enterprise-analytics/exports/[exportId]
• /studio/yemaya/enterprise-analytics/revisions/[revisionId]
• /studio/yemaya/enterprise-analytics/governance/[policyId]

Quick actions#

• "Open Yemaya Compliance and Audit workspace" → /studio/yemaya/compliance-and-audit.
• "Back to Studio workspace index" → /studio.

Data & contracts#

• Reads: GET /v1/admin/yemaya/enterprise-analytics (catalog: summaryFields) on mount.
• Writes: POST /v1/admin/yemaya/enterprise-analytics/summary.
• Realtime: none.
• Caching: client fetch on mount, cache: 'no-store', buildBffAuthHeaders().
• Auth/role check: admin-scoped fail-closed (401/403 → unauthorized state) behind the proxy studio gate.

Cross-references#

• Studio overview: studio-overview.md
• Workspace source: apps/oshun/web/src/components/studio/StudioYemayaEnterpriseAnalyticsWorkspace.tsx
• Route map source: apps/oshun/web/src/components/studio/StudioYemayaEnterpriseAnalyticsRouteMap.ts
• Engine: @yemaya/d3-visualizations
• Sibling Yemaya bridges: see folder index
• Feature spec: V1/features.md

Open questions / known gaps#

• The Route Map advertises scenes / exports / revisions / governance sub-routes that the live summary lane does not expose.