# alexandergdlc/tupichanga architecture

> Architecture diagram of the GitHub repository alexandergdlc/tupichanga, 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/alexandergdlc/tupichanga
- Repository: https://github.com/alexandergdlc/tupichanga

## Overview

This is a Next.js sports-venue booking platform: customers discover venues and courts, book time slots, and manage their reservations; venue owners administer venues, courts, schedules, and bookings. Server actions centralize booking and management mutations, while authentication gates protected workflows. The available excerpts establish several calls, but much of the UI and action implementation is unsampled, so those parts are represented without speculative wiring.

Main entry points: [`src/app/actions.ts`](https://github.com/alexandergdlc/tupichanga/blob/master/src/app/actions.ts) (Server actions), [`src/auth.ts`](https://github.com/alexandergdlc/tupichanga/blob/master/src/auth.ts) (Authentication), [`src/app/admin/page.tsx`](https://github.com/alexandergdlc/tupichanga/blob/master/src/app/admin/page.tsx) (Owner dashboard), [`src/app/my-bookings/page.tsx`](https://github.com/alexandergdlc/tupichanga/blob/master/src/app/my-bookings/page.tsx) (My bookings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Venue discovery"]
  node_search["Venue search<br/>[page.tsx]"]
  node_venue_detail["Venue details<br/>[page.tsx]"]
end

subgraph group_booking["Reservations"]
  node_booking_calendar["Booking calendar"]
  node_my_bookings["My bookings<br/>[page.tsx]"]
  node_bookings_ui["Reservation cards"]
  node_reschedule["Reschedule booking"]
end

subgraph group_owner["Venue operations"]
  node_admin_dashboard["Owner dashboard<br/>[page.tsx]"]
  node_booking_status["Booking status"]
  node_court_filter["Court filter<br/>[CourtFilter.tsx]"]
  node_venue_management["Venue management<br/>[page.tsx]"]
  node_venue_form["Venue form<br/>[VenueForm.tsx]"]
  node_court_creation["Create court"]
  node_court_edit["Edit court<br/>[EditCourtForm.tsx]"]
  node_schedules["Court schedules<br/>[EditCourtForm.tsx]"]
  node_venue_analytics["Venue analytics"]
  node_subscription["Subscription management"]
  node_actions["Server actions<br/>[actions.ts]"]
end

subgraph group_identity["Identity and access"]
  node_login["Login<br/>[LoginForm.tsx]"]
  node_registration["Registration<br/>[RegisterForm.tsx]"]
  node_profile["Profile<br/>[ProfileForm.tsx]"]
  node_auth["Authentication<br/>[auth.ts]"]
  node_auth_config["Access policy<br/>[auth.config.ts]"]
end

node_customer(("Customer"))
node_owner_actor(("Venue owner"))
node_database[("Application database")]

node_venue_detail -->|"renders"| node_booking_calendar
node_my_bookings -->|"renders"| node_bookings_ui
node_my_bookings -->|"expires bookings"| node_actions
node_bookings_ui -->|"opens"| node_reschedule
node_booking_calendar -->|"calls booking actions"| node_actions
node_reschedule -->|"calls reschedule action"| node_actions
node_admin_dashboard -->|"loads bookings"| node_actions
node_admin_dashboard -->|"renders"| node_court_filter
node_admin_dashboard -->|"renders"| node_booking_status
node_booking_status -->|"updates status"| node_actions
node_venue_form -->|"creates venue"| node_actions
node_court_edit -->|"updates court"| node_actions
node_court_edit -->|"saves schedules"| node_actions
node_venue_management -->|"loads venue data"| node_actions
node_venue_analytics -->|"loads statistics"| node_actions
node_subscription -->|"submits payment"| node_actions
node_login -->|"submits credentials"| node_actions
node_registration -->|"registers account"| node_actions
node_profile -->|"updates profile"| node_actions
node_auth -->|"uses configuration"| node_auth_config
node_auth -->|"looks up users"| node_database
node_auth_config -->|"configures sessions"| node_auth
node_actions -->|"checks session"| node_auth
node_actions -->|"reads and writes"| node_database
node_venue_detail -->|"checks session"| node_auth
node_my_bookings -->|"checks session"| node_auth
node_admin_dashboard -->|"checks session"| node_auth
node_customer -.->|"browses venues"| node_search
node_owner_actor -.->|"manages venue"| node_admin_dashboard

click node_search "https://github.com/alexandergdlc/tupichanga/blob/master/src/app/search/page.tsx"
click node_venue_detail "https://github.com/alexandergdlc/tupichanga/blob/master/src/app/venue/%5Bid%5D/page.tsx"
click node_booking_calendar "https://github.com/alexandergdlc/tupichanga/blob/master/src/components/BookingCalendar.tsx"
click node_my_bookings "https://github.com/alexandergdlc/tupichanga/blob/master/src/app/my-bookings/page.tsx"
click node_bookings_ui "https://github.com/alexandergdlc/tupichanga/blob/master/src/components/MyBookingsClient.tsx"
click node_reschedule "https://github.com/alexandergdlc/tupichanga/blob/master/src/components/RescheduleModal.tsx"
click node_admin_dashboard "https://github.com/alexandergdlc/tupichanga/blob/master/src/app/admin/page.tsx"
click node_booking_status "https://github.com/alexandergdlc/tupichanga/blob/master/src/components/BookingStatusManager.tsx"
click node_court_filter "https://github.com/alexandergdlc/tupichanga/blob/master/src/components/CourtFilter.tsx"
click node_venue_management "https://github.com/alexandergdlc/tupichanga/blob/master/src/app/admin/venues/%5Bid%5D/page.tsx"
click node_venue_form "https://github.com/alexandergdlc/tupichanga/blob/master/src/components/VenueForm.tsx"
click node_court_creation "https://github.com/alexandergdlc/tupichanga/blob/master/src/components/CreateCourtForm.tsx"
click node_court_edit "https://github.com/alexandergdlc/tupichanga/blob/master/src/components/EditCourtForm.tsx"
click node_schedules "https://github.com/alexandergdlc/tupichanga/blob/master/src/components/EditCourtForm.tsx"
click node_venue_analytics "https://github.com/alexandergdlc/tupichanga/blob/master/src/components/DashboardCharts.tsx"
click node_subscription "https://github.com/alexandergdlc/tupichanga/blob/master/src/app/admin/subscription/SubscriptionForm.tsx"
click node_actions "https://github.com/alexandergdlc/tupichanga/blob/master/src/app/actions.ts"
click node_login "https://github.com/alexandergdlc/tupichanga/blob/master/src/components/LoginForm.tsx"
click node_registration "https://github.com/alexandergdlc/tupichanga/blob/master/src/components/RegisterForm.tsx"
click node_profile "https://github.com/alexandergdlc/tupichanga/blob/master/src/components/ProfileForm.tsx"
click node_auth "https://github.com/alexandergdlc/tupichanga/blob/master/src/auth.ts"
click node_auth_config "https://github.com/alexandergdlc/tupichanga/blob/master/src/auth.config.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_search,node_venue_detail toneBlue
class node_booking_calendar,node_my_bookings,node_bookings_ui,node_reschedule,node_database toneAmber
class node_admin_dashboard,node_booking_status,node_court_filter,node_venue_management,node_venue_form,node_court_creation,node_court_edit,node_schedules,node_venue_analytics,node_subscription,node_actions toneMint
class node_login,node_registration,node_profile,node_auth,node_auth_config toneRose
class node_customer,node_owner_actor toneIndigo
```

## Components

### Venue discovery

- [Venue search](https://github.com/alexandergdlc/tupichanga/blob/master/src/app/search/page.tsx): `src/app/search/page.tsx`
- [Venue details](https://github.com/alexandergdlc/tupichanga/blob/master/src/app/venue/%5Bid%5D/page.tsx): `src/app/venue/[id]/page.tsx`

### Reservations

- [Booking calendar](https://github.com/alexandergdlc/tupichanga/blob/master/src/components/BookingCalendar.tsx): `src/components/BookingCalendar.tsx`
- [My bookings](https://github.com/alexandergdlc/tupichanga/blob/master/src/app/my-bookings/page.tsx): `src/app/my-bookings/page.tsx`
- [Reservation cards](https://github.com/alexandergdlc/tupichanga/blob/master/src/components/MyBookingsClient.tsx): `src/components/MyBookingsClient.tsx`
- [Reschedule booking](https://github.com/alexandergdlc/tupichanga/blob/master/src/components/RescheduleModal.tsx): `src/components/RescheduleModal.tsx`

### Venue operations

- [Owner dashboard](https://github.com/alexandergdlc/tupichanga/blob/master/src/app/admin/page.tsx): `src/app/admin/page.tsx`
- [Booking status](https://github.com/alexandergdlc/tupichanga/blob/master/src/components/BookingStatusManager.tsx): `src/components/BookingStatusManager.tsx`
- [Court filter](https://github.com/alexandergdlc/tupichanga/blob/master/src/components/CourtFilter.tsx): `src/components/CourtFilter.tsx`
- [Venue management](https://github.com/alexandergdlc/tupichanga/blob/master/src/app/admin/venues/%5Bid%5D/page.tsx): `src/app/admin/venues/[id]/page.tsx`
- [Venue form](https://github.com/alexandergdlc/tupichanga/blob/master/src/components/VenueForm.tsx): `src/components/VenueForm.tsx`
- [Create court](https://github.com/alexandergdlc/tupichanga/blob/master/src/components/CreateCourtForm.tsx): `src/components/CreateCourtForm.tsx`
- [Edit court](https://github.com/alexandergdlc/tupichanga/blob/master/src/components/EditCourtForm.tsx): `src/components/EditCourtForm.tsx`
- [Court schedules](https://github.com/alexandergdlc/tupichanga/blob/master/src/components/EditCourtForm.tsx): `src/components/EditCourtForm.tsx`
- [Venue analytics](https://github.com/alexandergdlc/tupichanga/blob/master/src/components/DashboardCharts.tsx): `src/components/DashboardCharts.tsx`
- [Subscription management](https://github.com/alexandergdlc/tupichanga/blob/master/src/app/admin/subscription/SubscriptionForm.tsx): `src/app/admin/subscription/SubscriptionForm.tsx`
- [Server actions](https://github.com/alexandergdlc/tupichanga/blob/master/src/app/actions.ts): `src/app/actions.ts`

### Identity and access

- [Login](https://github.com/alexandergdlc/tupichanga/blob/master/src/components/LoginForm.tsx): `src/components/LoginForm.tsx`
- [Registration](https://github.com/alexandergdlc/tupichanga/blob/master/src/components/RegisterForm.tsx): `src/components/RegisterForm.tsx`
- [Profile](https://github.com/alexandergdlc/tupichanga/blob/master/src/components/ProfileForm.tsx): `src/components/ProfileForm.tsx`
- [Authentication](https://github.com/alexandergdlc/tupichanga/blob/master/src/auth.ts): `src/auth.ts`
- [Access policy](https://github.com/alexandergdlc/tupichanga/blob/master/src/auth.config.ts): `src/auth.config.ts`

### Other components

- **Customer**
- **Venue owner**
- **Application database**

## Connections

- Venue details → Booking calendar: renders (evidence: `src/app/venue/[id]/page.tsx`)
- My bookings → Reservation cards: renders (evidence: `src/app/my-bookings/page.tsx`)
- My bookings → Server actions: expires bookings (evidence: `src/app/my-bookings/page.tsx`)
- Reservation cards → Reschedule booking: opens (evidence: `src/components/MyBookingsClient.tsx`)
- Booking calendar → Server actions: calls booking actions (evidence: `src/components/BookingCalendar.tsx`)
- Reschedule booking → Server actions: calls reschedule action (evidence: `src/components/RescheduleModal.tsx`)
- Owner dashboard → Server actions: loads bookings (evidence: `src/app/admin/page.tsx`)
- Owner dashboard → Court filter: renders (evidence: `src/app/admin/page.tsx`)
- Owner dashboard → Booking status: renders (evidence: `src/app/admin/page.tsx`)
- Booking status → Server actions: updates status (evidence: `src/components/BookingStatusManager.tsx`)
- Venue form → Server actions: creates venue (evidence: `src/components/VenueForm.tsx`)
- Edit court → Server actions: updates court (evidence: `src/components/EditCourtForm.tsx`)
- Edit court → Server actions: saves schedules (evidence: `src/components/EditCourtForm.tsx`)
- Venue management → Server actions: loads venue data (evidence: `src/app/admin/venues/[id]/page.tsx`)
- Venue analytics → Server actions: loads statistics (evidence: `src/app/admin/venues/[id]/dashboard/page.tsx`)
- Subscription management → Server actions: submits payment (evidence: `src/app/admin/subscription/SubscriptionForm.tsx`)
- Login → Server actions: submits credentials (evidence: `src/components/LoginForm.tsx`)
- Registration → Server actions: registers account (evidence: `src/components/RegisterForm.tsx`)
- Profile → Server actions: updates profile (evidence: `src/components/ProfileForm.tsx`)
- Authentication → Access policy: uses configuration (evidence: `src/auth.ts`)
- Authentication → Application database: looks up users (evidence: `src/auth.ts`)
- Access policy → Authentication: configures sessions (evidence: `src/auth.ts`)
- Server actions → Authentication: checks session (evidence: `src/app/actions.ts`)
- Server actions → Application database: reads and writes (evidence: `src/app/actions.ts`)
- Venue details → Authentication: checks session (evidence: `src/app/venue/[id]/page.tsx`)
- My bookings → Authentication: checks session (evidence: `src/app/my-bookings/page.tsx`)
- Owner dashboard → Authentication: checks session (evidence: `src/app/admin/page.tsx`)
- Customer → Venue search: browses venues
- Venue owner → Owner dashboard: manages venue
