--- path: /studio/aja/gaming-pipeline surface: studio domain: aja auth: signed-in + studio entitlement source: apps/oshun/web/src/app/studio/aja/gaming-pipeline/page.tsx status: walked + e2e-covered last_walked: '2026-07-04 focused real-dev-infra Playwright route walk — anonymous redirect, Aja-admin perceptual-quality catalog, exact shipped balanced and edited degraded game-animation clips through the real BFF, local/BFF validation, malformed/transport failures, loading/403/503/malformed catalog states, pending controls, route-map + quick-action affordances, mobile/touch/axe, and direct BFF auth/schema gates. Evidence: WALKTHROUGH/results/v1-real-infra-run-2026-06-22.md §293.' --- # Studio Aja · Gaming Pipeline ## Purpose Admin lane console for the real `@aja/motion-quality` `analyzePerceptualQuality` ship-readiness gate. The operator supplies joint ids and a frames array (≥4 frames of per-joint positions) for a game-animation clip; the lane runs the combined perceptual-quality suite — naturalness, style consistency, temporal coherence, and visual quality folded into a weighted overall score and a quality rating. ## Entry points - **Direct URL / bookmark** — `/studio/aja/gaming-pipeline`; metadata canonical to this path - **Studio nav** — Domain-bridge studios section of `/studio` - **Sibling quick-actions on this page**: Film/VFX Pipeline, Back to Studio (no breadcrumb panel on this route) - **Operator surfacing** — see [`../../studio-overview.md`](../../studio-overview.md) ## Layout regions `page.tsx` renders inside ``: - **Workspace** (``, archetype: LEAF with a capability summary): - `

` (`WorkspaceHeading`) "Aja Gaming Pipeline Workspace" - Summary `

` — operations lane runs the real combined perceptual-quality suite - **Capability Summary** panel (`data-aja-gaming-pipeline-capability-summary`, `

Capability Summary

`) — a single descriptive `
` (typed operations, diagnostics, security, parity), not a card grid - **Operations lane** (`data-aja-gaming-pipeline-operations-lane`, `

Perceptual Quality Operations Lane

`) — the live analyze form - **Route Map panel** (`data-aja-gaming-pipeline-route-map`): `

Route Map

` listing 5 entries from `STUDIO_AJA_GAMING_PIPELINE_ROUTE_MAP` exposed with `data-aja-gaming-pipeline-route-map-entry` / `data-route-path` (primary, scenes, exports, revisions, governance) - **Quick-action panel** (`data-aja-gaming-pipeline-quick-actions`): two `Link.quickAction` anchors — Film/VFX Pipeline, Back to Studio workspace index ## States - [x] **Loading** — operations lane GETs the suite catalog on mount; renders `

` "Loading perceptual-quality suite..." - [x] **Unauthorized** — 401/403 renders `data-aja-gp-unauthorized` ("Access restricted." + admin-scope message, default "Aja workspace scope required to run the perceptual-quality suite.") - [x] **Error** — non-OK / malformed / unreachable renders `data-aja-gp-error` ("Could not load the perceptual-quality suite." + reason) - [x] **Ready (form)** — success renders `data-aja-gp-catalog` with suite, sub-score count, rating count, `data-aja-gp-sub-score` spans, `data-aja-gp-rating` spans, `data-aja-gp-suite-summary`, and the idle `data-aja-gp-form` - [x] **Result** — a successful POST renders `data-aja-gp-result` with stable score / rating / naturalness / style-consistency / temporal-coherence / visual-quality attributes, `data-aja-gp-headline`, and `data-aja-gp-subscores` - [x] **Validation / analyze error** — client guards (≥1 joint id; frames valid JSON array ≥4) and POST failures render `data-aja-gp-analyze-error` - [x] **Pending** — controls and submit disable while `data-aja-gp-form-state="analyzing"` / `data-aja-gp-submit-state="analyzing"` - [x] **Mobile/touch containment** — form controls and route actions remain at least 44 px tall with no horizontal overflow - [x] **Empty / Standalone PWA / offline** — N/A beyond the above; shell SSR, lane is a client fetch on mount ## Interactions ### Operations lane (`data-aja-gp-form`) - [x] **Joint ids** (`data-aja-gp-joints`, input, aria-label "joint ids", comma-separated) - [x] **Frames** (`data-aja-gp-frames`, textarea, aria-label "frames json", JSON array of `{ positions: { jointId: { x, y, z } } }`, ≥4) - [x] **"Run perceptual-quality suite"** (`data-aja-gp-submit`, submit) — fires `POST /v1/admin/aja/gaming-pipeline/analyze` with `{ joints, frames }`; locked with `data-aja-gp-submit-state="analyzing"` while the real request is pending ### Route Map panel - [x] **Route entries** (5 × `

`) — non-interactive path+purpose with exact path ordering ### Quick-action panel - [x] **"Open Aja Film/VFX Pipeline workspace"** → `/studio/aja/film-vfx-pipeline` - [x] **"Back to Studio workspace index"** → `/studio` ## Data & contracts - **Reads**: `GET /v1/admin/aja/gaming-pipeline` on mount — catalog `{ suite, summary, subScores: string[], ratings: string[] }`; client fails closed unless the expected `perceptual-quality` suite, all four sub-score keys, and all five quality ratings are present - **Writes**: `POST /v1/admin/aja/gaming-pipeline/analyze` — `{ joints, frames }` → `{ result }` (overallScore, rating, naturalnessScore, styleConsistencyScore, temporalCoherenceScore, visualQualityScore); client fails closed unless every score is finite and the rating is one of the expected suite ratings - **Realtime**: none - **Caching**: client `fetch` on mount with `cache: 'no-store'` and `buildBffAuthHeaders()`; SSR shell only - **Auth/role check**: BFF endpoints admin-scoped + fail-closed (401/403 → unauthorized render); route behind the signed-in + studio proxy gate ## Cross-references - Parent: [`../../studio-overview.md`](../../studio-overview.md) - Shell: [`../../../shell/04-auth-session.md`](../../../shell/04-auth-session.md) - Sibling routes: [`./studio-aja-film-vfx-pipeline.md`](./studio-aja-film-vfx-pipeline.md) - Component sources: - `apps/oshun/web/src/components/studio/StudioAjaGamingPipelineWorkspace.tsx` - `apps/oshun/web/src/components/studio/StudioAjaGamingPipelineRouteMap.ts` ## Verification evidence - `apps/oshun/web/e2e/studio-aja-gaming-pipeline.spec.ts` runs against the real Next Studio shell and local BFF, forwarding browser bearer auth rather than mocking the perceptual-quality contract. - The spec covers anonymous redirect, Aja-admin catalog load, exact shipped balanced output, edited degraded output, local validation with no POST, BFF validation details, malformed result, transport failure, loading / 503 / malformed / non-admin states, pending form locking, mobile no-overflow + 44px controls, scoped axe, and direct BFF 401/403/400/200 gates. ## Open questions / known gaps - [ ] Route-map sub-routes are advertised but have no `page.tsx` in V1