# fcomair/rendivoo architecture

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

- Interactive diagram: https://gitdiagram.com/fcomair/rendivoo
- Repository: https://github.com/fcomair/rendivoo

## Overview

Rendivoo is a multilingual, multi-tenant SaaS for managing a client’s business, with a separate Super Admin area. The customer workflow spans organization setup, service and staff configuration, appointment planning, and ongoing customer engagement; billing, calendars, loyalty, reporting, and support provide distinct capabilities around it. The graph preserves these documented-by-module branches, but the excerpts do not establish most of their runtime call chains, so only relationships visible in the supplied excerpts or source index are connected.

Main entry points: [`app/Modules/Conversation/Services/ConversationEngine.php`](https://github.com/fcomair/rendivoo/blob/main/app/Modules/Conversation/Services/ConversationEngine.php) (Conversation engine), [`app/Modules/Tenancy/Support/CurrentTenant.php`](https://github.com/fcomair/rendivoo/blob/main/app/Modules/Tenancy/Support/CurrentTenant.php) (Tenant context), [`app/Modules/Tenancy/Models/Organization.php`](https://github.com/fcomair/rendivoo/blob/main/app/Modules/Tenancy/Models/Organization.php) (Organizations), [`app/Modules/Booking/Http/Controllers/PlanningController.php`](https://github.com/fcomair/rendivoo/blob/main/app/Modules/Booking/Http/Controllers/PlanningController.php) (Planning interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_tenant["Tenant foundation"]
  node_tenant_context["Tenant context<br/>[CurrentTenant.php]"]
  node_organization[("Organizations<br/>[Organization.php]")]
  node_location[("Business locations<br/>[Location.php]")]
  node_capabilities["Role capabilities<br/>[Capabilities.php]"]
  node_onboarding["Business onboarding"]
end

subgraph group_operations["Business operations"]
  node_catalog["Services and hours<br/>[ServiceCatalog.php]"]
  node_price_import["Price-list import"]
  node_practitioners["Staff and schedules"]
  node_booking_controller["Planning interface"]
  node_booking_core["Booking core<br/>[BookingCore.php]"]
  node_bookings[("Appointments<br/>[Booking.php]")]
  node_billing["Plans and billing<br/>[BillingService.php]"]
  node_calendars["Calendar sync<br/>[CalendarSync.php]"]
  node_reports["Business reports<br/>[ReportService.php]"]
end

subgraph group_engagement["Customer engagement"]
  node_conversation["Conversation engine"]
  node_inbound["Inbound message handler"]
  node_customers[("Customer records<br/>[Customer.php]")]
  node_loyalty["Loyalty program<br/>[LoyaltyEngine.php]"]
  node_feedback["Feedback and reviews"]
  node_help["Help center<br/>[HelpCatalog.php]"]
end

subgraph group_platform["Platform administration"]
  node_admin["Super Admin<br/>[AdminDashboard.php]"]
  node_client_admin["Client management<br/>[ClientManager.php]"]
  node_platform_audit["Platform audit<br/>[PlatformAudit.php]"]
  node_support["Support tickets<br/>[TicketDesk.php]"]
end

subgraph group_account["Account services"]
  node_privacy["Data deletion"]
  node_identity[("Identity and security<br/>[User.php]")]
  node_api["Client API"]
end

node_client(("Business user"))

node_client -.->|"requests planning"| node_booking_controller
node_booking_controller -->|"delegates booking"| node_booking_core
node_booking_core -.->|"writes appointments"| node_bookings
node_client -.->|"sends message"| node_inbound
node_inbound -.->|"handles message"| node_conversation
node_conversation -->|"uses customer"| node_customers
node_conversation -->|"uses location"| node_location
node_tenant_context -->|"resolves permissions"| node_capabilities
node_tenant_context -->|"holds organization"| node_organization
node_organization -->|"owns locations"| node_location
node_onboarding -.->|"reads tenant"| node_tenant_context
node_client -.->|"administers platform"| node_admin
node_client_admin -->|"records actions"| node_platform_audit
node_client -.->|"requests erasure"| node_privacy

click node_tenant_context "https://github.com/fcomair/rendivoo/blob/main/app/Modules/Tenancy/Support/CurrentTenant.php"
click node_organization "https://github.com/fcomair/rendivoo/blob/main/app/Modules/Tenancy/Models/Organization.php"
click node_location "https://github.com/fcomair/rendivoo/blob/main/app/Modules/Tenancy/Models/Location.php"
click node_capabilities "https://github.com/fcomair/rendivoo/blob/main/app/Modules/Team/Support/Capabilities.php"
click node_onboarding "https://github.com/fcomair/rendivoo/blob/main/app/Modules/Onboarding/Http/Controllers/OnboardingController.php"
click node_catalog "https://github.com/fcomair/rendivoo/blob/main/app/Modules/Catalog/Services/ServiceCatalog.php"
click node_price_import "https://github.com/fcomair/rendivoo/blob/main/app/Modules/Catalog/Services/PriceListImporter.php"
click node_practitioners "https://github.com/fcomair/rendivoo/blob/main/app/Modules/Staff/Services/PractitionerManager.php"
click node_booking_controller "https://github.com/fcomair/rendivoo/blob/main/app/Modules/Booking/Http/Controllers/PlanningController.php"
click node_booking_core "https://github.com/fcomair/rendivoo/blob/main/app/Modules/Booking/Services/BookingCore.php"
click node_bookings "https://github.com/fcomair/rendivoo/blob/main/app/Modules/Booking/Models/Booking.php"
click node_billing "https://github.com/fcomair/rendivoo/blob/main/app/Modules/Billing/Services/BillingService.php"
click node_calendars "https://github.com/fcomair/rendivoo/blob/main/app/Modules/Calendars/Services/CalendarSync.php"
click node_reports "https://github.com/fcomair/rendivoo/blob/main/app/Modules/Reports/Services/ReportService.php"
click node_conversation "https://github.com/fcomair/rendivoo/blob/main/app/Modules/Conversation/Services/ConversationEngine.php"
click node_inbound "https://github.com/fcomair/rendivoo/blob/main/app/Modules/Conversation/Jobs/HandleInboundMessage.php"
click node_customers "https://github.com/fcomair/rendivoo/blob/main/app/Modules/Customers/Models/Customer.php"
click node_loyalty "https://github.com/fcomair/rendivoo/blob/main/app/Modules/Loyalty/Services/LoyaltyEngine.php"
click node_feedback "https://github.com/fcomair/rendivoo/blob/main/app/Modules/Feedback/Services/FeedbackService.php"
click node_help "https://github.com/fcomair/rendivoo/blob/main/app/Modules/Help/Support/HelpCatalog.php"
click node_admin "https://github.com/fcomair/rendivoo/blob/main/app/Modules/Admin/Filament/Pages/AdminDashboard.php"
click node_client_admin "https://github.com/fcomair/rendivoo/blob/main/app/Modules/Admin/Services/ClientManager.php"
click node_platform_audit "https://github.com/fcomair/rendivoo/blob/main/app/Modules/Admin/Services/PlatformAudit.php"
click node_support "https://github.com/fcomair/rendivoo/blob/main/app/Modules/Support/Services/TicketDesk.php"
click node_privacy "https://github.com/fcomair/rendivoo/blob/main/app/Modules/Privacy/Services/DeletionPipeline.php"
click node_identity "https://github.com/fcomair/rendivoo/blob/main/app/Modules/Identity/Models/User.php"
click node_api "https://github.com/fcomair/rendivoo/blob/main/app/Modules/Api/Http/Controllers/BookingApiController.php"

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_tenant_context,node_organization,node_location,node_capabilities,node_onboarding,node_client toneBlue
class node_catalog,node_price_import,node_practitioners,node_booking_controller,node_booking_core,node_bookings,node_billing,node_calendars,node_reports toneAmber
class node_conversation,node_inbound,node_customers,node_loyalty,node_feedback,node_help toneMint
class node_admin,node_client_admin,node_platform_audit,node_support toneRose
class node_privacy,node_identity,node_api toneIndigo
```

## Components

### Tenant foundation

- [Tenant context](https://github.com/fcomair/rendivoo/blob/main/app/Modules/Tenancy/Support/CurrentTenant.php): `app/Modules/Tenancy/Support/CurrentTenant.php`
- [Organizations](https://github.com/fcomair/rendivoo/blob/main/app/Modules/Tenancy/Models/Organization.php): `app/Modules/Tenancy/Models/Organization.php`
- [Business locations](https://github.com/fcomair/rendivoo/blob/main/app/Modules/Tenancy/Models/Location.php): `app/Modules/Tenancy/Models/Location.php`
- [Role capabilities](https://github.com/fcomair/rendivoo/blob/main/app/Modules/Team/Support/Capabilities.php): `app/Modules/Team/Support/Capabilities.php`
- [Business onboarding](https://github.com/fcomair/rendivoo/blob/main/app/Modules/Onboarding/Http/Controllers/OnboardingController.php): `app/Modules/Onboarding/Http/Controllers/OnboardingController.php`

### Business operations

- [Services and hours](https://github.com/fcomair/rendivoo/blob/main/app/Modules/Catalog/Services/ServiceCatalog.php): `app/Modules/Catalog/Services/ServiceCatalog.php`
- [Price-list import](https://github.com/fcomair/rendivoo/blob/main/app/Modules/Catalog/Services/PriceListImporter.php): `app/Modules/Catalog/Services/PriceListImporter.php`
- [Staff and schedules](https://github.com/fcomair/rendivoo/blob/main/app/Modules/Staff/Services/PractitionerManager.php): `app/Modules/Staff/Services/PractitionerManager.php`
- [Planning interface](https://github.com/fcomair/rendivoo/blob/main/app/Modules/Booking/Http/Controllers/PlanningController.php): `app/Modules/Booking/Http/Controllers/PlanningController.php`
- [Booking core](https://github.com/fcomair/rendivoo/blob/main/app/Modules/Booking/Services/BookingCore.php): `app/Modules/Booking/Services/BookingCore.php`
- [Appointments](https://github.com/fcomair/rendivoo/blob/main/app/Modules/Booking/Models/Booking.php): `app/Modules/Booking/Models/Booking.php`
- [Plans and billing](https://github.com/fcomair/rendivoo/blob/main/app/Modules/Billing/Services/BillingService.php): `app/Modules/Billing/Services/BillingService.php`
- [Calendar sync](https://github.com/fcomair/rendivoo/blob/main/app/Modules/Calendars/Services/CalendarSync.php): `app/Modules/Calendars/Services/CalendarSync.php`
- [Business reports](https://github.com/fcomair/rendivoo/blob/main/app/Modules/Reports/Services/ReportService.php): `app/Modules/Reports/Services/ReportService.php`

### Customer engagement

- [Conversation engine](https://github.com/fcomair/rendivoo/blob/main/app/Modules/Conversation/Services/ConversationEngine.php): `app/Modules/Conversation/Services/ConversationEngine.php`
- [Inbound message handler](https://github.com/fcomair/rendivoo/blob/main/app/Modules/Conversation/Jobs/HandleInboundMessage.php): `app/Modules/Conversation/Jobs/HandleInboundMessage.php`
- [Customer records](https://github.com/fcomair/rendivoo/blob/main/app/Modules/Customers/Models/Customer.php): `app/Modules/Customers/Models/Customer.php`
- [Loyalty program](https://github.com/fcomair/rendivoo/blob/main/app/Modules/Loyalty/Services/LoyaltyEngine.php): `app/Modules/Loyalty/Services/LoyaltyEngine.php`
- [Feedback and reviews](https://github.com/fcomair/rendivoo/blob/main/app/Modules/Feedback/Services/FeedbackService.php): `app/Modules/Feedback/Services/FeedbackService.php`
- [Help center](https://github.com/fcomair/rendivoo/blob/main/app/Modules/Help/Support/HelpCatalog.php): `app/Modules/Help/Support/HelpCatalog.php`

### Platform administration

- [Super Admin](https://github.com/fcomair/rendivoo/blob/main/app/Modules/Admin/Filament/Pages/AdminDashboard.php): `app/Modules/Admin/Filament/Pages/AdminDashboard.php`
- [Client management](https://github.com/fcomair/rendivoo/blob/main/app/Modules/Admin/Services/ClientManager.php): `app/Modules/Admin/Services/ClientManager.php`
- [Platform audit](https://github.com/fcomair/rendivoo/blob/main/app/Modules/Admin/Services/PlatformAudit.php): `app/Modules/Admin/Services/PlatformAudit.php`
- [Support tickets](https://github.com/fcomair/rendivoo/blob/main/app/Modules/Support/Services/TicketDesk.php): `app/Modules/Support/Services/TicketDesk.php`

### Account services

- [Data deletion](https://github.com/fcomair/rendivoo/blob/main/app/Modules/Privacy/Services/DeletionPipeline.php): `app/Modules/Privacy/Services/DeletionPipeline.php`
- [Identity and security](https://github.com/fcomair/rendivoo/blob/main/app/Modules/Identity/Models/User.php): `app/Modules/Identity/Models/User.php`
- [Client API](https://github.com/fcomair/rendivoo/blob/main/app/Modules/Api/Http/Controllers/BookingApiController.php): `app/Modules/Api/Http/Controllers/BookingApiController.php`

### Other components

- **Business user**

## Connections

- Business user → Planning interface: requests planning
- Planning interface → Booking core: delegates booking (evidence: `app/Modules/Booking/Http/Controllers/PlanningController.php`)
- Booking core → Appointments: writes appointments
- Business user → Inbound message handler: sends message
- Inbound message handler → Conversation engine: handles message
- Conversation engine → Customer records: uses customer (evidence: `app/Modules/Conversation/Services/ConversationEngine.php`)
- Conversation engine → Business locations: uses location (evidence: `app/Modules/Conversation/Services/ConversationEngine.php`)
- Tenant context → Role capabilities: resolves permissions (evidence: `app/Modules/Tenancy/Support/CurrentTenant.php`)
- Tenant context → Organizations: holds organization (evidence: `app/Modules/Tenancy/Support/CurrentTenant.php`)
- Organizations → Business locations: owns locations (evidence: `app/Modules/Tenancy/Models/Organization.php`)
- Business onboarding → Tenant context: reads tenant
- Business user → Super Admin: administers platform
- Client management → Platform audit: records actions
- Business user → Data deletion: requests erasure
