Skip to content

System

System

Architecture, data model, API routes, and service internals.

System

Internals for developers and operators — everything under the surface of the studio:

  • Architecture — process layout, runtime topology, and where state lives.
  • Data Model — Postgres / Prisma, on-disk assets, and PlannerSession types.
  • API Routes — every Next.js route handler and what it does.
  • Testing and demo video — Vitest, optional Playwright smoke, and demo:record for marketing capture.
  • Beat Service — the local Python service for beats, downbeats, and lyrics.
  • Gallery hero strip — locked “All renders” tick behaviour (static list, no regressions).
  • Lessons Learned — caveats, product notes, and tracked TODOs (e.g. lyric timing).
  • Docs System — how this very docs site is wired up.

In this section