# federicofortuna/flight-trip-manager architecture

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

- Interactive diagram: https://gitdiagram.com/federicofortuna/flight-trip-manager
- Repository: https://github.com/federicofortuna/flight-trip-manager

## Overview

Flight Trip Manager is a modular backend for planning and managing air trips. Users maintain a trip and its legs and passengers, add flight segments and history, search and save flight alternatives, and manage budgets and transport expenses; a local catalog supplies airport, airline, and location data. The map preserves those documented capabilities and shows application services using their ports. Several controller, adapter, and persistence internals were not sampled, so uncertain wiring is omitted or shown as unverified.

Main entry points: [`src/main/java/com/flighttripmanager/trips/application/usecase/TripService.java`](https://github.com/federicofortuna/flight-trip-manager/blob/develop/src/main/java/com/flighttripmanager/trips/application/usecase/TripService.java) (Trip management), [`src/main/java/com/flighttripmanager/flightsearch/application/usecase/SearchService.java`](https://github.com/federicofortuna/flight-trip-manager/blob/develop/src/main/java/com/flighttripmanager/flightsearch/application/usecase/SearchService.java) (Flight search), [`src/main/java/com/flighttripmanager/flightsearch/application/usecase/SavedOptionService.java`](https://github.com/federicofortuna/flight-trip-manager/blob/develop/src/main/java/com/flighttripmanager/flightsearch/application/usecase/SavedOptionService.java) (Saved alternatives), [`src/main/java/com/flighttripmanager/budgets/application/usecase/BudgetService.java`](https://github.com/federicofortuna/flight-trip-manager/blob/develop/src/main/java/com/flighttripmanager/budgets/application/usecase/BudgetService.java) (Budget and expenses)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Reference Catalog"]
  node_catalog_api["Catalog API"]
  node_catalog_query["Catalog lookup"]
  node_catalog_import["Catalog import"]
  node_catalog_store[("Catalog persistence")]
end

subgraph group_trip["Trip Planning"]
  node_trips_api["Trips and passengers API"]
  node_trip_service["Trip management<br/>[TripService.java]"]
  node_passenger_service["Passenger management"]
  node_trip_budget_service["Trip budget bridge"]
  node_trip_store[("Trip persistence")]
end

subgraph group_flight["Flight Management"]
  node_flights_api["Flights API"]
  node_flight_service["Flight segments and history<br/>[FlightService.java]"]
  node_flight_store[("Flight persistence")]
end

subgraph group_search["Search and Options"]
  node_search_api["Search and saved options API"]
  node_search_service["Flight search<br/>[SearchService.java]"]
  node_search_provider["Offer providers"]
  node_search_state[("Search history and snapshots")]
  node_saved_service["Saved alternatives"]
  node_saved_store[("Saved options and prices")]
end

subgraph group_budget["Transport Budgets"]
  node_budget_api["Budget API"]
  node_budget_service["Budget and expenses<br/>[BudgetService.java]"]
  node_budget_store[("Budget persistence")]
end

node_traveler(("Trip planner"))

node_traveler -->|"queries or imports"| node_catalog_api
node_traveler -->|"manages trip"| node_trips_api
node_traveler -->|"records flights"| node_flights_api
node_traveler -->|"searches offers"| node_search_api
node_traveler -->|"sets budgets"| node_budget_api
node_catalog_api -.->|"dispatches lookup"| node_catalog_query
node_catalog_api -.->|"dispatches imports"| node_catalog_import
node_catalog_query -->|"reads entries"| node_catalog_store
node_catalog_import -->|"writes imports"| node_catalog_store
node_trips_api -.->|"dispatches trip actions"| node_trip_service
node_trips_api -.->|"dispatches passenger actions"| node_passenger_service
node_trip_service -->|"reads and saves"| node_trip_store
node_trip_service -.->|"validates places"| node_catalog_query
node_passenger_service -.->|"reads trip version"| node_trip_store
node_passenger_service -.->|"stores passengers"| node_trip_store
node_trip_budget_service -.->|"delegates budget actions"| node_budget_service
node_flights_api -.->|"dispatches flight actions"| node_flight_service
node_flight_service -->|"reads and saves"| node_flight_store
node_flight_service -.->|"checks trip context"| node_trip_service
node_search_api -.->|"dispatches searches"| node_search_service
node_search_api -.->|"dispatches saved options"| node_saved_service
node_search_service -->|"requests offers"| node_search_provider
node_search_service -.->|"checks airports"| node_catalog_query
node_search_service -->|"saves history and snapshots"| node_search_state
node_saved_service -->|"selects search offer"| node_search_state
node_saved_service -.->|"stores options and prices"| node_saved_store
node_saved_service -->|"validates leg route"| node_trip_service
node_budget_api -.->|"dispatches budget actions"| node_budget_service
node_budget_service -->|"reads and writes limits"| node_budget_store
node_budget_service -.->|"reads trip budget context"| node_trip_budget_service

click node_catalog_api "https://github.com/federicofortuna/flight-trip-manager/tree/develop/src/main/java/com/flighttripmanager/catalog/api/controller"
click node_catalog_query "https://github.com/federicofortuna/flight-trip-manager/blob/develop/src/main/java/com/flighttripmanager/catalog/application/usecase/CatalogQueryService.java"
click node_catalog_import "https://github.com/federicofortuna/flight-trip-manager/blob/develop/src/main/java/com/flighttripmanager/catalog/application/usecase/CatalogImportService.java"
click node_catalog_store "https://github.com/federicofortuna/flight-trip-manager/tree/develop/src/main/java/com/flighttripmanager/catalog/infrastructure/persistence/adapter"
click node_trips_api "https://github.com/federicofortuna/flight-trip-manager/tree/develop/src/main/java/com/flighttripmanager/trips/api/controller"
click node_trip_service "https://github.com/federicofortuna/flight-trip-manager/blob/develop/src/main/java/com/flighttripmanager/trips/application/usecase/TripService.java"
click node_passenger_service "https://github.com/federicofortuna/flight-trip-manager/blob/develop/src/main/java/com/flighttripmanager/trips/application/usecase/PassengerService.java"
click node_trip_budget_service "https://github.com/federicofortuna/flight-trip-manager/blob/develop/src/main/java/com/flighttripmanager/trips/application/usecase/TripBudgetService.java"
click node_trip_store "https://github.com/federicofortuna/flight-trip-manager/tree/develop/src/main/java/com/flighttripmanager/trips/infrastructure/persistence/repository"
click node_flights_api "https://github.com/federicofortuna/flight-trip-manager/blob/develop/src/main/java/com/flighttripmanager/flights/api/controller/FlightsController.java"
click node_flight_service "https://github.com/federicofortuna/flight-trip-manager/blob/develop/src/main/java/com/flighttripmanager/flights/application/usecase/FlightService.java"
click node_flight_store "https://github.com/federicofortuna/flight-trip-manager/blob/develop/src/main/java/com/flighttripmanager/flights/infrastructure/persistence/adapter/JpaFlightAdapter.java"
click node_search_api "https://github.com/federicofortuna/flight-trip-manager/tree/develop/src/main/java/com/flighttripmanager/flightsearch/api/controller"
click node_search_service "https://github.com/federicofortuna/flight-trip-manager/blob/develop/src/main/java/com/flighttripmanager/flightsearch/application/usecase/SearchService.java"
click node_search_provider "https://github.com/federicofortuna/flight-trip-manager/tree/develop/src/main/java/com/flighttripmanager/flightsearch/infrastructure/providers"
click node_search_state "https://github.com/federicofortuna/flight-trip-manager/tree/develop/src/main/java/com/flighttripmanager/flightsearch/infrastructure"
click node_saved_service "https://github.com/federicofortuna/flight-trip-manager/blob/develop/src/main/java/com/flighttripmanager/flightsearch/application/usecase/SavedOptionService.java"
click node_saved_store "https://github.com/federicofortuna/flight-trip-manager/tree/develop/src/main/java/com/flighttripmanager/flightsearch/infrastructure/persistence/adapter"
click node_budget_api "https://github.com/federicofortuna/flight-trip-manager/blob/develop/src/main/java/com/flighttripmanager/budgets/api/controller/BudgetController.java"
click node_budget_service "https://github.com/federicofortuna/flight-trip-manager/blob/develop/src/main/java/com/flighttripmanager/budgets/application/usecase/BudgetService.java"
click node_budget_store "https://github.com/federicofortuna/flight-trip-manager/blob/develop/src/main/java/com/flighttripmanager/budgets/infrastructure/persistence/adapter/JpaBudgetStore.java"

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_catalog_api,node_catalog_query,node_catalog_import,node_catalog_store toneBlue
class node_trips_api,node_trip_service,node_passenger_service,node_trip_budget_service,node_trip_store toneAmber
class node_flights_api,node_flight_service,node_flight_store toneMint
class node_search_api,node_search_service,node_search_provider,node_search_state,node_saved_service,node_saved_store toneRose
class node_budget_api,node_budget_service,node_budget_store,node_traveler toneIndigo
```

## Components

### Reference Catalog

- [Catalog API](https://github.com/federicofortuna/flight-trip-manager/tree/develop/src/main/java/com/flighttripmanager/catalog/api/controller): `src/main/java/com/flighttripmanager/catalog/api/controller`
- [Catalog lookup](https://github.com/federicofortuna/flight-trip-manager/blob/develop/src/main/java/com/flighttripmanager/catalog/application/usecase/CatalogQueryService.java): `src/main/java/com/flighttripmanager/catalog/application/usecase/CatalogQueryService.java`
- [Catalog import](https://github.com/federicofortuna/flight-trip-manager/blob/develop/src/main/java/com/flighttripmanager/catalog/application/usecase/CatalogImportService.java): `src/main/java/com/flighttripmanager/catalog/application/usecase/CatalogImportService.java`
- [Catalog persistence](https://github.com/federicofortuna/flight-trip-manager/tree/develop/src/main/java/com/flighttripmanager/catalog/infrastructure/persistence/adapter): `src/main/java/com/flighttripmanager/catalog/infrastructure/persistence/adapter`

### Trip Planning

- [Trips and passengers API](https://github.com/federicofortuna/flight-trip-manager/tree/develop/src/main/java/com/flighttripmanager/trips/api/controller): `src/main/java/com/flighttripmanager/trips/api/controller`
- [Trip management](https://github.com/federicofortuna/flight-trip-manager/blob/develop/src/main/java/com/flighttripmanager/trips/application/usecase/TripService.java): `src/main/java/com/flighttripmanager/trips/application/usecase/TripService.java`
- [Passenger management](https://github.com/federicofortuna/flight-trip-manager/blob/develop/src/main/java/com/flighttripmanager/trips/application/usecase/PassengerService.java): `src/main/java/com/flighttripmanager/trips/application/usecase/PassengerService.java`
- [Trip budget bridge](https://github.com/federicofortuna/flight-trip-manager/blob/develop/src/main/java/com/flighttripmanager/trips/application/usecase/TripBudgetService.java): `src/main/java/com/flighttripmanager/trips/application/usecase/TripBudgetService.java`
- [Trip persistence](https://github.com/federicofortuna/flight-trip-manager/tree/develop/src/main/java/com/flighttripmanager/trips/infrastructure/persistence/repository): `src/main/java/com/flighttripmanager/trips/infrastructure/persistence/repository`

### Flight Management

- [Flights API](https://github.com/federicofortuna/flight-trip-manager/blob/develop/src/main/java/com/flighttripmanager/flights/api/controller/FlightsController.java): `src/main/java/com/flighttripmanager/flights/api/controller/FlightsController.java`
- [Flight segments and history](https://github.com/federicofortuna/flight-trip-manager/blob/develop/src/main/java/com/flighttripmanager/flights/application/usecase/FlightService.java): `src/main/java/com/flighttripmanager/flights/application/usecase/FlightService.java`
- [Flight persistence](https://github.com/federicofortuna/flight-trip-manager/blob/develop/src/main/java/com/flighttripmanager/flights/infrastructure/persistence/adapter/JpaFlightAdapter.java): `src/main/java/com/flighttripmanager/flights/infrastructure/persistence/adapter/JpaFlightAdapter.java`

### Search and Options

- [Search and saved options API](https://github.com/federicofortuna/flight-trip-manager/tree/develop/src/main/java/com/flighttripmanager/flightsearch/api/controller): `src/main/java/com/flighttripmanager/flightsearch/api/controller`
- [Flight search](https://github.com/federicofortuna/flight-trip-manager/blob/develop/src/main/java/com/flighttripmanager/flightsearch/application/usecase/SearchService.java): `src/main/java/com/flighttripmanager/flightsearch/application/usecase/SearchService.java`
- [Offer providers](https://github.com/federicofortuna/flight-trip-manager/tree/develop/src/main/java/com/flighttripmanager/flightsearch/infrastructure/providers): `src/main/java/com/flighttripmanager/flightsearch/infrastructure/providers`
- [Search history and snapshots](https://github.com/federicofortuna/flight-trip-manager/tree/develop/src/main/java/com/flighttripmanager/flightsearch/infrastructure): `src/main/java/com/flighttripmanager/flightsearch/infrastructure`
- [Saved alternatives](https://github.com/federicofortuna/flight-trip-manager/blob/develop/src/main/java/com/flighttripmanager/flightsearch/application/usecase/SavedOptionService.java): `src/main/java/com/flighttripmanager/flightsearch/application/usecase/SavedOptionService.java`
- [Saved options and prices](https://github.com/federicofortuna/flight-trip-manager/tree/develop/src/main/java/com/flighttripmanager/flightsearch/infrastructure/persistence/adapter): `src/main/java/com/flighttripmanager/flightsearch/infrastructure/persistence/adapter`

### Transport Budgets

- [Budget API](https://github.com/federicofortuna/flight-trip-manager/blob/develop/src/main/java/com/flighttripmanager/budgets/api/controller/BudgetController.java): `src/main/java/com/flighttripmanager/budgets/api/controller/BudgetController.java`
- [Budget and expenses](https://github.com/federicofortuna/flight-trip-manager/blob/develop/src/main/java/com/flighttripmanager/budgets/application/usecase/BudgetService.java): `src/main/java/com/flighttripmanager/budgets/application/usecase/BudgetService.java`
- [Budget persistence](https://github.com/federicofortuna/flight-trip-manager/blob/develop/src/main/java/com/flighttripmanager/budgets/infrastructure/persistence/adapter/JpaBudgetStore.java): `src/main/java/com/flighttripmanager/budgets/infrastructure/persistence/adapter/JpaBudgetStore.java`

### Other components

- **Trip planner**

## Connections

- Trip planner → Catalog API: queries or imports (evidence: `README.md`)
- Trip planner → Trips and passengers API: manages trip (evidence: `README.md`)
- Trip planner → Flights API: records flights (evidence: `README.md`)
- Trip planner → Search and saved options API: searches offers (evidence: `README.md`)
- Trip planner → Budget API: sets budgets (evidence: `README.md`)
- Catalog API → Catalog lookup: dispatches lookup
- Catalog API → Catalog import: dispatches imports
- Catalog lookup → Catalog persistence: reads entries (evidence: `src/main/java/com/flighttripmanager/catalog/application/usecase/CatalogQueryService.java`)
- Catalog import → Catalog persistence: writes imports (evidence: `src/main/java/com/flighttripmanager/catalog/application/usecase/CatalogImportService.java`)
- Trips and passengers API → Trip management: dispatches trip actions
- Trips and passengers API → Passenger management: dispatches passenger actions
- Trip management → Trip persistence: reads and saves (evidence: `src/main/java/com/flighttripmanager/trips/application/usecase/TripService.java`)
- Trip management → Catalog lookup: validates places
- Passenger management → Trip persistence: reads trip version
- Passenger management → Trip persistence: stores passengers
- Trip budget bridge → Budget and expenses: delegates budget actions
- Flights API → Flight segments and history: dispatches flight actions
- Flight segments and history → Flight persistence: reads and saves (evidence: `src/main/java/com/flighttripmanager/flights/application/usecase/FlightService.java`)
- Flight segments and history → Trip management: checks trip context
- Search and saved options API → Flight search: dispatches searches
- Search and saved options API → Saved alternatives: dispatches saved options
- Flight search → Offer providers: requests offers (evidence: `src/main/java/com/flighttripmanager/flightsearch/application/usecase/SearchService.java`)
- Flight search → Catalog lookup: checks airports
- Flight search → Search history and snapshots: saves history and snapshots (evidence: `src/main/java/com/flighttripmanager/flightsearch/application/usecase/SearchService.java`)
- Saved alternatives → Search history and snapshots: selects search offer (evidence: `src/main/java/com/flighttripmanager/flightsearch/application/usecase/SavedOptionService.java`)
- Saved alternatives → Saved options and prices: stores options and prices
- Saved alternatives → Trip management: validates leg route (evidence: `src/main/java/com/flighttripmanager/flightsearch/application/usecase/SavedOptionService.java`)
- Budget API → Budget and expenses: dispatches budget actions
- Budget and expenses → Budget persistence: reads and writes limits (evidence: `src/main/java/com/flighttripmanager/budgets/application/usecase/BudgetService.java`)
- Budget and expenses → Trip budget bridge: reads trip budget context
