# pirathee587/travelhub architecture

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

- Interactive diagram: https://gitdiagram.com/pirathee587/travelhub
- Repository: https://github.com/pirathee587/travelhub

## Overview

TravelHub is a multi-role travel booking and management platform: tourists discover and book trips, while agencies, hotel owners, and administrators manage listings and operations. The React application routes users to a Spring Boot REST API; its domain services persist platform data in PostgreSQL. A separate FastAPI chatbot provides RAG-based travel assistance and syncs backend data. The graph preserves the README’s major product areas; detailed links are limited to sampled source or documented architecture, so unsampled domain relationships are not inferred.

Main entry points: [`backend/src/main/java/com/travelhub/backend/controller`](https://github.com/pirathee587/travelhub/tree/main/backend/src/main/java/com/travelhub/backend/controller) (REST API controllers), [`frontend/src/App.tsx`](https://github.com/pirathee587/travelhub/blob/main/frontend/src/App.tsx) (React application), [`backend/src/main/java/com/travelhub/backend/service/ReviewService.java`](https://github.com/pirathee587/travelhub/blob/main/backend/src/main/java/com/travelhub/backend/service/ReviewService.java) (Review management), [`backend/src/main/java/com/travelhub/backend/service/AuthService.java`](https://github.com/pirathee587/travelhub/blob/main/backend/src/main/java/com/travelhub/backend/service/AuthService.java) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User Experience"]
  node_web["React application<br/>[App.tsx]"]
  node_role_routes["Role routes"]
  node_auth_ui["Authentication UI"]
end

subgraph group_travel["Travel Operations"]
  node_reviews_api["Review endpoints"]
  node_reviews["Review management<br/>[ReviewService.java]"]
  node_review_data["Review persistence"]
  node_image_upload["Image uploads"]
  node_agent_reviews["Agency review replies"]
  node_domain_services["Travel and role services"]
end

subgraph group_platform["Platform Services"]
  node_api["REST API controllers"]
  node_auth_service["Authentication<br/>[AuthService.java]"]
  node_email["Email delivery<br/>[EmailService.java]"]
  node_domain_data[("Domain entities and repositories")]
end

subgraph group_assistant["AI Assistant"]
  node_chatbot_api["Chatbot service<br/>[main.py]"]
  node_chatbot_sync["Backend data sync<br/>[data_sync.py]"]
end

node_traveler(("Platform users"))
node_postgres[("PostgreSQL")]
node_groq["Groq LLM"]
node_supabase_storage[("Supabase storage")]
node_payhere["PayHere gateway"]

node_traveler -->|"uses"| node_web
node_web -->|"routes to"| node_role_routes
node_role_routes -->|"routes to"| node_auth_ui
node_web -->|"REST requests"| node_api
node_web -.->|"requests assistance"| node_chatbot_api
node_api -.->|"delegates auth"| node_auth_service
node_auth_service -->|"sends messages"| node_email
node_auth_service -->|"reads and writes users"| node_domain_data
node_reviews_api -->|"delegates reviews"| node_reviews
node_reviews -->|"reads and writes"| node_review_data
node_reviews -->|"uploads images"| node_image_upload
node_agent_reviews -->|"reads and updates"| node_review_data
node_api -.->|"dispatches requests"| node_domain_services
node_domain_services -.->|"accesses records"| node_domain_data
node_domain_data -->|"persists data"| node_postgres
node_chatbot_api -->|"uses sync module"| node_chatbot_sync
node_chatbot_api -->|"calls LLM"| node_groq
node_chatbot_sync -.->|"syncs backend data"| node_api
node_image_upload -.->|"stores images"| node_supabase_storage
node_api -.->|"integrates payments"| node_payhere

click node_web "https://github.com/pirathee587/travelhub/blob/main/frontend/src/App.tsx"
click node_role_routes "https://github.com/pirathee587/travelhub/tree/main/frontend/src/routes"
click node_auth_ui "https://github.com/pirathee587/travelhub/tree/main/frontend/src/auth"
click node_api "https://github.com/pirathee587/travelhub/tree/main/backend/src/main/java/com/travelhub/backend/controller"
click node_auth_service "https://github.com/pirathee587/travelhub/blob/main/backend/src/main/java/com/travelhub/backend/service/AuthService.java"
click node_email "https://github.com/pirathee587/travelhub/blob/main/backend/src/main/java/com/travelhub/backend/service/EmailService.java"
click node_reviews_api "https://github.com/pirathee587/travelhub/blob/main/backend/src/main/java/com/travelhub/backend/controller/ReviewController.java"
click node_reviews "https://github.com/pirathee587/travelhub/blob/main/backend/src/main/java/com/travelhub/backend/service/ReviewService.java"
click node_review_data "https://github.com/pirathee587/travelhub/blob/main/backend/src/main/java/com/travelhub/backend/repository/ReviewRepository.java"
click node_image_upload "https://github.com/pirathee587/travelhub/blob/main/backend/src/main/java/com/travelhub/backend/service/ImageUploadService.java"
click node_agent_reviews "https://github.com/pirathee587/travelhub/blob/main/backend/src/main/java/com/travelhub/backend/service/AgentReviewService.java"
click node_domain_services "https://github.com/pirathee587/travelhub/tree/main/backend/src/main/java/com/travelhub/backend/service"
click node_domain_data "https://github.com/pirathee587/travelhub/tree/main/backend/src/main/java/com/travelhub/backend/entity"
click node_chatbot_api "https://github.com/pirathee587/travelhub/blob/main/chatbot-service/main.py"
click node_chatbot_sync "https://github.com/pirathee587/travelhub/blob/main/chatbot-service/data_sync.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,node_role_routes,node_auth_ui,node_traveler toneBlue
class node_reviews_api,node_reviews,node_review_data,node_image_upload,node_agent_reviews,node_domain_services,node_postgres,node_supabase_storage toneAmber
class node_api,node_auth_service,node_email,node_domain_data toneMint
class node_chatbot_api,node_chatbot_sync toneRose
class node_groq,node_payhere toneIndigo
```

## Components

### User Experience

- [React application](https://github.com/pirathee587/travelhub/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Role routes](https://github.com/pirathee587/travelhub/tree/main/frontend/src/routes): `frontend/src/routes`
- [Authentication UI](https://github.com/pirathee587/travelhub/tree/main/frontend/src/auth): `frontend/src/auth`

### Travel Operations

- [Review endpoints](https://github.com/pirathee587/travelhub/blob/main/backend/src/main/java/com/travelhub/backend/controller/ReviewController.java): `backend/src/main/java/com/travelhub/backend/controller/ReviewController.java`
- [Review management](https://github.com/pirathee587/travelhub/blob/main/backend/src/main/java/com/travelhub/backend/service/ReviewService.java): `backend/src/main/java/com/travelhub/backend/service/ReviewService.java`
- [Review persistence](https://github.com/pirathee587/travelhub/blob/main/backend/src/main/java/com/travelhub/backend/repository/ReviewRepository.java): `backend/src/main/java/com/travelhub/backend/repository/ReviewRepository.java`
- [Image uploads](https://github.com/pirathee587/travelhub/blob/main/backend/src/main/java/com/travelhub/backend/service/ImageUploadService.java): `backend/src/main/java/com/travelhub/backend/service/ImageUploadService.java`
- [Agency review replies](https://github.com/pirathee587/travelhub/blob/main/backend/src/main/java/com/travelhub/backend/service/AgentReviewService.java): `backend/src/main/java/com/travelhub/backend/service/AgentReviewService.java`
- [Travel and role services](https://github.com/pirathee587/travelhub/tree/main/backend/src/main/java/com/travelhub/backend/service): `backend/src/main/java/com/travelhub/backend/service`

### Platform Services

- [REST API controllers](https://github.com/pirathee587/travelhub/tree/main/backend/src/main/java/com/travelhub/backend/controller): `backend/src/main/java/com/travelhub/backend/controller`
- [Authentication](https://github.com/pirathee587/travelhub/blob/main/backend/src/main/java/com/travelhub/backend/service/AuthService.java): `backend/src/main/java/com/travelhub/backend/service/AuthService.java`
- [Email delivery](https://github.com/pirathee587/travelhub/blob/main/backend/src/main/java/com/travelhub/backend/service/EmailService.java): `backend/src/main/java/com/travelhub/backend/service/EmailService.java`
- [Domain entities and repositories](https://github.com/pirathee587/travelhub/tree/main/backend/src/main/java/com/travelhub/backend/entity): `backend/src/main/java/com/travelhub/backend/entity`

### AI Assistant

- [Chatbot service](https://github.com/pirathee587/travelhub/blob/main/chatbot-service/main.py): `chatbot-service/main.py`
- [Backend data sync](https://github.com/pirathee587/travelhub/blob/main/chatbot-service/data_sync.py): `chatbot-service/data_sync.py`

### Other components

- **Platform users**
- **PostgreSQL**
- **Groq LLM**
- **Supabase storage**
- **PayHere gateway**

## Connections

- Platform users → React application: uses
- React application → Role routes: routes to (evidence: `frontend/src/App.tsx`)
- Role routes → Authentication UI: routes to (evidence: `frontend/src/routes/TouristRoutes.tsx`)
- React application → REST API controllers: REST requests
- React application → Chatbot service: requests assistance
- REST API controllers → Authentication: delegates auth
- Authentication → Email delivery: sends messages (evidence: `backend/src/main/java/com/travelhub/backend/service/AuthService.java`)
- Authentication → Domain entities and repositories: reads and writes users (evidence: `backend/src/main/java/com/travelhub/backend/service/AuthService.java`)
- Review endpoints → Review management: delegates reviews (evidence: `backend/src/main/java/com/travelhub/backend/controller/ReviewController.java`)
- Review management → Review persistence: reads and writes (evidence: `backend/src/main/java/com/travelhub/backend/service/ReviewService.java`)
- Review management → Image uploads: uploads images (evidence: `backend/src/main/java/com/travelhub/backend/service/ReviewService.java`)
- Agency review replies → Review persistence: reads and updates (evidence: `backend/src/main/java/com/travelhub/backend/service/AgentReviewService.java`)
- REST API controllers → Travel and role services: dispatches requests (evidence: `backend/src/main/java/com/travelhub/backend/controller/ReviewController.java`)
- Travel and role services → Domain entities and repositories: accesses records (evidence: `backend/src/main/java/com/travelhub/backend/service/ReviewService.java`)
- Domain entities and repositories → PostgreSQL: persists data
- Chatbot service → Backend data sync: uses sync module (evidence: `chatbot-service/main.py`)
- Chatbot service → Groq LLM: calls LLM
- Backend data sync → REST API controllers: syncs backend data
- Image uploads → Supabase storage: stores images
- REST API controllers → PayHere gateway: integrates payments
