# seneu123123/capstonefinal architecture

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

## Overview

Holiday Travelers is a travel-tour operations and customer-booking application with traveler and operator views. The main traveler flow presents expedition packages, supports booking and reservation tracking, and exposes account and feedback features; the operator view covers package, booking, itinerary, logistics, finance, feedback, and settings work. The React application uses both browser storage and Supabase helpers, while a Laravel REST API provides a separate Sanctum/PostgreSQL integration. Several UI subsystems are documented but unsampled, so their internal call relationships are not inferred here.

Main entry points: [`laravel/routes/api.php`](https://github.com/seneu123123/capstonefinal/blob/main/laravel/routes/api.php) (Laravel REST API), [`src/App.tsx`](https://github.com/seneu123123/capstonefinal/blob/main/src/App.tsx) (Application Shell), [`src/components/client/ClientPortal.tsx`](https://github.com/seneu123123/capstonefinal/blob/main/src/components/client/ClientPortal.tsx) (Customer Portal), [`laravel/app/Http/Controllers/Api/BookingController.php`](https://github.com/seneu123123/capstonefinal/blob/main/laravel/app/Http/Controllers/Api/BookingController.php) (Booking API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_traveler["Traveler Experience"]
  node_app["Application Shell<br/>[App.tsx]"]
  node_clientportal["Customer Portal<br/>[ClientPortal.tsx]"]
  node_catalog["Expedition Catalog"]
  node_bookingtracker["Booking Tracker"]
  node_bookingportal["Booking Portal"]
  node_concierge["AI Concierge"]
  node_traveleraccount["Traveler Account<br/>[MyAccountModal.tsx]"]
  node_weather["Weather Radar"]
end

subgraph group_operations["Tour Operations"]
  node_adminportal["Operator Portal<br/>[AdminPortal.tsx]"]
  node_packages["Package Management"]
  node_manifest["Booking Manifest"]
  node_itinerary["Itinerary Scheduling"]
  node_reservations["Hotel Transport"]
  node_invoices["Invoices and Payments"]
  node_feedback["Feedback and CSAT"]
  node_settings["Agency Settings<br/>[SystemSettings.tsx]"]
end

subgraph group_services["Data and API Services"]
  node_localstorage[("Browser Storage<br/>[storage.ts]")]
  node_supabaseclient["Supabase Access<br/>[supabaseClient.ts]"]
  node_api["Laravel REST API<br/>[api.php]"]
  node_bookingapi["Booking API"]
  node_packageapi["Tour Package API"]
  node_invoiceapi["Invoice API"]
  node_itineraryapi["Itinerary API"]
  node_feedbackapi["Feedback API"]
  node_authapi["Sanctum Auth API"]
  node_voucherapi["Voucher API"]
  node_auditapi["Security Audit API"]
  node_bookingmodel["Booking Model<br/>[Booking.php]"]
  node_invoicemodel["Invoice Model<br/>[Invoice.php]"]
end

node_traveler(("Traveler"))
node_operator(("Agency Operator"))
node_supabase[("Supabase")]
node_postgres[("PostgreSQL")]

node_traveler -->|"uses"| node_app
node_operator -->|"uses"| node_app
node_app -->|"renders"| node_clientportal
node_clientportal -->|"renders"| node_catalog
node_clientportal -->|"renders"| node_bookingtracker
node_clientportal -->|"renders"| node_bookingportal
node_clientportal -->|"renders"| node_feedback
node_app -->|"renders"| node_adminportal
node_traveler -->|"browses"| node_catalog
node_traveler -->|"books tours"| node_bookingportal
node_traveler -->|"tracks booking"| node_bookingtracker
node_operator -->|"manages"| node_packages
node_operator -->|"manages"| node_manifest
node_operator -->|"schedules"| node_itinerary
node_operator -->|"allocates"| node_reservations
node_operator -->|"manages billing"| node_invoices
node_operator -->|"reviews"| node_feedback
node_operator -->|"configures"| node_settings
node_app -->|"saves packages"| node_localstorage
node_app -->|"saves bookings"| node_supabaseclient
node_supabaseclient -->|"reads and writes"| node_supabase
node_api -->|"routes to"| node_authapi
node_api -->|"routes to"| node_packageapi
node_api -->|"routes to"| node_bookingapi
node_api -->|"routes to"| node_itineraryapi
node_api -->|"routes to"| node_voucherapi
node_api -->|"routes to"| node_invoiceapi
node_api -->|"routes to"| node_feedbackapi
node_api -->|"routes to"| node_auditapi
node_bookingapi -->|"creates and queries"| node_bookingmodel
node_bookingapi -->|"loads relation"| node_invoicemodel
node_bookingapi -->|"checks package"| node_postgres
node_packageapi -->|"reads and writes"| node_postgres
node_app -.->|"integrates API"| node_api

click node_app "https://github.com/seneu123123/capstonefinal/blob/main/src/App.tsx"
click node_clientportal "https://github.com/seneu123123/capstonefinal/blob/main/src/components/client/ClientPortal.tsx"
click node_catalog "https://github.com/seneu123123/capstonefinal/blob/main/src/components/client/ClientExpeditions.tsx"
click node_bookingtracker "https://github.com/seneu123123/capstonefinal/blob/main/src/components/client/ClientBookingTracker.tsx"
click node_bookingportal "https://github.com/seneu123123/capstonefinal/blob/main/src/components/submodules/CustomerBookingPortal.tsx"
click node_concierge "https://github.com/seneu123123/capstonefinal/blob/main/src/components/client/AiCustomerConcierge.tsx"
click node_traveleraccount "https://github.com/seneu123123/capstonefinal/blob/main/src/components/client/MyAccountModal.tsx"
click node_weather "https://github.com/seneu123123/capstonefinal/blob/main/src/components/client/GlobalWeatherRadarModal.tsx"
click node_adminportal "https://github.com/seneu123123/capstonefinal/blob/main/src/components/admin/AdminPortal.tsx"
click node_packages "https://github.com/seneu123123/capstonefinal/blob/main/src/components/submodules/TourPackageManagement.tsx"
click node_manifest "https://github.com/seneu123123/capstonefinal/blob/main/src/components/submodules/ComprehensivePassengerManifest.tsx"
click node_itinerary "https://github.com/seneu123123/capstonefinal/blob/main/src/components/submodules/ItineraryScheduleManagement.tsx"
click node_reservations "https://github.com/seneu123123/capstonefinal/blob/main/src/components/submodules/HotelTransportReservation.tsx"
click node_invoices "https://github.com/seneu123123/capstonefinal/blob/main/src/components/submodules/PaymentInvoiceManagement.tsx"
click node_feedback "https://github.com/seneu123123/capstonefinal/blob/main/src/components/submodules/CustomerFeedbackRating.tsx"
click node_settings "https://github.com/seneu123123/capstonefinal/blob/main/src/components/submodules/SystemSettings.tsx"
click node_localstorage "https://github.com/seneu123123/capstonefinal/blob/main/src/utils/storage.ts"
click node_supabaseclient "https://github.com/seneu123123/capstonefinal/blob/main/src/utils/supabaseClient.ts"
click node_api "https://github.com/seneu123123/capstonefinal/blob/main/laravel/routes/api.php"
click node_bookingapi "https://github.com/seneu123123/capstonefinal/blob/main/laravel/app/Http/Controllers/Api/BookingController.php"
click node_packageapi "https://github.com/seneu123123/capstonefinal/blob/main/laravel/app/Http/Controllers/Api/TourPackageController.php"
click node_invoiceapi "https://github.com/seneu123123/capstonefinal/blob/main/laravel/app/Http/Controllers/Api/InvoiceController.php"
click node_itineraryapi "https://github.com/seneu123123/capstonefinal/blob/main/laravel/app/Http/Controllers/Api/ItineraryController.php"
click node_feedbackapi "https://github.com/seneu123123/capstonefinal/blob/main/laravel/app/Http/Controllers/Api/FeedbackController.php"
click node_authapi "https://github.com/seneu123123/capstonefinal/blob/main/laravel/app/Http/Controllers/Api/SanctumAuthController.php"
click node_voucherapi "https://github.com/seneu123123/capstonefinal/blob/main/laravel/app/Http/Controllers/Api/VoucherController.php"
click node_auditapi "https://github.com/seneu123123/capstonefinal/blob/main/laravel/app/Http/Controllers/Api/SecurityAuditController.php"
click node_bookingmodel "https://github.com/seneu123123/capstonefinal/blob/main/laravel/app/Models/Booking.php"
click node_invoicemodel "https://github.com/seneu123123/capstonefinal/blob/main/laravel/app/Models/Invoice.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_app,node_clientportal,node_catalog,node_bookingtracker,node_bookingportal,node_concierge,node_traveleraccount,node_weather toneBlue
class node_adminportal,node_packages,node_manifest,node_itinerary,node_reservations,node_invoices,node_feedback,node_settings,node_supabase,node_postgres toneAmber
class node_localstorage,node_supabaseclient,node_api,node_bookingapi,node_packageapi,node_invoiceapi,node_itineraryapi,node_feedbackapi,node_authapi,node_voucherapi,node_auditapi,node_bookingmodel,node_invoicemodel toneMint
class node_traveler,node_operator toneIndigo
```

## Components

### Traveler Experience

- [Application Shell](https://github.com/seneu123123/capstonefinal/blob/main/src/App.tsx): `src/App.tsx`
- [Customer Portal](https://github.com/seneu123123/capstonefinal/blob/main/src/components/client/ClientPortal.tsx): `src/components/client/ClientPortal.tsx`
- [Expedition Catalog](https://github.com/seneu123123/capstonefinal/blob/main/src/components/client/ClientExpeditions.tsx): `src/components/client/ClientExpeditions.tsx`
- [Booking Tracker](https://github.com/seneu123123/capstonefinal/blob/main/src/components/client/ClientBookingTracker.tsx): `src/components/client/ClientBookingTracker.tsx`
- [Booking Portal](https://github.com/seneu123123/capstonefinal/blob/main/src/components/submodules/CustomerBookingPortal.tsx): `src/components/submodules/CustomerBookingPortal.tsx`
- [AI Concierge](https://github.com/seneu123123/capstonefinal/blob/main/src/components/client/AiCustomerConcierge.tsx): `src/components/client/AiCustomerConcierge.tsx`
- [Traveler Account](https://github.com/seneu123123/capstonefinal/blob/main/src/components/client/MyAccountModal.tsx): `src/components/client/MyAccountModal.tsx`
- [Weather Radar](https://github.com/seneu123123/capstonefinal/blob/main/src/components/client/GlobalWeatherRadarModal.tsx): `src/components/client/GlobalWeatherRadarModal.tsx`

### Tour Operations

- [Operator Portal](https://github.com/seneu123123/capstonefinal/blob/main/src/components/admin/AdminPortal.tsx): `src/components/admin/AdminPortal.tsx`
- [Package Management](https://github.com/seneu123123/capstonefinal/blob/main/src/components/submodules/TourPackageManagement.tsx): `src/components/submodules/TourPackageManagement.tsx`
- [Booking Manifest](https://github.com/seneu123123/capstonefinal/blob/main/src/components/submodules/ComprehensivePassengerManifest.tsx): `src/components/submodules/ComprehensivePassengerManifest.tsx`
- [Itinerary Scheduling](https://github.com/seneu123123/capstonefinal/blob/main/src/components/submodules/ItineraryScheduleManagement.tsx): `src/components/submodules/ItineraryScheduleManagement.tsx`
- [Hotel Transport](https://github.com/seneu123123/capstonefinal/blob/main/src/components/submodules/HotelTransportReservation.tsx): `src/components/submodules/HotelTransportReservation.tsx`
- [Invoices and Payments](https://github.com/seneu123123/capstonefinal/blob/main/src/components/submodules/PaymentInvoiceManagement.tsx): `src/components/submodules/PaymentInvoiceManagement.tsx`
- [Feedback and CSAT](https://github.com/seneu123123/capstonefinal/blob/main/src/components/submodules/CustomerFeedbackRating.tsx): `src/components/submodules/CustomerFeedbackRating.tsx`
- [Agency Settings](https://github.com/seneu123123/capstonefinal/blob/main/src/components/submodules/SystemSettings.tsx): `src/components/submodules/SystemSettings.tsx`

### Data and API Services

- [Browser Storage](https://github.com/seneu123123/capstonefinal/blob/main/src/utils/storage.ts): `src/utils/storage.ts`
- [Supabase Access](https://github.com/seneu123123/capstonefinal/blob/main/src/utils/supabaseClient.ts): `src/utils/supabaseClient.ts`
- [Laravel REST API](https://github.com/seneu123123/capstonefinal/blob/main/laravel/routes/api.php): `laravel/routes/api.php`
- [Booking API](https://github.com/seneu123123/capstonefinal/blob/main/laravel/app/Http/Controllers/Api/BookingController.php): `laravel/app/Http/Controllers/Api/BookingController.php`
- [Tour Package API](https://github.com/seneu123123/capstonefinal/blob/main/laravel/app/Http/Controllers/Api/TourPackageController.php): `laravel/app/Http/Controllers/Api/TourPackageController.php`
- [Invoice API](https://github.com/seneu123123/capstonefinal/blob/main/laravel/app/Http/Controllers/Api/InvoiceController.php): `laravel/app/Http/Controllers/Api/InvoiceController.php`
- [Itinerary API](https://github.com/seneu123123/capstonefinal/blob/main/laravel/app/Http/Controllers/Api/ItineraryController.php): `laravel/app/Http/Controllers/Api/ItineraryController.php`
- [Feedback API](https://github.com/seneu123123/capstonefinal/blob/main/laravel/app/Http/Controllers/Api/FeedbackController.php): `laravel/app/Http/Controllers/Api/FeedbackController.php`
- [Sanctum Auth API](https://github.com/seneu123123/capstonefinal/blob/main/laravel/app/Http/Controllers/Api/SanctumAuthController.php): `laravel/app/Http/Controllers/Api/SanctumAuthController.php`
- [Voucher API](https://github.com/seneu123123/capstonefinal/blob/main/laravel/app/Http/Controllers/Api/VoucherController.php): `laravel/app/Http/Controllers/Api/VoucherController.php`
- [Security Audit API](https://github.com/seneu123123/capstonefinal/blob/main/laravel/app/Http/Controllers/Api/SecurityAuditController.php): `laravel/app/Http/Controllers/Api/SecurityAuditController.php`
- [Booking Model](https://github.com/seneu123123/capstonefinal/blob/main/laravel/app/Models/Booking.php): `laravel/app/Models/Booking.php`
- [Invoice Model](https://github.com/seneu123123/capstonefinal/blob/main/laravel/app/Models/Invoice.php): `laravel/app/Models/Invoice.php`

### Other components

- **Traveler**
- **Agency Operator**
- **Supabase**
- **PostgreSQL**

## Connections

- Traveler → Application Shell: uses
- Agency Operator → Application Shell: uses
- Application Shell → Customer Portal: renders (evidence: `src/App.tsx`)
- Customer Portal → Expedition Catalog: renders (evidence: `src/components/client/ClientPortal.tsx`)
- Customer Portal → Booking Tracker: renders (evidence: `src/components/client/ClientPortal.tsx`)
- Customer Portal → Booking Portal: renders (evidence: `src/components/client/ClientPortal.tsx`)
- Customer Portal → Feedback and CSAT: renders (evidence: `src/components/client/ClientPortal.tsx`)
- Application Shell → Operator Portal: renders (evidence: `src/App.tsx`)
- Traveler → Expedition Catalog: browses
- Traveler → Booking Portal: books tours
- Traveler → Booking Tracker: tracks booking
- Agency Operator → Package Management: manages
- Agency Operator → Booking Manifest: manages
- Agency Operator → Itinerary Scheduling: schedules
- Agency Operator → Hotel Transport: allocates
- Agency Operator → Invoices and Payments: manages billing
- Agency Operator → Feedback and CSAT: reviews
- Agency Operator → Agency Settings: configures
- Application Shell → Browser Storage: saves packages (evidence: `src/App.tsx`)
- Application Shell → Supabase Access: saves bookings (evidence: `src/App.tsx`)
- Supabase Access → Supabase: reads and writes (evidence: `src/utils/supabaseClient.ts`)
- Laravel REST API → Sanctum Auth API: routes to (evidence: `laravel/routes/api.php`)
- Laravel REST API → Tour Package API: routes to (evidence: `laravel/routes/api.php`)
- Laravel REST API → Booking API: routes to (evidence: `laravel/routes/api.php`)
- Laravel REST API → Itinerary API: routes to (evidence: `laravel/routes/api.php`)
- Laravel REST API → Voucher API: routes to (evidence: `laravel/routes/api.php`)
- Laravel REST API → Invoice API: routes to (evidence: `laravel/routes/api.php`)
- Laravel REST API → Feedback API: routes to (evidence: `laravel/routes/api.php`)
- Laravel REST API → Security Audit API: routes to (evidence: `laravel/routes/api.php`)
- Booking API → Booking Model: creates and queries (evidence: `laravel/app/Http/Controllers/Api/BookingController.php`)
- Booking API → Invoice Model: loads relation (evidence: `laravel/app/Http/Controllers/Api/BookingController.php`)
- Booking API → PostgreSQL: checks package (evidence: `laravel/app/Http/Controllers/Api/BookingController.php`)
- Tour Package API → PostgreSQL: reads and writes (evidence: `laravel/app/Http/Controllers/Api/TourPackageController.php`)
- Application Shell → Laravel REST API: integrates API
