How hbuz/aafe-airways works
AAFE is a two-service airline fare-calculation product. The primary workflow validates a submitted itinerary, obtains airport details, calculates leg distances and pricing components, then returns the fare and tax. A separate admin workflow refreshes the in-memory served-station registry. The README documents both Haversine and Geodesic distance strategies and airport-specific charges. Some fare-engine modules and the Geodesic implementation were not excerpted; their nodes reflect paths and capabilities in the tree/README, and uncertain links are omitted.
Main entry points: FareCalculationService.java Fare orchestrator · ItineraryController.java Itinerary endpoint · ItineraryValidator.java Itinerary validation · AirportClient.java Airport client
Components 23
Airport data
- Airport client
aafe-fare-engine/src/main/java/com/aafe/fareengine/service/AirportClient.java - Airports API
airports-api/src/index.ts - Airport data model
airports-api/src/model.ts
Fare API
- Itinerary endpoint
aafe-fare-engine/src/main/java/com/aafe/fareengine/controller/ItineraryController.java - Admin endpoint
aafe-fare-engine/src/main/java/com/aafe/fareengine/controller/AdminController.java
Itinerary rules
- Itinerary validation
aafe-fare-engine/src/main/java/com/aafe/fareengine/validation/ItineraryValidator.java - Validation annotation
aafe-fare-engine/src/main/java/com/aafe/fareengine/validation/ValidItinerary.java - Station registry
aafe-fare-engine/src/main/java/com/aafe/fareengine/service/StationRegistryService.java
Fare calculation
- Fare orchestrator
aafe-fare-engine/src/main/java/com/aafe/fareengine/service/FareCalculationService.java - Airport coordinate mapper
aafe-fare-engine/src/main/java/com/aafe/fareengine/mapper/AirportMapper.java - Distance selector
aafe-fare-engine/src/main/java/com/aafe/fareengine/service/DistanceCalculator.java - Distance strategy contract
aafe-fare-engine/src/main/java/com/aafe/fareengine/service/distance/DistanceStrategy.java - Haversine strategy
aafe-fare-engine/src/main/java/com/aafe/fareengine/service/distance/HaversineDistanceStrategy.java - Geodesic strategy
aafe-fare-engine/src/main/java/com/aafe/fareengine/service/distance/AccurateDistanceStrategy.java - Haversine calculation
aafe-fare-engine/src/main/java/com/aafe/fareengine/util/HaversineUtil.java - Service charges
aafe-fare-engine/src/main/java/com/aafe/fareengine/service/ServiceChargeCalculator.java - Fare result
aafe-fare-engine/src/main/java/com/aafe/fareengine/model/Itinerary.java - Fare breakdown
aafe-fare-engine/src/main/java/com/aafe/fareengine/model/FareBreakdown.java
Configuration and errors
- Fare rules
aafe-fare-engine/src/main/java/com/aafe/fareengine/config/FareEngineProperties.java - Charge rules
aafe-fare-engine/src/main/java/com/aafe/fareengine/config/ServiceChargeProperties.java - API error mapping
aafe-fare-engine/src/main/java/com/aafe/fareengine/exception/GlobalExceptionHandler.java - Cache configuration
aafe-fare-engine/src/main/java/com/aafe/fareengine/config/CacheConfig.java
Other components
- API caller
Connections 22
- API caller → Itinerary endpoint: requests fare
- Itinerary endpoint → Validation annotation: validates input
aafe-fare-engine/src/main/java/com/aafe/fareengine/controller/ItineraryController.java - Validation annotation → Itinerary validation: delegates validation
aafe-fare-engine/src/main/java/com/aafe/fareengine/validation/ValidItinerary.java - Itinerary validation → Station registry: checks stations
aafe-fare-engine/src/main/java/com/aafe/fareengine/validation/ItineraryValidator.java - Itinerary validation → Fare rules: reads restrictions
aafe-fare-engine/src/main/java/com/aafe/fareengine/validation/ItineraryValidator.java - Itinerary endpoint → Fare orchestrator: calculates fare
aafe-fare-engine/src/main/java/com/aafe/fareengine/controller/ItineraryController.java - Fare orchestrator → Airport client: fetches airport data
aafe-fare-engine/src/main/java/com/aafe/fareengine/service/FareCalculationService.java - Airport client → Airports API: requests airport details
aafe-fare-engine/src/main/java/com/aafe/fareengine/service/AirportClient.java - Airports API → Airport data model: uses data model
airports-api/src/index.ts - Fare orchestrator → Airport coordinate mapper: maps coordinates
aafe-fare-engine/src/main/java/com/aafe/fareengine/service/FareCalculationService.java - Fare orchestrator → Distance selector: calculates leg distance
aafe-fare-engine/src/main/java/com/aafe/fareengine/service/FareCalculationService.java - Fare orchestrator → Fare rules: reads pricing rules
aafe-fare-engine/src/main/java/com/aafe/fareengine/service/FareCalculationService.java - Distance selector → Distance strategy contract: selects strategy
aafe-fare-engine/src/main/java/com/aafe/fareengine/service/DistanceCalculator.java - Haversine strategy → Haversine calculation: uses formula
aafe-fare-engine/src/main/java/com/aafe/fareengine/service/distance/HaversineDistanceStrategy.java - Fare orchestrator → Service charges: calculates charges
aafe-fare-engine/src/main/java/com/aafe/fareengine/service/FareCalculationService.java - Service charges → Charge rules: reads charge rules
aafe-fare-engine/src/main/java/com/aafe/fareengine/service/ServiceChargeCalculator.java - Fare orchestrator → Fare breakdown: builds breakdown
aafe-fare-engine/src/main/java/com/aafe/fareengine/service/FareCalculationService.java - Fare orchestrator → Fare result: returns itinerary
aafe-fare-engine/src/main/java/com/aafe/fareengine/service/FareCalculationService.java - API caller → Admin endpoint: requests refresh
- Admin endpoint → Station registry: refreshes stations
aafe-fare-engine/src/main/java/com/aafe/fareengine/controller/AdminController.java - Cache configuration → Airport client: caches responses
- API error mapping → API caller: returns API errors