V1 Web PWA · Surface walkthrough

Studio Hathor · Theory

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/theory · auth signed-in + studio entitlement · source apps/oshun/web/src/app/studio/hathor/theory/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 design-theory cluster. It mounts a Capability Summary plus four embedded lanes — Game Design Theory (MDA), Narrative Theory Tooling, Culture Modeling, and Legal Systems Modeling — so the worldbuilding theory 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/theory; alternates.canonical is set.
  • Breadcrumb / quick-action — Studio › Hathor Game Design Theory (MDA) › Theory; this page links to MDA, Narrative Theory Tooling, Culture Modeling, and Legal Systems Modeling.
  • Studio overview — see ../../studio-overview.md.

Layout regions#

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

  • Breadcrumb panel (<section data-hathor-theory-breadcrumbs>): Studio → Hathor Game Design Theory (MDA) → Theory (current).
  • Workspace (StudioHathorTheoryWorkspace, data-hathor-theory-workspace):
    • <h1> WorkspaceHeading — "Hathor Theory Workspace"
    • Summary <p data-hathor-theory-summary>
    • Capability Summary (data-hathor-theory-capability-summary, <h2>): 4 capability cards.
    • Game Design Theory (MDA) Lane (data-hathor-theory-game-design-lane, <h2>): embeds StudioHathorGameDesignTheoryMdaWorkspace.
    • Narrative Theory Tooling Lane (data-hathor-theory-narrative-lane, <h2>): embeds StudioHathorNarrativeTheoryToolingWorkspace.
    • Culture Modeling Lane (data-hathor-theory-culture-lane, <h2>): embeds StudioHathorCultureModelingWorkspace.
    • Legal Systems Modeling Lane (data-hathor-theory-legal-lane, <h2>): embeds StudioHathorLegalSystemsModelingWorkspace.
  • Route Map panel (<section data-hathor-theory-route-map>, <h2>Route Map</h2>): 6 entries from STUDIO_HATHOR_THEORY_ROUTE_MAP.
  • Quick-action lane (className="quickAction" Links): Game Design Theory (MDA), Narrative Theory Tooling, Culture Modeling, Legal Systems Modeling, Back to Studio workspace index.

States#

  • Each embedded lane — Loading / Unauthorized / Error / Ready / Result, per the lane's own doc (MDA, Narrative Theory Tooling, Culture Modeling, Legal Systems Modeling).

Interactions#

  • Embedded lane interactions — delegated to the four child workspaces; see their docs for fields and submit verbs.
  • Route Map entries — verify against STUDIO_HATHOR_THEORY_ROUTE_MAP (6 entries).
  • Quick-action links — Game Design Theory (MDA) (/studio/hathor/game-design-theory-mda), Narrative Theory Tooling (/studio/hathor/narrative-theory-tooling), Culture Modeling (/studio/hathor/culture-modeling), Legal Systems Modeling (/studio/hathor/legal-systems-modeling), Back to Studio (/studio).

Data & contracts#

  • Reads / Writes: none from this aggregator; the four embedded lanes own their contracts (e.g. /v1/admin/hathor/game-design-theory-mda, /v1/admin/hathor/legal-systems-assessment).
  • 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.