How federicofortuna/flight-trip-manager works
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: TripService.java Trip management · SearchService.java Flight search · SavedOptionService.java Saved alternatives · BudgetService.java Budget and expenses
Components 22
Reference Catalog
- Catalog API
src/main/java/com/flighttripmanager/catalog/api/controller - Catalog lookup
src/main/java/com/flighttripmanager/catalog/application/usecase/CatalogQueryService.java - Catalog import
src/main/java/com/flighttripmanager/catalog/application/usecase/CatalogImportService.java - Catalog persistence
src/main/java/com/flighttripmanager/catalog/infrastructure/persistence/adapter
Trip Planning
- Trips and passengers API
src/main/java/com/flighttripmanager/trips/api/controller - Trip management
src/main/java/com/flighttripmanager/trips/application/usecase/TripService.java - Passenger management
src/main/java/com/flighttripmanager/trips/application/usecase/PassengerService.java - Trip budget bridge
src/main/java/com/flighttripmanager/trips/application/usecase/TripBudgetService.java - Trip persistence
src/main/java/com/flighttripmanager/trips/infrastructure/persistence/repository
Flight Management
- Flights API
src/main/java/com/flighttripmanager/flights/api/controller/FlightsController.java - Flight segments and history
src/main/java/com/flighttripmanager/flights/application/usecase/FlightService.java - Flight persistence
src/main/java/com/flighttripmanager/flights/infrastructure/persistence/adapter/JpaFlightAdapter.java
Search and Options
- Search and saved options API
src/main/java/com/flighttripmanager/flightsearch/api/controller - Flight search
src/main/java/com/flighttripmanager/flightsearch/application/usecase/SearchService.java - Offer providers
src/main/java/com/flighttripmanager/flightsearch/infrastructure/providers - Search history and snapshots
src/main/java/com/flighttripmanager/flightsearch/infrastructure - Saved alternatives
src/main/java/com/flighttripmanager/flightsearch/application/usecase/SavedOptionService.java - Saved options and prices
src/main/java/com/flighttripmanager/flightsearch/infrastructure/persistence/adapter
Transport Budgets
- Budget API
src/main/java/com/flighttripmanager/budgets/api/controller/BudgetController.java - Budget and expenses
src/main/java/com/flighttripmanager/budgets/application/usecase/BudgetService.java - Budget persistence
src/main/java/com/flighttripmanager/budgets/infrastructure/persistence/adapter/JpaBudgetStore.java
Other components
- Trip planner
Connections 30
- Trip planner → Catalog API: queries or imports
README.md - Trip planner → Trips and passengers API: manages trip
README.md - Trip planner → Flights API: records flights
README.md - Trip planner → Search and saved options API: searches offers
README.md - Trip planner → Budget API: sets budgets
README.md - Catalog API → Catalog lookup: dispatches lookup
- Catalog API → Catalog import: dispatches imports
- Catalog lookup → Catalog persistence: reads entries
src/main/java/com/flighttripmanager/catalog/application/usecase/CatalogQueryService.java - Catalog import → Catalog persistence: writes imports
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
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
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
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
src/main/java/com/flighttripmanager/flightsearch/application/usecase/SearchService.java - Saved alternatives → Search history and snapshots: selects search offer
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
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
src/main/java/com/flighttripmanager/budgets/application/usecase/BudgetService.java - Budget and expenses → Trip budget bridge: reads trip budget context