# aldr-solutions/isle-be-there architecture

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

- Interactive diagram: https://gitdiagram.com/aldr-solutions/isle-be-there
- Repository: https://github.com/aldr-solutions/isle-be-there

## Overview

Isle Be There is a travel platform for travelers and travel businesses. The main user journey is browsing listings, checking availability, and booking; supporting capabilities include itinerary planning, reviews, payments, business operations, and account management. The Vue app sends API requests to a FastAPI backend backed by PostgreSQL, with optional image storage and payment/email integrations. The graph follows documented capabilities and visible wiring; several domain modules are represented at their service layer because their router implementations were not excerpted.

Main entry points: [`backend/app/main.py`](https://github.com/aldr-solutions/isle-be-there/blob/main/backend/app/main.py) (FastAPI app), [`backend/app/modules/bookings/service.py`](https://github.com/aldr-solutions/isle-be-there/blob/main/backend/app/modules/bookings/service.py) (Bookings), [`frontend/src/services/api.js`](https://github.com/aldr-solutions/isle-be-there/blob/main/frontend/src/services/api.js) (API client), [`backend/app/modules/listings/service.py`](https://github.com/aldr-solutions/isle-be-there/blob/main/backend/app/modules/listings/service.py) (Listings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web application"]
  node_web_app["Vue app<br/>[App.vue]"]
  node_api_client["API client<br/>[api.js]"]
  node_auth_store["Auth state<br/>[auth.js]"]
  node_business_view["Business workspace<br/>[BusinessHome.vue]"]
  node_booking_ui["Booking UI"]
  node_itinerary_ui["Itinerary UI<br/>[Itinerary.vue]"]
end

subgraph group_backend["API foundation"]
  node_backend_app["FastAPI app<br/>[main.py]"]
  node_database[("PostgreSQL<br/>[engine.py]")]
end

subgraph group_travel["Travel operations"]
  node_listings["Listings<br/>[service.py]"]
  node_availability["Availability<br/>[service.py]"]
  node_bookings["Bookings<br/>[service.py]"]
  node_itineraries["Itinerary planning<br/>[planner.py]"]
  node_businesses["Business management<br/>[service.py]"]
  node_services["Bookable services<br/>[models.py]"]
  node_pricing["Pricing<br/>[service.py]"]
  node_discounts["Discounts<br/>[service.py]"]
  node_calendar["Calendar<br/>[service.py]"]
end

subgraph group_engagement["Discovery and engagement"]
  node_reviews["Reviews<br/>[service.py]"]
  node_recommendations["Recommendations<br/>[service.py]"]
  node_favourites["Favourites<br/>[service.py]"]
  node_interests["Interests<br/>[models.py]"]
end

subgraph group_platform["Shared services"]
  node_users["Accounts<br/>[models.py]"]
  node_payments["Stripe payments<br/>[service.py]"]
  node_storage["Image storage<br/>[storage.py]"]
end

node_traveler(("Traveler"))
node_business_user(("Business user"))
node_stripe["Stripe"]
node_supabase["Supabase storage"]

node_traveler -->|"uses"| node_web_app
node_business_user -->|"uses"| node_web_app
node_web_app -->|"checks auth"| node_auth_store
node_web_app -->|"loads API client"| node_api_client
node_booking_ui -.->|"submits requests"| node_api_client
node_itinerary_ui -.->|"plans trips"| node_api_client
node_business_view -.->|"manages business"| node_api_client
node_api_client -->|"sends API requests"| node_backend_app
node_backend_app -->|"configures engine"| node_database
node_backend_app -->|"registers routes"| node_listings
node_backend_app -->|"registers routes"| node_bookings
node_backend_app -->|"registers routes"| node_itineraries
node_bookings -->|"checks slots"| node_availability
node_bookings -->|"calculates prices"| node_pricing
node_bookings -->|"applies discounts"| node_discounts
node_bookings -->|"processes payments"| node_payments
node_payments -.->|"charges payments"| node_stripe
node_listings -->|"manages services"| node_services
node_itineraries -.->|"plans around listings"| node_listings
node_businesses -->|"uses account data"| node_users
node_reviews -->|"associates reviews"| node_listings
node_recommendations -.->|"uses preferences"| node_interests
node_favourites -.->|"saves listings"| node_listings
node_backend_app -->|"handles uploads"| node_storage
node_storage -.->|"uploads images"| node_supabase

click node_web_app "https://github.com/aldr-solutions/isle-be-there/blob/main/frontend/src/App.vue"
click node_api_client "https://github.com/aldr-solutions/isle-be-there/blob/main/frontend/src/services/api.js"
click node_auth_store "https://github.com/aldr-solutions/isle-be-there/blob/main/frontend/src/stores/auth.js"
click node_business_view "https://github.com/aldr-solutions/isle-be-there/blob/main/frontend/src/views/BusinessHome.vue"
click node_booking_ui "https://github.com/aldr-solutions/isle-be-there/blob/main/frontend/src/components/BookingFormCard.vue"
click node_itinerary_ui "https://github.com/aldr-solutions/isle-be-there/blob/main/frontend/src/views/Itinerary.vue"
click node_backend_app "https://github.com/aldr-solutions/isle-be-there/blob/main/backend/app/main.py"
click node_database "https://github.com/aldr-solutions/isle-be-there/blob/main/backend/app/infrastructure/database/engine.py"
click node_users "https://github.com/aldr-solutions/isle-be-there/blob/main/backend/app/modules/users/models.py"
click node_listings "https://github.com/aldr-solutions/isle-be-there/blob/main/backend/app/modules/listings/service.py"
click node_availability "https://github.com/aldr-solutions/isle-be-there/blob/main/backend/app/modules/availability/service.py"
click node_bookings "https://github.com/aldr-solutions/isle-be-there/blob/main/backend/app/modules/bookings/service.py"
click node_itineraries "https://github.com/aldr-solutions/isle-be-there/blob/main/backend/app/modules/itineraries/planner.py"
click node_businesses "https://github.com/aldr-solutions/isle-be-there/blob/main/backend/app/modules/businesses/service.py"
click node_services "https://github.com/aldr-solutions/isle-be-there/blob/main/backend/app/modules/services/models.py"
click node_pricing "https://github.com/aldr-solutions/isle-be-there/blob/main/backend/app/modules/pricing/service.py"
click node_discounts "https://github.com/aldr-solutions/isle-be-there/blob/main/backend/app/modules/discounts/service.py"
click node_calendar "https://github.com/aldr-solutions/isle-be-there/blob/main/backend/app/modules/calendar/service.py"
click node_reviews "https://github.com/aldr-solutions/isle-be-there/blob/main/backend/app/modules/reviews/service.py"
click node_recommendations "https://github.com/aldr-solutions/isle-be-there/blob/main/backend/app/modules/recommendations/service.py"
click node_favourites "https://github.com/aldr-solutions/isle-be-there/blob/main/backend/app/modules/favourites/service.py"
click node_interests "https://github.com/aldr-solutions/isle-be-there/blob/main/backend/app/modules/interests/models.py"
click node_payments "https://github.com/aldr-solutions/isle-be-there/blob/main/backend/app/modules/stripe_payment/service.py"
click node_storage "https://github.com/aldr-solutions/isle-be-there/blob/main/backend/app/infrastructure/storage.py"

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_web_app,node_api_client,node_auth_store,node_business_view,node_booking_ui,node_itinerary_ui,node_business_user toneBlue
class node_backend_app,node_database,node_supabase toneAmber
class node_listings,node_availability,node_bookings,node_itineraries,node_businesses,node_services,node_pricing,node_discounts,node_calendar toneMint
class node_reviews,node_recommendations,node_favourites,node_interests toneRose
class node_users,node_payments,node_storage,node_traveler,node_stripe toneIndigo
```

## Components

### Web application

- [Vue app](https://github.com/aldr-solutions/isle-be-there/blob/main/frontend/src/App.vue): `frontend/src/App.vue`
- [API client](https://github.com/aldr-solutions/isle-be-there/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`
- [Auth state](https://github.com/aldr-solutions/isle-be-there/blob/main/frontend/src/stores/auth.js): `frontend/src/stores/auth.js`
- [Business workspace](https://github.com/aldr-solutions/isle-be-there/blob/main/frontend/src/views/BusinessHome.vue): `frontend/src/views/BusinessHome.vue`
- [Booking UI](https://github.com/aldr-solutions/isle-be-there/blob/main/frontend/src/components/BookingFormCard.vue): `frontend/src/components/BookingFormCard.vue`
- [Itinerary UI](https://github.com/aldr-solutions/isle-be-there/blob/main/frontend/src/views/Itinerary.vue): `frontend/src/views/Itinerary.vue`

### API foundation

- [FastAPI app](https://github.com/aldr-solutions/isle-be-there/blob/main/backend/app/main.py): `backend/app/main.py`
- [PostgreSQL](https://github.com/aldr-solutions/isle-be-there/blob/main/backend/app/infrastructure/database/engine.py): `backend/app/infrastructure/database/engine.py`

### Travel operations

- [Listings](https://github.com/aldr-solutions/isle-be-there/blob/main/backend/app/modules/listings/service.py): `backend/app/modules/listings/service.py`
- [Availability](https://github.com/aldr-solutions/isle-be-there/blob/main/backend/app/modules/availability/service.py): `backend/app/modules/availability/service.py`
- [Bookings](https://github.com/aldr-solutions/isle-be-there/blob/main/backend/app/modules/bookings/service.py): `backend/app/modules/bookings/service.py`
- [Itinerary planning](https://github.com/aldr-solutions/isle-be-there/blob/main/backend/app/modules/itineraries/planner.py): `backend/app/modules/itineraries/planner.py`
- [Business management](https://github.com/aldr-solutions/isle-be-there/blob/main/backend/app/modules/businesses/service.py): `backend/app/modules/businesses/service.py`
- [Bookable services](https://github.com/aldr-solutions/isle-be-there/blob/main/backend/app/modules/services/models.py): `backend/app/modules/services/models.py`
- [Pricing](https://github.com/aldr-solutions/isle-be-there/blob/main/backend/app/modules/pricing/service.py): `backend/app/modules/pricing/service.py`
- [Discounts](https://github.com/aldr-solutions/isle-be-there/blob/main/backend/app/modules/discounts/service.py): `backend/app/modules/discounts/service.py`
- [Calendar](https://github.com/aldr-solutions/isle-be-there/blob/main/backend/app/modules/calendar/service.py): `backend/app/modules/calendar/service.py`

### Discovery and engagement

- [Reviews](https://github.com/aldr-solutions/isle-be-there/blob/main/backend/app/modules/reviews/service.py): `backend/app/modules/reviews/service.py`
- [Recommendations](https://github.com/aldr-solutions/isle-be-there/blob/main/backend/app/modules/recommendations/service.py): `backend/app/modules/recommendations/service.py`
- [Favourites](https://github.com/aldr-solutions/isle-be-there/blob/main/backend/app/modules/favourites/service.py): `backend/app/modules/favourites/service.py`
- [Interests](https://github.com/aldr-solutions/isle-be-there/blob/main/backend/app/modules/interests/models.py): `backend/app/modules/interests/models.py`

### Shared services

- [Accounts](https://github.com/aldr-solutions/isle-be-there/blob/main/backend/app/modules/users/models.py): `backend/app/modules/users/models.py`
- [Stripe payments](https://github.com/aldr-solutions/isle-be-there/blob/main/backend/app/modules/stripe_payment/service.py): `backend/app/modules/stripe_payment/service.py`
- [Image storage](https://github.com/aldr-solutions/isle-be-there/blob/main/backend/app/infrastructure/storage.py): `backend/app/infrastructure/storage.py`

### Other components

- **Traveler**
- **Business user**
- **Stripe**
- **Supabase storage**

## Connections

- Traveler → Vue app: uses
- Business user → Vue app: uses
- Vue app → Auth state: checks auth (evidence: `frontend/src/App.vue`)
- Vue app → API client: loads API client (evidence: `frontend/src/main.js`)
- Booking UI → API client: submits requests
- Itinerary UI → API client: plans trips
- Business workspace → API client: manages business
- API client → FastAPI app: sends API requests
- FastAPI app → PostgreSQL: configures engine (evidence: `backend/app/infrastructure/database/engine.py`)
- FastAPI app → Listings: registers routes (evidence: `backend/app/main.py`)
- FastAPI app → Bookings: registers routes (evidence: `backend/app/main.py`)
- FastAPI app → Itinerary planning: registers routes (evidence: `backend/app/main.py`)
- Bookings → Availability: checks slots (evidence: `backend/app/modules/bookings/service.py`)
- Bookings → Pricing: calculates prices (evidence: `backend/app/modules/bookings/service.py`)
- Bookings → Discounts: applies discounts (evidence: `backend/app/modules/bookings/service.py`)
- Bookings → Stripe payments: processes payments (evidence: `backend/app/modules/bookings/service.py`)
- Stripe payments → Stripe: charges payments
- Listings → Bookable services: manages services (evidence: `backend/app/modules/listings/service.py`)
- Itinerary planning → Listings: plans around listings
- Business management → Accounts: uses account data (evidence: `backend/app/modules/businesses/service.py`)
- Reviews → Listings: associates reviews (evidence: `backend/app/modules/reviews/service.py`)
- Recommendations → Interests: uses preferences
- Favourites → Listings: saves listings
- FastAPI app → Image storage: handles uploads (evidence: `backend/app/main.py`)
- Image storage → Supabase storage: uploads images
