# edselrenz/itinerary-app architecture

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

## Overview

Nueva Ecija Travel Itinerary is a travel-planning product with Angular and native Python desktop clients backed by a FastAPI service. Travelers can sign in or use guest mode, discover places, build custom or suggested itineraries, and view saved plans. The desktop source index exposes client-to-service dependencies and offline fallbacks; the README documents the REST API and desktop role. Backend itinerary and place internals were not sampled, so those components are shown without speculative internal call chains.

Main entry points: [`desktop_client/services`](https://github.com/edselrenz/itinerary-app/tree/main/desktop_client/services) (Client Services), [`Project/src/app/app.routes.ts`](https://github.com/edselrenz/itinerary-app/blob/main/Project/src/app/app.routes.ts) (App Routes), [`desktop_client/main.py`](https://github.com/edselrenz/itinerary-app/blob/main/desktop_client/main.py) (Desktop App), [`backend/app/main.py`](https://github.com/edselrenz/itinerary-app/blob/main/backend/app/main.py) (FastAPI Service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Angular Client"]
  node_web_app["Web App<br/>[main.ts]"]
  node_web_routes["App Routes<br/>[app.routes.ts]"]
  node_web_auth["Auth Screens"]
  node_web_builder["Itinerary Builder"]
  node_web_tabs["Travel Tabs"]
end

subgraph group_desktop["Desktop Client"]
  node_desktop_app["Desktop App<br/>[main.py]"]
  node_desktop_builder["Trip Builder"]
  node_desktop_wizard["Suggested Wizard"]
  node_desktop_places["Places View<br/>[places_view.py]"]
  node_desktop_services["Client Services"]
  node_api_client["HTTP Client<br/>[api_client.py]"]
  node_itinerary_model["Trip Models<br/>[itinerary.py]"]
  node_place_model["Place Models<br/>[place.py]"]
end

subgraph group_backend["Backend API"]
  node_api["FastAPI Service<br/>[main.py]"]
  node_auth_routes["Auth Routes<br/>[auth.py]"]
  node_itinerary_routes["Itinerary Routes<br/>[itineraries.py]"]
  node_place_routes["Place Routes<br/>[places.py]"]
  node_auth_service["Auth Service<br/>[auth_service.py]"]
end

subgraph group_data["Persistence and Discovery"]
  node_guest_storage[("Guest Storage<br/>[storage.py]")]
  node_offline_places[("Offline Places<br/>[offline_data.py]")]
  node_database[("Database<br/>[database.py]")]
end

node_traveler(("Traveler"))
node_google_maps["Google Maps"]

node_traveler -->|"uses"| node_web_app
node_web_app -->|"loads routes"| node_web_routes
node_web_routes -->|"routes to"| node_web_auth
node_web_routes -->|"routes to"| node_web_builder
node_web_routes -->|"loads tabs"| node_web_tabs
node_traveler -->|"uses"| node_desktop_app
node_desktop_app -->|"loads view"| node_desktop_builder
node_desktop_app -->|"loads view"| node_desktop_wizard
node_desktop_app -->|"loads view"| node_desktop_places
node_desktop_builder -->|"uses services"| node_desktop_services
node_desktop_wizard -->|"uses services"| node_desktop_services
node_desktop_places -->|"uses services"| node_desktop_services
node_desktop_services -->|"sends requests"| node_api_client
node_desktop_services -->|"uses models"| node_itinerary_model
node_desktop_services -->|"uses models"| node_place_model
node_desktop_services -->|"falls back to"| node_offline_places
node_desktop_services -->|"persists guest trips"| node_guest_storage
node_api_client -->|"calls REST API"| node_api
node_api -->|"registers routes"| node_auth_routes
node_api -->|"registers routes"| node_itinerary_routes
node_api -->|"registers routes"| node_place_routes
node_auth_routes -->|"calls"| node_auth_service
node_auth_service -->|"uses sessions"| node_database
node_place_routes -.->|"may use mapping"| node_google_maps

click node_web_app "https://github.com/edselrenz/itinerary-app/blob/main/Project/src/main.ts"
click node_web_routes "https://github.com/edselrenz/itinerary-app/blob/main/Project/src/app/app.routes.ts"
click node_web_auth "https://github.com/edselrenz/itinerary-app/tree/main/Project/src/app/features/auth"
click node_web_builder "https://github.com/edselrenz/itinerary-app/tree/main/Project/src/app/features/itinerary"
click node_web_tabs "https://github.com/edselrenz/itinerary-app/tree/main/Project/src/app/tabs"
click node_desktop_app "https://github.com/edselrenz/itinerary-app/blob/main/desktop_client/main.py"
click node_desktop_builder "https://github.com/edselrenz/itinerary-app/blob/main/desktop_client/views/custom_builder_view.py"
click node_desktop_wizard "https://github.com/edselrenz/itinerary-app/blob/main/desktop_client/views/suggested_wizard_view.py"
click node_desktop_places "https://github.com/edselrenz/itinerary-app/blob/main/desktop_client/views/places_view.py"
click node_desktop_services "https://github.com/edselrenz/itinerary-app/tree/main/desktop_client/services"
click node_api_client "https://github.com/edselrenz/itinerary-app/blob/main/desktop_client/core/api_client.py"
click node_itinerary_model "https://github.com/edselrenz/itinerary-app/blob/main/desktop_client/models/itinerary.py"
click node_place_model "https://github.com/edselrenz/itinerary-app/blob/main/desktop_client/models/place.py"
click node_guest_storage "https://github.com/edselrenz/itinerary-app/blob/main/desktop_client/core/storage.py"
click node_offline_places "https://github.com/edselrenz/itinerary-app/blob/main/desktop_client/core/offline_data.py"
click node_api "https://github.com/edselrenz/itinerary-app/blob/main/backend/app/main.py"
click node_auth_routes "https://github.com/edselrenz/itinerary-app/blob/main/backend/app/api/v1/auth.py"
click node_itinerary_routes "https://github.com/edselrenz/itinerary-app/blob/main/backend/app/api/v1/itineraries.py"
click node_place_routes "https://github.com/edselrenz/itinerary-app/blob/main/backend/app/api/v1/places.py"
click node_auth_service "https://github.com/edselrenz/itinerary-app/blob/main/backend/app/services/auth_service.py"
click node_database "https://github.com/edselrenz/itinerary-app/blob/main/backend/app/core/database.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_app,node_web_routes,node_web_auth,node_web_builder,node_web_tabs toneBlue
class node_desktop_app,node_desktop_builder,node_desktop_wizard,node_desktop_places,node_desktop_services,node_api_client,node_itinerary_model,node_place_model toneAmber
class node_api,node_auth_routes,node_itinerary_routes,node_place_routes,node_auth_service toneMint
class node_guest_storage,node_offline_places,node_database toneRose
class node_traveler,node_google_maps toneIndigo
```

## Components

### Angular Client

- [Web App](https://github.com/edselrenz/itinerary-app/blob/main/Project/src/main.ts): `Project/src/main.ts`
- [App Routes](https://github.com/edselrenz/itinerary-app/blob/main/Project/src/app/app.routes.ts): `Project/src/app/app.routes.ts`
- [Auth Screens](https://github.com/edselrenz/itinerary-app/tree/main/Project/src/app/features/auth): `Project/src/app/features/auth`
- [Itinerary Builder](https://github.com/edselrenz/itinerary-app/tree/main/Project/src/app/features/itinerary): `Project/src/app/features/itinerary`
- [Travel Tabs](https://github.com/edselrenz/itinerary-app/tree/main/Project/src/app/tabs): `Project/src/app/tabs`

### Desktop Client

- [Desktop App](https://github.com/edselrenz/itinerary-app/blob/main/desktop_client/main.py): `desktop_client/main.py`
- [Trip Builder](https://github.com/edselrenz/itinerary-app/blob/main/desktop_client/views/custom_builder_view.py): `desktop_client/views/custom_builder_view.py`
- [Suggested Wizard](https://github.com/edselrenz/itinerary-app/blob/main/desktop_client/views/suggested_wizard_view.py): `desktop_client/views/suggested_wizard_view.py`
- [Places View](https://github.com/edselrenz/itinerary-app/blob/main/desktop_client/views/places_view.py): `desktop_client/views/places_view.py`
- [Client Services](https://github.com/edselrenz/itinerary-app/tree/main/desktop_client/services): `desktop_client/services`
- [HTTP Client](https://github.com/edselrenz/itinerary-app/blob/main/desktop_client/core/api_client.py): `desktop_client/core/api_client.py`
- [Trip Models](https://github.com/edselrenz/itinerary-app/blob/main/desktop_client/models/itinerary.py): `desktop_client/models/itinerary.py`
- [Place Models](https://github.com/edselrenz/itinerary-app/blob/main/desktop_client/models/place.py): `desktop_client/models/place.py`

### Backend API

- [FastAPI Service](https://github.com/edselrenz/itinerary-app/blob/main/backend/app/main.py): `backend/app/main.py`
- [Auth Routes](https://github.com/edselrenz/itinerary-app/blob/main/backend/app/api/v1/auth.py): `backend/app/api/v1/auth.py`
- [Itinerary Routes](https://github.com/edselrenz/itinerary-app/blob/main/backend/app/api/v1/itineraries.py): `backend/app/api/v1/itineraries.py`
- [Place Routes](https://github.com/edselrenz/itinerary-app/blob/main/backend/app/api/v1/places.py): `backend/app/api/v1/places.py`
- [Auth Service](https://github.com/edselrenz/itinerary-app/blob/main/backend/app/services/auth_service.py): `backend/app/services/auth_service.py`

### Persistence and Discovery

- [Guest Storage](https://github.com/edselrenz/itinerary-app/blob/main/desktop_client/core/storage.py): `desktop_client/core/storage.py`
- [Offline Places](https://github.com/edselrenz/itinerary-app/blob/main/desktop_client/core/offline_data.py): `desktop_client/core/offline_data.py`
- [Database](https://github.com/edselrenz/itinerary-app/blob/main/backend/app/core/database.py): `backend/app/core/database.py`

### Other components

- **Traveler**
- **Google Maps**

## Connections

- Traveler → Web App: uses
- Web App → App Routes: loads routes (evidence: `Project/src/main.ts`)
- App Routes → Auth Screens: routes to (evidence: `Project/src/app/app.routes.ts`)
- App Routes → Itinerary Builder: routes to (evidence: `Project/src/app/app.routes.ts`)
- App Routes → Travel Tabs: loads tabs (evidence: `Project/src/app/app.routes.ts`)
- Traveler → Desktop App: uses
- Desktop App → Trip Builder: loads view (evidence: `desktop_client/main.py`)
- Desktop App → Suggested Wizard: loads view (evidence: `desktop_client/main.py`)
- Desktop App → Places View: loads view (evidence: `desktop_client/main.py`)
- Trip Builder → Client Services: uses services (evidence: `desktop_client/views/custom_builder_view.py`)
- Suggested Wizard → Client Services: uses services (evidence: `desktop_client/views/suggested_wizard_view.py`)
- Places View → Client Services: uses services (evidence: `desktop_client/views/places_view.py`)
- Client Services → HTTP Client: sends requests (evidence: `desktop_client/services/itinerary_service.py`)
- Client Services → Trip Models: uses models (evidence: `desktop_client/services/itinerary_service.py`)
- Client Services → Place Models: uses models (evidence: `desktop_client/services/place_service.py`)
- Client Services → Offline Places: falls back to (evidence: `desktop_client/services/place_service.py`)
- Client Services → Guest Storage: persists guest trips (evidence: `desktop_client/core/storage.py`)
- HTTP Client → FastAPI Service: calls REST API
- FastAPI Service → Auth Routes: registers routes (evidence: `backend/app/main.py`)
- FastAPI Service → Itinerary Routes: registers routes (evidence: `backend/app/main.py`)
- FastAPI Service → Place Routes: registers routes (evidence: `backend/app/main.py`)
- Auth Routes → Auth Service: calls (evidence: `backend/app/api/v1/auth.py`)
- Auth Service → Database: uses sessions (evidence: `backend/app/services/auth_service.py`)
- Place Routes → Google Maps: may use mapping
