# ibrahimelshishtawy/gouna-lifestyle-platform architecture

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

- Interactive diagram: https://gitdiagram.com/ibrahimelshishtawy/gouna-lifestyle-platform
- Repository: https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform

## Overview

Gouna Lifestyle Platform combines a multilingual public experience for stays, properties, experiences and events with a Laravel management backend and reservation checkout. Visitors discover listings, submit inquiries or book a stay; checkout obtains a quote, creates a booking and initiates payment. Administrators manage inventory and review bookings. The graph includes documented product branches even where their implementation was not sampled; those branches have no speculative call edges. Backend call edges are limited to relationships visible in the supplied excerpts or SOURCE INDEX.

Main entry points: [`backend/app/Http/Controllers/CheckoutController.php`](https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/backend/app/Http/Controllers/CheckoutController.php) (Checkout handler), [`frontend/src/app/admin/AdminLayoutClient.tsx`](https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/frontend/src/app/admin/AdminLayoutClient.tsx) (Management interface), [`backend/app/Http/Controllers/PropertyListingController.php`](https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/backend/app/Http/Controllers/PropertyListingController.php) (Property listing handler), [`frontend/src/app/(public)/layout.tsx`](https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/frontend/src/app/(public)/layout.tsx) (Public web experience)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public discovery"]
  node_public_ui["Public web experience<br/>[layout.tsx]"]
  node_property_browse["Property search<br/>[page.tsx]"]
  node_property_detail["Property details<br/>[page.tsx]"]
  node_experience_catalog["Experiences<br/>[page.tsx]"]
  node_event_discovery["Events and home<br/>[EventsSection.tsx]"]
  node_inquiries["Property inquiries"]
end

subgraph group_booking["Booking and payment"]
  node_checkout_ui["Checkout interface<br/>[CheckoutClient.tsx]"]
  node_checkout_handler["Checkout handler"]
  node_pricing["Booking pricing"]
  node_availability["Availability"]
  node_booking_create["Booking creation"]
  node_booking_records[("Bookings<br/>[Booking.php]")]
  node_payment["Payment processing"]
end

subgraph group_operations["Administration"]
  node_admin_ui["Management interface"]
  node_login["Admin authentication"]
  node_admin_dashboard["Admin dashboard"]
  node_property_admin["Property management"]
end

subgraph group_backend["Backend domain"]
  node_property_controller["Property listing handler"]
  node_property_search["Property search query"]
  node_property_records[("Property inventory<br/>[Property.php]")]
  node_experience_records[("Experience inventory<br/>[Experience.php]")]
  node_event_records[("Event inventory<br/>[Event.php]")]
  node_media["Media management<br/>[MediaService.php]"]
  node_activity[("Activity audit<br/>[ActivityLog.php]")]
end

node_visitor(("Visitor"))
node_admin_user(("Administrator"))

node_visitor -->|"browses"| node_public_ui
node_public_ui -->|"opens listings"| node_property_browse
node_visitor -->|"discovers"| node_experience_catalog
node_visitor -->|"discovers"| node_event_discovery
node_property_browse -.->|"requests listings"| node_property_controller
node_property_controller -->|"executes search"| node_property_search
node_property_search -->|"queries"| node_property_records
node_property_detail -.->|"requests details"| node_property_controller
node_visitor -.->|"submits inquiry"| node_inquiries
node_property_controller -->|"stores inquiry"| node_inquiries
node_visitor -->|"books stay"| node_checkout_ui
node_checkout_ui -.->|"submits checkout"| node_checkout_handler
node_checkout_handler -->|"gets quote"| node_pricing
node_checkout_handler -->|"creates booking"| node_booking_create
node_booking_create -.->|"persists booking"| node_booking_records
node_checkout_handler -->|"initiates payment"| node_payment
node_checkout_handler -.->|"checks availability"| node_availability
node_admin_user -->|"manages platform"| node_admin_ui
node_admin_ui -.->|"authenticates"| node_login
node_login -->|"records audit"| node_activity
node_admin_ui -.->|"views operations"| node_admin_dashboard
node_admin_dashboard -->|"reads bookings"| node_booking_records
node_admin_ui -.->|"manages inventory"| node_property_admin
node_property_admin -->|"uploads media"| node_media

click node_public_ui "https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/frontend/src/app/(public)/layout.tsx"
click node_property_browse "https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/frontend/src/app/(public)/stays/page.tsx"
click node_property_detail "https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/frontend/src/app/(public)/properties/%5Bslug%5D/page.tsx"
click node_experience_catalog "https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/frontend/src/app/(public)/experiences/page.tsx"
click node_event_discovery "https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/frontend/src/features/home/components/EventsSection.tsx"
click node_inquiries "https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/backend/app/Modules/Lead/Application/Actions/StoreInquiryLeadAction.php"
click node_property_controller "https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/backend/app/Http/Controllers/PropertyListingController.php"
click node_property_search "https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/backend/app/Modules/Property/Application/Queries/SearchPropertiesQuery.php"
click node_property_records "https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/backend/app/Models/Property.php"
click node_experience_records "https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/backend/app/Models/Experience.php"
click node_event_records "https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/backend/app/Models/Event.php"
click node_checkout_ui "https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/frontend/src/features/checkout/components/CheckoutClient.tsx"
click node_checkout_handler "https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/backend/app/Http/Controllers/CheckoutController.php"
click node_pricing "https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/backend/app/Modules/Pricing/Application/Queries/CalculateBookingQuoteQuery.php"
click node_availability "https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/backend/app/Services/AvailabilityService.php"
click node_booking_create "https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/backend/app/Modules/Booking/Application/Actions/CreateBookingAction.php"
click node_booking_records "https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/backend/app/Models/Booking.php"
click node_payment "https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/backend/app/Modules/Payment/Application/Actions/InitiatePaymentAction.php"
click node_admin_ui "https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/frontend/src/app/admin/AdminLayoutClient.tsx"
click node_login "https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/backend/app/Http/Controllers/Auth/LoginController.php"
click node_admin_dashboard "https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/backend/app/Http/Controllers/Admin/DashboardController.php"
click node_property_admin "https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/backend/app/Http/Controllers/Admin/PropertyController.php"
click node_media "https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/backend/app/Services/MediaService.php"
click node_activity "https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/backend/app/Models/ActivityLog.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_public_ui,node_property_browse,node_property_detail,node_experience_catalog,node_event_discovery,node_inquiries toneBlue
class node_checkout_ui,node_checkout_handler,node_pricing,node_availability,node_booking_create,node_booking_records,node_payment toneAmber
class node_admin_ui,node_login,node_admin_dashboard,node_property_admin toneMint
class node_property_controller,node_property_search,node_property_records,node_experience_records,node_event_records,node_media,node_activity toneRose
class node_visitor,node_admin_user toneIndigo
```

## Components

### Public discovery

- [Public web experience](https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/frontend/src/app/(public)/layout.tsx): `frontend/src/app/(public)/layout.tsx`
- [Property search](https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/frontend/src/app/(public)/stays/page.tsx): `frontend/src/app/(public)/stays/page.tsx`
- [Property details](https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/frontend/src/app/(public)/properties/%5Bslug%5D/page.tsx): `frontend/src/app/(public)/properties/[slug]/page.tsx`
- [Experiences](https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/frontend/src/app/(public)/experiences/page.tsx): `frontend/src/app/(public)/experiences/page.tsx`
- [Events and home](https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/frontend/src/features/home/components/EventsSection.tsx): `frontend/src/features/home/components/EventsSection.tsx`
- [Property inquiries](https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/backend/app/Modules/Lead/Application/Actions/StoreInquiryLeadAction.php): `backend/app/Modules/Lead/Application/Actions/StoreInquiryLeadAction.php`

### Booking and payment

- [Checkout interface](https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/frontend/src/features/checkout/components/CheckoutClient.tsx): `frontend/src/features/checkout/components/CheckoutClient.tsx`
- [Checkout handler](https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/backend/app/Http/Controllers/CheckoutController.php): `backend/app/Http/Controllers/CheckoutController.php`
- [Booking pricing](https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/backend/app/Modules/Pricing/Application/Queries/CalculateBookingQuoteQuery.php): `backend/app/Modules/Pricing/Application/Queries/CalculateBookingQuoteQuery.php`
- [Availability](https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/backend/app/Services/AvailabilityService.php): `backend/app/Services/AvailabilityService.php`
- [Booking creation](https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/backend/app/Modules/Booking/Application/Actions/CreateBookingAction.php): `backend/app/Modules/Booking/Application/Actions/CreateBookingAction.php`
- [Bookings](https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/backend/app/Models/Booking.php): `backend/app/Models/Booking.php`
- [Payment processing](https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/backend/app/Modules/Payment/Application/Actions/InitiatePaymentAction.php): `backend/app/Modules/Payment/Application/Actions/InitiatePaymentAction.php`

### Administration

- [Management interface](https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/frontend/src/app/admin/AdminLayoutClient.tsx): `frontend/src/app/admin/AdminLayoutClient.tsx`
- [Admin authentication](https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/backend/app/Http/Controllers/Auth/LoginController.php): `backend/app/Http/Controllers/Auth/LoginController.php`
- [Admin dashboard](https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/backend/app/Http/Controllers/Admin/DashboardController.php): `backend/app/Http/Controllers/Admin/DashboardController.php`
- [Property management](https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/backend/app/Http/Controllers/Admin/PropertyController.php): `backend/app/Http/Controllers/Admin/PropertyController.php`

### Backend domain

- [Property listing handler](https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/backend/app/Http/Controllers/PropertyListingController.php): `backend/app/Http/Controllers/PropertyListingController.php`
- [Property search query](https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/backend/app/Modules/Property/Application/Queries/SearchPropertiesQuery.php): `backend/app/Modules/Property/Application/Queries/SearchPropertiesQuery.php`
- [Property inventory](https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/backend/app/Models/Property.php): `backend/app/Models/Property.php`
- [Experience inventory](https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/backend/app/Models/Experience.php): `backend/app/Models/Experience.php`
- [Event inventory](https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/backend/app/Models/Event.php): `backend/app/Models/Event.php`
- [Media management](https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/backend/app/Services/MediaService.php): `backend/app/Services/MediaService.php`
- [Activity audit](https://github.com/ibrahimelshishtawy/gouna-lifestyle-platform/blob/main/backend/app/Models/ActivityLog.php): `backend/app/Models/ActivityLog.php`

### Other components

- **Visitor**
- **Administrator**

## Connections

- Visitor → Public web experience: browses (evidence: `README.md`)
- Public web experience → Property search: opens listings (evidence: `frontend/src/app/(public)/stays/page.tsx`)
- Visitor → Experiences: discovers (evidence: `README.md`)
- Visitor → Events and home: discovers (evidence: `README.md`)
- Property search → Property listing handler: requests listings
- Property listing handler → Property search query: executes search (evidence: `backend/app/Http/Controllers/PropertyListingController.php`)
- Property search query → Property inventory: queries (evidence: `backend/app/Modules/Property/Application/Queries/SearchPropertiesQuery.php`)
- Property details → Property listing handler: requests details
- Visitor → Property inquiries: submits inquiry
- Property listing handler → Property inquiries: stores inquiry (evidence: `backend/app/Http/Controllers/PropertyListingController.php`)
- Visitor → Checkout interface: books stay (evidence: `README.md`)
- Checkout interface → Checkout handler: submits checkout
- Checkout handler → Booking pricing: gets quote (evidence: `backend/app/Http/Controllers/CheckoutController.php`)
- Checkout handler → Booking creation: creates booking (evidence: `backend/app/Http/Controllers/CheckoutController.php`)
- Booking creation → Bookings: persists booking
- Checkout handler → Payment processing: initiates payment (evidence: `backend/app/Http/Controllers/CheckoutController.php`)
- Checkout handler → Availability: checks availability
- Administrator → Management interface: manages platform (evidence: `README.md`)
- Management interface → Admin authentication: authenticates
- Admin authentication → Activity audit: records audit (evidence: `backend/app/Http/Controllers/Auth/LoginController.php`)
- Management interface → Admin dashboard: views operations
- Admin dashboard → Bookings: reads bookings (evidence: `backend/app/Http/Controllers/Admin/DashboardController.php`)
- Management interface → Property management: manages inventory
- Property management → Media management: uploads media (evidence: `backend/app/Http/Controllers/Admin/PropertyController.php`)
