How guru173/courier-logistics-management works
This is a Spring-based courier logistics API. Clients create and query shipments, which are associated with customers, packages, payments, warehouses, and delivery agents; shipment assignment and tracking history support fulfillment. Controllers expose domain operations, services enforce rules and coordinate repositories, and JPA entities represent persisted records. The graph retains the distinct customer, package, payment, warehouse, agent, shipment, and tracking areas. Some controllers and services were not excerpted, so their internal calls are omitted where the index does not establish them.
Main entry points: repository JPA Repositories · ShipmentService.java Shipment Service · DeliveryAgentService.java Agent Service · WarehouseService.java Warehouse Service
Components 20
REST API
- Customer API
src/main/java/courier/logistics/controller/CustomerController.java - Agent API
src/main/java/courier/logistics/controller/DeliveryAgentController.java - Package API
src/main/java/courier/logistics/controller/PackageController.java - Payment API
src/main/java/courier/logistics/controller/PaymentController.java - Shipment API
src/main/java/courier/logistics/controller/ShipmentController.java - Tracking API
src/main/java/courier/logistics/controller/TrackingHistoryController.java - Warehouse API
src/main/java/courier/logistics/controller/WarehouseController.java
Domain Services
- Customer Service
src/main/java/courier/logistics/service/CustomerService.java - Agent Service
src/main/java/courier/logistics/service/DeliveryAgentService.java - Package Service
src/main/java/courier/logistics/service/PackageService.java - Payment Service
src/main/java/courier/logistics/service/PaymentService.java - Shipment Service
src/main/java/courier/logistics/service/ShipmentService.java - Tracking Service
src/main/java/courier/logistics/service/TrackingHistoryService.java - Warehouse Service
src/main/java/courier/logistics/service/WarehouseService.java
Persistence Model
- JPA Repositories
src/main/java/courier/logistics/repository - Logistics Entities
src/main/java/courier/logistics/entity
Shared Handling
- Response Envelope
src/main/java/courier/logistics/dto/ResponseStructure.java - Domain Exceptions
src/main/java/courier/logistics/exception/InvalidInputException.java - Exception Mapper
src/main/java/courier/logistics/exception/GlobalExceptionHandler.java
Other components
- API Client
Connections 23
- API Client → Shipment API: requests
- API Client → Agent API: requests
- API Client → Warehouse API: requests
- API Client → Package API: requests
- API Client → Payment API: requests
- API Client → Tracking API: requests
- Shipment API → Shipment Service: delegates to
src/main/java/courier/logistics/controller/ShipmentController.java - Agent API → Agent Service: delegates to
src/main/java/courier/logistics/controller/DeliveryAgentController.java - Warehouse API → Warehouse Service: delegates to
src/main/java/courier/logistics/controller/WarehouseController.java - Package API → Package Service: delegates to
src/main/java/courier/logistics/controller/PackageController.java - Payment API → Payment Service: delegates to
src/main/java/courier/logistics/controller/PaymentController.java - Tracking API → Tracking Service: delegates to
src/main/java/courier/logistics/controller/TrackingHistoryController.java - Shipment Service → JPA Repositories: queries and saves
src/main/java/courier/logistics/service/ShipmentService.java - Customer Service → JPA Repositories: uses repository
src/main/java/courier/logistics/service/CustomerService.java - Agent Service → JPA Repositories: uses repository
src/main/java/courier/logistics/service/DeliveryAgentService.java - Package Service → JPA Repositories: uses repository
src/main/java/courier/logistics/service/PackageService.java - Payment Service → JPA Repositories: uses repository
src/main/java/courier/logistics/service/PaymentService.java - Warehouse Service → JPA Repositories: uses repository
src/main/java/courier/logistics/service/WarehouseService.java - Shipment Service → Customer Service: looks up customer
src/main/java/courier/logistics/service/ShipmentService.java - Shipment Service → Warehouse Service: looks up warehouse
src/main/java/courier/logistics/service/ShipmentService.java - Shipment Service → Agent Service: coordinates agent
src/main/java/courier/logistics/service/ShipmentService.java - Logistics Entities → Response Envelope
- Exception Mapper → Domain Exceptions: handles failures
src/main/java/courier/logistics/exception/GlobalExceptionHandler.java