How harshpatel-08/smart-courier-manager works
Smart Courier Manager is a Spring Boot REST API for courier operations. Clients authenticate or register, create and track orders, and staff assign parcels to delivery agents; assignment status and location can then be updated, including scheduled status progression. The graph preserves the documented JWT, role, email, validation, and centralized-error capabilities. Source excerpts establish several service calls and persistence interactions; other documented layers are represented from the README, while unsampled implementation details are not inferred.
Main entry points: OrderService.java Order Lifecycle · DeliveryAssignmentService.java Delivery Assignment · UserRepository.java User Records · OrderController.java Order API
Components 22
REST API
- Authentication API
src/main/java/com/Harsh/Smart/Courier/Manager/Controller/AuthController.java - User API
src/main/java/com/Harsh/Smart/Courier/Manager/Controller/UserController.java - Order API
src/main/java/com/Harsh/Smart/Courier/Manager/Controller/OrderController.java - Assignment API
src/main/java/com/Harsh/Smart/Courier/Manager/Controller/DeliveryAssignmentController.java - Error Handling
src/main/java/com/Harsh/Smart/Courier/Manager/Exception/GlobalExceptionHandler.java
Identity and Security
- JWT Request Filter
src/main/java/com/Harsh/Smart/Courier/Manager/Security/jwtAuthenticationFilter.java - JWT Tokens
src/main/java/com/Harsh/Smart/Courier/Manager/Security/JwtTokenProvider.java - Access Configuration
src/main/java/com/Harsh/Smart/Courier/Manager/Security/SecurityConfig.java - Authentication
src/main/java/com/Harsh/Smart/Courier/Manager/Service/AuthService.java - User Registration
src/main/java/com/Harsh/Smart/Courier/Manager/Service/RegisterUserUseCase.java
Courier Operations
- Order Lifecycle
src/main/java/com/Harsh/Smart/Courier/Manager/Service/OrderService.java - Delivery Assignment
src/main/java/com/Harsh/Smart/Courier/Manager/Service/DeliveryAssignmentService.java - Scheduled Updates
src/main/java/com/Harsh/Smart/Courier/Manager/Service/ScheduledDeliveryUpdateService.java - Email Notifications
src/main/java/com/Harsh/Smart/Courier/Manager/Service/EmailService.java
Persistence
- User Records
src/main/java/com/Harsh/Smart/Courier/Manager/Repository/UserRepository.java - Order Records
src/main/java/com/Harsh/Smart/Courier/Manager/Repository/OrderRepository.java - Parcel Records
src/main/java/com/Harsh/Smart/Courier/Manager/Repository/ParcelRepository.java - Assignment Records
src/main/java/com/Harsh/Smart/Courier/Manager/Repository/DeliveryAssignmentRepository.java - Location Records
src/main/java/com/Harsh/Smart/Courier/Manager/Repository/LocationRepository.java
Other components
- API Client
- MySQL
- Gmail SMTP
Connections 31
- API Client → JWT Request Filter: sends requests
README.md - JWT Request Filter → JWT Tokens: validates tokens
README.md - JWT Request Filter → Access Configuration: uses security rules
- API Client → Authentication API: submits login
README.md - API Client → User API: registers users
README.md - API Client → Order API: manages orders
README.md - API Client → Assignment API: manages deliveries
README.md - Authentication API → Authentication: delegates login
src/main/java/com/Harsh/Smart/Courier/Manager/Controller/AuthController.java - User API → User Registration: delegates registration
src/main/java/com/Harsh/Smart/Courier/Manager/Controller/UserController.java - Order API → Order Lifecycle: delegates orders
src/main/java/com/Harsh/Smart/Courier/Manager/Controller/OrderController.java - Assignment API → Delivery Assignment: delegates assignments
src/main/java/com/Harsh/Smart/Courier/Manager/Controller/DeliveryAssignmentController.java - Authentication → User Records: looks up users
src/main/java/com/Harsh/Smart/Courier/Manager/Service/AuthService.java - Authentication → JWT Tokens: generates token
src/main/java/com/Harsh/Smart/Courier/Manager/Service/AuthService.java - User Registration → User Records: persists accounts
- Order Lifecycle → User Records: loads customer
src/main/java/com/Harsh/Smart/Courier/Manager/Service/OrderService.java - Order Lifecycle → Location Records: loads locations
src/main/java/com/Harsh/Smart/Courier/Manager/Service/OrderService.java - Order Lifecycle → Order Records: saves and queries
src/main/java/com/Harsh/Smart/Courier/Manager/Service/OrderService.java - Order Lifecycle → Email Notifications: requests notification
src/main/java/com/Harsh/Smart/Courier/Manager/Service/OrderService.java - Email Notifications → Gmail SMTP: sends mail
- Delivery Assignment → Parcel Records: loads parcels
src/main/java/com/Harsh/Smart/Courier/Manager/Service/DeliveryAssignmentService.java - Delivery Assignment → User Records: checks agents
src/main/java/com/Harsh/Smart/Courier/Manager/Service/DeliveryAssignmentService.java - Delivery Assignment → Location Records: reads locations
src/main/java/com/Harsh/Smart/Courier/Manager/Service/DeliveryAssignmentService.java - Delivery Assignment → Assignment Records: reads and updates
src/main/java/com/Harsh/Smart/Courier/Manager/Service/DeliveryAssignmentService.java - Scheduled Updates → Assignment Records: loads in-transit records
src/main/java/com/Harsh/Smart/Courier/Manager/Service/ScheduledDeliveryUpdateService.java - Order Records → MySQL: stores entities
README.md - Assignment Records → MySQL: stores entities
README.md - User Records → MySQL: stores entities
README.md - Parcel Records → MySQL: stores entities
README.md - Location Records → MySQL: stores entities
README.md - Order API → Error Handling: returns structured errors
- Assignment API → Error Handling: returns structured errors