--- path: /studio/hathor/cinematography-planning surface: studio domain: hathor auth: signed-in + studio entitlement source: apps/oshun/web/src/app/studio/hathor/cinematography-planning/page.tsx status: walked last_walked: | 2026-07-03 standalone real-BFF route addendum: the dedicated Playwright spec now covers anonymous redirect, admin direct navigation, live cinematography reference catalog GET, AuthProvider Hathor-admin bearer propagation, exact @hathor/theory shot-scale / lighting-style / camera-angle / color-scheme reference-card output through the real BFF, client-only empty emotion/mood rejection, BFF detail surfacing, plan transport failure, catalog loading/503/malformed states, non-admin fail-closed state, pending submit disablement, 247-entry route-map contract, quick-action affordances, representative panel cluster presence, mobile 44px controls, direct BFF auth/schema gates, and shared axe. Evidence: WALKTHROUGH/results/v1-real-infra-run-2026-06-22.md §270; apps/oshun/web/e2e/studio-hathor-cinematography-planning.spec.ts. 2026-05-29 automated runtime walk evidence: WALKTHROUGH/results/runtime-sweep-2026-05-29.md; body re-derived 2026-06-03 from current source (panel-cluster aggregator; no embedded economy workspace). --- # Studio Hathor · Cinematography Planning ## Purpose Panel-cluster aggregator and admin reference-planning console for drone-and-virtual-production cinematography. The workspace renders `StudioHathorCinematographyReferencePlanner`, which calls the real `/v1/admin/hathor/cinematography-planning` BFF route backed by `@hathor/theory`, plus ~243 specialist `StudioHathor*Panel` sub-components covering drone fleet choreography, photogrammetry / Gaussian-splatting / NeRF / LiDAR capture, ICVFX LED-wall simulation, performer / facial / hand capture, virtual-set library, editorial color / VFX, and director comms. A `renderMode` prop (`full` | `inventory`) switches between the full panel cluster and a selector-only inventory; the page renders the default `full`. It does NOT embed `StudioHathorEconomyModelingWorkspace`. ## Entry points - **Quick-action link from `/studio/hathor/chronicle-parser`** — "Open Hathor Cinematography Planning workspace" (verify against that page's source) - **Direct URL / bookmark** — yes; `alternates.canonical` set to `/studio/hathor/cinematography-planning` - **Studio overview** — see [`../../studio-overview.md`](../../studio-overview.md) ## Layout regions `page.tsx` renders inside ``: - **Workspace** `` (default `renderMode="full"`): - `WorkspaceHeading` `

` — "Hathor Cinematography Planning Workspace" - A long `

` enumerating the desks (drone shot library, choreography, fleet, role assignment, handoff, battery, timecode, formation, launch/recovery, fleet health, emergency, comms mesh, autonomous framing, shot-type classifier, photogrammetry, NeRF / Gaussian-splat / LiDAR capture, virtual-set library, ICVFX, mocap, facial / hand capture, director comms, editorial color / VFX, and flight-path design) - `` — `data-hathor-cinematography-reference-planner`; catalog-gated `data-hathor-crp-form`, visible catalog summary `data-hathor-crp-catalog`, emotion/mood text inputs, optional camera-angle/color-scheme selects, and `data-hathor-crp-submit` - In `renderMode='full'`: the ~243 individual `StudioHathor*Panel` children (`StudioHathorDroneShotLibraryPanel` … `StudioHathorDroneFlightPathDesignerPanel`) - In `renderMode='inventory'`: `` — a selector-only inventory in place of the panel cluster - **Route Map panel** (`data-hathor-cinematography-planning-route-map`, `data-hathor-cp-route-count="247"`) — `

` "Route Map" listing the entries from `STUDIO_HATHOR_CINEMATOGRAPHY_PLANNING_ROUTE_MAP`; each entry is tagged with `data-hathor-cinematography-planning-route-map-entry` and `data-route-path` - **Quick-action lane** (`data-hathor-cinematography-planning-quick-actions`, `data-hathor-cp-quick-action-count="2"`) — Narrative Theory Tooling (`data-hathor-cinematography-planning-quick-action="narrative-theory-tooling"`) and Back to Studio workspace index (`data-hathor-cinematography-planning-quick-action="studio-index"`) ## States - [x] **Loading** — `

` "Loading cinematography reference engine…" while the reference catalog GET is in flight - [x] **Unauthorized** — `data-hathor-crp-unauthorized` "Access restricted." on 401/403 (admin Hathor scope required); fail-closed - [x] **Error** — `data-hathor-crp-error` on non-OK GET or malformed catalog - [x] **Ready (form)** — `data-hathor-crp-form` after the camera-angle and color-scheme catalog loads, with `data-hathor-crp-catalog` - [x] **Pending submit** — `data-hathor-crp-plan-state="pending"` and `data-hathor-crp-submit-state="pending"`; emotion, mood, angle, scheme, and submit controls are disabled with `aria-busy="true"` until the BFF response returns - [x] **Result** — `data-hathor-crp-result` after a 200 plan; validation, non-200, and transport failures surface through `data-hathor-crp-plan-error` - [x] **Populated (full mode, route default)** — `ReferencePlanner` + every drone / cinematography / director / virtual-set panel renders - [ ] **Populated (inventory mode)** — only the `StudioHathorCinematographyPlanningPanelInventory` selector renders (no panel cluster). The page renders `full`; this is the alternate `renderMode` - [ ] **Error (unrecoverable)** — bubbles to nearest `error.tsx` - [x] **Empty** — N/A; hard-coded panel set - [x] **Gated** — N/A at this route; entitlement at the proxy/middleware level ## Interactions ### Workspace body - [x] **Heading + summary** (non-interactive `

` + summary `

`) - [x] **Emotion** — `` seeded with `heroic power` - [x] **Mood** — `` seeded with `dark dramatic` - [x] **Camera angle** — `` from catalog color schemes; optional `warm` resolves the reference card - [x] **Plan cinematography** — `