How edikkapustnyak/beautybook works
BeautyBook is a multi-tenant SaaS for beauty professionals, combining public business pages and online booking with a tenant dashboard and a separately deployed platform-admin app. A customer discovers a business, checks availability, verifies a phone, and books; tenants manage bookings and business data, while platform admins oversee companies and subscriptions. The backend also supports queued notifications, billing, and file storage. Several frontend/API and operational links are documented only at a high level; those are shown as unverified rather than asserted as source-level calls.
Main entry points: app.ts API application · bookingController.ts Tenant booking handlers · router.ts Tenant API · companyAdminController.ts Company administration
Components 25
Customer and tenant apps
- Public booking UI
apps/frontend/src/components/public/BookingFlow.tsx - Tenant dashboard
apps/frontend/src/app/(app)/bookings/page.tsx - Admin app
apps/admin/src/app/page.tsx
Backend API surfaces
- API application
apps/backend/src/app.ts - Tenant API
apps/backend/src/tenant/router.ts - Public booking routes
apps/backend/src/tenant/routes/publicRoutes.ts - Admin API
apps/backend/src/admin/router.ts - Company administration
apps/backend/src/admin/controllers/companyAdminController.ts - Company admin repository
apps/backend/src/admin/repositories/companyAdminRepository.ts
Booking and operations
- Public booking handlers
apps/backend/src/tenant/controllers/publicController.ts - Tenant booking handlers
apps/backend/src/tenant/controllers/bookingController.ts - Booking service
apps/backend/src/tenant/services/bookingService.ts - Availability engine
apps/backend/src/tenant/services/availabilityEngine.ts - Tenant repositories
apps/backend/src/tenant/repositories - Booking data
apps/backend/src/tenant/models/booking.model.ts
Platform services
- Notification queue
apps/backend/src/shared/queue/queues.ts - Notification worker
apps/backend/src/shared/queue/notificationWorker.ts - Notification service
apps/backend/src/tenant/services/notificationService.instance.ts - SMS provider
apps/backend/src/shared/sms/smsProviderPort.ts - Subscription billing data
apps/backend/src/shared/billing/subscriptionRepository.ts - S3-compatible storage
apps/backend/src/shared/storage/s3Storage.ts
Other components
- Customer
- Beauty professional
- Platform admin
- Stripe
Connections 25
- Customer → Public booking UI: books through
- Beauty professional → Tenant dashboard: manages business
- Platform admin → Admin app: administers platform
- Public booking UI → Tenant API: requests data
- Tenant dashboard → Tenant API: uses API
- Admin app → Admin API: uses API
- API application → Tenant API: mounts at tenant path
apps/backend/src/app.ts - API application → Admin API: mounts at admin path
apps/backend/src/app.ts - Tenant API → Public booking routes: mounts public routes
apps/backend/src/tenant/routes/publicRoutes.ts - Public booking routes → Public booking handlers: dispatches handlers
apps/backend/src/tenant/routes/publicRoutes.ts - Public booking handlers → Booking service: creates or updates bookings
apps/backend/src/tenant/controllers/publicController.ts - Public booking handlers → Tenant repositories: reads booking data
apps/backend/src/tenant/controllers/publicController.ts - Tenant booking handlers → Booking service: updates booking state
apps/backend/src/tenant/controllers/bookingController.ts - Tenant booking handlers → Availability engine: checks available slots
apps/backend/src/tenant/controllers/bookingController.ts - Tenant booking handlers → Tenant repositories: reads and writes records
apps/backend/src/tenant/controllers/bookingController.ts - Tenant repositories → Booking data: persists bookings
apps/backend/src/tenant/repositories/bookingRepository.ts - Tenant booking handlers → Notification queue: enqueues notifications
apps/backend/src/tenant/controllers/bookingController.ts - Notification worker → Notification queue: consumes jobs
apps/backend/src/shared/queue/notificationWorker.ts - Notification worker → Notification service: dispatches notifications
apps/backend/src/shared/queue/notificationWorker.ts - Notification service → SMS provider: sends SMS
- Admin API → Company administration: routes company operations
- Company administration → Company admin repository: reads and updates companies
apps/backend/src/admin/controllers/companyAdminController.ts - Company administration → Subscription billing data: looks up subscriptions
apps/backend/src/admin/controllers/companyAdminController.ts - API application → Stripe: receives webhook
apps/backend/src/app.ts - API application → S3-compatible storage: configures storage integration