How marcuschew2024/connectsphere works
ConnectSphere is a role-based event lifecycle app: organisers create and revise requests, coordinators review them, and venue staff handle catalogue and booking workflows. The Next.js frontend communicates with a Flask API, which applies identity and role checks, validates domain actions, and persists records in Supabase. The README also describes attendee registration and confirmation, but the supplied tree and excerpts do not establish a distinct implementation path for registration. Arrows reflect shown imports, calls, or documented architecture; unsampled subsystems are represented cautiously.
Main entry points: main.py Flask app and routes · page.tsx Role dashboard · events.py Event request API · bookings.py Booking API
Components 25
Web application
- Role dashboard
frontend/src/app/page.tsx - Demo role switcher
frontend/src/app/dev-role-switcher.tsx - Event request form
frontend/src/app/events/new/event-request-form.tsx - Draft workspace
frontend/src/app/events/drafts/draft-workspace.tsx - Event review and detail
frontend/src/app/events/[eventId]/page.tsx - Venue workspace
frontend/src/app/venues/venue-workspace.tsx - Venue form
frontend/src/app/venues/new/venue-form.tsx - Booking workflow
frontend/src/app/venues/bookings/new/page.tsx
API and access
- Flask app and routes
api/app/main.py - Identity and access
api/app/acting_user.py - Login sessions
api/app/auth.py
Event lifecycle
- Event request API
api/app/events.py - Event decisions and status
api/app/event_decision.py - Event persistence
api/app/event_repository.py - Organiser notifications
api/app/notifications.py - Registration and confirmation
api/app
Venue operations
- Venue API and suitability
api/app/venues.py - Venue catalogue store
api/app/venue_repository.py - Booking API
api/app/bookings.py - Booking persistence
api/app/booking_repository.py
Persistence
- Supabase PostgreSQL
Other components
- Organiser
- Coordinator
- Venue staff
- Attendee
Connections 34
- Organiser → Role dashboard: uses
README.md - Coordinator → Role dashboard: uses
README.md - Venue staff → Role dashboard: uses
README.md - Attendee → Registration and confirmation: registers
README.md - Role dashboard → Demo role switcher: renders
frontend/src/app/page.tsx - Role dashboard → Event request form: links to
frontend/src/app/page.tsx - Role dashboard → Draft workspace: links to
frontend/src/app/page.tsx - Role dashboard → Venue workspace: links to
frontend/src/app/page.tsx - Draft workspace → Event request form: reuses form
frontend/src/app/events/drafts/[eventId]/page.tsx - Venue workspace → Venue form: links to
frontend/src/app/venues/new/page.tsx - Event request form → Flask app and routes: calls API
README.md - Booking workflow → Flask app and routes: calls API
README.md - Flask app and routes → Event request API: registers routes
api/app/main.py - Flask app and routes → Login sessions: registers routes
api/app/main.py - Flask app and routes → Venue API and suitability: registers routes
api/app/main.py - Flask app and routes → Booking API: registers routes
api/app/main.py - Flask app and routes → Organiser notifications: registers routes
api/app/main.py - Event request API → Identity and access: resolves actor
api/app/events.py - Event request API → Event decisions and status: uses decisions
api/app/events.py - Event request API → Event persistence: reads and writes
api/app/events.py - Organiser notifications → Identity and access: checks actor
api/app/notifications.py - Venue API and suitability → Venue catalogue store: reads and writes
api/app/venues.py - Venue API and suitability → Booking persistence: checks availability
api/app/venues.py - Booking API → Identity and access: resolves actor
api/app/bookings.py - Booking API → Booking persistence: reads and writes
api/app/bookings.py - Booking API → Event persistence: checks event
api/app/bookings.py - Event persistence → Supabase PostgreSQL: queries
api/app/event_repository.py - Venue catalogue store → Supabase PostgreSQL: queries
api/app/venue_repository.py - Booking persistence → Supabase PostgreSQL: queries
api/app/booking_repository.py - Login sessions → Supabase PostgreSQL: looks up users
api/app/auth.py - Demo role switcher → Flask app and routes: switches demo session
frontend/src/app/dev-role-switcher.tsx - Event review and detail → Flask app and routes: loads event
- Venue form → Flask app and routes: submits venue
- Registration and confirmation → Flask app and routes: uses API
api/app/main.py