# cadmotrashboy/nova-tickets architecture

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

- Interactive diagram: https://gitdiagram.com/cadmotrashboy/nova-tickets
- Repository: https://github.com/cadmotrashboy/nova-tickets

## Overview

Nova Tickets is an event-ticketing application with buyer, event-organizer, and gate-check-in workflows. Buyers browse events, select ticket batches, reserve tickets, complete attendee details and Pix payment, then view their tickets; organizers manage events, attendees, and financial settings; gate staff validate tickets with offline support. The UI is routed through App.tsx and uses Supabase for authentication and application data. Relationships are based on the supplied excerpts and SOURCE INDEX; unsampled implementation details are not inferred.

Main entry points: [`src/lib/supabase.ts`](https://github.com/cadmotrashboy/nova-tickets/blob/main/src/lib/supabase.ts) (Supabase Client), [`src/App.tsx`](https://github.com/cadmotrashboy/nova-tickets/blob/main/src/App.tsx) (Route Dispatcher), [`src/pages/DashboardPage.tsx`](https://github.com/cadmotrashboy/nova-tickets/blob/main/src/pages/DashboardPage.tsx) (Organizer Dashboard), [`src/pages/EventDetailsPage.tsx`](https://github.com/cadmotrashboy/nova-tickets/blob/main/src/pages/EventDetailsPage.tsx) (Event Details)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_routing["Application Routing"]
  node_app["Route Dispatcher<br/>[App.tsx]"]
end

subgraph group_buyer["Buyer Experience"]
  node_home["Event Discovery<br/>[HomePage.tsx]"]
  node_event_details["Event Details"]
  node_cart["Cart State<br/>[useCartStore.ts]"]
  node_checkout["Ticket Checkout<br/>[CheckoutPage.tsx]"]
  node_my_tickets["My Tickets<br/>[MyTicketsPage.tsx]"]
  node_navbar["Navigation<br/>[Navbar.tsx]"]
  node_footer["Footer<br/>[Footer.tsx]"]
end

subgraph group_identity["Identity"]
  node_auth_modal["Authentication Dialog<br/>[AuthModal.tsx]"]
  node_auth_context["Session and Profile<br/>[AuthContext.tsx]"]
end

subgraph group_organizer["Organizer Tools"]
  node_dashboard["Organizer Dashboard<br/>[DashboardPage.tsx]"]
  node_onboarding["Producer Onboarding"]
  node_event_manager["Event and Batch Management<br/>[EventManager.tsx]"]
  node_overview["Sales Overview"]
  node_attendees["Attendees and Check-in"]
  node_financial["Financial Settings"]
end

subgraph group_platform["Data and Gate Operations"]
  node_gate["Gate Check-in"]
  node_local_gate_db[("Offline Gate Store<br/>[portariaDb.ts]")]
  node_gate_audio["Gate Audio Feedback<br/>[portariaAudio.ts]"]
  node_supabase_client["Supabase Client<br/>[supabase.ts]"]
  node_supabase_service[("Supabase")]
  node_data_types["Database Types<br/>[database.ts]"]
  node_formatters["Formatting Utilities<br/>[formatters.ts]"]
end

node_buyer(("Buyer"))
node_organizer_user(("Organizer"))
node_gate_staff(("Gate Staff"))

node_buyer -->|"opens routes"| node_app
node_organizer_user -->|"opens dashboard"| node_app
node_gate_staff -->|"opens gate"| node_app
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_event_details
node_app -->|"routes to"| node_checkout
node_app -->|"routes to"| node_my_tickets
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_gate
node_home -->|"queries events"| node_supabase_client
node_event_details -->|"loads event"| node_supabase_client
node_event_details -->|"updates quantities"| node_cart
node_event_details -.->|"reserves tickets"| node_checkout
node_checkout -->|"handles order"| node_supabase_client
node_my_tickets -->|"loads tickets"| node_supabase_client
node_navbar -->|"opens dialog"| node_auth_modal
node_auth_modal -->|"uses auth"| node_auth_context
node_auth_context -->|"authenticates user"| node_supabase_client
node_dashboard -->|"renders"| node_onboarding
node_dashboard -->|"renders"| node_event_manager
node_dashboard -->|"renders"| node_overview
node_dashboard -->|"renders"| node_attendees
node_dashboard -->|"renders"| node_financial
node_event_manager -->|"manages events"| node_supabase_client
node_attendees -->|"loads attendees"| node_supabase_client
node_overview -->|"loads metrics"| node_supabase_client
node_financial -->|"loads settings"| node_supabase_client
node_onboarding -->|"saves profile"| node_supabase_client
node_gate -->|"checks offline cache"| node_local_gate_db
node_gate -->|"checks online tickets"| node_supabase_client
node_gate -->|"uses audio feedback"| node_gate_audio
node_supabase_client -->|"connects to"| node_supabase_service
node_local_gate_db -->|"uses types"| node_data_types
node_event_manager -->|"creates slugs"| node_formatters

click node_app "https://github.com/cadmotrashboy/nova-tickets/blob/main/src/App.tsx"
click node_home "https://github.com/cadmotrashboy/nova-tickets/blob/main/src/pages/HomePage.tsx"
click node_event_details "https://github.com/cadmotrashboy/nova-tickets/blob/main/src/pages/EventDetailsPage.tsx"
click node_cart "https://github.com/cadmotrashboy/nova-tickets/blob/main/src/store/useCartStore.ts"
click node_checkout "https://github.com/cadmotrashboy/nova-tickets/blob/main/src/pages/CheckoutPage.tsx"
click node_my_tickets "https://github.com/cadmotrashboy/nova-tickets/blob/main/src/pages/MyTicketsPage.tsx"
click node_navbar "https://github.com/cadmotrashboy/nova-tickets/blob/main/src/components/Navbar.tsx"
click node_footer "https://github.com/cadmotrashboy/nova-tickets/blob/main/src/components/Footer.tsx"
click node_auth_modal "https://github.com/cadmotrashboy/nova-tickets/blob/main/src/components/AuthModal.tsx"
click node_auth_context "https://github.com/cadmotrashboy/nova-tickets/blob/main/src/context/AuthContext.tsx"
click node_dashboard "https://github.com/cadmotrashboy/nova-tickets/blob/main/src/pages/DashboardPage.tsx"
click node_onboarding "https://github.com/cadmotrashboy/nova-tickets/blob/main/src/components/producer/ProducerOnboarding.tsx"
click node_event_manager "https://github.com/cadmotrashboy/nova-tickets/blob/main/src/components/producer/EventManager.tsx"
click node_overview "https://github.com/cadmotrashboy/nova-tickets/blob/main/src/components/producer/DashboardOverview.tsx"
click node_attendees "https://github.com/cadmotrashboy/nova-tickets/blob/main/src/components/producer/AttendeesAndCheckin.tsx"
click node_financial "https://github.com/cadmotrashboy/nova-tickets/blob/main/src/components/producer/FinancialSettings.tsx"
click node_gate "https://github.com/cadmotrashboy/nova-tickets/blob/main/src/pages/GateCheckinPage.tsx"
click node_local_gate_db "https://github.com/cadmotrashboy/nova-tickets/blob/main/src/services/portariaDb.ts"
click node_gate_audio "https://github.com/cadmotrashboy/nova-tickets/blob/main/src/services/portariaAudio.ts"
click node_supabase_client "https://github.com/cadmotrashboy/nova-tickets/blob/main/src/lib/supabase.ts"
click node_data_types "https://github.com/cadmotrashboy/nova-tickets/blob/main/src/types/database.ts"
click node_formatters "https://github.com/cadmotrashboy/nova-tickets/blob/main/src/utils/formatters.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_app toneBlue
class node_home,node_event_details,node_cart,node_checkout,node_my_tickets,node_navbar,node_footer toneAmber
class node_auth_modal,node_auth_context toneMint
class node_dashboard,node_onboarding,node_event_manager,node_overview,node_attendees,node_financial toneRose
class node_gate,node_local_gate_db,node_gate_audio,node_supabase_client,node_supabase_service,node_data_types,node_formatters,node_buyer,node_organizer_user,node_gate_staff toneIndigo
```

## Components

### Application Routing

- [Route Dispatcher](https://github.com/cadmotrashboy/nova-tickets/blob/main/src/App.tsx): `src/App.tsx`

### Buyer Experience

- [Event Discovery](https://github.com/cadmotrashboy/nova-tickets/blob/main/src/pages/HomePage.tsx): `src/pages/HomePage.tsx`
- [Event Details](https://github.com/cadmotrashboy/nova-tickets/blob/main/src/pages/EventDetailsPage.tsx): `src/pages/EventDetailsPage.tsx`
- [Cart State](https://github.com/cadmotrashboy/nova-tickets/blob/main/src/store/useCartStore.ts): `src/store/useCartStore.ts`
- [Ticket Checkout](https://github.com/cadmotrashboy/nova-tickets/blob/main/src/pages/CheckoutPage.tsx): `src/pages/CheckoutPage.tsx`
- [My Tickets](https://github.com/cadmotrashboy/nova-tickets/blob/main/src/pages/MyTicketsPage.tsx): `src/pages/MyTicketsPage.tsx`
- [Navigation](https://github.com/cadmotrashboy/nova-tickets/blob/main/src/components/Navbar.tsx): `src/components/Navbar.tsx`
- [Footer](https://github.com/cadmotrashboy/nova-tickets/blob/main/src/components/Footer.tsx): `src/components/Footer.tsx`

### Identity

- [Authentication Dialog](https://github.com/cadmotrashboy/nova-tickets/blob/main/src/components/AuthModal.tsx): `src/components/AuthModal.tsx`
- [Session and Profile](https://github.com/cadmotrashboy/nova-tickets/blob/main/src/context/AuthContext.tsx): `src/context/AuthContext.tsx`

### Organizer Tools

- [Organizer Dashboard](https://github.com/cadmotrashboy/nova-tickets/blob/main/src/pages/DashboardPage.tsx): `src/pages/DashboardPage.tsx`
- [Producer Onboarding](https://github.com/cadmotrashboy/nova-tickets/blob/main/src/components/producer/ProducerOnboarding.tsx): `src/components/producer/ProducerOnboarding.tsx`
- [Event and Batch Management](https://github.com/cadmotrashboy/nova-tickets/blob/main/src/components/producer/EventManager.tsx): `src/components/producer/EventManager.tsx`
- [Sales Overview](https://github.com/cadmotrashboy/nova-tickets/blob/main/src/components/producer/DashboardOverview.tsx): `src/components/producer/DashboardOverview.tsx`
- [Attendees and Check-in](https://github.com/cadmotrashboy/nova-tickets/blob/main/src/components/producer/AttendeesAndCheckin.tsx): `src/components/producer/AttendeesAndCheckin.tsx`
- [Financial Settings](https://github.com/cadmotrashboy/nova-tickets/blob/main/src/components/producer/FinancialSettings.tsx): `src/components/producer/FinancialSettings.tsx`

### Data and Gate Operations

- [Gate Check-in](https://github.com/cadmotrashboy/nova-tickets/blob/main/src/pages/GateCheckinPage.tsx): `src/pages/GateCheckinPage.tsx`
- [Offline Gate Store](https://github.com/cadmotrashboy/nova-tickets/blob/main/src/services/portariaDb.ts): `src/services/portariaDb.ts`
- [Gate Audio Feedback](https://github.com/cadmotrashboy/nova-tickets/blob/main/src/services/portariaAudio.ts): `src/services/portariaAudio.ts`
- [Supabase Client](https://github.com/cadmotrashboy/nova-tickets/blob/main/src/lib/supabase.ts): `src/lib/supabase.ts`
- **Supabase**
- [Database Types](https://github.com/cadmotrashboy/nova-tickets/blob/main/src/types/database.ts): `src/types/database.ts`
- [Formatting Utilities](https://github.com/cadmotrashboy/nova-tickets/blob/main/src/utils/formatters.ts): `src/utils/formatters.ts`

### Other components

- **Buyer**
- **Organizer**
- **Gate Staff**

## Connections

- Buyer → Route Dispatcher: opens routes (evidence: `src/App.tsx`)
- Organizer → Route Dispatcher: opens dashboard (evidence: `src/App.tsx`)
- Gate Staff → Route Dispatcher: opens gate (evidence: `src/App.tsx`)
- Route Dispatcher → Event Discovery: routes to (evidence: `src/App.tsx`)
- Route Dispatcher → Event Details: routes to (evidence: `src/App.tsx`)
- Route Dispatcher → Ticket Checkout: routes to (evidence: `src/App.tsx`)
- Route Dispatcher → My Tickets: routes to (evidence: `src/App.tsx`)
- Route Dispatcher → Organizer Dashboard: routes to (evidence: `src/App.tsx`)
- Route Dispatcher → Gate Check-in: routes to (evidence: `src/App.tsx`)
- Event Discovery → Supabase Client: queries events (evidence: `src/pages/HomePage.tsx`)
- Event Details → Supabase Client: loads event (evidence: `src/pages/EventDetailsPage.tsx`)
- Event Details → Cart State: updates quantities (evidence: `src/pages/EventDetailsPage.tsx`)
- Event Details → Ticket Checkout: reserves tickets
- Ticket Checkout → Supabase Client: handles order (evidence: `src/pages/CheckoutPage.tsx`)
- My Tickets → Supabase Client: loads tickets (evidence: `src/pages/MyTicketsPage.tsx`)
- Navigation → Authentication Dialog: opens dialog (evidence: `src/components/Navbar.tsx`)
- Authentication Dialog → Session and Profile: uses auth (evidence: `src/components/AuthModal.tsx`)
- Session and Profile → Supabase Client: authenticates user (evidence: `src/context/AuthContext.tsx`)
- Organizer Dashboard → Producer Onboarding: renders (evidence: `src/pages/DashboardPage.tsx`)
- Organizer Dashboard → Event and Batch Management: renders (evidence: `src/pages/DashboardPage.tsx`)
- Organizer Dashboard → Sales Overview: renders (evidence: `src/pages/DashboardPage.tsx`)
- Organizer Dashboard → Attendees and Check-in: renders (evidence: `src/pages/DashboardPage.tsx`)
- Organizer Dashboard → Financial Settings: renders (evidence: `src/pages/DashboardPage.tsx`)
- Event and Batch Management → Supabase Client: manages events (evidence: `src/components/producer/EventManager.tsx`)
- Attendees and Check-in → Supabase Client: loads attendees (evidence: `src/components/producer/AttendeesAndCheckin.tsx`)
- Sales Overview → Supabase Client: loads metrics (evidence: `src/components/producer/DashboardOverview.tsx`)
- Financial Settings → Supabase Client: loads settings (evidence: `src/components/producer/FinancialSettings.tsx`)
- Producer Onboarding → Supabase Client: saves profile (evidence: `src/components/producer/ProducerOnboarding.tsx`)
- Gate Check-in → Offline Gate Store: checks offline cache (evidence: `src/pages/GateCheckinPage.tsx`)
- Gate Check-in → Supabase Client: checks online tickets (evidence: `src/pages/GateCheckinPage.tsx`)
- Gate Check-in → Gate Audio Feedback: uses audio feedback (evidence: `src/pages/GateCheckinPage.tsx`)
- Supabase Client → Supabase: connects to (evidence: `src/lib/supabase.ts`)
- Offline Gate Store → Database Types: uses types (evidence: `src/services/portariaDb.ts`)
- Event and Batch Management → Formatting Utilities: creates slugs (evidence: `src/components/producer/EventManager.tsx`)
