# rohini258/spott architecture

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

- Interactive diagram: https://gitdiagram.com/rohini258/spott
- Repository: https://github.com/rohini258/spott

## Overview

Spot is an event-discovery and management application. Attendees browse events, inspect details, register, and access tickets; organizers create events and manage attendance, including QR check-in. Convex provides the application data/functions, while client hooks wrap its queries and mutations. The graph also retains the documented-by-tree exploration, search, onboarding, AI-assisted creation, and seed-data branches. Several backend and page implementations are unsampled, so their relationships are included only where excerpts or the source index show them.

Main entry points: [`spot/app/(main)/my-events/[eventId]/page.jsx`](https://github.com/rohini258/spott/blob/landing-page/spot/app/(main)/my-events/%5BeventId%5D/page.jsx) (Event dashboard), [`spot/app/(main)/create-event/page.jsx`](https://github.com/rohini258/spott/blob/landing-page/spot/app/(main)/create-event/page.jsx) (Create event), [`spot/app/(public)/events/[slug]/page.jsx`](https://github.com/rohini258/spott/blob/landing-page/spot/app/(public)/events/%5Bslug%5D/page.jsx) (Event details), [`spot/hooks/use-onboarding.jsx`](https://github.com/rohini258/spott/blob/landing-page/spot/hooks/use-onboarding.jsx) (Onboarding state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_attendee["Attendee discovery"]
  node_explore["Explore events<br/>[page.jsx]"]
  node_event_card["Event cards<br/>[event-card.jsx]"]
  node_explore_detail["Explore detail<br/>[page.jsx]"]
  node_event_detail["Event details<br/>[page.jsx]"]
  node_registration["Registration flow<br/>[register-modal.jsx]"]
  node_tickets["My tickets<br/>[page.jsx]"]
  node_onboarding["Onboarding"]
end

subgraph group_organizer["Organizer tools"]
  node_create_page["Create event<br/>[page.jsx]"]
  node_ai_creator["AI event creator"]
  node_generate_api["Event generation API<br/>[route.js]"]
  node_my_events["Organizer events<br/>[page.jsx]"]
  node_dashboard["Event dashboard<br/>[page.jsx]"]
  node_attendee_card["Attendee record<br/>[attendee-card.jsx]"]
  node_qr_scanner["QR check-in"]
end

subgraph group_platform["Application platform"]
  node_onboarding_hook["Onboarding state<br/>[use-onboarding.jsx]"]
  node_query_hook["Convex query hooks"]
  node_store_user["User sync<br/>[use-store-user.js]"]
  node_client_provider["Convex client"]
end

subgraph group_data["Convex data"]
  node_search["Event search<br/>[search.js]"]
  node_events_api["Event functions<br/>[events.js]"]
  node_explore_api["Explore functions<br/>[explore.js]"]
  node_registrations_api["Registration functions<br/>[registrations.js]"]
  node_dashboard_api["Dashboard functions<br/>[dashboard.js]"]
  node_users_api["User functions<br/>[users.js]"]
  node_schema[("Data schema<br/>[schema.js]")]
  node_seed["Sample event seeding<br/>[seed.js]"]
end

node_attendee(("Attendee"))
node_organizer(("Organizer"))

node_attendee -->|"browses"| node_explore
node_explore -.->|"searches"| node_search
node_explore -.->|"renders"| node_event_card
node_attendee -->|"opens event"| node_event_detail
node_event_detail -->|"queries event"| node_events_api
node_event_detail -->|"checks registration"| node_registrations_api
node_event_detail -->|"opens modal"| node_registration
node_attendee -.->|"views tickets"| node_tickets
node_attendee -.->|"starts onboarding"| node_onboarding_hook
node_onboarding_hook -->|"queries user"| node_query_hook
node_onboarding_hook -->|"reads user"| node_users_api
node_onboarding_hook -.->|"shows"| node_onboarding
node_organizer -->|"creates event"| node_create_page
node_create_page -->|"renders"| node_ai_creator
node_ai_creator -.->|"requests generation"| node_generate_api
node_create_page -->|"uses mutations"| node_query_hook
node_create_page -->|"queries user"| node_users_api
node_create_page -->|"creates event"| node_events_api
node_organizer -.->|"manages events"| node_my_events
node_my_events -.->|"opens event"| node_dashboard
node_dashboard -->|"uses queries"| node_query_hook
node_dashboard -->|"loads attendees"| node_registrations_api
node_dashboard -->|"deletes event"| node_dashboard_api
node_dashboard -->|"renders"| node_attendee_card
node_dashboard -.->|"opens scanner"| node_qr_scanner
node_store_user -->|"stores user"| node_users_api
node_client_provider -.->|"provides client"| node_query_hook
node_search -->|"queries events"| node_schema
node_seed -->|"writes records"| node_schema

click node_explore "https://github.com/rohini258/spott/blob/landing-page/spot/app/(public)/explore/page.jsx"
click node_search "https://github.com/rohini258/spott/blob/landing-page/spot/convex/search.js"
click node_event_card "https://github.com/rohini258/spott/blob/landing-page/spot/components/event-card.jsx"
click node_explore_detail "https://github.com/rohini258/spott/blob/landing-page/spot/app/(public)/explore/%5Bslug%5D/page.jsx"
click node_event_detail "https://github.com/rohini258/spott/blob/landing-page/spot/app/(public)/events/%5Bslug%5D/page.jsx"
click node_registration "https://github.com/rohini258/spott/blob/landing-page/spot/app/(public)/events/%5Bslug%5D/components/register-modal.jsx"
click node_tickets "https://github.com/rohini258/spott/blob/landing-page/spot/app/(main)/my-tickets/page.jsx"
click node_onboarding "https://github.com/rohini258/spott/blob/landing-page/spot/components/onboarding-modal.jsx"
click node_onboarding_hook "https://github.com/rohini258/spott/blob/landing-page/spot/hooks/use-onboarding.jsx"
click node_create_page "https://github.com/rohini258/spott/blob/landing-page/spot/app/(main)/create-event/page.jsx"
click node_ai_creator "https://github.com/rohini258/spott/blob/landing-page/spot/app/(main)/create-event/_components/ai-event-creator.jsx"
click node_generate_api "https://github.com/rohini258/spott/blob/landing-page/spot/app/api/generate-event/route.js"
click node_my_events "https://github.com/rohini258/spott/blob/landing-page/spot/app/(main)/my-events/page.jsx"
click node_dashboard "https://github.com/rohini258/spott/blob/landing-page/spot/app/(main)/my-events/%5BeventId%5D/page.jsx"
click node_attendee_card "https://github.com/rohini258/spott/blob/landing-page/spot/app/(main)/my-events/%5BeventId%5D/_components/attendee-card.jsx"
click node_qr_scanner "https://github.com/rohini258/spott/blob/landing-page/spot/app/(main)/my-events/%5BeventId%5D/_components/qr-scanner-modal.jsx"
click node_query_hook "https://github.com/rohini258/spott/blob/landing-page/spot/hooks/use-convex-query.js"
click node_store_user "https://github.com/rohini258/spott/blob/landing-page/spot/hooks/use-store-user.js"
click node_client_provider "https://github.com/rohini258/spott/blob/landing-page/spot/app/ConvexClientProvider.jsx"
click node_events_api "https://github.com/rohini258/spott/blob/landing-page/spot/convex/events.js"
click node_explore_api "https://github.com/rohini258/spott/blob/landing-page/spot/convex/explore.js"
click node_registrations_api "https://github.com/rohini258/spott/blob/landing-page/spot/convex/registrations.js"
click node_dashboard_api "https://github.com/rohini258/spott/blob/landing-page/spot/convex/dashboard.js"
click node_users_api "https://github.com/rohini258/spott/blob/landing-page/spot/convex/users.js"
click node_schema "https://github.com/rohini258/spott/blob/landing-page/spot/convex/schema.js"
click node_seed "https://github.com/rohini258/spott/blob/landing-page/spot/convex/seed.js"

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_explore,node_event_card,node_explore_detail,node_event_detail,node_registration,node_tickets,node_onboarding toneBlue
class node_create_page,node_ai_creator,node_generate_api,node_my_events,node_dashboard,node_attendee_card,node_qr_scanner toneAmber
class node_onboarding_hook,node_query_hook,node_store_user,node_client_provider toneMint
class node_search,node_events_api,node_explore_api,node_registrations_api,node_dashboard_api,node_users_api,node_schema,node_seed toneRose
class node_attendee,node_organizer toneIndigo
```

## Components

### Attendee discovery

- [Explore events](https://github.com/rohini258/spott/blob/landing-page/spot/app/(public)/explore/page.jsx): `spot/app/(public)/explore/page.jsx`
- [Event cards](https://github.com/rohini258/spott/blob/landing-page/spot/components/event-card.jsx): `spot/components/event-card.jsx`
- [Explore detail](https://github.com/rohini258/spott/blob/landing-page/spot/app/(public)/explore/%5Bslug%5D/page.jsx): `spot/app/(public)/explore/[slug]/page.jsx`
- [Event details](https://github.com/rohini258/spott/blob/landing-page/spot/app/(public)/events/%5Bslug%5D/page.jsx): `spot/app/(public)/events/[slug]/page.jsx`
- [Registration flow](https://github.com/rohini258/spott/blob/landing-page/spot/app/(public)/events/%5Bslug%5D/components/register-modal.jsx): `spot/app/(public)/events/[slug]/components/register-modal.jsx`
- [My tickets](https://github.com/rohini258/spott/blob/landing-page/spot/app/(main)/my-tickets/page.jsx): `spot/app/(main)/my-tickets/page.jsx`
- [Onboarding](https://github.com/rohini258/spott/blob/landing-page/spot/components/onboarding-modal.jsx): `spot/components/onboarding-modal.jsx`

### Organizer tools

- [Create event](https://github.com/rohini258/spott/blob/landing-page/spot/app/(main)/create-event/page.jsx): `spot/app/(main)/create-event/page.jsx`
- [AI event creator](https://github.com/rohini258/spott/blob/landing-page/spot/app/(main)/create-event/_components/ai-event-creator.jsx): `spot/app/(main)/create-event/_components/ai-event-creator.jsx`
- [Event generation API](https://github.com/rohini258/spott/blob/landing-page/spot/app/api/generate-event/route.js): `spot/app/api/generate-event/route.js`
- [Organizer events](https://github.com/rohini258/spott/blob/landing-page/spot/app/(main)/my-events/page.jsx): `spot/app/(main)/my-events/page.jsx`
- [Event dashboard](https://github.com/rohini258/spott/blob/landing-page/spot/app/(main)/my-events/%5BeventId%5D/page.jsx): `spot/app/(main)/my-events/[eventId]/page.jsx`
- [Attendee record](https://github.com/rohini258/spott/blob/landing-page/spot/app/(main)/my-events/%5BeventId%5D/_components/attendee-card.jsx): `spot/app/(main)/my-events/[eventId]/_components/attendee-card.jsx`
- [QR check-in](https://github.com/rohini258/spott/blob/landing-page/spot/app/(main)/my-events/%5BeventId%5D/_components/qr-scanner-modal.jsx): `spot/app/(main)/my-events/[eventId]/_components/qr-scanner-modal.jsx`

### Application platform

- [Onboarding state](https://github.com/rohini258/spott/blob/landing-page/spot/hooks/use-onboarding.jsx): `spot/hooks/use-onboarding.jsx`
- [Convex query hooks](https://github.com/rohini258/spott/blob/landing-page/spot/hooks/use-convex-query.js): `spot/hooks/use-convex-query.js`
- [User sync](https://github.com/rohini258/spott/blob/landing-page/spot/hooks/use-store-user.js): `spot/hooks/use-store-user.js`
- [Convex client](https://github.com/rohini258/spott/blob/landing-page/spot/app/ConvexClientProvider.jsx): `spot/app/ConvexClientProvider.jsx`

### Convex data

- [Event search](https://github.com/rohini258/spott/blob/landing-page/spot/convex/search.js): `spot/convex/search.js`
- [Event functions](https://github.com/rohini258/spott/blob/landing-page/spot/convex/events.js): `spot/convex/events.js`
- [Explore functions](https://github.com/rohini258/spott/blob/landing-page/spot/convex/explore.js): `spot/convex/explore.js`
- [Registration functions](https://github.com/rohini258/spott/blob/landing-page/spot/convex/registrations.js): `spot/convex/registrations.js`
- [Dashboard functions](https://github.com/rohini258/spott/blob/landing-page/spot/convex/dashboard.js): `spot/convex/dashboard.js`
- [User functions](https://github.com/rohini258/spott/blob/landing-page/spot/convex/users.js): `spot/convex/users.js`
- [Data schema](https://github.com/rohini258/spott/blob/landing-page/spot/convex/schema.js): `spot/convex/schema.js`
- [Sample event seeding](https://github.com/rohini258/spott/blob/landing-page/spot/convex/seed.js): `spot/convex/seed.js`

### Other components

- **Attendee**
- **Organizer**

## Connections

- Attendee → Explore events: browses
- Explore events → Event search: searches
- Explore events → Event cards: renders
- Attendee → Event details: opens event
- Event details → Event functions: queries event (evidence: `spot/app/(public)/events/[slug]/page.jsx`)
- Event details → Registration functions: checks registration (evidence: `spot/app/(public)/events/[slug]/page.jsx`)
- Event details → Registration flow: opens modal (evidence: `spot/app/(public)/events/[slug]/page.jsx`)
- Attendee → My tickets: views tickets
- Attendee → Onboarding state: starts onboarding
- Onboarding state → Convex query hooks: queries user (evidence: `spot/hooks/use-onboarding.jsx`)
- Onboarding state → User functions: reads user (evidence: `spot/hooks/use-onboarding.jsx`)
- Onboarding state → Onboarding: shows
- Organizer → Create event: creates event
- Create event → AI event creator: renders (evidence: `spot/app/(main)/create-event/page.jsx`)
- AI event creator → Event generation API: requests generation
- Create event → Convex query hooks: uses mutations (evidence: `spot/app/(main)/create-event/page.jsx`)
- Create event → User functions: queries user (evidence: `spot/app/(main)/create-event/page.jsx`)
- Create event → Event functions: creates event (evidence: `spot/app/(main)/create-event/page.jsx`)
- Organizer → Organizer events: manages events
- Organizer events → Event dashboard: opens event
- Event dashboard → Convex query hooks: uses queries (evidence: `spot/app/(main)/my-events/[eventId]/page.jsx`)
- Event dashboard → Registration functions: loads attendees (evidence: `spot/app/(main)/my-events/[eventId]/page.jsx`)
- Event dashboard → Dashboard functions: deletes event (evidence: `spot/app/(main)/my-events/[eventId]/page.jsx`)
- Event dashboard → Attendee record: renders (evidence: `spot/app/(main)/my-events/[eventId]/page.jsx`)
- Event dashboard → QR check-in: opens scanner (evidence: `spot/app/(main)/my-events/[eventId]/page.jsx`)
- User sync → User functions: stores user (evidence: `spot/hooks/use-store-user.js`)
- Convex client → Convex query hooks: provides client
- Event search → Data schema: queries events (evidence: `spot/convex/search.js`)
- Sample event seeding → Data schema: writes records (evidence: `spot/convex/seed.js`)
