How vadluri-pratheek/bookmycut works
BookMyCut is a two-sided barber appointment platform. Customers authenticate, discover nearby shops, choose services and available slots, then create and manage bookings; barbers configure shop and staff schedules and manage appointments. The graph includes the documented MongoDB transaction and live slot-locking behavior, although those implementation details are not fully visible in the excerpts. Edges are limited to relationships shown in excerpts, the source index, or README; unsampled route and dashboard wiring is not inferred.
Main entry points: booking.controller.js Booking and slots · App.jsx App routing · schedule.controller.js Schedule management · client.js API client
Components 27
Customer experience
- App routing
frontend/src/App.jsx - Customer auth
frontend/src/pages/CustomerAuthPage.jsx - Shop discovery and booking
frontend/src/pages/CustomerDashboard.jsx - Location utilities
frontend/src/utils/location.js - API client
frontend/src/api/client.js
Barber operations
- Barber auth
frontend/src/pages/BarberAuthPage.jsx - Barber dashboard
frontend/src/pages/BarberDashboard.jsx
API and domain
- Express API
backend/src/app.js - Auth routes
backend/src/routes/auth.route.js - Authentication
backend/src/controllers/auth.controller.js - Shop discovery
backend/src/controllers/shop.controller.js - Booking routes
backend/src/routes/booking.route.js - Booking and slots
backend/src/controllers/booking.controller.js - Schedule management
backend/src/controllers/schedule.controller.js - Barber management
backend/src/controllers/barber.controller.js - Slot availability engine
backend/src/utils/availabilityEngine.js - Travel buffer
backend/src/utils/travelTime.js - Booking lifecycle
backend/src/utils/bookingLifecycle.js - Booking notifications
backend/src/utils/bookingNotifications.js
Booking and data
- Bookings
backend/src/models/booking.model.js - User and barber profiles
backend/src/models/user.model.js - Shops
backend/src/models/shop.model.js - Daily schedules
backend/src/models/daySchedule.model.js
Other components
- Customer
- Barber staff
- MongoDB
- OpenStreetMap Nominatim
Connections 41
- Customer → App routing: uses
frontend/src/App.jsx - Barber staff → App routing: uses
frontend/src/App.jsx - App routing → Customer auth: routes to
frontend/src/App.jsx - App routing → Barber auth: routes to
frontend/src/App.jsx - App routing → Shop discovery and booking: routes to
frontend/src/App.jsx - App routing → Barber dashboard: routes to
frontend/src/App.jsx - Customer auth → API client: calls
frontend/src/pages/CustomerAuthPage.jsx - Barber auth → API client: calls
frontend/src/pages/BarberAuthPage.jsx - Shop discovery and booking → API client: calls
frontend/src/pages/CustomerDashboard.jsx - Shop discovery and booking → Location utilities: uses
frontend/src/pages/CustomerDashboard.jsx - Location utilities → OpenStreetMap Nominatim: reverse geocodes
frontend/src/utils/location.js - API client → Express API: HTTP requests
frontend/src/api/client.js - Express API → Auth routes: mounts
backend/src/app.js - Express API → Booking routes: mounts
backend/src/app.js - Auth routes → Authentication: dispatches
backend/src/routes/auth.route.js - Authentication → User and barber profiles: reads and writes
backend/src/controllers/auth.controller.js - Authentication → Shops: creates shop
backend/src/controllers/auth.controller.js - Booking routes → Booking and slots: dispatches
backend/src/routes/booking.route.js - Booking and slots → Slot availability engine: computes slots
backend/src/controllers/booking.controller.js - Slot availability engine → Travel buffer: accounts for travel
backend/src/utils/availabilityEngine.js - Booking and slots → Bookings: reads and writes
backend/src/controllers/booking.controller.js - Booking and slots → Shops: reads
backend/src/controllers/booking.controller.js - Booking and slots → User and barber profiles: reads
backend/src/controllers/booking.controller.js - Booking and slots → Daily schedules: reads schedules
backend/src/controllers/booking.controller.js - Booking and slots → Booking lifecycle: cancels expired
backend/src/controllers/booking.controller.js - Booking lifecycle → Bookings: updates
backend/src/utils/bookingLifecycle.js - Booking lifecycle → Booking notifications: notifies
backend/src/utils/bookingLifecycle.js - Schedule management → User and barber profiles: reads and writes
backend/src/controllers/schedule.controller.js - Schedule management → Bookings: reads bookings
backend/src/controllers/schedule.controller.js - Schedule management → Daily schedules: reads and writes
backend/src/controllers/schedule.controller.js - Schedule management → Shops: reads
backend/src/controllers/schedule.controller.js - Barber management → User and barber profiles: reads and writes
backend/src/controllers/barber.controller.js - Barber management → Bookings: reads bookings
backend/src/controllers/barber.controller.js - Barber management → Daily schedules: reads schedules
backend/src/controllers/barber.controller.js - Bookings → MongoDB: persists in
README.md - Shops → MongoDB: persists in
README.md - User and barber profiles → MongoDB: persists in
README.md - Daily schedules → MongoDB: persists in
README.md - Shop discovery and booking → Booking and slots: requests booking API
- Barber dashboard → API client: uses API
- Barber dashboard → Schedule management: manages schedules