How saurabh240/courier-saas-portal works
Courier SaaS Portal is a multi-role courier-management product: users authenticate, create and manage shipments, assign and track delivery work, and review operational results. The React app routes users to role-specific screens; the Spring backend exposes domain APIs backed by PostgreSQL, with JWT and tenant-aware user management. The tree also shows payment, proof-of-delivery, ETA, notifications, settings, reports, and audit capabilities. Some subsystem links are dashed because their implementation was not sampled; they indicate unverified relationships, not inspected call paths.
Main entry points: OrderService.java Order lifecycle · App.jsx Role-based app · UserService.java User management · OrderController.java Order API
Components 21
Web client
- Role-based app
frontend/src/App.jsx - Auth state
frontend/src/context/AuthContext.jsx - Role dashboards
frontend/src/pages
Identity and tenancy
- Login and registration
backend/src/main/java/com/courier/app/usermgmt/controller/UserController.java - User management
backend/src/main/java/com/courier/app/usermgmt/service/UserService.java - Users and tenants
backend/src/main/java/com/courier/app/usermgmt - JWT security
backend/src/main/java/com/courier/app/config
Shipment fulfillment
- Order API
backend/src/main/java/com/courier/app/orders/controller/OrderController.java - Order lifecycle
backend/src/main/java/com/courier/app/orders/service/OrderService.java - Order records
backend/src/main/java/com/courier/app/orders/repository/OrderRepository.java - Status audit
backend/src/main/java/com/courier/app/status/service/ManualStatusUpdateService.java - Live tracking
backend/src/main/java/com/courier/app/tracking - Delivery operations
backend/src/main/java/com/courier/app/delivery - Delivery proof
backend/src/main/java/com/courier/app/proof - Delivery ETA
backend/src/main/java/com/courier/app/eta
Operations and insights
- Dashboard metrics
backend/src/main/java/com/courier/app/dashboard/service/DashboardService.java - Reports export
backend/src/main/java/com/courier/app/reports - Tenant settings
backend/src/main/java/com/courier/app/settings
Payments and messaging
- Payment processing
backend/src/main/java/com/courier/app/payment - Delivery notifications
backend/src/main/java/com/courier/app/notification
Other components
- Courier users
Connections 23
- Courier users → Role-based app: uses
README.md - Role-based app → Auth state: checks session
frontend/src/App.jsx - Role-based app → Role dashboards: routes roles
frontend/src/App.jsx - Auth state → Login and registration: signs in
- Login and registration → User management: delegates to
backend/src/main/java/com/courier/app/usermgmt/controller/UserController.java - User management → Users and tenants: persists users
backend/src/main/java/com/courier/app/usermgmt/service/UserService.java - User management → Delivery notifications: sends account email
backend/src/main/java/com/courier/app/usermgmt/service/UserService.java - Courier users → Order API: manages shipments
- Order API → Order lifecycle: delegates to
backend/src/main/java/com/courier/app/orders/controller/OrderController.java - Order lifecycle → Order records: reads and writes
backend/src/main/java/com/courier/app/orders/service/OrderService.java - Order lifecycle → Status audit: updates status
- Courier users → Live tracking: tracks delivery
- Courier users → Delivery operations: handles delivery
- Delivery operations → Delivery proof: records proof
- Live tracking → Delivery ETA: informs estimate
- Dashboard metrics → Order records: queries orders
backend/src/main/java/com/courier/app/dashboard/service/DashboardService.java - Dashboard metrics → Payment processing: queries payments
backend/src/main/java/com/courier/app/dashboard/service/DashboardService.java - Courier users → Dashboard metrics: reviews metrics
- Courier users → Reports export: requests reports
- Courier users → Tenant settings: configures tenant
- Order API → Payment processing: initiates payment
- Order lifecycle → Delivery notifications: publishes order events
- Courier users → JWT security: authenticates