How victoriousvijay/meeting-room-booking-system works
Meeting Room Booking System: users view a room’s bookings by day, filter rooms, create or cancel bookings, and find the next available slot. The main path runs from the dashboard through the frontend API client to FastAPI routes, booking/room services, scheduling rules, and PostgreSQL. The UI also provides form validation, loading/error states, and toast feedback. Backend relationships are supported by excerpts and the README’s request-flow description; some frontend data-fetching and unsampled room-route details are documented but not excerpted.
Main entry points: BookingDashboard.tsx Booking dashboard · main.py FastAPI application · bookings.py Booking operations · rooms.py Room operations
Components 23
Booking interface
- Booking dashboard
frontend/components/BookingDashboard.tsx - Date and room filters
frontend/components/Filters.tsx - Room day card
frontend/components/RoomCard.tsx - Booking form
frontend/components/BookingModal.tsx - Next slot finder
frontend/components/NextSlotFinder.tsx - Loading and errors
frontend/components/States.tsx - Toast notifications
frontend/components/Toast.tsx
Frontend data
- Room and booking hooks
frontend/hooks - API client
frontend/lib/api.ts - Form validation
frontend/lib/validation.ts
HTTP API
- FastAPI application
backend/app/main.py - Booking routes
backend/app/routers/bookings.py - Room routes
backend/app/routers/rooms.py - Request and response schemas
backend/app/schemas.py
Booking domain
- Booking operations
backend/app/services/bookings.py - Room operations
backend/app/services/rooms.py - Scheduling rules
backend/app/scheduling.py - API errors
backend/app/errors.py - Room initialization
backend/app/seed.py
Persistence
- Database sessions
backend/app/database.py - Room and booking tables
backend/app/models.py - PostgreSQL
Other components
- Room booker
Connections 30
- Room booker → Booking dashboard: uses
README.md - Booking dashboard → Date and room filters: renders
frontend/components/BookingDashboard.tsx - Booking dashboard → Room day card: renders
frontend/components/BookingDashboard.tsx - Booking dashboard → Booking form: renders
frontend/components/BookingDashboard.tsx - Booking dashboard → Next slot finder: renders
frontend/components/BookingDashboard.tsx - Booking dashboard → Loading and errors: renders
frontend/components/BookingDashboard.tsx - Booking dashboard → Room and booking hooks: loads data
frontend/components/BookingDashboard.tsx - Booking dashboard → API client: creates and cancels
frontend/components/BookingDashboard.tsx - Booking dashboard → Toast notifications: notifies
frontend/components/BookingDashboard.tsx - Booking form → Form validation: validates
frontend/components/BookingModal.tsx - Room and booking hooks → API client: fetches data
README.md - API client → FastAPI application: HTTP requests
README.md - FastAPI application → Booking routes: registers
backend/app/main.py - FastAPI application → Room routes: registers
backend/app/main.py - FastAPI application → Room initialization: initializes on startup
backend/app/main.py - Booking routes → Booking operations: calls
backend/app/routers/bookings.py - Room routes → Room operations: calls
backend/app/routers/rooms.py - Booking routes → Request and response schemas: validates and shapes
backend/app/routers/bookings.py - Room routes → Request and response schemas: shapes responses
backend/app/routers/rooms.py - Booking operations → Scheduling rules: checks booking rules
backend/app/services/bookings.py - Room operations → Scheduling rules: finds free slots
backend/app/services/rooms.py - Booking operations → Room operations: looks up room
backend/app/services/bookings.py - Booking operations → API errors: raises domain errors
backend/app/services/bookings.py - Room operations → API errors: raises not found
backend/app/services/rooms.py - FastAPI application → API errors: maps to responses
backend/app/main.py - Booking operations → Room and booking tables: reads and writes
backend/app/services/bookings.py - Room operations → Room and booking tables: reads
backend/app/services/rooms.py - Room initialization → Room and booking tables: creates room records
backend/app/seed.py - Room and booking tables → Database sessions: uses base
backend/app/models.py - Database sessions → PostgreSQL: queries database
backend/app/database.py