V1 Web PWA · Surface walkthrough

Studio Aja · Depth Analysis

A per-surface walkthrough of the V1 Web PWA studio surface: layout, states, interactions, data, and cross-references.

walked
8sections2 minread
Markdown source
On this page

Context. surface studio · domain aja · route /studio/aja/depth-analysis · auth signed-in + studio entitlement · source apps/oshun/web/src/app/studio/aja/depth-analysis/page.tsx

Last walked. 2026-05-29 automated runtime walk (Playwright headless) — render, /v1 data (2xx), console/page-errors, expected content, screenshot verified; live screen-reader, touch, offline, and telemetry-delivery checks pending a manual AT pass. Evidence: WALKTHROUGH/results/runtime-sweep-2026-05-29.md ; body re-derived 2026-06-03 from current source (lane-console architecture)

Purpose#

Leaf lane console that wires the real @aja/pose-lifting sampleDepth primitive. Given a depth grid (width×height, row-major) and a set of normalized (x, y) keypoint locations, the lane returns the bilinearly-interpolated depth at each point — the per-joint operation a 2D→3D pose lift relies on.

Entry points#

  • Direct URL / bookmark — /studio/aja/depth-analysis.
  • Studio nav — Domain-bridge studios section of /studio.
  • Sibling quick-action — "Open Aja Pose Estimation workspace" (/studio/aja/pose-estimation).

Layout regions#

page.tsx renders inside <ShellLayout active="studio">:

  • Workspace <StudioAjaDepthAnalysisWorkspace />:
    • <h1> "Aja Depth Analysis Workspace" + summary (data-aja-depth-analysis-summary).
    • Capability Summary panel (data-aja-depth-analysis-capability-summary, <h2>) — a static descriptive block, no cards.
    • Depth Sampling Operations Lane (data-aja-depth-analysis-operations-lane, <h2>) — the form (states below); includes data-aja-da-sampler-summary (catalog summary).
  • Route Map panel (data-aja-depth-analysis-route-map, <h2> "Route Map"): 5 STUDIO_AJA_DEPTH_ANALYSIS_ROUTE_MAP entries — primary, scenes, exports, revisions, governance.
  • Quick-action lane: two Link.quickAction anchors (Pose Estimation, Back to Studio). No breadcrumb panel on this route.

States#

The lane fetches GET /v1/admin/aja/depth-analysis on mount.

  • Loading — data-aja-da-loading "Loading depth sampler…".
  • Unauthorized — data-aja-da-unauthorized (401/403; default "Aja workspace scope required to sample depth.").
  • Error — data-aja-da-error.
  • Ready (form) — data-aja-da-form.
  • Result — data-aja-da-result with data-aja-da-headline (grid size + depth range) and data-aja-da-samples rows (data-aja-da-sample-row).
  • Validation error — data-aja-da-sample-error (e.g. "Data must be N comma-separated numbers." / "Points must be valid JSON.").

Interactions#

Sample form (data-aja-da-form)#

  • Width — input data-aja-da-width (default 2).
  • Height — input data-aja-da-height (default 2).
  • Depth grid — input data-aja-da-data (default 0, 1, 2, 3).
  • Query points (JSON) — textarea data-aja-da-points.
  • Sample depth — submit data-aja-da-submit; fires POST /v1/admin/aja/depth-analysis/sample with { width, height, data, points }.

Route Map#

  • Route entries (5) — non-interactive listing.

Quick-action lane#

  • "Open Aja Pose Estimation workspace" → /studio/aja/pose-estimation
  • "Back to Studio workspace index" → /studio

Data & contracts#

  • Reads: GET /v1/admin/aja/depth-analysis (catalog: sampler, summary, reports).
  • Writes: POST /v1/admin/aja/depth-analysis/sample → { width, height, minDepth, maxDepth, samples }.
  • Realtime: none.
  • Caching: client fetch on mount (cache: 'no-store'); SSR shell.
  • Auth/role check: BFF endpoint admin-scoped + fail-closed; route gated signed-in + studio via proxy.

Cross-references#

  • Parent: ../../studio-overview.md
  • Sibling (quick-action): /studio/aja/pose-estimation
  • Component sources:
    • apps/oshun/web/src/components/studio/StudioAjaDepthAnalysisWorkspace.tsx
    • apps/oshun/web/src/components/studio/StudioAjaDepthAnalysisRouteMap.ts

Open questions / known gaps#

  • Route Map lists scenes/exports/revisions/governance child routes that are not yet implemented as pages.