# javaee/cargotracker architecture

> Architecture diagram of the GitHub repository javaee/cargotracker, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/javaee/cargotracker
- Repository: https://github.com/javaee/cargotracker

## Overview

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: [`src/main/java/net/java/cargotracker/application/internal/DefaultHandlingEventService.java`](https://github.com/javaee/cargotracker/blob/master/src/main/java/net/java/cargotracker/application/internal/DefaultHandlingEventService.java) (Handling service), [`src/main/java/net/java/cargotracker/application/internal/DefaultBookingService.java`](https://github.com/javaee/cargotracker/blob/master/src/main/java/net/java/cargotracker/application/internal/DefaultBookingService.java) (Booking service), [`src/main/java/net/java/cargotracker/application/internal/DefaultCargoInspectionService.java`](https://github.com/javaee/cargotracker/blob/master/src/main/java/net/java/cargotracker/application/internal/DefaultCargoInspectionService.java) (Cargo inspection), [`src/main/java/net/java/cargotracker/interfaces/booking/rest/CargoMonitoringService.java`](https://github.com/javaee/cargotracker/blob/master/src/main/java/net/java/cargotracker/interfaces/booking/rest/CargoMonitoringService.java) (Cargo monitoring REST)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["User Interfaces"]
  node_booking_ui["Booking &amp; admin UI"]
  node_booking_facade["Booking facade"]
  node_tracking_ui["Tracking UI<br/>[Track.java]"]
  node_monitoring_rest["Cargo monitoring REST"]
  node_event_mobile["Mobile event entry"]
  node_event_rest["Handling report REST"]
  node_event_files["Bulk event files"]
  node_realtime["Realtime dashboard updates"]
end

subgraph group_application["Application Services"]
  node_booking_service["Booking service"]
  node_handling_service["Handling service"]
  node_inspection_service["Cargo inspection"]
end

subgraph group_domain["Shipping Domain"]
  node_cargo_model["Cargo &amp; itinerary<br/>[Cargo.java]"]
  node_handling_model["Handling events<br/>[HandlingEvent.java]"]
  node_routing["Route calculation"]
  node_pathfinder["Transit pathfinder"]
end

subgraph group_infrastructure["Persistence &amp; Integration"]
  node_cargo_store[("Cargo repository")]
  node_event_store[("Handling event repository")]
  node_jms["JMS event handling"]
  node_cdi["CDI event bus"]
end

node_staff(("Shipping staff"))
node_port(("Port personnel"))
node_public(("Public user"))

node_staff -->|"books cargo"| node_booking_ui
node_booking_ui -.->|"routes requests"| node_booking_facade
node_booking_facade -.->|"delegates booking"| node_booking_service
node_booking_service -->|"creates and updates"| node_cargo_model
node_booking_service -->|"stores cargo"| node_cargo_store
node_booking_service -.->|"requests routes"| node_routing
node_routing -.->|"searches paths"| node_pathfinder
node_staff -->|"monitors cargo"| node_monitoring_rest
node_public -->|"tracks shipment"| node_tracking_ui
node_tracking_ui -.->|"retrieves status"| node_monitoring_rest
node_port -->|"registers events"| node_event_mobile
node_port -->|"registers events"| node_event_rest
node_port -->|"uploads events"| node_event_files
node_event_mobile -.->|"submits event"| node_handling_service
node_event_rest -->|"submits event"| node_handling_service
node_event_files -.->|"processes entries"| node_handling_service
node_handling_service -->|"creates event"| node_handling_model
node_handling_service -->|"stores event"| node_event_store
node_handling_service -.->|"publishes handling"| node_jms
node_jms -.->|"dispatches handling"| node_inspection_service
node_inspection_service -->|"updates delivery"| node_cargo_model
node_inspection_service -->|"fires inspection"| node_cdi
node_cdi -->|"notifies dashboard"| node_realtime
node_realtime -->|"updates dashboard"| node_staff
node_monitoring_rest -->|"reads cargo"| node_cargo_store

click node_booking_ui "https://github.com/javaee/cargotracker/tree/master/src/main/java/net/java/cargotracker/interfaces/booking/web"
click node_booking_facade "https://github.com/javaee/cargotracker/blob/master/src/main/java/net/java/cargotracker/interfaces/booking/facade/internal/DefaultBookingServiceFacade.java"
click node_tracking_ui "https://github.com/javaee/cargotracker/blob/master/src/main/java/net/java/cargotracker/interfaces/tracking/web/Track.java"
click node_monitoring_rest "https://github.com/javaee/cargotracker/blob/master/src/main/java/net/java/cargotracker/interfaces/booking/rest/CargoMonitoringService.java"
click node_event_mobile "https://github.com/javaee/cargotracker/tree/master/src/main/java/net/java/cargotracker/interfaces/handling/mobile"
click node_event_rest "https://github.com/javaee/cargotracker/blob/master/src/main/java/net/java/cargotracker/interfaces/handling/rest/HandlingReportService.java"
click node_event_files "https://github.com/javaee/cargotracker/tree/master/src/main/java/net/java/cargotracker/interfaces/handling/file"
click node_booking_service "https://github.com/javaee/cargotracker/blob/master/src/main/java/net/java/cargotracker/application/internal/DefaultBookingService.java"
click node_handling_service "https://github.com/javaee/cargotracker/blob/master/src/main/java/net/java/cargotracker/application/internal/DefaultHandlingEventService.java"
click node_inspection_service "https://github.com/javaee/cargotracker/blob/master/src/main/java/net/java/cargotracker/application/internal/DefaultCargoInspectionService.java"
click node_cargo_model "https://github.com/javaee/cargotracker/blob/master/src/main/java/net/java/cargotracker/domain/model/cargo/Cargo.java"
click node_handling_model "https://github.com/javaee/cargotracker/blob/master/src/main/java/net/java/cargotracker/domain/model/handling/HandlingEvent.java"
click node_routing "https://github.com/javaee/cargotracker/blob/master/src/main/java/net/java/cargotracker/infrastructure/routing/ExternalRoutingService.java"
click node_cargo_store "https://github.com/javaee/cargotracker/blob/master/src/main/java/net/java/cargotracker/infrastructure/persistence/jpa/JpaCargoRepository.java"
click node_event_store "https://github.com/javaee/cargotracker/blob/master/src/main/java/net/java/cargotracker/infrastructure/persistence/jpa/JpaHandlingEventRepository.java"
click node_jms "https://github.com/javaee/cargotracker/blob/master/src/main/java/net/java/cargotracker/infrastructure/messaging/jms/JmsApplicationEvents.java"
click node_realtime "https://github.com/javaee/cargotracker/blob/master/src/main/java/net/java/cargotracker/interfaces/booking/socket/RealtimeCargoTrackingService.java"
click node_cdi "https://github.com/javaee/cargotracker/blob/master/src/main/java/net/java/cargotracker/infrastructure/events/cdi/CargoInspected.java"
click node_pathfinder "https://github.com/javaee/cargotracker/blob/master/src/main/java/net/java/pathfinder/api/GraphTraversalService.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_booking_ui,node_booking_facade,node_tracking_ui,node_monitoring_rest,node_event_mobile,node_event_rest,node_event_files,node_realtime,node_public toneBlue
class node_booking_service,node_handling_service,node_inspection_service toneAmber
class node_cargo_model,node_handling_model,node_routing,node_pathfinder toneMint
class node_cargo_store,node_event_store,node_jms,node_cdi toneRose
class node_staff,node_port toneIndigo
```

## Components

### User Interfaces

- [Booking & admin UI](https://github.com/javaee/cargotracker/tree/master/src/main/java/net/java/cargotracker/interfaces/booking/web): `src/main/java/net/java/cargotracker/interfaces/booking/web`
- [Booking facade](https://github.com/javaee/cargotracker/blob/master/src/main/java/net/java/cargotracker/interfaces/booking/facade/internal/DefaultBookingServiceFacade.java): `src/main/java/net/java/cargotracker/interfaces/booking/facade/internal/DefaultBookingServiceFacade.java`
- [Tracking UI](https://github.com/javaee/cargotracker/blob/master/src/main/java/net/java/cargotracker/interfaces/tracking/web/Track.java): `src/main/java/net/java/cargotracker/interfaces/tracking/web/Track.java`
- [Cargo monitoring REST](https://github.com/javaee/cargotracker/blob/master/src/main/java/net/java/cargotracker/interfaces/booking/rest/CargoMonitoringService.java): `src/main/java/net/java/cargotracker/interfaces/booking/rest/CargoMonitoringService.java`
- [Mobile event entry](https://github.com/javaee/cargotracker/tree/master/src/main/java/net/java/cargotracker/interfaces/handling/mobile): `src/main/java/net/java/cargotracker/interfaces/handling/mobile`
- [Handling report REST](https://github.com/javaee/cargotracker/blob/master/src/main/java/net/java/cargotracker/interfaces/handling/rest/HandlingReportService.java): `src/main/java/net/java/cargotracker/interfaces/handling/rest/HandlingReportService.java`
- [Bulk event files](https://github.com/javaee/cargotracker/tree/master/src/main/java/net/java/cargotracker/interfaces/handling/file): `src/main/java/net/java/cargotracker/interfaces/handling/file`
- [Realtime dashboard updates](https://github.com/javaee/cargotracker/blob/master/src/main/java/net/java/cargotracker/interfaces/booking/socket/RealtimeCargoTrackingService.java): `src/main/java/net/java/cargotracker/interfaces/booking/socket/RealtimeCargoTrackingService.java`

### Application Services

- [Booking service](https://github.com/javaee/cargotracker/blob/master/src/main/java/net/java/cargotracker/application/internal/DefaultBookingService.java): `src/main/java/net/java/cargotracker/application/internal/DefaultBookingService.java`
- [Handling service](https://github.com/javaee/cargotracker/blob/master/src/main/java/net/java/cargotracker/application/internal/DefaultHandlingEventService.java): `src/main/java/net/java/cargotracker/application/internal/DefaultHandlingEventService.java`
- [Cargo inspection](https://github.com/javaee/cargotracker/blob/master/src/main/java/net/java/cargotracker/application/internal/DefaultCargoInspectionService.java): `src/main/java/net/java/cargotracker/application/internal/DefaultCargoInspectionService.java`

### Shipping Domain

- [Cargo & itinerary](https://github.com/javaee/cargotracker/blob/master/src/main/java/net/java/cargotracker/domain/model/cargo/Cargo.java): `src/main/java/net/java/cargotracker/domain/model/cargo/Cargo.java`
- [Handling events](https://github.com/javaee/cargotracker/blob/master/src/main/java/net/java/cargotracker/domain/model/handling/HandlingEvent.java): `src/main/java/net/java/cargotracker/domain/model/handling/HandlingEvent.java`
- [Route calculation](https://github.com/javaee/cargotracker/blob/master/src/main/java/net/java/cargotracker/infrastructure/routing/ExternalRoutingService.java): `src/main/java/net/java/cargotracker/infrastructure/routing/ExternalRoutingService.java`
- [Transit pathfinder](https://github.com/javaee/cargotracker/blob/master/src/main/java/net/java/pathfinder/api/GraphTraversalService.java): `src/main/java/net/java/pathfinder/api/GraphTraversalService.java`

### Persistence & Integration

- [Cargo repository](https://github.com/javaee/cargotracker/blob/master/src/main/java/net/java/cargotracker/infrastructure/persistence/jpa/JpaCargoRepository.java): `src/main/java/net/java/cargotracker/infrastructure/persistence/jpa/JpaCargoRepository.java`
- [Handling event repository](https://github.com/javaee/cargotracker/blob/master/src/main/java/net/java/cargotracker/infrastructure/persistence/jpa/JpaHandlingEventRepository.java): `src/main/java/net/java/cargotracker/infrastructure/persistence/jpa/JpaHandlingEventRepository.java`
- [JMS event handling](https://github.com/javaee/cargotracker/blob/master/src/main/java/net/java/cargotracker/infrastructure/messaging/jms/JmsApplicationEvents.java): `src/main/java/net/java/cargotracker/infrastructure/messaging/jms/JmsApplicationEvents.java`
- [CDI event bus](https://github.com/javaee/cargotracker/blob/master/src/main/java/net/java/cargotracker/infrastructure/events/cdi/CargoInspected.java): `src/main/java/net/java/cargotracker/infrastructure/events/cdi/CargoInspected.java`

### Other components

- **Shipping staff**
- **Port personnel**
- **Public user**

## Connections

- 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 (evidence: `src/main/java/net/java/cargotracker/application/internal/DefaultBookingService.java`)
- Booking service → Cargo repository: stores cargo (evidence: `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 (evidence: `src/main/java/net/java/cargotracker/interfaces/handling/rest/HandlingReportService.java`)
- Bulk event files → Handling service: processes entries
- Handling service → Handling events: creates event (evidence: `src/main/java/net/java/cargotracker/application/internal/DefaultHandlingEventService.java`)
- Handling service → Handling event repository: stores event (evidence: `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 (evidence: `src/main/java/net/java/cargotracker/application/internal/DefaultCargoInspectionService.java`)
- Cargo inspection → CDI event bus: fires inspection (evidence: `src/main/java/net/java/cargotracker/application/internal/DefaultCargoInspectionService.java`)
- CDI event bus → Realtime dashboard updates: notifies dashboard (evidence: `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 (evidence: `src/main/java/net/java/cargotracker/interfaces/booking/rest/CargoMonitoringService.java`)
