# mihneacatana/multi-tenants-scheduler-app architecture

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

- Interactive diagram: https://gitdiagram.com/mihneacatana/multi-tenants-scheduler-app
- Repository: https://github.com/mihneacatana/multi-tenants-scheduler-app

## Overview

Simi is a multi-tenant SMB management SaaS: users enter a tenant-specific React workspace, authenticate, and manage clients, appointments, staff, services, resources, and availability through a Fastify API backed by isolated tenant databases. Platform administration provisions tenants and manages feature flags through the shared global database. The graph reflects documented architecture and source-index references; some feature-specific backend route and controller links are not evidenced in the excerpts, so those connections are omitted.

Main entry points: [`frontend/src/App.tsx`](https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/frontend/src/App.tsx) (React workspace), [`frontend/src/features/scheduling/SchedulingPage.tsx`](https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/frontend/src/features/scheduling/SchedulingPage.tsx) (Scheduling workspace), [`backend/src/controllers/admin.controller.ts`](https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/backend/src/controllers/admin.controller.ts) (Admin handlers), [`backend/src/app.ts`](https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/backend/src/app.ts) (Fastify app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_app["React workspace<br/>[App.tsx]"]
  node_authui["Auth state<br/>[auth.tsx]"]
  node_api_client["API client<br/>[api.ts]"]
  node_clients_ui["Client workspace"]
  node_scheduling_ui["Scheduling workspace<br/>[SchedulingPage.tsx]"]
  node_admin_ui["Admin console<br/>[AdminConsole.tsx]"]
  node_tenant_ui["Tenant context<br/>[tenant.ts]"]
end

subgraph group_api["Backend API"]
  node_api_app["Fastify app<br/>[app.ts]"]
  node_auth_routes["Auth routes<br/>[auth.routes.ts]"]
  node_admin_routes["Admin routes<br/>[admin.routes.ts]"]
  node_auth_controller["Auth handlers<br/>[auth.controller.ts]"]
  node_admin_controller["Admin handlers"]
end

subgraph group_identity["Identity and tenancy"]
  node_auth_service["Authentication<br/>[service.ts]"]
  node_tenant_auth["Tenant authentication<br/>[tenant-service.ts]"]
  node_tenant_provision["Tenant provisioning<br/>[provision.ts]"]
  node_tenant_plugin["Tenant resolution<br/>[tenant.ts]"]
end

subgraph group_operations["Scheduling domains"]
  node_scheduling["Appointment lifecycle<br/>[service.ts]"]
  node_availability["Availability<br/>[service.ts]"]
  node_catalog["Services catalog<br/>[service.ts]"]
  node_resources["Resource management<br/>[service.ts]"]
  node_staff["Staff management<br/>[service.ts]"]
end

subgraph group_data["Persistence"]
  node_global_db[("Global PostgreSQL<br/>[client.ts]")]
  node_tenant_pool[("Tenant DB pools<br/>[tenant-pool.ts]")]
  node_global_schema["Global schema<br/>[index.ts]"]
  node_tenant_schema["Tenant schema<br/>[index.ts]"]
end

node_user(("Tenant user"))
node_platform_admin(("Platform administrator"))

node_user -->|"uses"| node_app
node_app -->|"provides"| node_authui
node_app -->|"routes to"| node_clients_ui
node_app -->|"routes to"| node_scheduling_ui
node_app -->|"routes to"| node_admin_ui
node_clients_ui -->|"requests data"| node_api_client
node_authui -->|"calls"| node_api_client
node_app -->|"renders tenant context"| node_tenant_ui
node_api_client -->|"HTTP requests"| node_api_app
node_api_app -->|"registers routes"| node_auth_routes
node_auth_routes -->|"dispatches"| node_auth_controller
node_admin_routes -->|"dispatches"| node_admin_controller
node_auth_controller -->|"authenticates global user"| node_auth_service
node_auth_controller -->|"authenticates tenant user"| node_tenant_auth
node_admin_controller -->|"provisions tenant"| node_tenant_provision
node_api_app -->|"registers plugin"| node_tenant_plugin
node_auth_service -->|"reads and writes"| node_global_db
node_tenant_auth -->|"uses schema"| node_tenant_schema
node_admin_controller -->|"reads and writes tenant registry"| node_global_db
node_admin_controller -->|"opens or closes pool"| node_tenant_pool
node_scheduling -->|"queries tenant data"| node_tenant_pool
node_scheduling -->|"uses schema"| node_tenant_schema
node_global_db -->|"registers schema"| node_global_schema
node_tenant_pool -->|"registers schema"| node_tenant_schema
node_platform_admin -->|"administers tenants"| node_admin_ui
node_scheduling_ui -.->|"availability workflow"| node_availability
node_scheduling_ui -.->|"service setup"| node_catalog
node_scheduling_ui -.->|"resource setup"| node_resources
node_admin_ui -.->|"staff administration"| node_staff

click node_app "https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/frontend/src/App.tsx"
click node_authui "https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/frontend/src/lib/auth.tsx"
click node_api_client "https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/frontend/src/lib/api.ts"
click node_clients_ui "https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/frontend/src/features/clients/ClientsWorkspace.tsx"
click node_scheduling_ui "https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/frontend/src/features/scheduling/SchedulingPage.tsx"
click node_admin_ui "https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/frontend/src/features/admin/AdminConsole.tsx"
click node_tenant_ui "https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/frontend/src/lib/tenant.ts"
click node_api_app "https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/backend/src/app.ts"
click node_auth_routes "https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/backend/src/routes/auth.routes.ts"
click node_admin_routes "https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/backend/src/routes/admin.routes.ts"
click node_auth_controller "https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/backend/src/controllers/auth.controller.ts"
click node_admin_controller "https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/backend/src/controllers/admin.controller.ts"
click node_auth_service "https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/backend/src/modules/auth/service.ts"
click node_tenant_auth "https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/backend/src/modules/auth/tenant-service.ts"
click node_tenant_provision "https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/backend/src/modules/tenants/provision.ts"
click node_tenant_plugin "https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/backend/src/plugins/tenant.ts"
click node_scheduling "https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/backend/src/modules/scheduling/service.ts"
click node_availability "https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/backend/src/modules/availability/service.ts"
click node_catalog "https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/backend/src/modules/services-catalog/service.ts"
click node_resources "https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/backend/src/modules/resources/service.ts"
click node_staff "https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/backend/src/modules/staff/service.ts"
click node_global_db "https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/backend/src/db/client.ts"
click node_tenant_pool "https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/backend/src/db/tenant-pool.ts"
click node_global_schema "https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/backend/src/db/schema/global/index.ts"
click node_tenant_schema "https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/backend/src/db/schema/tenant/index.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_app,node_authui,node_api_client,node_clients_ui,node_scheduling_ui,node_admin_ui,node_tenant_ui,node_user toneBlue
class node_api_app,node_auth_routes,node_admin_routes,node_auth_controller,node_admin_controller toneAmber
class node_auth_service,node_tenant_auth,node_tenant_provision,node_tenant_plugin toneMint
class node_scheduling,node_availability,node_catalog,node_resources,node_staff toneRose
class node_global_db,node_tenant_pool,node_global_schema,node_tenant_schema,node_platform_admin toneIndigo
```

## Components

### Web application

- [React workspace](https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Auth state](https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/frontend/src/lib/auth.tsx): `frontend/src/lib/auth.tsx`
- [API client](https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/frontend/src/lib/api.ts): `frontend/src/lib/api.ts`
- [Client workspace](https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/frontend/src/features/clients/ClientsWorkspace.tsx): `frontend/src/features/clients/ClientsWorkspace.tsx`
- [Scheduling workspace](https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/frontend/src/features/scheduling/SchedulingPage.tsx): `frontend/src/features/scheduling/SchedulingPage.tsx`
- [Admin console](https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/frontend/src/features/admin/AdminConsole.tsx): `frontend/src/features/admin/AdminConsole.tsx`
- [Tenant context](https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/frontend/src/lib/tenant.ts): `frontend/src/lib/tenant.ts`

### Backend API

- [Fastify app](https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/backend/src/app.ts): `backend/src/app.ts`
- [Auth routes](https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/backend/src/routes/auth.routes.ts): `backend/src/routes/auth.routes.ts`
- [Admin routes](https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/backend/src/routes/admin.routes.ts): `backend/src/routes/admin.routes.ts`
- [Auth handlers](https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/backend/src/controllers/auth.controller.ts): `backend/src/controllers/auth.controller.ts`
- [Admin handlers](https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/backend/src/controllers/admin.controller.ts): `backend/src/controllers/admin.controller.ts`

### Identity and tenancy

- [Authentication](https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/backend/src/modules/auth/service.ts): `backend/src/modules/auth/service.ts`
- [Tenant authentication](https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/backend/src/modules/auth/tenant-service.ts): `backend/src/modules/auth/tenant-service.ts`
- [Tenant provisioning](https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/backend/src/modules/tenants/provision.ts): `backend/src/modules/tenants/provision.ts`
- [Tenant resolution](https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/backend/src/plugins/tenant.ts): `backend/src/plugins/tenant.ts`

### Scheduling domains

- [Appointment lifecycle](https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/backend/src/modules/scheduling/service.ts): `backend/src/modules/scheduling/service.ts`
- [Availability](https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/backend/src/modules/availability/service.ts): `backend/src/modules/availability/service.ts`
- [Services catalog](https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/backend/src/modules/services-catalog/service.ts): `backend/src/modules/services-catalog/service.ts`
- [Resource management](https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/backend/src/modules/resources/service.ts): `backend/src/modules/resources/service.ts`
- [Staff management](https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/backend/src/modules/staff/service.ts): `backend/src/modules/staff/service.ts`

### Persistence

- [Global PostgreSQL](https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/backend/src/db/client.ts): `backend/src/db/client.ts`
- [Tenant DB pools](https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/backend/src/db/tenant-pool.ts): `backend/src/db/tenant-pool.ts`
- [Global schema](https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/backend/src/db/schema/global/index.ts): `backend/src/db/schema/global/index.ts`
- [Tenant schema](https://github.com/mihneacatana/multi-tenants-scheduler-app/blob/main/backend/src/db/schema/tenant/index.ts): `backend/src/db/schema/tenant/index.ts`

### Other components

- **Tenant user**
- **Platform administrator**

## Connections

- Tenant user → React workspace: uses (evidence: `README.md`)
- React workspace → Auth state: provides (evidence: `frontend/src/App.tsx`)
- React workspace → Client workspace: routes to (evidence: `frontend/src/App.tsx`)
- React workspace → Scheduling workspace: routes to (evidence: `frontend/src/App.tsx`)
- React workspace → Admin console: routes to (evidence: `frontend/src/App.tsx`)
- Client workspace → API client: requests data (evidence: `frontend/src/features/clients/ClientsWorkspace.tsx`)
- Auth state → API client: calls (evidence: `frontend/src/lib/auth.tsx`)
- React workspace → Tenant context: renders tenant context
- API client → Fastify app: HTTP requests (evidence: `README.md`)
- Fastify app → Auth routes: registers routes (evidence: `backend/src/app.ts`)
- Auth routes → Auth handlers: dispatches (evidence: `backend/src/routes/auth.routes.ts`)
- Admin routes → Admin handlers: dispatches (evidence: `backend/src/routes/admin.routes.ts`)
- Auth handlers → Authentication: authenticates global user (evidence: `backend/src/controllers/auth.controller.ts`)
- Auth handlers → Tenant authentication: authenticates tenant user (evidence: `backend/src/controllers/auth.controller.ts`)
- Admin handlers → Tenant provisioning: provisions tenant (evidence: `backend/src/controllers/admin.controller.ts`)
- Fastify app → Tenant resolution: registers plugin (evidence: `backend/src/app.ts`)
- Authentication → Global PostgreSQL: reads and writes (evidence: `backend/src/modules/auth/service.ts`)
- Tenant authentication → Tenant schema: uses schema (evidence: `backend/src/modules/auth/tenant-service.ts`)
- Admin handlers → Global PostgreSQL: reads and writes tenant registry (evidence: `backend/src/controllers/admin.controller.ts`)
- Admin handlers → Tenant DB pools: opens or closes pool (evidence: `backend/src/controllers/admin.controller.ts`)
- Appointment lifecycle → Tenant DB pools: queries tenant data (evidence: `backend/src/modules/scheduling/service.ts`)
- Appointment lifecycle → Tenant schema: uses schema (evidence: `backend/src/modules/scheduling/service.ts`)
- Global PostgreSQL → Global schema: registers schema (evidence: `backend/src/db/client.ts`)
- Tenant DB pools → Tenant schema: registers schema (evidence: `backend/src/db/tenant-pool.ts`)
- Platform administrator → Admin console: administers tenants (evidence: `README.md`)
- Scheduling workspace → Availability: availability workflow
- Scheduling workspace → Services catalog: service setup
- Scheduling workspace → Resource management: resource setup
- Admin console → Staff management: staff administration
