# naderyb/stars-house-club architecture

> Architecture diagram of the GitHub repository naderyb/stars-house-club, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/naderyb/stars-house-club
- Repository: https://github.com/naderyb/stars-house-club

## Overview

This is a Next.js venue and community operations site: visitors explore the venue, events, menu and workshops, then can submit a membership application with identity and proof uploads. Staff use role-scoped administration for registrations, door checks, events, menu, workshops, team, statistics and table tabs. The graph preserves those documented-by-tree capabilities, but most page and route wiring was not excerpted; edges are limited to visible calls and indexed imports.

Main entry points: [`src/lib/supabase/server.ts`](https://github.com/naderyb/stars-house-club/blob/main/src/lib/supabase/server.ts) (Supabase services), [`src/app/api/join/route.ts`](https://github.com/naderyb/stars-house-club/blob/main/src/app/api/join/route.ts) (Application intake), [`src/app/api/admin`](https://github.com/naderyb/stars-house-club/tree/main/src/app/api/admin) (Admin APIs), [`src/lib/admin/session.ts`](https://github.com/naderyb/stars-house-club/blob/main/src/lib/admin/session.ts) (Session and guards)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public venue"]
  node_publicsite["Venue pages"]
  node_publicdata["Venue content"]
  node_publicevents["Event feed<br/>[publicEvents.ts]"]
end

subgraph group_joining["Membership intake"]
  node_applications["Join form<br/>[JoinForm.tsx]"]
  node_upload["Identity uploads"]
  node_joinapi["Application intake<br/>[route.ts]"]
  node_statusapi["Application status<br/>[route.ts]"]
end

subgraph group_admin["Staff operations"]
  node_adminui["Admin screens"]
  node_registrations["Registration review"]
  node_door["Door and ID checks<br/>[DoorList.tsx]"]
  node_eventsadmin["Event management<br/>[EventManager.tsx]"]
  node_menuadmin["Menu management<br/>[MenuManager.tsx]"]
  node_workshopadmin["Workshop management"]
  node_tabs["Table tabs<br/>[route.ts]"]
  node_team["Team management<br/>[TeamManager.tsx]"]
  node_stats["Operations statistics<br/>[stats.ts]"]
  node_adminapi["Admin APIs"]
  node_admincall["Admin request helper<br/>[useAdminCall.ts]"]
end

subgraph group_foundation["Shared services"]
  node_auth["Admin authentication<br/>[auth.ts]"]
  node_session["Session and guards<br/>[session.ts]"]
  node_roles["Role permissions<br/>[roles.ts]"]
  node_joinrules["Application validation<br/>[schema.ts]"]
  node_ratelimit["Request throttling<br/>[rateLimit.ts]"]
  node_supabase[("Supabase services<br/>[server.ts]")]
  node_eventsdata["Event definitions<br/>[events.ts]"]
  node_menudata["Menu definitions<br/>[menu.ts]"]
  node_sitedata["Site settings<br/>[site.ts]"]
end

node_visitor(("Visitor"))

node_visitor -->|"submits"| node_applications
node_applications -->|"posts application"| node_joinapi
node_joinapi -->|"validates with"| node_joinrules
node_joinapi -->|"throttles with"| node_ratelimit
node_joinapi -->|"stores records"| node_supabase
node_upload -->|"validates with"| node_joinrules
node_upload -->|"throttles with"| node_ratelimit
node_upload -->|"uses storage"| node_supabase
node_statusapi -->|"reads status"| node_supabase
node_publicevents -->|"reads events"| node_eventsdata
node_publicevents -->|"reads events"| node_supabase
node_workshopadmin -->|"sends actions"| node_admincall
node_admincall -->|"posts actions"| node_adminapi
node_team -->|"posts team actions"| node_adminapi
node_adminapi -->|"checks session"| node_session
node_adminapi -->|"reads and writes"| node_supabase
node_session -->|"loads session"| node_supabase
node_session -->|"checks access"| node_roles
node_auth -->|"checks credentials"| node_supabase
node_session -->|"uses starter identity"| node_auth
node_adminapi -->|"checks permissions"| node_roles
node_menuadmin -->|"formats prices"| node_menudata
node_workshopadmin -->|"formats prices"| node_menudata
node_joinapi -->|"checks join pause"| node_sitedata

click node_publicsite "https://github.com/naderyb/stars-house-club/tree/main/src/app"
click node_publicdata "https://github.com/naderyb/stars-house-club/tree/main/src/data"
click node_publicevents "https://github.com/naderyb/stars-house-club/blob/main/src/lib/publicEvents.ts"
click node_applications "https://github.com/naderyb/stars-house-club/blob/main/src/components/JoinForm.tsx"
click node_upload "https://github.com/naderyb/stars-house-club/tree/main/src/app/api/join"
click node_joinapi "https://github.com/naderyb/stars-house-club/blob/main/src/app/api/join/route.ts"
click node_statusapi "https://github.com/naderyb/stars-house-club/blob/main/src/app/api/status/route.ts"
click node_adminui "https://github.com/naderyb/stars-house-club/tree/main/src/app/admin/(panel)"
click node_registrations "https://github.com/naderyb/stars-house-club/blob/main/src/components/admin/RegistrationsBoard.tsx"
click node_door "https://github.com/naderyb/stars-house-club/blob/main/src/components/admin/DoorList.tsx"
click node_eventsadmin "https://github.com/naderyb/stars-house-club/blob/main/src/components/admin/EventManager.tsx"
click node_menuadmin "https://github.com/naderyb/stars-house-club/blob/main/src/components/admin/MenuManager.tsx"
click node_workshopadmin "https://github.com/naderyb/stars-house-club/blob/main/src/components/WorkshopManager.tsx"
click node_tabs "https://github.com/naderyb/stars-house-club/blob/main/src/app/api/admin/tabs/route.ts"
click node_team "https://github.com/naderyb/stars-house-club/blob/main/src/components/admin/TeamManager.tsx"
click node_stats "https://github.com/naderyb/stars-house-club/blob/main/src/lib/admin/stats.ts"
click node_adminapi "https://github.com/naderyb/stars-house-club/tree/main/src/app/api/admin"
click node_admincall "https://github.com/naderyb/stars-house-club/blob/main/src/components/admin/useAdminCall.ts"
click node_auth "https://github.com/naderyb/stars-house-club/blob/main/src/lib/admin/auth.ts"
click node_session "https://github.com/naderyb/stars-house-club/blob/main/src/lib/admin/session.ts"
click node_roles "https://github.com/naderyb/stars-house-club/blob/main/src/lib/admin/roles.ts"
click node_joinrules "https://github.com/naderyb/stars-house-club/blob/main/src/lib/join/schema.ts"
click node_ratelimit "https://github.com/naderyb/stars-house-club/blob/main/src/lib/rateLimit.ts"
click node_supabase "https://github.com/naderyb/stars-house-club/blob/main/src/lib/supabase/server.ts"
click node_eventsdata "https://github.com/naderyb/stars-house-club/blob/main/src/data/events.ts"
click node_menudata "https://github.com/naderyb/stars-house-club/blob/main/src/data/menu.ts"
click node_sitedata "https://github.com/naderyb/stars-house-club/blob/main/src/data/site.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_publicsite,node_publicdata,node_publicevents toneBlue
class node_applications,node_upload,node_joinapi,node_statusapi toneAmber
class node_adminui,node_registrations,node_door,node_eventsadmin,node_menuadmin,node_workshopadmin,node_tabs,node_team,node_stats,node_adminapi,node_admincall toneMint
class node_auth,node_session,node_roles,node_joinrules,node_ratelimit,node_supabase,node_eventsdata,node_menudata,node_sitedata toneRose
class node_visitor toneIndigo
```

## Components

### Public venue

- [Venue pages](https://github.com/naderyb/stars-house-club/tree/main/src/app): `src/app`
- [Venue content](https://github.com/naderyb/stars-house-club/tree/main/src/data): `src/data`
- [Event feed](https://github.com/naderyb/stars-house-club/blob/main/src/lib/publicEvents.ts): `src/lib/publicEvents.ts`

### Membership intake

- [Join form](https://github.com/naderyb/stars-house-club/blob/main/src/components/JoinForm.tsx): `src/components/JoinForm.tsx`
- [Identity uploads](https://github.com/naderyb/stars-house-club/tree/main/src/app/api/join): `src/app/api/join`
- [Application intake](https://github.com/naderyb/stars-house-club/blob/main/src/app/api/join/route.ts): `src/app/api/join/route.ts`
- [Application status](https://github.com/naderyb/stars-house-club/blob/main/src/app/api/status/route.ts): `src/app/api/status/route.ts`

### Staff operations

- [Admin screens](https://github.com/naderyb/stars-house-club/tree/main/src/app/admin/(panel)): `src/app/admin/(panel)`
- [Registration review](https://github.com/naderyb/stars-house-club/blob/main/src/components/admin/RegistrationsBoard.tsx): `src/components/admin/RegistrationsBoard.tsx`
- [Door and ID checks](https://github.com/naderyb/stars-house-club/blob/main/src/components/admin/DoorList.tsx): `src/components/admin/DoorList.tsx`
- [Event management](https://github.com/naderyb/stars-house-club/blob/main/src/components/admin/EventManager.tsx): `src/components/admin/EventManager.tsx`
- [Menu management](https://github.com/naderyb/stars-house-club/blob/main/src/components/admin/MenuManager.tsx): `src/components/admin/MenuManager.tsx`
- [Workshop management](https://github.com/naderyb/stars-house-club/blob/main/src/components/WorkshopManager.tsx): `src/components/WorkshopManager.tsx`
- [Table tabs](https://github.com/naderyb/stars-house-club/blob/main/src/app/api/admin/tabs/route.ts): `src/app/api/admin/tabs/route.ts`
- [Team management](https://github.com/naderyb/stars-house-club/blob/main/src/components/admin/TeamManager.tsx): `src/components/admin/TeamManager.tsx`
- [Operations statistics](https://github.com/naderyb/stars-house-club/blob/main/src/lib/admin/stats.ts): `src/lib/admin/stats.ts`
- [Admin APIs](https://github.com/naderyb/stars-house-club/tree/main/src/app/api/admin): `src/app/api/admin`
- [Admin request helper](https://github.com/naderyb/stars-house-club/blob/main/src/components/admin/useAdminCall.ts): `src/components/admin/useAdminCall.ts`

### Shared services

- [Admin authentication](https://github.com/naderyb/stars-house-club/blob/main/src/lib/admin/auth.ts): `src/lib/admin/auth.ts`
- [Session and guards](https://github.com/naderyb/stars-house-club/blob/main/src/lib/admin/session.ts): `src/lib/admin/session.ts`
- [Role permissions](https://github.com/naderyb/stars-house-club/blob/main/src/lib/admin/roles.ts): `src/lib/admin/roles.ts`
- [Application validation](https://github.com/naderyb/stars-house-club/blob/main/src/lib/join/schema.ts): `src/lib/join/schema.ts`
- [Request throttling](https://github.com/naderyb/stars-house-club/blob/main/src/lib/rateLimit.ts): `src/lib/rateLimit.ts`
- [Supabase services](https://github.com/naderyb/stars-house-club/blob/main/src/lib/supabase/server.ts): `src/lib/supabase/server.ts`
- [Event definitions](https://github.com/naderyb/stars-house-club/blob/main/src/data/events.ts): `src/data/events.ts`
- [Menu definitions](https://github.com/naderyb/stars-house-club/blob/main/src/data/menu.ts): `src/data/menu.ts`
- [Site settings](https://github.com/naderyb/stars-house-club/blob/main/src/data/site.ts): `src/data/site.ts`

### Other components

- **Visitor**

## Connections

- Visitor → Join form: submits
- Join form → Application intake: posts application (evidence: `src/app/api/join/route.ts`)
- Application intake → Application validation: validates with (evidence: `src/app/api/join/route.ts`)
- Application intake → Request throttling: throttles with (evidence: `src/app/api/join/route.ts`)
- Application intake → Supabase services: stores records (evidence: `src/app/api/join/route.ts`)
- Identity uploads → Application validation: validates with (evidence: `src/app/api/join/id-upload/route.ts`)
- Identity uploads → Request throttling: throttles with (evidence: `src/app/api/join/id-upload/route.ts`)
- Identity uploads → Supabase services: uses storage (evidence: `src/app/api/join/id-upload/route.ts`)
- Application status → Supabase services: reads status (evidence: `src/app/api/status/route.ts`)
- Event feed → Event definitions: reads events (evidence: `src/lib/publicEvents.ts`)
- Event feed → Supabase services: reads events (evidence: `src/lib/publicEvents.ts`)
- Workshop management → Admin request helper: sends actions (evidence: `src/components/WorkshopManager.tsx`)
- Admin request helper → Admin APIs: posts actions (evidence: `src/components/admin/useAdminCall.ts`)
- Team management → Admin APIs: posts team actions (evidence: `src/components/admin/TeamManager.tsx`)
- Admin APIs → Session and guards: checks session (evidence: `src/app/api/admin/tabs/route.ts`)
- Admin APIs → Supabase services: reads and writes (evidence: `src/app/api/admin/tabs/route.ts`)
- Session and guards → Supabase services: loads session (evidence: `src/lib/admin/session.ts`)
- Session and guards → Role permissions: checks access (evidence: `src/lib/admin/session.ts`)
- Admin authentication → Supabase services: checks credentials (evidence: `src/lib/admin/auth.ts`)
- Session and guards → Admin authentication: uses starter identity (evidence: `src/lib/admin/session.ts`)
- Admin APIs → Role permissions: checks permissions (evidence: `src/app/api/admin/tabs/route.ts`)
- Menu management → Menu definitions: formats prices (evidence: `src/components/admin/MenuManager.tsx`)
- Workshop management → Menu definitions: formats prices (evidence: `src/components/WorkshopManager.tsx`)
- Application intake → Site settings: checks join pause (evidence: `src/app/api/join/route.ts`)
