Studio Aja · Motion Format Conversion

Purpose#

Admin lane console for converting motion between skeleton formats. It wires the real @aja/skeleton-mapping template catalog + converter via /v1/admin/aja/motion-format-conversion: list the skeleton formats (Mixamo / MediaPipe / COCO / H36M / Unity / OpenPose / SMPL) and convert source→target via auto joint-name matching, returning the mapped joint count, a joint-preservation quality score, and any validation errors.

Entry points#

• Direct URL / bookmark — /studio/aja/motion-format-conversion; metadata sets alternates.canonical
• Linked from /studio Domain-bridge studios section (Aja sub-area)
• Quick action — "Open Aja Automated QA Pipeline workspace" (/studio/aja/automated-qa-pipeline)

Layout regions#

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

• Workspace StudioAjaMotionFormatConversionWorkspace — <h1> "Aja Motion Format Conversion Workspace" + summary (data-aja-motion-format-conversion-summary), the skeleton-formats list (<h2> "Skeleton formats (N)") and the convert form
• Route Map panel (data-aja-motion-format-conversion-route-map, <h2>) — 5 entries from STUDIO_AJA_MOTION_FORMAT_CONVERSION_ROUTE_MAP
• Quick-action lane — quickAction links: automated-qa-pipeline, /studio

States#

• Loading — data-aja-mfc-loading "Loading skeleton formats…" while GET /v1/admin/aja/motion-format-conversion is in flight
• Unauthorized (gated) — data-aja-mfc-unauthorized on 401/403; admin scope message ("Aja workspace scope required to view motion format conversion.")
• Error — data-aja-mfc-error on non-OK / malformed / network failure
• Ready (form) — data-aja-mfc-convert-form once the templates load (each listed as data-aja-mfc-template=<id>)
• Result — data-aja-mfc-result (-mapped, -preservation, validation error count) after a successful POST; convert error in data-aja-mfc-convert-error
• Offline — SSR shell; lane error state when fetch unavailable
• Standalone PWA — desktop layout; quickAction anchors wrap
• Empty — N/A; template catalog is constant

Interactions#

Convert form#

• Source format (<select data-aja-mfc-field-source>) — options from the template catalog (defaults coco-17)
• Target format (<select data-aja-mfc-field-target>) — options from the template catalog (defaults h36m-17)
• "Convert" (<button data-aja-mfc-convert-submit>) — POSTs { sourceTemplateId, targetTemplateId } to /v1/admin/aja/motion-format-conversion/convert

Route Map panel#

• 5 entries (<article> per path + purpose) — non-interactive

Quick-action lane#

• "Open Aja Automated QA Pipeline workspace" → /studio/aja/automated-qa-pipeline
• "Back to Studio workspace index" → /studio

Data & contracts#

• Reads: GET /v1/admin/aja/motion-format-conversion ({ templates }) on mount, cache: 'no-store', buildBffAuthHeaders()
• Writes: POST /v1/admin/aja/motion-format-conversion/convert
• Realtime: none
• Caching: client fetch on mount (no-store); SSR shell
• Auth/role check: BFF endpoints admin-scoped, fail-closed (401/403 → unauthorized render); route gated signed-in + studio via the proxy

Cross-references#

• Parent: ../../studio-overview.md
• Sibling routes: ./studio-aja-automated-qa-pipeline.md
• Component sources:
  • apps/oshun/web/src/components/studio/StudioAjaMotionFormatConversionWorkspace.tsx
  • apps/oshun/web/src/components/studio/StudioAjaMotionFormatConversionRouteMap.ts

Open questions / known gaps#

• The conversion reports preservation quality against the template skeletons; converting an actual uploaded motion clip is not an in-page input