# sambit-d-swain07/champclub architecture

> Architecture diagram of the GitHub repository sambit-d-swain07/champclub, 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/sambit-d-swain07/champclub
- Repository: https://github.com/sambit-d-swain07/champclub

## Overview

Champions Club is a sports-club management system for court reservations, memberships, retail, bar service, and financial oversight. The main customer journey runs from public discovery or trial signup into booking and member services; staff handle sales and orders, while owners review financial and operational summaries. The graph includes the documented kitchen, entitlement, and ledger capabilities. Edges are limited to README statements and shown import/call evidence; unsampled subsystems are represented only at paths present in the tree.

Main entry points: [`src/lib/services/booking.ts`](https://github.com/sambit-d-swain07/champclub/blob/main/src/lib/services/booking.ts) (Court booking engine), [`src/lib/services/finance.ts`](https://github.com/sambit-d-swain07/champclub/blob/main/src/lib/services/finance.ts) (Financial ledger & reports), [`src/lib/prisma.ts`](https://github.com/sambit-d-swain07/champclub/blob/main/src/lib/prisma.ts) (PostgreSQL club data), [`src/lib/services/shop.ts`](https://github.com/sambit-d-swain07/champclub/blob/main/src/lib/services/shop.ts) (Shop inventory)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_customer["Customer Experience"]
  node_public["Public club site<br/>[page.tsx]"]
  node_trial["Trial signup<br/>[page.tsx]"]
  node_member["Member portal"]
  node_bookingui["Booking interface"]
end

subgraph group_operations["Club Operations"]
  node_bookingactions["Booking actions<br/>[bookings.ts]"]
  node_bookingservice["Court booking engine<br/>[booking.ts]"]
  node_entitlement["Member entitlements<br/>[entitlement.ts]"]
  node_availability["Availability API<br/>[route.ts]"]
  node_shopui["Shop sales<br/>[member-shop.tsx]"]
  node_shopactions["Shop actions<br/>[shop.ts]"]
  node_shopservice["Shop inventory<br/>[shop.ts]"]
  node_barui["Bar service<br/>[staff-bar.tsx]"]
  node_baractions["Bar actions<br/>[bar.ts]"]
  node_barservice["Bar operations<br/>[bar.ts]"]
  node_kitchen["Kitchen order board<br/>[kitchen-board.tsx]"]
end

subgraph group_governance["Management &amp; Finance"]
  node_admin["Staff administration"]
  node_dashboard["Executive dashboard<br/>[page.tsx]"]
  node_finance["Financial ledger &amp; reports<br/>[finance.ts]"]
  node_leads["Lead management"]
end

subgraph group_platform["Identity &amp; Data"]
  node_authroute["Authentication endpoint<br/>[route.ts]"]
  node_auth["Authentication service<br/>[auth.ts]"]
  node_session["Session resolver<br/>[session.ts]"]
  node_database[("PostgreSQL club data<br/>[prisma.ts]")]
end

node_visitor(("Visitor or member"))

node_visitor -->|"browses"| node_public
node_public -->|"reads availability"| node_bookingservice
node_visitor -->|"requests trial"| node_trial
node_visitor -.->|"uses portal"| node_member
node_member -.->|"opens booking"| node_bookingui
node_bookingui -->|"submits booking"| node_bookingactions
node_bookingactions -->|"calls"| node_bookingservice
node_availability -->|"reads slots"| node_bookingservice
node_bookingservice -->|"resolves discounts"| node_entitlement
node_bookingservice -->|"reads and writes"| node_database
node_shopui -->|"submits sales"| node_shopactions
node_shopactions -->|"calls"| node_shopservice
node_shopservice -->|"controls inventory"| node_database
node_barui -->|"submits orders"| node_baractions
node_baractions -->|"calls"| node_barservice
node_kitchen -.->|"tracks order states"| node_barservice
node_visitor -->|"signs in"| node_authroute
node_authroute -->|"dispatches to"| node_auth
node_auth -->|"persists identity"| node_database
node_session -->|"gets session"| node_auth
node_admin -.->|"checks access"| node_session
node_dashboard -.->|"summarizes metrics"| node_finance
node_admin -.->|"manages leads"| node_leads
node_finance -->|"reads ledger"| node_database
node_bookingservice -.->|"records transactions"| node_finance
node_shopservice -.->|"records transactions"| node_finance
node_barservice -.->|"records transactions"| node_finance

click node_public "https://github.com/sambit-d-swain07/champclub/blob/main/src/app/page.tsx"
click node_trial "https://github.com/sambit-d-swain07/champclub/blob/main/src/app/(public)/trial/page.tsx"
click node_member "https://github.com/sambit-d-swain07/champclub/tree/main/src/app/member"
click node_bookingui "https://github.com/sambit-d-swain07/champclub/blob/main/src/components/member/member-court-booking.tsx"
click node_bookingactions "https://github.com/sambit-d-swain07/champclub/blob/main/src/app/actions/bookings.ts"
click node_bookingservice "https://github.com/sambit-d-swain07/champclub/blob/main/src/lib/services/booking.ts"
click node_entitlement "https://github.com/sambit-d-swain07/champclub/blob/main/src/lib/services/entitlement.ts"
click node_availability "https://github.com/sambit-d-swain07/champclub/blob/main/src/app/api/courts/availability/route.ts"
click node_shopui "https://github.com/sambit-d-swain07/champclub/blob/main/src/components/shop/member-shop.tsx"
click node_shopactions "https://github.com/sambit-d-swain07/champclub/blob/main/src/app/actions/shop.ts"
click node_shopservice "https://github.com/sambit-d-swain07/champclub/blob/main/src/lib/services/shop.ts"
click node_barui "https://github.com/sambit-d-swain07/champclub/blob/main/src/components/bar/staff-bar.tsx"
click node_baractions "https://github.com/sambit-d-swain07/champclub/blob/main/src/app/actions/bar.ts"
click node_barservice "https://github.com/sambit-d-swain07/champclub/blob/main/src/lib/services/bar.ts"
click node_kitchen "https://github.com/sambit-d-swain07/champclub/blob/main/src/components/bar/kitchen-board.tsx"
click node_admin "https://github.com/sambit-d-swain07/champclub/tree/main/src/app/admin"
click node_dashboard "https://github.com/sambit-d-swain07/champclub/blob/main/src/app/admin/page.tsx"
click node_finance "https://github.com/sambit-d-swain07/champclub/blob/main/src/lib/services/finance.ts"
click node_leads "https://github.com/sambit-d-swain07/champclub/tree/main/src/app/admin/leads"
click node_authroute "https://github.com/sambit-d-swain07/champclub/blob/main/src/app/api/auth/%5B...all%5D/route.ts"
click node_auth "https://github.com/sambit-d-swain07/champclub/blob/main/src/lib/auth.ts"
click node_session "https://github.com/sambit-d-swain07/champclub/blob/main/src/lib/session.ts"
click node_database "https://github.com/sambit-d-swain07/champclub/blob/main/src/lib/prisma.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_public,node_trial,node_member,node_bookingui toneBlue
class node_bookingactions,node_bookingservice,node_entitlement,node_availability,node_shopui,node_shopactions,node_shopservice,node_barui,node_baractions,node_barservice,node_kitchen toneAmber
class node_admin,node_dashboard,node_finance,node_leads toneMint
class node_authroute,node_auth,node_session,node_database toneRose
class node_visitor toneIndigo
```

## Components

### Customer Experience

- [Public club site](https://github.com/sambit-d-swain07/champclub/blob/main/src/app/page.tsx): `src/app/page.tsx`
- [Trial signup](https://github.com/sambit-d-swain07/champclub/blob/main/src/app/(public)/trial/page.tsx): `src/app/(public)/trial/page.tsx`
- [Member portal](https://github.com/sambit-d-swain07/champclub/tree/main/src/app/member): `src/app/member`
- [Booking interface](https://github.com/sambit-d-swain07/champclub/blob/main/src/components/member/member-court-booking.tsx): `src/components/member/member-court-booking.tsx`

### Club Operations

- [Booking actions](https://github.com/sambit-d-swain07/champclub/blob/main/src/app/actions/bookings.ts): `src/app/actions/bookings.ts`
- [Court booking engine](https://github.com/sambit-d-swain07/champclub/blob/main/src/lib/services/booking.ts): `src/lib/services/booking.ts`
- [Member entitlements](https://github.com/sambit-d-swain07/champclub/blob/main/src/lib/services/entitlement.ts): `src/lib/services/entitlement.ts`
- [Availability API](https://github.com/sambit-d-swain07/champclub/blob/main/src/app/api/courts/availability/route.ts): `src/app/api/courts/availability/route.ts`
- [Shop sales](https://github.com/sambit-d-swain07/champclub/blob/main/src/components/shop/member-shop.tsx): `src/components/shop/member-shop.tsx`
- [Shop actions](https://github.com/sambit-d-swain07/champclub/blob/main/src/app/actions/shop.ts): `src/app/actions/shop.ts`
- [Shop inventory](https://github.com/sambit-d-swain07/champclub/blob/main/src/lib/services/shop.ts): `src/lib/services/shop.ts`
- [Bar service](https://github.com/sambit-d-swain07/champclub/blob/main/src/components/bar/staff-bar.tsx): `src/components/bar/staff-bar.tsx`
- [Bar actions](https://github.com/sambit-d-swain07/champclub/blob/main/src/app/actions/bar.ts): `src/app/actions/bar.ts`
- [Bar operations](https://github.com/sambit-d-swain07/champclub/blob/main/src/lib/services/bar.ts): `src/lib/services/bar.ts`
- [Kitchen order board](https://github.com/sambit-d-swain07/champclub/blob/main/src/components/bar/kitchen-board.tsx): `src/components/bar/kitchen-board.tsx`

### Management & Finance

- [Staff administration](https://github.com/sambit-d-swain07/champclub/tree/main/src/app/admin): `src/app/admin`
- [Executive dashboard](https://github.com/sambit-d-swain07/champclub/blob/main/src/app/admin/page.tsx): `src/app/admin/page.tsx`
- [Financial ledger & reports](https://github.com/sambit-d-swain07/champclub/blob/main/src/lib/services/finance.ts): `src/lib/services/finance.ts`
- [Lead management](https://github.com/sambit-d-swain07/champclub/tree/main/src/app/admin/leads): `src/app/admin/leads`

### Identity & Data

- [Authentication endpoint](https://github.com/sambit-d-swain07/champclub/blob/main/src/app/api/auth/%5B...all%5D/route.ts): `src/app/api/auth/[...all]/route.ts`
- [Authentication service](https://github.com/sambit-d-swain07/champclub/blob/main/src/lib/auth.ts): `src/lib/auth.ts`
- [Session resolver](https://github.com/sambit-d-swain07/champclub/blob/main/src/lib/session.ts): `src/lib/session.ts`
- [PostgreSQL club data](https://github.com/sambit-d-swain07/champclub/blob/main/src/lib/prisma.ts): `src/lib/prisma.ts`

### Other components

- **Visitor or member**

## Connections

- Visitor or member → Public club site: browses (evidence: `src/app/page.tsx`)
- Public club site → Court booking engine: reads availability (evidence: `src/app/page.tsx`)
- Visitor or member → Trial signup: requests trial (evidence: `README.md`)
- Visitor or member → Member portal: uses portal (evidence: `README.md`)
- Member portal → Booking interface: opens booking
- Booking interface → Booking actions: submits booking
- Booking actions → Court booking engine: calls (evidence: `src/app/actions/bookings.ts`)
- Availability API → Court booking engine: reads slots (evidence: `src/app/api/courts/availability/route.ts`)
- Court booking engine → Member entitlements: resolves discounts (evidence: `src/lib/services/booking.ts`)
- Court booking engine → PostgreSQL club data: reads and writes (evidence: `src/lib/services/booking.ts`)
- Shop sales → Shop actions: submits sales
- Shop actions → Shop inventory: calls (evidence: `src/app/actions/shop.ts`)
- Shop inventory → PostgreSQL club data: controls inventory (evidence: `README.md`)
- Bar service → Bar actions: submits orders (evidence: `src/components/bar/staff-bar.tsx`)
- Bar actions → Bar operations: calls (evidence: `src/app/actions/bar.ts`)
- Kitchen order board → Bar operations: tracks order states (evidence: `README.md`)
- Visitor or member → Authentication endpoint: signs in (evidence: `src/app/api/auth/[...all]/route.ts`)
- Authentication endpoint → Authentication service: dispatches to (evidence: `src/app/api/auth/[...all]/route.ts`)
- Authentication service → PostgreSQL club data: persists identity (evidence: `src/lib/auth.ts`)
- Session resolver → Authentication service: gets session (evidence: `src/lib/session.ts`)
- Staff administration → Session resolver: checks access (evidence: `src/app/admin/page.tsx`)
- Executive dashboard → Financial ledger & reports: summarizes metrics (evidence: `README.md`)
- Staff administration → Lead management: manages leads (evidence: `README.md`)
- Financial ledger & reports → PostgreSQL club data: reads ledger (evidence: `src/lib/services/finance.ts`)
- Court booking engine → Financial ledger & reports: records transactions (evidence: `README.md`)
- Shop inventory → Financial ledger & reports: records transactions (evidence: `README.md`)
- Bar operations → Financial ledger & reports: records transactions (evidence: `README.md`)
