# chandru2600/travelplanneragent architecture

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

## Overview

This Flask travel-planning application takes a user's destination, dates, budget, and preferences, generates and saves an AI itinerary, enriches it with weather, and presents the trip for later review or PDF export. Users can manage saved trips and expenses; administrators get user, trip, and destination analytics. The graph captures the documented web workflow and major capabilities, but not every route detail: some route and frontend implementations were not excerpted, so uncertain wiring is omitted.

Main entry points: [`app.py`](https://github.com/chandru2600/travelplanneragent/blob/main/app.py) (Flask application), [`backend/routes/planner_routes.py`](https://github.com/chandru2600/travelplanneragent/blob/main/backend/routes/planner_routes.py) (Trip planner routes), [`backend/routes/api_routes.py`](https://github.com/chandru2600/travelplanneragent/blob/main/backend/routes/api_routes.py) (REST API), [`backend/models/trip.py`](https://github.com/chandru2600/travelplanneragent/blob/main/backend/models/trip.py) (Trip, saves, expenses)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_flask_app["Flask application<br/>[app.py]"]
  node_web_views["Web views"]
  node_web_scripts["Browser interactions"]
end

subgraph group_planning["Trip planning"]
  node_planner_routes["Trip planner routes<br/>[planner_routes.py]"]
  node_api_routes["REST API<br/>[api_routes.py]"]
  node_granite["AI itinerary service<br/>[granite_service.py]"]
  node_weather["Weather service<br/>[weather_service.py]"]
  node_pdf["PDF export<br/>[pdf_service.py]"]
  node_trip_model["Trip, saves, expenses<br/>[trip.py]"]
end

subgraph group_accounts["Accounts and admin"]
  node_account_routes["Authentication routes<br/>[auth_routes.py]"]
  node_admin_routes["Admin routes<br/>[admin_routes.py]"]
  node_user_model["User operations<br/>[user.py]"]
end

subgraph group_persistence["Persistence"]
  node_sqlite[("SQLite database<br/>[db.py]")]
end

node_traveler(("Traveler"))
node_admin_actor(("Administrator"))
node_granite_api{{"IBM watsonx.ai"}}
node_weather_api{{"OpenWeatherMap"}}

node_traveler -->|"uses"| node_flask_app
node_admin_actor -->|"uses"| node_flask_app
node_flask_app -->|"registers"| node_account_routes
node_flask_app -->|"registers"| node_planner_routes
node_flask_app -->|"registers"| node_admin_routes
node_flask_app -->|"registers"| node_api_routes
node_flask_app -->|"initializes"| node_sqlite
node_account_routes -->|"authenticates users"| node_user_model
node_admin_routes -->|"manages users"| node_user_model
node_admin_routes -->|"queries analytics"| node_trip_model
node_planner_routes -->|"generates itinerary"| node_granite
node_planner_routes -->|"fetches forecasts"| node_weather
node_planner_routes -->|"manages trips"| node_trip_model
node_planner_routes -.->|"exports report"| node_pdf
node_api_routes -->|"generates itinerary"| node_granite
node_api_routes -->|"fetches forecasts"| node_weather
node_api_routes -->|"manages trips"| node_trip_model
node_api_routes -.->|"exports report"| node_pdf
node_granite -->|"requests generation"| node_granite_api
node_weather -->|"requests weather"| node_weather_api
node_user_model -->|"reads and writes"| node_sqlite
node_trip_model -->|"reads and writes"| node_sqlite
node_planner_routes -->|"renders pages"| node_web_views
node_traveler -.->|"interacts with"| node_web_scripts

click node_flask_app "https://github.com/chandru2600/travelplanneragent/blob/main/app.py"
click node_web_views "https://github.com/chandru2600/travelplanneragent/tree/main/frontend/templates"
click node_web_scripts "https://github.com/chandru2600/travelplanneragent/tree/main/frontend/static/js"
click node_account_routes "https://github.com/chandru2600/travelplanneragent/blob/main/backend/routes/auth_routes.py"
click node_admin_routes "https://github.com/chandru2600/travelplanneragent/blob/main/backend/routes/admin_routes.py"
click node_planner_routes "https://github.com/chandru2600/travelplanneragent/blob/main/backend/routes/planner_routes.py"
click node_api_routes "https://github.com/chandru2600/travelplanneragent/blob/main/backend/routes/api_routes.py"
click node_granite "https://github.com/chandru2600/travelplanneragent/blob/main/backend/services/granite/granite_service.py"
click node_weather "https://github.com/chandru2600/travelplanneragent/blob/main/backend/services/weather/weather_service.py"
click node_pdf "https://github.com/chandru2600/travelplanneragent/blob/main/backend/services/pdf/pdf_service.py"
click node_user_model "https://github.com/chandru2600/travelplanneragent/blob/main/backend/models/user.py"
click node_trip_model "https://github.com/chandru2600/travelplanneragent/blob/main/backend/models/trip.py"
click node_sqlite "https://github.com/chandru2600/travelplanneragent/blob/main/backend/database/db.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_flask_app,node_web_views,node_web_scripts toneBlue
class node_planner_routes,node_api_routes,node_granite,node_weather,node_pdf,node_trip_model toneAmber
class node_account_routes,node_admin_routes,node_user_model toneMint
class node_sqlite toneRose
class node_traveler,node_admin_actor,node_granite_api,node_weather_api toneIndigo
```

## Components

### Web experience

- [Flask application](https://github.com/chandru2600/travelplanneragent/blob/main/app.py): `app.py`
- [Web views](https://github.com/chandru2600/travelplanneragent/tree/main/frontend/templates): `frontend/templates`
- [Browser interactions](https://github.com/chandru2600/travelplanneragent/tree/main/frontend/static/js): `frontend/static/js`

### Trip planning

- [Trip planner routes](https://github.com/chandru2600/travelplanneragent/blob/main/backend/routes/planner_routes.py): `backend/routes/planner_routes.py`
- [REST API](https://github.com/chandru2600/travelplanneragent/blob/main/backend/routes/api_routes.py): `backend/routes/api_routes.py`
- [AI itinerary service](https://github.com/chandru2600/travelplanneragent/blob/main/backend/services/granite/granite_service.py): `backend/services/granite/granite_service.py`
- [Weather service](https://github.com/chandru2600/travelplanneragent/blob/main/backend/services/weather/weather_service.py): `backend/services/weather/weather_service.py`
- [PDF export](https://github.com/chandru2600/travelplanneragent/blob/main/backend/services/pdf/pdf_service.py): `backend/services/pdf/pdf_service.py`
- [Trip, saves, expenses](https://github.com/chandru2600/travelplanneragent/blob/main/backend/models/trip.py): `backend/models/trip.py`

### Accounts and admin

- [Authentication routes](https://github.com/chandru2600/travelplanneragent/blob/main/backend/routes/auth_routes.py): `backend/routes/auth_routes.py`
- [Admin routes](https://github.com/chandru2600/travelplanneragent/blob/main/backend/routes/admin_routes.py): `backend/routes/admin_routes.py`
- [User operations](https://github.com/chandru2600/travelplanneragent/blob/main/backend/models/user.py): `backend/models/user.py`

### Persistence

- [SQLite database](https://github.com/chandru2600/travelplanneragent/blob/main/backend/database/db.py): `backend/database/db.py`

### Other components

- **Traveler**
- **Administrator**
- **IBM watsonx.ai**
- **OpenWeatherMap**

## Connections

- Traveler → Flask application: uses (evidence: `README.md`)
- Administrator → Flask application: uses (evidence: `README.md`)
- Flask application → Authentication routes: registers (evidence: `app.py`)
- Flask application → Trip planner routes: registers (evidence: `app.py`)
- Flask application → Admin routes: registers (evidence: `app.py`)
- Flask application → REST API: registers (evidence: `app.py`)
- Flask application → SQLite database: initializes (evidence: `app.py`)
- Authentication routes → User operations: authenticates users (evidence: `backend/routes/auth_routes.py`)
- Admin routes → User operations: manages users (evidence: `backend/routes/admin_routes.py`)
- Admin routes → Trip, saves, expenses: queries analytics (evidence: `backend/routes/admin_routes.py`)
- Trip planner routes → AI itinerary service: generates itinerary (evidence: `backend/routes/planner_routes.py`)
- Trip planner routes → Weather service: fetches forecasts (evidence: `backend/routes/planner_routes.py`)
- Trip planner routes → Trip, saves, expenses: manages trips (evidence: `backend/routes/planner_routes.py`)
- Trip planner routes → PDF export: exports report (evidence: `README.md`)
- REST API → AI itinerary service: generates itinerary (evidence: `backend/routes/api_routes.py`)
- REST API → Weather service: fetches forecasts (evidence: `backend/routes/api_routes.py`)
- REST API → Trip, saves, expenses: manages trips (evidence: `backend/routes/api_routes.py`)
- REST API → PDF export: exports report (evidence: `README.md`)
- AI itinerary service → IBM watsonx.ai: requests generation (evidence: `README.md`)
- Weather service → OpenWeatherMap: requests weather (evidence: `README.md`)
- User operations → SQLite database: reads and writes (evidence: `backend/models/user.py`)
- Trip, saves, expenses → SQLite database: reads and writes (evidence: `backend/models/trip.py`)
- Trip planner routes → Web views: renders pages (evidence: `README.md`)
- Traveler → Browser interactions: interacts with
