How intellectdaksh/bnb26_terminal_maharashtra_round works
Fair Drop is a ticket-drop frontend with participant registration, queueing, time-limited reservation and confirmation, alongside an admin console for operating and monitoring drops. The participant journey is driven by server-reported entry status, with realtime updates and refreshes informing screen routing; API mode selects live or mock behavior. The README also documents bot-defense and FIFO-versus-protected allocation simulation. Those capabilities are represented, but details of unsampled implementations are necessarily limited to documented scope.
Main entry points: index.ts API mode selector · JourneyProvider.tsx Journey state · page.tsx Registration · mock.ts Mock API
Components 28
Participant journey
- Drop discovery
app/(site)/page.tsx - Event catalog
app/(site)/events/page.tsx - Event details
app/(site)/events/[id]/page.tsx - Registration
app/(site)/events/[id]/register/page.tsx - Queue status
app/(site)/events/[id]/queue/page.tsx - Seat reservation
app/(site)/events/[id]/reservation/page.tsx - Confirmation
app/(site)/events/[id]/confirmed/page.tsx - Ticket access
app/(site)/my-tickets/page.tsx
Admin operations
- Drop dashboard
app/admin/page.tsx - Queue operations
app/admin/queue/page.tsx - Reservation oversight
app/admin/reservations/page.tsx - Security controls
app/admin/security/page.tsx - Traffic analytics
app/admin/traffic/page.tsx - Drop settings
app/admin/settings/page.tsx
API and journey runtime
- Journey routing
lib/state/journey.ts - Journey state
lib/state/JourneyProvider.tsx - API contracts
lib/contracts/index.ts - API mode selector
lib/api/index.ts - Live API
lib/api/live.ts - Mock API
lib/api/mock.ts - Mock event catalog
lib/api/catalog.ts - Realtime updates
lib/realtime/index.ts - Allocation simulation
lib/sim/index.ts - Time utilities
lib/time/index.ts
Identity and protection
- Sign-in and roles
lib/auth.ts - Supabase browser client
lib/supabase/client.ts - Bot challenge endpoint
app/api/turnstile/route.ts
Other components
- Participant
Connections 34
- Participant → Drop discovery: browses
README.md - Drop discovery → Event catalog: opens catalog
app/(site)/page.tsx - Event catalog → Event details: opens drop
app/(site)/events/page.tsx - Event details → Registration: starts entry
- Registration → Sign-in and roles: signs in
app/(site)/events/[id]/register/page.tsx - Registration → API mode selector: submits entry
app/(site)/events/[id]/register/page.tsx - Registration → Journey state: sets entry status
app/(site)/events/[id]/register/page.tsx - Journey state → Journey routing: reconciles status
lib/state/JourneyProvider.tsx - Journey state → API mode selector: fetches entry and event
lib/state/JourneyProvider.tsx - Journey state → Realtime updates: subscribes to updates
lib/state/JourneyProvider.tsx - Queue status → Journey state: reads journey
app/(site)/events/[id]/queue/page.tsx - Seat reservation → API mode selector: confirms reservation
app/(site)/events/[id]/reservation/page.tsx - Seat reservation → Journey state: updates entry status
app/(site)/events/[id]/reservation/page.tsx - Confirmation → Journey state: reads journey
app/(site)/events/[id]/confirmed/page.tsx - Ticket access → API mode selector: loads ticket entries
app/(site)/my-tickets/page.tsx - API mode selector → Live API: selects live mode
lib/api/index.ts - API mode selector → Mock API: selects mock mode
lib/api/index.ts - Live API → API contracts: validates payloads
lib/api/live.ts - Mock API → API contracts: uses schemas
lib/api/mock.ts - Mock API → Mock event catalog: loads demo events
lib/api/mock.ts - Mock API → Allocation simulation: simulates allocation
lib/api/mock.ts - Realtime updates → API mode selector: uses API mode
lib/realtime/index.ts - Realtime updates → Live API: uses live transport
lib/realtime/index.ts - Drop dashboard → API mode selector: loads operations data
app/admin/page.tsx - Queue operations → API mode selector: operates queue
app/admin/queue/page.tsx - Queue operations → Allocation simulation: shows allocation model
app/admin/queue/page.tsx - Reservation oversight → API mode selector: loads reservations
app/admin/reservations/page.tsx - Security controls → API mode selector: loads security data
app/admin/security/page.tsx - Traffic analytics → API mode selector: loads traffic data
app/admin/traffic/page.tsx - Drop settings → API mode selector: updates settings
app/admin/settings/page.tsx - Sign-in and roles → Supabase browser client: uses browser auth
lib/auth.ts - Live API → Supabase browser client: gets access token
lib/api/live.ts - Bot challenge endpoint → Participant: supports bot checks
- Seat reservation → Time utilities: uses expiry timing