How knehe/aero_bound_ventures-public works
Aero Bound Ventures is a full-stack flight-booking platform. Travelers search and price flights, create bookings, pay, manage seats and bookings, and receive ticket and notification updates; users can also authenticate, while administrators manage bookings and tickets. The graph separates the Next.js experience, FastAPI entry points and domain use cases, persistence, and external/event integrations. README statements support the broad system links; source-index references and excerpts support selected implementation links. Unsampled routes and adapters are represented at directory level, so their internal call wiring is not asserted.
Main entry points: main.py FastAPI entry · flights.py Flight and booking routes · database.py PostgreSQL · oauth_login.py OAuth login workflow
Components 25
Web experience
- Next.js application
frontend/src/app/page.tsx
API and workflows
- FastAPI entry
backend/main.py - Flight and booking routes
backend/routers/flights.py - Flight workflows
backend/application/flights - Booking workflows
backend/application/bookings - Payment routes
backend/routers/payments.py - Payment workflows
backend/application/payments - OAuth routes
backend/routers/oauth.py - OAuth login workflow
backend/application/oauth/oauth_login.py - Ticket routes
backend/routers/tickets.py - Notification routes
backend/routers/notifications.py - Admin routes
backend/routers/admin.py
Persistence
- Booking repository
backend/infrastructure/bookings/sqlmodel_booking_repository.py - Notification repository
backend/infrastructure/notifications/sqlmodel_notification_repository.py - PostgreSQL
backend/crud/database.py
External services
- Amadeus or mock flights
backend/external_services/flight.py - Pesapal payments
backend/external_services/pesapal.py - Google OAuth
backend/infrastructure/oauth/google_oauth_provider.py - Cloudinary ticket storage
backend/infrastructure/tickets/cloudinary_ticket_file_storage.py
Async notifications
- Redis cache and streams
backend/utils/redis.py - Kafka
backend/utils/kafka.py - Notification worker
backend/worker.py - Notification publisher
backend/utils/notification_service.py
Other components
- Traveler
- Administrator
Connections 29
- Traveler → Next.js application: uses
README.md - Administrator → Next.js application: uses
README.md - Next.js application → FastAPI entry: REST and SSE
README.md - FastAPI entry → Flight and booking routes: mounts routes
backend/main.py - FastAPI entry → Payment routes: mounts routes
backend/main.py - FastAPI entry → OAuth routes: mounts routes
backend/main.py - FastAPI entry → Ticket routes: mounts routes
backend/main.py - FastAPI entry → Notification routes: mounts routes
backend/main.py - FastAPI entry → Admin routes: mounts routes
backend/main.py - Flight and booking routes → Flight workflows: dispatches to
backend/routers/flights.py - Flight and booking routes → Booking workflows: dispatches to
backend/routers/flights.py - Flight and booking routes → Booking repository: configures repository
backend/routers/flights.py - Booking repository → PostgreSQL: queries
backend/infrastructure/bookings/sqlmodel_booking_repository.py - Booking workflows → Booking repository: uses repository
backend/infrastructure/bookings/sqlmodel_booking_repository.py - Flight workflows → Amadeus or mock flights: flight data
README.md - Payment routes → Payment workflows: dispatches to
README.md - Payment workflows → Pesapal payments: processes payments
README.md - OAuth routes → OAuth login workflow: dispatches to
backend/routers/oauth.py - OAuth login workflow → Google OAuth: fetches identity
backend/routers/oauth.py - OAuth login workflow → PostgreSQL: user records
- Ticket routes → Cloudinary ticket storage: stores uploads
backend/infrastructure/tickets/cloudinary_ticket_file_storage.py - Notification routes → Notification repository: notification records
backend/infrastructure/notifications/sqlmodel_notification_repository.py - Notification publisher → PostgreSQL: persists notification
backend/utils/notification_service.py - Notification publisher → Redis cache and streams: publishes updates
backend/utils/notification_service.py - FastAPI entry → Kafka: starts producer
backend/main.py - Kafka → Notification worker: delivers events
README.md - FastAPI entry → PostgreSQL: uses storage
README.md - FastAPI entry → Redis cache and streams: uses cache and Pub/Sub
README.md - FastAPI entry → Cloudinary ticket storage: ticket uploads
README.md