# it24101200/ai-travel-planning-booking-management-system architecture

> Architecture diagram of the GitHub repository it24101200/ai-travel-planning-booking-management-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/it24101200/ai-travel-planning-booking-management-system
- Repository: https://github.com/it24101200/ai-travel-planning-booking-management-system

## Overview

Serendib Trails is a travel-planning and booking platform spanning a React customer/staff interface, an ASP.NET API, and an agentic planning service. The central workflow is a customer trip request, AI-generated proposal, persisted itinerary and booking awaiting staff approval. The tree also shows catalog, payment, customer, notification, media, and staff-management capabilities. Mobile platform shells appear in the tree, but no Flutter application source is listed. Several backend and AI relationships are inferred only where the excerpts or SOURCE INDEX establish them; unsampled links are omitted.

Main entry points: [`backend/Controllers/TripRequestController.cs`](https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/backend/Controllers/TripRequestController.cs) (Trip requests), [`backend/Services/BookingService.cs`](https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/backend/Services/BookingService.cs) (Booking service), [`backend/Services/AgentProposalPersistenceService.cs`](https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/backend/Services/AgentProposalPersistenceService.cs) (Proposal persistence), [`frontend-react/src/App.jsx`](https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/frontend-react/src/App.jsx) (React application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_webapp["React application<br/>[App.jsx]"]
  node_planner["Trip planner<br/>[Planner.jsx]"]
  node_staffui["Staff console"]
  node_apiclient["API client<br/>[apiClient.js]"]
end

subgraph group_api["Travel API"]
  node_tripcontroller["Trip requests"]
  node_bookingcontroller["Booking endpoints"]
  node_itinerarycontroller["Itinerary endpoints"]
  node_approvalcontroller["Approval endpoints"]
  node_catalogcontrollers["Travel catalog API"]
  node_authcontroller["Authentication<br/>[AuthController.cs]"]
  node_tripservice["Trip request service"]
  node_bookingservice["Booking service<br/>[BookingService.cs]"]
  node_currency["Currency conversion"]
end

subgraph group_planning["Trip planning"]
  node_proposal["Proposal persistence"]
  node_agents{{"AI agent workflow<br/>[graph.py]"}}
  node_agententry["Agent service entry<br/>[main.py]"]
  node_itineraryagent["Itinerary agent<br/>[itinerary_agent.py]"]
  node_toursearch["Tour search tool<br/>[search_tours.py]"]
end

subgraph group_domain["Travel records"]
  node_dbcontext["EF data context<br/>[AppDbContext.cs]"]
  node_triprecords["Trip requests and logs<br/>[TripRequest.cs]"]
  node_itineraryrecords["Itinerary records<br/>[Itinerary.cs]"]
  node_bookingrecords["Booking records<br/>[Booking.cs]"]
  node_customerrecords["Customer records<br/>[Customer.cs]"]
  node_catalogrecords["Destination and tours<br/>[Destination.cs]"]
  node_database[("Application database<br/>[AppDbContext.cs]")]
end

node_traveler(("Traveler"))
node_staff(("Travel staff"))
node_agentservice["Agent HTTP service"]

node_traveler -->|"uses"| node_webapp
node_staff -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_planner
node_webapp -->|"routes to"| node_staffui
node_staffui -->|"uses"| node_apiclient
node_tripcontroller -->|"delegates to"| node_tripservice
node_tripcontroller -->|"posts plan request"| node_agentservice
node_tripcontroller -->|"persists proposal"| node_proposal
node_tripcontroller -->|"uses itinerary service"| node_itinerarycontroller
node_tripcontroller -->|"creates booking"| node_bookingservice
node_agententry -->|"invokes graph"| node_agents
node_itineraryagent -->|"searches tours"| node_toursearch
node_proposal -->|"reads and writes"| node_dbcontext
node_bookingservice -->|"reads and writes"| node_dbcontext
node_tripservice -->|"reads and writes"| node_dbcontext
node_proposal -->|"converts amounts"| node_currency
node_bookingservice -->|"converts amounts"| node_currency
node_dbcontext -->|"maps entities"| node_database
node_tripcontroller -->|"updates request"| node_triprecords
node_proposal -->|"creates itinerary"| node_itineraryrecords
node_proposal -->|"creates booking"| node_bookingrecords
node_tripservice -->|"manages requests"| node_triprecords
node_bookingservice -->|"manages bookings"| node_bookingrecords
node_authcontroller -->|"reads and writes"| node_customerrecords
node_catalogcontrollers -.->|"serves catalog"| node_catalogrecords
node_bookingcontroller -.->|"delegates to"| node_bookingservice
node_approvalcontroller -.->|"handles approvals"| node_bookingservice

click node_webapp "https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/frontend-react/src/App.jsx"
click node_planner "https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/frontend-react/src/pages/site/Planner.jsx"
click node_staffui "https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/frontend-react/src/pages/tours/ItineraryReview.jsx"
click node_apiclient "https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/frontend-react/src/services/apiClient.js"
click node_tripcontroller "https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/backend/Controllers/TripRequestController.cs"
click node_bookingcontroller "https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/backend/Controllers/BookingController.cs"
click node_itinerarycontroller "https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/backend/Controllers/ItineraryController.cs"
click node_approvalcontroller "https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/backend/Controllers/ApprovalController.cs"
click node_catalogcontrollers "https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/backend/Controllers/DestinationController.cs"
click node_authcontroller "https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/backend/Controllers/AuthController.cs"
click node_tripservice "https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/backend/Services/TripRequestService.cs"
click node_bookingservice "https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/backend/Services/BookingService.cs"
click node_proposal "https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/backend/Services/AgentProposalPersistenceService.cs"
click node_agents "https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/agentic-ai/graph.py"
click node_agententry "https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/agentic-ai/main.py"
click node_itineraryagent "https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/agentic-ai/agents/itinerary_agent.py"
click node_toursearch "https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/agentic-ai/tools/search_tours.py"
click node_dbcontext "https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/backend/data/AppDbContext.cs"
click node_triprecords "https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/backend/Models/TripRequest.cs"
click node_itineraryrecords "https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/backend/Models/Itinerary.cs"
click node_bookingrecords "https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/backend/Models/Booking.cs"
click node_customerrecords "https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/backend/Models/Customer.cs"
click node_catalogrecords "https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/backend/Models/Destination.cs"
click node_currency "https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/backend/Services/CurrencyConversionService.cs"
click node_database "https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/backend/data/AppDbContext.cs"

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_webapp,node_planner,node_staffui,node_apiclient toneBlue
class node_tripcontroller,node_bookingcontroller,node_itinerarycontroller,node_approvalcontroller,node_catalogcontrollers,node_authcontroller,node_tripservice,node_bookingservice,node_currency toneAmber
class node_proposal,node_agents,node_agententry,node_itineraryagent,node_toursearch toneMint
class node_dbcontext,node_triprecords,node_itineraryrecords,node_bookingrecords,node_customerrecords,node_catalogrecords,node_database toneRose
class node_traveler,node_staff,node_agentservice toneIndigo
```

## Components

### Web experience

- [React application](https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/frontend-react/src/App.jsx): `frontend-react/src/App.jsx`
- [Trip planner](https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/frontend-react/src/pages/site/Planner.jsx): `frontend-react/src/pages/site/Planner.jsx`
- [Staff console](https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/frontend-react/src/pages/tours/ItineraryReview.jsx): `frontend-react/src/pages/tours/ItineraryReview.jsx`
- [API client](https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/frontend-react/src/services/apiClient.js): `frontend-react/src/services/apiClient.js`

### Travel API

- [Trip requests](https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/backend/Controllers/TripRequestController.cs): `backend/Controllers/TripRequestController.cs`
- [Booking endpoints](https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/backend/Controllers/BookingController.cs): `backend/Controllers/BookingController.cs`
- [Itinerary endpoints](https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/backend/Controllers/ItineraryController.cs): `backend/Controllers/ItineraryController.cs`
- [Approval endpoints](https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/backend/Controllers/ApprovalController.cs): `backend/Controllers/ApprovalController.cs`
- [Travel catalog API](https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/backend/Controllers/DestinationController.cs): `backend/Controllers/DestinationController.cs`
- [Authentication](https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/backend/Controllers/AuthController.cs): `backend/Controllers/AuthController.cs`
- [Trip request service](https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/backend/Services/TripRequestService.cs): `backend/Services/TripRequestService.cs`
- [Booking service](https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/backend/Services/BookingService.cs): `backend/Services/BookingService.cs`
- [Currency conversion](https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/backend/Services/CurrencyConversionService.cs): `backend/Services/CurrencyConversionService.cs`

### Trip planning

- [Proposal persistence](https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/backend/Services/AgentProposalPersistenceService.cs): `backend/Services/AgentProposalPersistenceService.cs`
- [AI agent workflow](https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/agentic-ai/graph.py): `agentic-ai/graph.py`
- [Agent service entry](https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/agentic-ai/main.py): `agentic-ai/main.py`
- [Itinerary agent](https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/agentic-ai/agents/itinerary_agent.py): `agentic-ai/agents/itinerary_agent.py`
- [Tour search tool](https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/agentic-ai/tools/search_tours.py): `agentic-ai/tools/search_tours.py`

### Travel records

- [EF data context](https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/backend/data/AppDbContext.cs): `backend/data/AppDbContext.cs`
- [Trip requests and logs](https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/backend/Models/TripRequest.cs): `backend/Models/TripRequest.cs`
- [Itinerary records](https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/backend/Models/Itinerary.cs): `backend/Models/Itinerary.cs`
- [Booking records](https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/backend/Models/Booking.cs): `backend/Models/Booking.cs`
- [Customer records](https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/backend/Models/Customer.cs): `backend/Models/Customer.cs`
- [Destination and tours](https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/backend/Models/Destination.cs): `backend/Models/Destination.cs`
- [Application database](https://github.com/it24101200/ai-travel-planning-booking-management-system/blob/main/backend/data/AppDbContext.cs): `backend/data/AppDbContext.cs`

### Other components

- **Traveler**
- **Travel staff**
- **Agent HTTP service**

## Connections

- Traveler → React application: uses (evidence: `frontend-react/src/App.jsx`)
- Travel staff → React application: uses (evidence: `frontend-react/src/App.jsx`)
- React application → Trip planner: routes to (evidence: `frontend-react/src/App.jsx`)
- React application → Staff console: routes to (evidence: `frontend-react/src/App.jsx`)
- Staff console → API client: uses (evidence: `frontend-react/src/pages/tours/ItineraryReview.jsx`)
- Trip requests → Trip request service: delegates to (evidence: `backend/Controllers/TripRequestController.cs`)
- Trip requests → Agent HTTP service: posts plan request (evidence: `backend/Controllers/TripRequestController.cs`)
- Trip requests → Proposal persistence: persists proposal (evidence: `backend/Controllers/TripRequestController.cs`)
- Trip requests → Itinerary endpoints: uses itinerary service (evidence: `backend/Controllers/TripRequestController.cs`)
- Trip requests → Booking service: creates booking (evidence: `backend/Controllers/TripRequestController.cs`)
- Agent service entry → AI agent workflow: invokes graph (evidence: `agentic-ai/main.py`)
- Itinerary agent → Tour search tool: searches tours (evidence: `agentic-ai/agents/itinerary_agent.py`)
- Proposal persistence → EF data context: reads and writes (evidence: `backend/Services/AgentProposalPersistenceService.cs`)
- Booking service → EF data context: reads and writes (evidence: `backend/Services/BookingService.cs`)
- Trip request service → EF data context: reads and writes (evidence: `backend/Services/TripRequestService.cs`)
- Proposal persistence → Currency conversion: converts amounts (evidence: `backend/Services/AgentProposalPersistenceService.cs`)
- Booking service → Currency conversion: converts amounts (evidence: `backend/Services/BookingService.cs`)
- EF data context → Application database: maps entities (evidence: `backend/data/AppDbContext.cs`)
- Trip requests → Trip requests and logs: updates request (evidence: `backend/Controllers/TripRequestController.cs`)
- Proposal persistence → Itinerary records: creates itinerary (evidence: `backend/Services/AgentProposalPersistenceService.cs`)
- Proposal persistence → Booking records: creates booking (evidence: `backend/Services/AgentProposalPersistenceService.cs`)
- Trip request service → Trip requests and logs: manages requests (evidence: `backend/Services/TripRequestService.cs`)
- Booking service → Booking records: manages bookings (evidence: `backend/Services/BookingService.cs`)
- Authentication → Customer records: reads and writes (evidence: `backend/Controllers/AuthController.cs`)
- Travel catalog API → Destination and tours: serves catalog
- Booking endpoints → Booking service: delegates to
- Approval endpoints → Booking service: handles approvals
