How bettercallareeb1/meridian-studio works
Meridian Studio OS is a browser-based creative-studio planning workspace. Users sign in, then view studio KPIs and manage projects, deliverables/tasks, team members, resource bookings, and optional project files through authenticated CRUD APIs. The server hydrates related records into workspace data backed by PostgreSQL; optional uploads use S3-compatible object storage. The graph reflects documented capabilities and indexed imports/calls, but several UI and API implementations were not excerpted, so uncertain internal links are omitted.
Main entry points: WorkspaceProvider.tsx Workspace state · studio-data.ts Workspace hydration · index.ts Studio database · route.ts Projects API
Components 25
Studio experience
- Login view
src/components/AuthView.tsx - Overview dashboard
src/components/OverviewClient.tsx - Projects view
src/components/ProjectsClient.tsx - Tasks view
src/components/TasksClient.tsx - Resource schedule
src/components/ScheduleClient.tsx - Team view
src/components/TeamClient.tsx - Project files
src/components/ProjectFilesSection.tsx - Workspace state
src/components/WorkspaceProvider.tsx
Identity and sessions
- Login and registration
src/app/api/auth/login/route.ts - Session authentication
src/lib/auth.ts - API session guard
src/lib/api-auth.ts
Workspace API
- Projects API
src/app/api/projects/route.ts - Tasks API
src/app/api/tasks/route.ts - Bookings API
src/app/api/bookings/route.ts - Team API
src/app/api/team/route.ts - Workspace API
src/app/api/workspace/route.ts - Project file API
src/app/api/projects/[id]/files/route.ts
Workspace data
- Workspace hydration
src/lib/studio-data.ts - Studio data types
src/lib/studio-types.ts
Persistence and files
- Studio database
src/db/index.ts - Workspace schema
src/db/schema.ts - Demo workspace seed
src/db/seed.ts - S3-compatible storage
- Object storage helper
src/lib/storage.ts
Other components
- Studio user
Connections 30
- Studio user → Login view: signs in
- Login view → Login and registration: authenticates
- Login and registration → Session authentication: creates session
src/app/api/auth/login/route.ts - Session authentication → Studio database: reads and writes
src/lib/auth.ts - Studio user → Overview dashboard: plans studio work
README.md - Overview dashboard → Workspace state: uses workspace state
src/components/OverviewClient.tsx - Projects view → Workspace state: uses workspace state
src/components/ProjectsClient.tsx - Tasks view → Workspace state: uses workspace state
src/components/TasksClient.tsx - Resource schedule → Workspace state: uses workspace state
src/components/ScheduleClient.tsx - Team view → Workspace state: uses workspace state
src/components/TeamClient.tsx - Workspace state → Workspace API: fetches workspace
src/components/WorkspaceProvider.tsx - Workspace state → Projects API: sends project changes
src/components/WorkspaceProvider.tsx - Workspace state → Tasks API: sends task changes
src/components/WorkspaceProvider.tsx - Workspace state → Bookings API: sends booking changes
src/components/WorkspaceProvider.tsx - Workspace state → Team API: sends team changes
- Project files → Project file API: manages uploads
- Workspace API → API session guard: checks session
src/app/api/workspace/route.ts - Projects API → API session guard: checks session
src/app/api/projects/route.ts - Tasks API → API session guard: checks session
src/app/api/tasks/route.ts - Projects API → Workspace hydration: loads workspace data
src/app/api/projects/route.ts - Tasks API → Workspace hydration: loads workspace data
src/app/api/tasks/route.ts - Bookings API → Workspace hydration: loads workspace data
src/app/api/bookings/route.ts - Team API → Workspace hydration: loads workspace data
src/app/api/team/route.ts - Workspace API → Workspace hydration: returns workspace data
src/app/api/workspace/route.ts - Workspace hydration → Studio database: queries records
src/lib/studio-data.ts - Workspace hydration → Demo workspace seed: ensures demo seed
src/lib/studio-data.ts - Demo workspace seed → Studio database: inserts demo records
src/db/seed.ts - Studio database → Workspace schema: configures ORM
src/db/index.ts - Project file API → Object storage helper: uploads and deletes objects
src/app/api/projects/[id]/files/route.ts - Object storage helper → S3-compatible storage: stores file objects
src/lib/storage.ts