How impulse-event-app/impulse-monorepo works
Impulse is a venue-discovery and group-booking product with a mobile client, a venue-management dashboard, and a FastAPI backend. The user flow is to discover deals, form a solo or shared booking (or vote in a Huddle), collect participant payments, and redeem the booking; venue operators manage deals, bookings, payouts, and merchant onboarding. The backend centralizes booking rules and payment processing. The graph reflects only relationships evidenced by excerpts or the source index; the README is empty, and some dashboard and mobile feature links are therefore not asserted.
Main entry points: main.py FastAPI app · booking_flow.py Booking engine · auth.ts Mobile auth · (user) Mobile screens
Components 22
Mobile app
- Mobile screens
mobile-sdk54/app/(user) - App state
mobile-sdk54/src/theme.tsx - Mobile auth
mobile-sdk54/src/auth.ts - API client
mobile-sdk54/src/api.ts - Supabase client
mobile-sdk54/src/supabase.ts - Deals and plans
mobile-sdk54/src/data.ts - Shared components
mobile-sdk54/src/components.tsx
API and bookings
- FastAPI app
backend/main.py - Booking routes
backend/routers/bookings.py - Booking engine
backend/booking_flow.py - Booking rules
backend/booking_logic.py - Domain routes
backend/routers - Payment webhooks
backend/routers/webhooks.py - Domain models
backend/models.py
Venue operations
- Venue dashboard
venue-web/src/app/dashboard - Merchant onboarding
backend/routers/merchants.py
Auth and payments
- SQL database
backend/database.py - Supabase Auth
- Pinch client
backend/pinch_client.py
Other components
- Customer
- Venue operator
- Pinch Payments
Connections 23
- Customer → Mobile screens: uses
- Mobile screens → App state: reads state
mobile-sdk54/app/(user)/sign-in.tsx - Mobile screens → Shared components: renders
mobile-sdk54/app/(user)/sign-in.tsx - App state → API client: loads bookings
mobile-sdk54/src/theme.tsx - App state → Deals and plans: maps deals
mobile-sdk54/src/theme.tsx - Mobile auth → API client: calls profile API
mobile-sdk54/src/auth.ts - Mobile auth → Supabase client: authenticates
mobile-sdk54/src/auth.ts - API client → Supabase client: uses client
mobile-sdk54/src/api.ts - FastAPI app → Booking routes: registers
backend/main.py - FastAPI app → Domain routes: registers
backend/main.py - FastAPI app → Booking engine: sweeps deadlines
backend/main.py - Booking routes → Booking engine: delegates booking
backend/routers/bookings.py - Booking engine → Booking rules: uses rules
backend/booking_flow.py - Booking engine → Domain models: updates bookings
backend/booking_flow.py - Domain models → SQL database: maps tables
backend/models.py - Domain routes → SQL database: accesses data
backend/routers/webhooks.py - Booking routes → SQL database: loads records
backend/routers/bookings.py - Venue operator → Venue dashboard: manages venue
- FastAPI app → Payment webhooks: registers
backend/main.py - Payment webhooks → Pinch client: queries transfers
backend/routers/webhooks.py - Merchant onboarding → Pinch client: onboards merchant
backend/routers/merchants.py - Pinch client → Pinch Payments: sends requests
backend/pinch_client.py - Mobile auth → Supabase Auth: signs in