How javaee/cargotracker works
Cargo Tracker is a Java EE cargo-shipping application. Shipping staff book cargo, request and assign a feasible itinerary, then update its destination or monitor it; port personnel register handling events through mobile, REST, or bulk-file interfaces. Those events update cargo delivery state and drive dashboard notifications, while the public tracking interface exposes cargo status. The graph reflects documented capabilities and indexed source relationships; several UI and integration details are represented at subsystem level because their implementation excerpts were not supplied.
Main entry points: DefaultHandlingEventService.java Handling service · DefaultBookingService.java Booking service · DefaultCargoInspectionService.java Cargo inspection · CargoMonitoringService.java Cargo monitoring REST
Components 22
User Interfaces
- Booking & admin UI
src/main/java/net/java/cargotracker/interfaces/booking/web - Booking facade
src/main/java/net/java/cargotracker/interfaces/booking/facade/internal/DefaultBookingServiceFacade.java - Tracking UI
src/main/java/net/java/cargotracker/interfaces/tracking/web/Track.java - Cargo monitoring REST
src/main/java/net/java/cargotracker/interfaces/booking/rest/CargoMonitoringService.java - Mobile event entry
src/main/java/net/java/cargotracker/interfaces/handling/mobile - Handling report REST
src/main/java/net/java/cargotracker/interfaces/handling/rest/HandlingReportService.java - Bulk event files
src/main/java/net/java/cargotracker/interfaces/handling/file - Realtime dashboard updates
src/main/java/net/java/cargotracker/interfaces/booking/socket/RealtimeCargoTrackingService.java
Application Services
- Booking service
src/main/java/net/java/cargotracker/application/internal/DefaultBookingService.java - Handling service
src/main/java/net/java/cargotracker/application/internal/DefaultHandlingEventService.java - Cargo inspection
src/main/java/net/java/cargotracker/application/internal/DefaultCargoInspectionService.java
Shipping Domain
- Cargo & itinerary
src/main/java/net/java/cargotracker/domain/model/cargo/Cargo.java - Handling events
src/main/java/net/java/cargotracker/domain/model/handling/HandlingEvent.java - Route calculation
src/main/java/net/java/cargotracker/infrastructure/routing/ExternalRoutingService.java - Transit pathfinder
src/main/java/net/java/pathfinder/api/GraphTraversalService.java
Persistence & Integration
- Cargo repository
src/main/java/net/java/cargotracker/infrastructure/persistence/jpa/JpaCargoRepository.java - Handling event repository
src/main/java/net/java/cargotracker/infrastructure/persistence/jpa/JpaHandlingEventRepository.java - JMS event handling
src/main/java/net/java/cargotracker/infrastructure/messaging/jms/JmsApplicationEvents.java - CDI event bus
src/main/java/net/java/cargotracker/infrastructure/events/cdi/CargoInspected.java
Other components
- Shipping staff
- Port personnel
- Public user
Connections 25
- Shipping staff → Booking & admin UI: books cargo
- Booking & admin UI → Booking facade: routes requests
- Booking facade → Booking service: delegates booking
- Booking service → Cargo & itinerary: creates and updates
src/main/java/net/java/cargotracker/application/internal/DefaultBookingService.java - Booking service → Cargo repository: stores cargo
src/main/java/net/java/cargotracker/application/internal/DefaultBookingService.java - Booking service → Route calculation: requests routes
- Route calculation → Transit pathfinder: searches paths
- Shipping staff → Cargo monitoring REST: monitors cargo
- Public user → Tracking UI: tracks shipment
- Tracking UI → Cargo monitoring REST: retrieves status
- Port personnel → Mobile event entry: registers events
- Port personnel → Handling report REST: registers events
- Port personnel → Bulk event files: uploads events
- Mobile event entry → Handling service: submits event
- Handling report REST → Handling service: submits event
src/main/java/net/java/cargotracker/interfaces/handling/rest/HandlingReportService.java - Bulk event files → Handling service: processes entries
- Handling service → Handling events: creates event
src/main/java/net/java/cargotracker/application/internal/DefaultHandlingEventService.java - Handling service → Handling event repository: stores event
src/main/java/net/java/cargotracker/application/internal/DefaultHandlingEventService.java - Handling service → JMS event handling: publishes handling
- JMS event handling → Cargo inspection: dispatches handling
- Cargo inspection → Cargo & itinerary: updates delivery
src/main/java/net/java/cargotracker/application/internal/DefaultCargoInspectionService.java - Cargo inspection → CDI event bus: fires inspection
src/main/java/net/java/cargotracker/application/internal/DefaultCargoInspectionService.java - CDI event bus → Realtime dashboard updates: notifies dashboard
src/main/java/net/java/cargotracker/interfaces/booking/socket/RealtimeCargoTrackingService.java - Realtime dashboard updates → Shipping staff: updates dashboard
- Cargo monitoring REST → Cargo repository: reads cargo
src/main/java/net/java/cargotracker/interfaces/booking/rest/CargoMonitoringService.java