V1 Web PWA · Surface walkthrough

Studio Hathor · Pre-Production

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 hathor · route /studio/hathor/pre-production · auth signed-in + studio entitlement · source apps/oshun/web/src/app/studio/hathor/pre-production/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#

Aggregator surface for the Hathor pre-production cluster. It mounts a Capability Summary plus three embedded lanes — Pre-Production Project Management, Visual Storyboarding, and Cinematography Planning — so the pre-production tools are reachable from one page. It issues no /v1 fetch of its own; each embedded lane owns its data.

Entry points#

  • Direct URL / bookmark — /studio/hathor/pre-production; alternates.canonical is set.
  • Breadcrumb / quick-action — Studio › Hathor Pre-Production Project Management › Pre-Production; this page links to Pre-Production Project Management, Visual Storyboarding, and Cinematography Planning.
  • Studio overview — see ../../studio-overview.md.

Layout regions#

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

  • Breadcrumb panel (<section data-hathor-pre-production-breadcrumbs>): Studio → Hathor Pre-Production Project Management → Pre-Production (current).
  • Workspace (StudioHathorPreProductionWorkspace, data-hathor-pre-production-workspace):
    • <h1> WorkspaceHeading — "Hathor Pre-Production Workspace"
    • Summary <p data-hathor-pre-production-summary>
    • Capability Summary (data-hathor-pre-production-capability-summary, <h2>): 4 capability cards.
    • Pre-Production Project Management Lane (data-hathor-pre-production-project-management-lane, <h2>): embeds StudioHathorPreProductionProjectManagementWorkspace.
    • Visual Storyboarding Lane (data-hathor-pre-production-storyboarding-lane, <h2>): embeds StudioHathorVisualStoryboardingWorkspace.
    • Cinematography Planning Lane (data-hathor-pre-production-cinematography-lane, <h2>): embeds StudioHathorCinematographyPlanningWorkspace.
  • Route Map panel (<section data-hathor-pre-production-route-map>, <h2>Route Map</h2>): 6 entries from STUDIO_HATHOR_PRE_PRODUCTION_ROUTE_MAP.
  • Quick-action lane (className="quickAction" Links): Pre-Production Project Management, Visual Storyboarding, Cinematography Planning, Back to Studio workspace index.

States#

  • Each embedded lane — Loading / Unauthorized / Error / Ready / Result, per the lane's own doc (Project Management, Visual Storyboarding, Cinematography Planning).

Interactions#

  • Embedded lane interactions — delegated to the three child workspaces; see their docs for fields and submit verbs.
  • Route Map entries — verify against STUDIO_HATHOR_PRE_PRODUCTION_ROUTE_MAP (6 entries).
  • Quick-action links — Pre-Production Project Management (/studio/hathor/pre-production-project-management), Visual Storyboarding (/studio/hathor/visual-storyboarding), Cinematography Planning (/studio/hathor/cinematography-planning), Back to Studio (/studio).

Data & contracts#

  • Reads / Writes: none from this aggregator; the three embedded lanes own their contracts.
  • Realtime: none.
  • Caching: n/a here; each child lane fetches on mount, cache: 'no-store'.
  • Auth: route is behind the signed-in + studio proxy gate; the embedded lanes are admin-scoped and fail-closed.

Cross-references#

Open questions / known gaps#

  • Hathor is unconfirmed-v1 per WALKTHROUGH/matrix/routes.csv; confirm whether the dedicated /studio/hathor/* surfaces ship V1 or are internal-only.