# edikkapustnyak/beautybook architecture

> Architecture diagram of the GitHub repository edikkapustnyak/beautybook, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/edikkapustnyak/beautybook
- Repository: https://github.com/edikkapustnyak/beautybook

## Overview

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: [`apps/backend/src/app.ts`](https://github.com/edikkapustnyak/beautybook/blob/main/apps/backend/src/app.ts) (API application), [`apps/backend/src/tenant/controllers/bookingController.ts`](https://github.com/edikkapustnyak/beautybook/blob/main/apps/backend/src/tenant/controllers/bookingController.ts) (Tenant booking handlers), [`apps/backend/src/tenant/router.ts`](https://github.com/edikkapustnyak/beautybook/blob/main/apps/backend/src/tenant/router.ts) (Tenant API), [`apps/backend/src/admin/controllers/companyAdminController.ts`](https://github.com/edikkapustnyak/beautybook/blob/main/apps/backend/src/admin/controllers/companyAdminController.ts) (Company administration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["Customer and tenant apps"]
  node_public_ui["Public booking UI<br/>[BookingFlow.tsx]"]
  node_tenant_ui["Tenant dashboard<br/>[page.tsx]"]
  node_admin_ui["Admin app<br/>[page.tsx]"]
end

subgraph group_api["Backend API surfaces"]
  node_api_app["API application<br/>[app.ts]"]
  node_tenant_api["Tenant API<br/>[router.ts]"]
  node_public_routes["Public booking routes<br/>[publicRoutes.ts]"]
  node_admin_api["Admin API<br/>[router.ts]"]
  node_company_admin["Company administration"]
  node_company_admin_repo["Company admin repository"]
end

subgraph group_booking["Booking and operations"]
  node_public_controller["Public booking handlers"]
  node_booking_controller["Tenant booking handlers"]
  node_booking_service["Booking service<br/>[bookingService.ts]"]
  node_availability["Availability engine"]
  node_tenant_repositories["Tenant repositories"]
  node_booking_store[("Booking data<br/>[booking.model.ts]")]
end

subgraph group_platform["Platform services"]
  node_notification_queue["Notification queue<br/>[queues.ts]"]
  node_notification_worker["Notification worker"]
  node_notification_service["Notification service"]
  node_sms_provider["SMS provider<br/>[smsProviderPort.ts]"]
  node_subscription_store[("Subscription billing data")]
  node_file_storage[("S3-compatible storage<br/>[s3Storage.ts]")]
end

node_customer(("Customer"))
node_tenant_user(("Beauty professional"))
node_platform_admin(("Platform admin"))
node_stripe["Stripe"]

node_customer -.->|"books through"| node_public_ui
node_tenant_user -.->|"manages business"| node_tenant_ui
node_platform_admin -.->|"administers platform"| node_admin_ui
node_public_ui -.->|"requests data"| node_tenant_api
node_tenant_ui -.->|"uses API"| node_tenant_api
node_admin_ui -.->|"uses API"| node_admin_api
node_api_app -->|"mounts at tenant path"| node_tenant_api
node_api_app -->|"mounts at admin path"| node_admin_api
node_tenant_api -->|"mounts public routes"| node_public_routes
node_public_routes -->|"dispatches handlers"| node_public_controller
node_public_controller -->|"creates or updates bookings"| node_booking_service
node_public_controller -->|"reads booking data"| node_tenant_repositories
node_booking_controller -->|"updates booking state"| node_booking_service
node_booking_controller -->|"checks available slots"| node_availability
node_booking_controller -->|"reads and writes records"| node_tenant_repositories
node_tenant_repositories -->|"persists bookings"| node_booking_store
node_booking_controller -->|"enqueues notifications"| node_notification_queue
node_notification_worker -->|"consumes jobs"| node_notification_queue
node_notification_worker -->|"dispatches notifications"| node_notification_service
node_notification_service -.->|"sends SMS"| node_sms_provider
node_admin_api -.->|"routes company operations"| node_company_admin
node_company_admin -->|"reads and updates companies"| node_company_admin_repo
node_company_admin -->|"looks up subscriptions"| node_subscription_store
node_api_app -->|"receives webhook"| node_stripe
node_api_app -.->|"configures storage integration"| node_file_storage

click node_public_ui "https://github.com/edikkapustnyak/beautybook/blob/main/apps/frontend/src/components/public/BookingFlow.tsx"
click node_tenant_ui "https://github.com/edikkapustnyak/beautybook/blob/main/apps/frontend/src/app/(app)/bookings/page.tsx"
click node_admin_ui "https://github.com/edikkapustnyak/beautybook/blob/main/apps/admin/src/app/page.tsx"
click node_api_app "https://github.com/edikkapustnyak/beautybook/blob/main/apps/backend/src/app.ts"
click node_tenant_api "https://github.com/edikkapustnyak/beautybook/blob/main/apps/backend/src/tenant/router.ts"
click node_public_routes "https://github.com/edikkapustnyak/beautybook/blob/main/apps/backend/src/tenant/routes/publicRoutes.ts"
click node_public_controller "https://github.com/edikkapustnyak/beautybook/blob/main/apps/backend/src/tenant/controllers/publicController.ts"
click node_booking_controller "https://github.com/edikkapustnyak/beautybook/blob/main/apps/backend/src/tenant/controllers/bookingController.ts"
click node_booking_service "https://github.com/edikkapustnyak/beautybook/blob/main/apps/backend/src/tenant/services/bookingService.ts"
click node_availability "https://github.com/edikkapustnyak/beautybook/blob/main/apps/backend/src/tenant/services/availabilityEngine.ts"
click node_tenant_repositories "https://github.com/edikkapustnyak/beautybook/tree/main/apps/backend/src/tenant/repositories"
click node_booking_store "https://github.com/edikkapustnyak/beautybook/blob/main/apps/backend/src/tenant/models/booking.model.ts"
click node_notification_queue "https://github.com/edikkapustnyak/beautybook/blob/main/apps/backend/src/shared/queue/queues.ts"
click node_notification_worker "https://github.com/edikkapustnyak/beautybook/blob/main/apps/backend/src/shared/queue/notificationWorker.ts"
click node_notification_service "https://github.com/edikkapustnyak/beautybook/blob/main/apps/backend/src/tenant/services/notificationService.instance.ts"
click node_sms_provider "https://github.com/edikkapustnyak/beautybook/blob/main/apps/backend/src/shared/sms/smsProviderPort.ts"
click node_admin_api "https://github.com/edikkapustnyak/beautybook/blob/main/apps/backend/src/admin/router.ts"
click node_company_admin "https://github.com/edikkapustnyak/beautybook/blob/main/apps/backend/src/admin/controllers/companyAdminController.ts"
click node_company_admin_repo "https://github.com/edikkapustnyak/beautybook/blob/main/apps/backend/src/admin/repositories/companyAdminRepository.ts"
click node_subscription_store "https://github.com/edikkapustnyak/beautybook/blob/main/apps/backend/src/shared/billing/subscriptionRepository.ts"
click node_file_storage "https://github.com/edikkapustnyak/beautybook/blob/main/apps/backend/src/shared/storage/s3Storage.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_public_ui,node_tenant_ui,node_admin_ui toneBlue
class node_api_app,node_tenant_api,node_public_routes,node_admin_api,node_company_admin,node_company_admin_repo toneAmber
class node_public_controller,node_booking_controller,node_booking_service,node_availability,node_tenant_repositories,node_booking_store toneMint
class node_notification_queue,node_notification_worker,node_notification_service,node_sms_provider,node_subscription_store,node_file_storage toneRose
class node_customer,node_tenant_user,node_platform_admin,node_stripe toneIndigo
```

## Components

### Customer and tenant apps

- [Public booking UI](https://github.com/edikkapustnyak/beautybook/blob/main/apps/frontend/src/components/public/BookingFlow.tsx): `apps/frontend/src/components/public/BookingFlow.tsx`
- [Tenant dashboard](https://github.com/edikkapustnyak/beautybook/blob/main/apps/frontend/src/app/(app)/bookings/page.tsx): `apps/frontend/src/app/(app)/bookings/page.tsx`
- [Admin app](https://github.com/edikkapustnyak/beautybook/blob/main/apps/admin/src/app/page.tsx): `apps/admin/src/app/page.tsx`

### Backend API surfaces

- [API application](https://github.com/edikkapustnyak/beautybook/blob/main/apps/backend/src/app.ts): `apps/backend/src/app.ts`
- [Tenant API](https://github.com/edikkapustnyak/beautybook/blob/main/apps/backend/src/tenant/router.ts): `apps/backend/src/tenant/router.ts`
- [Public booking routes](https://github.com/edikkapustnyak/beautybook/blob/main/apps/backend/src/tenant/routes/publicRoutes.ts): `apps/backend/src/tenant/routes/publicRoutes.ts`
- [Admin API](https://github.com/edikkapustnyak/beautybook/blob/main/apps/backend/src/admin/router.ts): `apps/backend/src/admin/router.ts`
- [Company administration](https://github.com/edikkapustnyak/beautybook/blob/main/apps/backend/src/admin/controllers/companyAdminController.ts): `apps/backend/src/admin/controllers/companyAdminController.ts`
- [Company admin repository](https://github.com/edikkapustnyak/beautybook/blob/main/apps/backend/src/admin/repositories/companyAdminRepository.ts): `apps/backend/src/admin/repositories/companyAdminRepository.ts`

### Booking and operations

- [Public booking handlers](https://github.com/edikkapustnyak/beautybook/blob/main/apps/backend/src/tenant/controllers/publicController.ts): `apps/backend/src/tenant/controllers/publicController.ts`
- [Tenant booking handlers](https://github.com/edikkapustnyak/beautybook/blob/main/apps/backend/src/tenant/controllers/bookingController.ts): `apps/backend/src/tenant/controllers/bookingController.ts`
- [Booking service](https://github.com/edikkapustnyak/beautybook/blob/main/apps/backend/src/tenant/services/bookingService.ts): `apps/backend/src/tenant/services/bookingService.ts`
- [Availability engine](https://github.com/edikkapustnyak/beautybook/blob/main/apps/backend/src/tenant/services/availabilityEngine.ts): `apps/backend/src/tenant/services/availabilityEngine.ts`
- [Tenant repositories](https://github.com/edikkapustnyak/beautybook/tree/main/apps/backend/src/tenant/repositories): `apps/backend/src/tenant/repositories`
- [Booking data](https://github.com/edikkapustnyak/beautybook/blob/main/apps/backend/src/tenant/models/booking.model.ts): `apps/backend/src/tenant/models/booking.model.ts`

### Platform services

- [Notification queue](https://github.com/edikkapustnyak/beautybook/blob/main/apps/backend/src/shared/queue/queues.ts): `apps/backend/src/shared/queue/queues.ts`
- [Notification worker](https://github.com/edikkapustnyak/beautybook/blob/main/apps/backend/src/shared/queue/notificationWorker.ts): `apps/backend/src/shared/queue/notificationWorker.ts`
- [Notification service](https://github.com/edikkapustnyak/beautybook/blob/main/apps/backend/src/tenant/services/notificationService.instance.ts): `apps/backend/src/tenant/services/notificationService.instance.ts`
- [SMS provider](https://github.com/edikkapustnyak/beautybook/blob/main/apps/backend/src/shared/sms/smsProviderPort.ts): `apps/backend/src/shared/sms/smsProviderPort.ts`
- [Subscription billing data](https://github.com/edikkapustnyak/beautybook/blob/main/apps/backend/src/shared/billing/subscriptionRepository.ts): `apps/backend/src/shared/billing/subscriptionRepository.ts`
- [S3-compatible storage](https://github.com/edikkapustnyak/beautybook/blob/main/apps/backend/src/shared/storage/s3Storage.ts): `apps/backend/src/shared/storage/s3Storage.ts`

### Other components

- **Customer**
- **Beauty professional**
- **Platform admin**
- **Stripe**

## Connections

- 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 (evidence: `apps/backend/src/app.ts`)
- API application → Admin API: mounts at admin path (evidence: `apps/backend/src/app.ts`)
- Tenant API → Public booking routes: mounts public routes (evidence: `apps/backend/src/tenant/routes/publicRoutes.ts`)
- Public booking routes → Public booking handlers: dispatches handlers (evidence: `apps/backend/src/tenant/routes/publicRoutes.ts`)
- Public booking handlers → Booking service: creates or updates bookings (evidence: `apps/backend/src/tenant/controllers/publicController.ts`)
- Public booking handlers → Tenant repositories: reads booking data (evidence: `apps/backend/src/tenant/controllers/publicController.ts`)
- Tenant booking handlers → Booking service: updates booking state (evidence: `apps/backend/src/tenant/controllers/bookingController.ts`)
- Tenant booking handlers → Availability engine: checks available slots (evidence: `apps/backend/src/tenant/controllers/bookingController.ts`)
- Tenant booking handlers → Tenant repositories: reads and writes records (evidence: `apps/backend/src/tenant/controllers/bookingController.ts`)
- Tenant repositories → Booking data: persists bookings (evidence: `apps/backend/src/tenant/repositories/bookingRepository.ts`)
- Tenant booking handlers → Notification queue: enqueues notifications (evidence: `apps/backend/src/tenant/controllers/bookingController.ts`)
- Notification worker → Notification queue: consumes jobs (evidence: `apps/backend/src/shared/queue/notificationWorker.ts`)
- Notification worker → Notification service: dispatches notifications (evidence: `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 (evidence: `apps/backend/src/admin/controllers/companyAdminController.ts`)
- Company administration → Subscription billing data: looks up subscriptions (evidence: `apps/backend/src/admin/controllers/companyAdminController.ts`)
- API application → Stripe: receives webhook (evidence: `apps/backend/src/app.ts`)
- API application → S3-compatible storage: configures storage integration
