# srijan110705/travel-planner architecture

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

- Interactive diagram: https://gitdiagram.com/srijan110705/travel-planner
- Repository: https://github.com/srijan110705/travel-planner

## Overview

Travel Planner is a collaborative trip-planning application: users sign in, create or join trips, then generate and manage itineraries and track shared expenses. The backend exposes authenticated Express routes; controllers handle authentication, trip operations and Gemini-assisted itinerary features, with MongoDB models holding users and trips. The README documents natural-language itinerary generation, suggestions, route optimization and expense balancing. Frontend-to-backend links are shown only where excerpts or documentation support them; unsampled page integrations are not assumed.

Main entry points: [`Frontend/src/App.jsx`](https://github.com/srijan110705/travel-planner/blob/main/Frontend/src/App.jsx) (App routing), [`Frontend/src/pages/Dashboard.jsx`](https://github.com/srijan110705/travel-planner/blob/main/Frontend/src/pages/Dashboard.jsx) (Trip dashboard), [`Backend/src/app.js`](https://github.com/srijan110705/travel-planner/blob/main/Backend/src/app.js) (Express app), [`Backend/src/routes/auth.routes.js`](https://github.com/srijan110705/travel-planner/blob/main/Backend/src/routes/auth.routes.js) (Auth routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web experience"]
  node_app["App routing<br/>[App.jsx]"]
  node_home["Home<br/>[Home.jsx]"]
  node_login["Login<br/>[Login.jsx]"]
  node_register["Register<br/>[Register.jsx]"]
  node_dashboard["Trip dashboard<br/>[Dashboard.jsx]"]
  node_create["Create trip<br/>[CreateTrip.jsx]"]
  node_join["Join trip<br/>[JoinTrip.jsx]"]
  node_mytrips["My trips<br/>[MyTrips.jsx]"]
  node_tripaccess["Trip access<br/>[useTripAccess.js]"]
  node_itineraryui["Itinerary view<br/>[Itinerary.jsx]"]
  node_financeui["Finance view<br/>[Finances.jsx]"]
end

subgraph group_api["API and access"]
  node_express["Express app<br/>[app.js]"]
  node_authroutes["Auth routes<br/>[auth.routes.js]"]
  node_triproutes["Trip routes<br/>[trip.routes.js]"]
  node_airoutes["AI routes<br/>[ai.routes.js]"]
  node_authmiddleware["JWT verification<br/>[auth.middleware.js]"]
  node_server["Server startup<br/>[server.js]"]
end

subgraph group_domain["Trip domain"]
  node_authcontroller["Authentication<br/>[auth.controller.js]"]
  node_tripcontroller["Trip operations<br/>[trip.controller.js]"]
end

subgraph group_data["Persistence"]
  node_usermodel[("User records<br/>[user.model.js]")]
  node_tripmodel[("Trip records<br/>[trip.model.js]")]
  node_dbconnect["Database connection<br/>[db.js]"]
end

subgraph group_ai["AI planning"]
  node_aicontroller["AI planning<br/>[ai.controller.js]"]
end

node_traveler(("Traveler"))
node_gemini{{"Gemini API"}}
node_mongo[("MongoDB")]

node_traveler -->|"uses"| node_app
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_register
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_create
node_app -->|"routes to"| node_join
node_app -->|"routes to"| node_mytrips
node_dashboard -->|"stores access"| node_tripaccess
node_dashboard -->|"renders"| node_itineraryui
node_dashboard -->|"renders"| node_financeui
node_dashboard -->|"renders"| node_create
node_dashboard -->|"renders"| node_join
node_dashboard -->|"requests trips"| node_triproutes
node_dashboard -->|"requests logout"| node_authroutes
node_express -->|"mounts"| node_authroutes
node_express -->|"mounts"| node_triproutes
node_express -->|"mounts"| node_airoutes
node_authroutes -->|"dispatches"| node_authcontroller
node_triproutes -->|"dispatches"| node_tripcontroller
node_airoutes -->|"dispatches"| node_aicontroller
node_authroutes -->|"verifies logout"| node_authmiddleware
node_triproutes -->|"verifies requests"| node_authmiddleware
node_airoutes -->|"verifies requests"| node_authmiddleware
node_authcontroller -->|"reads and writes"| node_usermodel
node_authmiddleware -->|"loads user"| node_usermodel
node_tripcontroller -->|"reads and writes"| node_tripmodel
node_aicontroller -->|"reads and updates"| node_tripmodel
node_aicontroller -->|"generates plans"| node_gemini
node_server -->|"starts"| node_express
node_server -->|"connects"| node_dbconnect
node_dbconnect -->|"connects to"| node_mongo
node_traveler -.->|"requests suggestions"| node_gemini
node_traveler -.->|"logs expenses"| node_financeui

click node_app "https://github.com/srijan110705/travel-planner/blob/main/Frontend/src/App.jsx"
click node_home "https://github.com/srijan110705/travel-planner/blob/main/Frontend/src/pages/Home.jsx"
click node_login "https://github.com/srijan110705/travel-planner/blob/main/Frontend/src/pages/Login.jsx"
click node_register "https://github.com/srijan110705/travel-planner/blob/main/Frontend/src/pages/Register.jsx"
click node_dashboard "https://github.com/srijan110705/travel-planner/blob/main/Frontend/src/pages/Dashboard.jsx"
click node_create "https://github.com/srijan110705/travel-planner/blob/main/Frontend/src/pages/CreateTrip.jsx"
click node_join "https://github.com/srijan110705/travel-planner/blob/main/Frontend/src/pages/JoinTrip.jsx"
click node_mytrips "https://github.com/srijan110705/travel-planner/blob/main/Frontend/src/pages/MyTrips.jsx"
click node_tripaccess "https://github.com/srijan110705/travel-planner/blob/main/Frontend/src/hooks/useTripAccess.js"
click node_itineraryui "https://github.com/srijan110705/travel-planner/blob/main/Frontend/src/components/Itinerary.jsx"
click node_financeui "https://github.com/srijan110705/travel-planner/blob/main/Frontend/src/components/Finances.jsx"
click node_express "https://github.com/srijan110705/travel-planner/blob/main/Backend/src/app.js"
click node_authroutes "https://github.com/srijan110705/travel-planner/blob/main/Backend/src/routes/auth.routes.js"
click node_triproutes "https://github.com/srijan110705/travel-planner/blob/main/Backend/src/routes/trip.routes.js"
click node_airoutes "https://github.com/srijan110705/travel-planner/blob/main/Backend/src/routes/ai.routes.js"
click node_authcontroller "https://github.com/srijan110705/travel-planner/blob/main/Backend/src/controllers/auth.controller.js"
click node_tripcontroller "https://github.com/srijan110705/travel-planner/blob/main/Backend/src/controllers/trip.controller.js"
click node_authmiddleware "https://github.com/srijan110705/travel-planner/blob/main/Backend/src/middlewares/auth.middleware.js"
click node_usermodel "https://github.com/srijan110705/travel-planner/blob/main/Backend/src/models/user.model.js"
click node_tripmodel "https://github.com/srijan110705/travel-planner/blob/main/Backend/src/models/trip.model.js"
click node_aicontroller "https://github.com/srijan110705/travel-planner/blob/main/Backend/src/controllers/ai.controller.js"
click node_server "https://github.com/srijan110705/travel-planner/blob/main/Backend/server.js"
click node_dbconnect "https://github.com/srijan110705/travel-planner/blob/main/Backend/src/db/db.js"

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_home,node_login,node_register,node_dashboard,node_create,node_join,node_mytrips,node_tripaccess,node_itineraryui,node_financeui toneBlue
class node_express,node_authroutes,node_triproutes,node_airoutes,node_authmiddleware,node_server,node_mongo toneAmber
class node_authcontroller,node_tripcontroller,node_gemini toneMint
class node_usermodel,node_tripmodel,node_dbconnect toneRose
class node_aicontroller,node_traveler toneIndigo
```

## Components

### Web experience

- [App routing](https://github.com/srijan110705/travel-planner/blob/main/Frontend/src/App.jsx): `Frontend/src/App.jsx`
- [Home](https://github.com/srijan110705/travel-planner/blob/main/Frontend/src/pages/Home.jsx): `Frontend/src/pages/Home.jsx`
- [Login](https://github.com/srijan110705/travel-planner/blob/main/Frontend/src/pages/Login.jsx): `Frontend/src/pages/Login.jsx`
- [Register](https://github.com/srijan110705/travel-planner/blob/main/Frontend/src/pages/Register.jsx): `Frontend/src/pages/Register.jsx`
- [Trip dashboard](https://github.com/srijan110705/travel-planner/blob/main/Frontend/src/pages/Dashboard.jsx): `Frontend/src/pages/Dashboard.jsx`
- [Create trip](https://github.com/srijan110705/travel-planner/blob/main/Frontend/src/pages/CreateTrip.jsx): `Frontend/src/pages/CreateTrip.jsx`
- [Join trip](https://github.com/srijan110705/travel-planner/blob/main/Frontend/src/pages/JoinTrip.jsx): `Frontend/src/pages/JoinTrip.jsx`
- [My trips](https://github.com/srijan110705/travel-planner/blob/main/Frontend/src/pages/MyTrips.jsx): `Frontend/src/pages/MyTrips.jsx`
- [Trip access](https://github.com/srijan110705/travel-planner/blob/main/Frontend/src/hooks/useTripAccess.js): `Frontend/src/hooks/useTripAccess.js`
- [Itinerary view](https://github.com/srijan110705/travel-planner/blob/main/Frontend/src/components/Itinerary.jsx): `Frontend/src/components/Itinerary.jsx`
- [Finance view](https://github.com/srijan110705/travel-planner/blob/main/Frontend/src/components/Finances.jsx): `Frontend/src/components/Finances.jsx`

### API and access

- [Express app](https://github.com/srijan110705/travel-planner/blob/main/Backend/src/app.js): `Backend/src/app.js`
- [Auth routes](https://github.com/srijan110705/travel-planner/blob/main/Backend/src/routes/auth.routes.js): `Backend/src/routes/auth.routes.js`
- [Trip routes](https://github.com/srijan110705/travel-planner/blob/main/Backend/src/routes/trip.routes.js): `Backend/src/routes/trip.routes.js`
- [AI routes](https://github.com/srijan110705/travel-planner/blob/main/Backend/src/routes/ai.routes.js): `Backend/src/routes/ai.routes.js`
- [JWT verification](https://github.com/srijan110705/travel-planner/blob/main/Backend/src/middlewares/auth.middleware.js): `Backend/src/middlewares/auth.middleware.js`
- [Server startup](https://github.com/srijan110705/travel-planner/blob/main/Backend/server.js): `Backend/server.js`

### Trip domain

- [Authentication](https://github.com/srijan110705/travel-planner/blob/main/Backend/src/controllers/auth.controller.js): `Backend/src/controllers/auth.controller.js`
- [Trip operations](https://github.com/srijan110705/travel-planner/blob/main/Backend/src/controllers/trip.controller.js): `Backend/src/controllers/trip.controller.js`

### Persistence

- [User records](https://github.com/srijan110705/travel-planner/blob/main/Backend/src/models/user.model.js): `Backend/src/models/user.model.js`
- [Trip records](https://github.com/srijan110705/travel-planner/blob/main/Backend/src/models/trip.model.js): `Backend/src/models/trip.model.js`
- [Database connection](https://github.com/srijan110705/travel-planner/blob/main/Backend/src/db/db.js): `Backend/src/db/db.js`

### AI planning

- [AI planning](https://github.com/srijan110705/travel-planner/blob/main/Backend/src/controllers/ai.controller.js): `Backend/src/controllers/ai.controller.js`

### Other components

- **Traveler**
- **Gemini API**
- **MongoDB**

## Connections

- Traveler → App routing: uses (evidence: `README.md`)
- App routing → Home: routes to (evidence: `Frontend/src/App.jsx`)
- App routing → Login: routes to (evidence: `Frontend/src/App.jsx`)
- App routing → Register: routes to (evidence: `Frontend/src/App.jsx`)
- App routing → Trip dashboard: routes to (evidence: `Frontend/src/App.jsx`)
- App routing → Create trip: routes to (evidence: `Frontend/src/App.jsx`)
- App routing → Join trip: routes to (evidence: `Frontend/src/App.jsx`)
- App routing → My trips: routes to (evidence: `Frontend/src/App.jsx`)
- Trip dashboard → Trip access: stores access (evidence: `Frontend/src/pages/Dashboard.jsx`)
- Trip dashboard → Itinerary view: renders (evidence: `Frontend/src/pages/Dashboard.jsx`)
- Trip dashboard → Finance view: renders (evidence: `Frontend/src/pages/Dashboard.jsx`)
- Trip dashboard → Create trip: renders (evidence: `Frontend/src/pages/Dashboard.jsx`)
- Trip dashboard → Join trip: renders (evidence: `Frontend/src/pages/Dashboard.jsx`)
- Trip dashboard → Trip routes: requests trips (evidence: `Frontend/src/pages/Dashboard.jsx`)
- Trip dashboard → Auth routes: requests logout (evidence: `Frontend/src/pages/Dashboard.jsx`)
- Express app → Auth routes: mounts (evidence: `Backend/src/app.js`)
- Express app → Trip routes: mounts (evidence: `Backend/src/app.js`)
- Express app → AI routes: mounts (evidence: `Backend/src/app.js`)
- Auth routes → Authentication: dispatches (evidence: `Backend/src/routes/auth.routes.js`)
- Trip routes → Trip operations: dispatches (evidence: `Backend/src/routes/trip.routes.js`)
- AI routes → AI planning: dispatches (evidence: `Backend/src/routes/ai.routes.js`)
- Auth routes → JWT verification: verifies logout (evidence: `Backend/src/routes/auth.routes.js`)
- Trip routes → JWT verification: verifies requests (evidence: `Backend/src/routes/trip.routes.js`)
- AI routes → JWT verification: verifies requests (evidence: `Backend/src/routes/ai.routes.js`)
- Authentication → User records: reads and writes (evidence: `Backend/src/controllers/auth.controller.js`)
- JWT verification → User records: loads user (evidence: `Backend/src/middlewares/auth.middleware.js`)
- Trip operations → Trip records: reads and writes (evidence: `Backend/src/controllers/trip.controller.js`)
- AI planning → Trip records: reads and updates (evidence: `Backend/src/controllers/ai.controller.js`)
- AI planning → Gemini API: generates plans (evidence: `README.md`)
- Server startup → Express app: starts (evidence: `Backend/server.js`)
- Server startup → Database connection: connects (evidence: `Backend/server.js`)
- Database connection → MongoDB: connects to (evidence: `README.md`)
- Traveler → Gemini API: requests suggestions (evidence: `README.md`)
- Traveler → Finance view: logs expenses (evidence: `README.md`)
