How koushiksai-builds/courier-parcel-tracking works
The repository implements a courier parcel-tracking system: users book parcels, follow tracking status and history, and staff manage delivery, payments, notifications, and failed events. The README describes separate services behind an API gateway, with parcel events distributed through RabbitMQ and service data held in separate MySQL schemas. Sampled controllers and services confirm the user, parcel, and tracking request paths and their repository operations. Delivery, payment, and notification internals are unsampled, so their detailed flows are represented only where the README documents them.
Main entry points: GatewayApplication.java API gateway · CommonSecurityConfiguration.java Shared security · ParcelController.java Parcel endpoints · TrackingService.java Status and history
Components 21
Access and identity
- API gateway
gateway/src/main/java/edu/vitap/gateway/GatewayApplication.java - User endpoints
user-service/src/main/java/com/courier/userservice/controller/UserController.java - User management
user-service/src/main/java/com/courier/userservice/service/UserService.java - User records
user-service/src/main/java/com/courier/userservice/repository/UserRepository.java
Parcel lifecycle
- Parcel endpoints
parcel-service/src/main/java/com/courier/parcelservice/controller/ParcelController.java - Booking and status
parcel-service/src/main/java/com/courier/parcelservice/service/ParcelService.java - Parcel records
parcel-service/src/main/java/com/courier/parcelservice/repository/ParcelRepository.java
Tracking
- Tracking endpoints
tracking-service/src/main/java/com/courier/trackingservice/controller/TrackingController.java - Status and history
tracking-service/src/main/java/com/courier/trackingservice/service/TrackingService.java - Tracking records
tracking-service/src/main/java/com/courier/trackingservice/repository/TrackingRecordRepository.java - Status history
tracking-service/src/main/java/com/courier/trackingservice/repository/TrackingHistoryRepository.java
Delivery and customer operations
- Courier assignment and delivery
delivery-service/src/main/java/edu/vitap/delivery - Customer notifications
notification-service/src/main/java/edu/vitap/notifications - SMTP email
- Failed-event review and retry
notification-service/src/main/java/edu/vitap/notifications - Payment orders and checkout
payment-service/src/main/java/edu/vitap/payments
Shared infrastructure
- RabbitMQ events
- Parcel event contracts
common/src/main/java/edu/vitap/common/ParcelEventConfiguration.java - Shared security
common/src/main/java/edu/vitap/common/CommonSecurityConfiguration.java - MySQL schemas
Other components
- Customer or staff
Connections 33
- Customer or staff → API gateway: sends requests
- API gateway → User endpoints: routes requests
- API gateway → Parcel endpoints: routes requests
- API gateway → Tracking endpoints: routes requests
- API gateway → Courier assignment and delivery: routes requests
- API gateway → Customer notifications: routes requests
- API gateway → Payment orders and checkout: routes requests
- User endpoints → User management: delegates to
user-service/src/main/java/com/courier/userservice/controller/UserController.java - User management → User records: reads and writes
user-service/src/main/java/com/courier/userservice/service/UserService.java - User records → MySQL schemas: persists users
- Parcel endpoints → Booking and status: delegates to
parcel-service/src/main/java/com/courier/parcelservice/controller/ParcelController.java - Booking and status → Parcel records: reads and writes
parcel-service/src/main/java/com/courier/parcelservice/service/ParcelService.java - Parcel records → MySQL schemas: persists parcels
- Tracking endpoints → Status and history: delegates to
tracking-service/src/main/java/com/courier/trackingservice/controller/TrackingController.java - Status and history → Tracking records: reads and writes
tracking-service/src/main/java/com/courier/trackingservice/service/TrackingService.java - Status and history → Status history: reads and writes
tracking-service/src/main/java/com/courier/trackingservice/service/TrackingService.java - Tracking records → MySQL schemas: persists status
- Status history → MySQL schemas: persists history
- Parcel endpoints → RabbitMQ events: publishes parcel events
- RabbitMQ events → Status and history: delivers parcel events
- RabbitMQ events → Courier assignment and delivery: delivers parcel events
- RabbitMQ events → Customer notifications: delivers parcel events
- RabbitMQ events → Payment orders and checkout: delivers parcel events
- Parcel event contracts → RabbitMQ events: configures exchanges
common/src/main/java/edu/vitap/common/ParcelEventConfiguration.java - Customer notifications → SMTP email: sends optional email
- Customer or staff → MySQL schemas: service data stored
- Shared security → User endpoints: configures service security
- Shared security → Parcel endpoints: configures service security
- Shared security → Tracking endpoints: configures service security
- Shared security → Courier assignment and delivery: configures service security
delivery-service/src/main/java/edu/vitap/delivery/DeliveryServiceApplication.java - Shared security → Customer notifications: configures service security
notification-service/src/main/java/edu/vitap/notifications/NotificationServiceApplication.java - Shared security → Payment orders and checkout: configures service security
payment-service/src/main/java/edu/vitap/payments/PaymentServiceApplication.java - Customer or staff → Failed-event review and retry: requests retry