# pothe/theworloasis architecture

> Architecture diagram of the GitHub repository pothe/theworloasis, 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/pothe/theworloasis
- Repository: https://github.com/pothe/theworloasis

## Overview

The Wild Oasis is a hotel-operations dashboard for managing cabins, bookings, settings, and daily activity. Staff enter through the routed React app, then use domain pages and query/service layers to retrieve or change Supabase data. The graph preserves the documented booking, cabin, check-in, dashboard, authentication, and settings areas; source excerpts are incomplete, so uncertain page-to-feature wiring is omitted or marked unverified.

Main entry points: [`17-The Wild Oasis/src/App.jsx`](https://github.com/pothe/theworloasis/blob/main/17-The%20Wild%20Oasis/src/App.jsx) (Routed application), [`17-The Wild Oasis/src/services/supabase.js`](https://github.com/pothe/theworloasis/blob/main/17-The%20Wild%20Oasis/src/services/supabase.js) (Supabase client), [`17-The Wild Oasis/src/services/apiBookings.js`](https://github.com/pothe/theworloasis/blob/main/17-The%20Wild%20Oasis/src/services/apiBookings.js) (Booking service), [`17-The Wild Oasis/src/pages/Bookings.jsx`](https://github.com/pothe/theworloasis/blob/main/17-The%20Wild%20Oasis/src/pages/Bookings.jsx) (Bookings page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application shell"]
  node_app["Routed application<br/>[App.jsx]"]
  node_layout["App layout<br/>[AppLayout.jsx]"]
  node_login["Login page<br/>[Login.jsx]"]
end

subgraph group_booking["Booking operations"]
  node_bookings_page["Bookings page<br/>[Bookings.jsx]"]
  node_booking_table["Booking table<br/>[BookingTable.jsx]"]
  node_booking_detail["Booking detail<br/>[BookingDetail.jsx]"]
  node_booking_query["Booking queries<br/>[useBookings.js]"]
  node_booking_api["Booking service<br/>[apiBookings.js]"]
  node_checkin["Check-in workflow<br/>[CheckinBooking.jsx]"]
end

subgraph group_property["Property and settings"]
  node_cabins_page["Cabins page<br/>[Cabins.jsx]"]
  node_cabins["Cabin management<br/>[CabinTable.jsx]"]
  node_cabin_api["Cabin service<br/>[apiCabins.js]"]
  node_settings_page["Settings page<br/>[Settings.jsx]"]
  node_settings_form["Settings editor"]
  node_settings_api["Settings service<br/>[apiSettings.js]"]
  node_supabase["Supabase client<br/>[supabase.js]"]
end

subgraph group_insight["Dashboard and shared UI"]
  node_dashboard_page["Dashboard page<br/>[Dashboard.jsx]"]
  node_dashboard_charts["Dashboard analytics<br/>[DurationChart.jsx]"]
  node_shared_ui["Shared interface<br/>[Heading.jsx]"]
end

node_staff(("Hotel staff"))
node_database[("Supabase data store")]

node_staff -.->|"uses"| node_app
node_app -->|"routes through"| node_layout
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_bookings_page
node_app -->|"routes to"| node_cabins_page
node_app -->|"routes to"| node_settings_page
node_app -->|"routes to"| node_dashboard_page
node_bookings_page -->|"renders"| node_booking_table
node_booking_table -.->|"loads"| node_booking_query
node_booking_query -->|"calls"| node_booking_api
node_booking_detail -->|"loads booking"| node_booking_api
node_checkin -->|"displays details"| node_booking_detail
node_cabins_page -->|"renders"| node_cabins
node_cabins -.->|"manages cabins"| node_cabin_api
node_settings_page -->|"renders"| node_settings_form
node_settings_form -.->|"updates settings"| node_settings_api
node_dashboard_page -.->|"shows analytics"| node_dashboard_charts
node_settings_api -->|"queries"| node_supabase
node_cabin_api -->|"queries"| node_supabase
node_booking_api -->|"queries"| node_supabase
node_supabase -.->|"reads and writes"| node_database

click node_app "https://github.com/pothe/theworloasis/blob/main/17-The%20Wild%20Oasis/src/App.jsx"
click node_layout "https://github.com/pothe/theworloasis/blob/main/17-The%20Wild%20Oasis/src/ui/AppLayout.jsx"
click node_login "https://github.com/pothe/theworloasis/blob/main/17-The%20Wild%20Oasis/src/pages/Login.jsx"
click node_bookings_page "https://github.com/pothe/theworloasis/blob/main/17-The%20Wild%20Oasis/src/pages/Bookings.jsx"
click node_booking_table "https://github.com/pothe/theworloasis/blob/main/17-The%20Wild%20Oasis/src/features/bookings/BookingTable.jsx"
click node_booking_detail "https://github.com/pothe/theworloasis/blob/main/17-The%20Wild%20Oasis/src/features/bookings/BookingDetail.jsx"
click node_booking_query "https://github.com/pothe/theworloasis/blob/main/17-The%20Wild%20Oasis/src/features/bookings/useBookings.js"
click node_booking_api "https://github.com/pothe/theworloasis/blob/main/17-The%20Wild%20Oasis/src/services/apiBookings.js"
click node_checkin "https://github.com/pothe/theworloasis/blob/main/17-The%20Wild%20Oasis/src/features/check-in-out/CheckinBooking.jsx"
click node_cabins_page "https://github.com/pothe/theworloasis/blob/main/17-The%20Wild%20Oasis/src/pages/Cabins.jsx"
click node_cabins "https://github.com/pothe/theworloasis/blob/main/17-The%20Wild%20Oasis/src/features/cabins/CabinTable.jsx"
click node_cabin_api "https://github.com/pothe/theworloasis/blob/main/17-The%20Wild%20Oasis/src/services/apiCabins.js"
click node_settings_page "https://github.com/pothe/theworloasis/blob/main/17-The%20Wild%20Oasis/src/pages/Settings.jsx"
click node_settings_form "https://github.com/pothe/theworloasis/blob/main/17-The%20Wild%20Oasis/src/features/settings/UpdateSettingsForm.jsx"
click node_settings_api "https://github.com/pothe/theworloasis/blob/main/17-The%20Wild%20Oasis/src/services/apiSettings.js"
click node_dashboard_page "https://github.com/pothe/theworloasis/blob/main/17-The%20Wild%20Oasis/src/pages/Dashboard.jsx"
click node_dashboard_charts "https://github.com/pothe/theworloasis/blob/main/17-The%20Wild%20Oasis/src/features/dashboard/DurationChart.jsx"
click node_shared_ui "https://github.com/pothe/theworloasis/blob/main/17-The%20Wild%20Oasis/src/ui/Heading.jsx"
click node_supabase "https://github.com/pothe/theworloasis/blob/main/17-The%20Wild%20Oasis/src/services/supabase.js"

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_layout,node_login toneBlue
class node_bookings_page,node_booking_table,node_booking_detail,node_booking_query,node_booking_api,node_checkin,node_database toneAmber
class node_cabins_page,node_cabins,node_cabin_api,node_settings_page,node_settings_form,node_settings_api,node_supabase toneMint
class node_dashboard_page,node_dashboard_charts,node_shared_ui toneRose
class node_staff toneIndigo
```

## Components

### Application shell

- [Routed application](https://github.com/pothe/theworloasis/blob/main/17-The%20Wild%20Oasis/src/App.jsx): `17-The Wild Oasis/src/App.jsx`
- [App layout](https://github.com/pothe/theworloasis/blob/main/17-The%20Wild%20Oasis/src/ui/AppLayout.jsx): `17-The Wild Oasis/src/ui/AppLayout.jsx`
- [Login page](https://github.com/pothe/theworloasis/blob/main/17-The%20Wild%20Oasis/src/pages/Login.jsx): `17-The Wild Oasis/src/pages/Login.jsx`

### Booking operations

- [Bookings page](https://github.com/pothe/theworloasis/blob/main/17-The%20Wild%20Oasis/src/pages/Bookings.jsx): `17-The Wild Oasis/src/pages/Bookings.jsx`
- [Booking table](https://github.com/pothe/theworloasis/blob/main/17-The%20Wild%20Oasis/src/features/bookings/BookingTable.jsx): `17-The Wild Oasis/src/features/bookings/BookingTable.jsx`
- [Booking detail](https://github.com/pothe/theworloasis/blob/main/17-The%20Wild%20Oasis/src/features/bookings/BookingDetail.jsx): `17-The Wild Oasis/src/features/bookings/BookingDetail.jsx`
- [Booking queries](https://github.com/pothe/theworloasis/blob/main/17-The%20Wild%20Oasis/src/features/bookings/useBookings.js): `17-The Wild Oasis/src/features/bookings/useBookings.js`
- [Booking service](https://github.com/pothe/theworloasis/blob/main/17-The%20Wild%20Oasis/src/services/apiBookings.js): `17-The Wild Oasis/src/services/apiBookings.js`
- [Check-in workflow](https://github.com/pothe/theworloasis/blob/main/17-The%20Wild%20Oasis/src/features/check-in-out/CheckinBooking.jsx): `17-The Wild Oasis/src/features/check-in-out/CheckinBooking.jsx`

### Property and settings

- [Cabins page](https://github.com/pothe/theworloasis/blob/main/17-The%20Wild%20Oasis/src/pages/Cabins.jsx): `17-The Wild Oasis/src/pages/Cabins.jsx`
- [Cabin management](https://github.com/pothe/theworloasis/blob/main/17-The%20Wild%20Oasis/src/features/cabins/CabinTable.jsx): `17-The Wild Oasis/src/features/cabins/CabinTable.jsx`
- [Cabin service](https://github.com/pothe/theworloasis/blob/main/17-The%20Wild%20Oasis/src/services/apiCabins.js): `17-The Wild Oasis/src/services/apiCabins.js`
- [Settings page](https://github.com/pothe/theworloasis/blob/main/17-The%20Wild%20Oasis/src/pages/Settings.jsx): `17-The Wild Oasis/src/pages/Settings.jsx`
- [Settings editor](https://github.com/pothe/theworloasis/blob/main/17-The%20Wild%20Oasis/src/features/settings/UpdateSettingsForm.jsx): `17-The Wild Oasis/src/features/settings/UpdateSettingsForm.jsx`
- [Settings service](https://github.com/pothe/theworloasis/blob/main/17-The%20Wild%20Oasis/src/services/apiSettings.js): `17-The Wild Oasis/src/services/apiSettings.js`
- [Supabase client](https://github.com/pothe/theworloasis/blob/main/17-The%20Wild%20Oasis/src/services/supabase.js): `17-The Wild Oasis/src/services/supabase.js`

### Dashboard and shared UI

- [Dashboard page](https://github.com/pothe/theworloasis/blob/main/17-The%20Wild%20Oasis/src/pages/Dashboard.jsx): `17-The Wild Oasis/src/pages/Dashboard.jsx`
- [Dashboard analytics](https://github.com/pothe/theworloasis/blob/main/17-The%20Wild%20Oasis/src/features/dashboard/DurationChart.jsx): `17-The Wild Oasis/src/features/dashboard/DurationChart.jsx`
- [Shared interface](https://github.com/pothe/theworloasis/blob/main/17-The%20Wild%20Oasis/src/ui/Heading.jsx): `17-The Wild Oasis/src/ui/Heading.jsx`

### Other components

- **Hotel staff**
- **Supabase data store**

## Connections

- Hotel staff → Routed application: uses
- Routed application → App layout: routes through (evidence: `17-The Wild Oasis/src/App.jsx`)
- Routed application → Login page: routes to (evidence: `17-The Wild Oasis/src/App.jsx`)
- Routed application → Bookings page: routes to (evidence: `17-The Wild Oasis/src/App.jsx`)
- Routed application → Cabins page: routes to (evidence: `17-The Wild Oasis/src/App.jsx`)
- Routed application → Settings page: routes to (evidence: `17-The Wild Oasis/src/App.jsx`)
- Routed application → Dashboard page: routes to (evidence: `17-The Wild Oasis/src/App.jsx`)
- Bookings page → Booking table: renders (evidence: `17-The Wild Oasis/src/pages/Bookings.jsx`)
- Booking table → Booking queries: loads
- Booking queries → Booking service: calls (evidence: `17-The Wild Oasis/src/features/bookings/useBookings.js`)
- Booking detail → Booking service: loads booking
- Check-in workflow → Booking detail: displays details (evidence: `17-The Wild Oasis/src/features/check-in-out/CheckinBooking.jsx`)
- Cabins page → Cabin management: renders (evidence: `17-The Wild Oasis/src/pages/Cabins.jsx`)
- Cabin management → Cabin service: manages cabins
- Settings page → Settings editor: renders (evidence: `17-The Wild Oasis/src/pages/Settings.jsx`)
- Settings editor → Settings service: updates settings
- Dashboard page → Dashboard analytics: shows analytics
- Settings service → Supabase client: queries (evidence: `17-The Wild Oasis/src/services/apiSettings.js`)
- Cabin service → Supabase client: queries (evidence: `17-The Wild Oasis/src/services/apiCabins.js`)
- Booking service → Supabase client: queries (evidence: `17-The Wild Oasis/src/services/apiBookings.js`)
- Supabase client → Supabase data store: reads and writes
