How 9090856788/courier_delivery_app works
CargoPilot is a courier logistics platform with a public customer experience and a protected operations console, backed by an Express REST API. The main workflow lets customers track shipments or request a shipping quote; authenticated staff create and manage parcels, record checkpoints, and review operational metrics. The backend routes requests through controllers to parcel/pricing and analytics logic, with MongoDB or a documented in-memory fallback. The graph reflects the supplied route/controller excerpts, source index, and README; unsampled feature internals are represented at their documented subsystem paths.
Main entry points: server.js Express API · App.jsx Admin console · parcelController.js Parcel operations · parcelSlice.js Parcel state
Components 34
Customer experience
- Public web app
frontend/src/App.jsx - Parcel tracking
frontend/src/pages/TrackParcel.jsx - Rate calculator
frontend/src/pages/CalculateCost.jsx
Operations console
- Admin console
src/App.jsx - Staff login
src/pages/Login.jsx - KPI dashboard
src/pages/Dashboard.jsx - Parcel creation
src/pages/CreateParcel.jsx - Parcel management
src/pages/ManageParcels.jsx - Parcel details
src/pages/ParcelDetails.jsx - Checkpoint tracking
src/pages/ParcelTracking.jsx - Analytics reports
src/pages/Analytics.jsx - Staff provisioning
src/pages/AddAdmin.jsx - Auth state
src/features/auth/authSlice.js - Parcel state
src/features/parcels/parcelSlice.js - Dashboard state
src/features/dashboard/dashboardSlice.js
API and services
- Express API
backend/server.js - Parcel routes
backend/routes/parcelRoutes.js - Auth routes
backend/routes/authRoutes.js - Dashboard routes
backend/routes/dashboardRoutes.js - Analytics routes
backend/routes/analyticsRoutes.js - Parcel operations
backend/controllers/parcelController.js - Authentication
backend/controllers/authController.js - Dashboard metrics
backend/controllers/dashboardController.js - Analytics reporting
backend/controllers/analyticsController.js - Cost calculation
backend/services/calculateCost.js - Tracking ID generation
backend/services/generateTrackingId.js - Access control
backend/middlewares/authMiddleware.js
Persistence and identity
- MongoDB
- Database connection
backend/db/dbConnection.js - Memory fallback
backend/db/memoryStore.js - Parcel records
backend/models/parcelSchema.js - User records
backend/models/userSchema.js
Other components
- Customer
- Operations staff
Connections 41
- Customer → Public web app: uses
frontend/src/App.jsx - Public web app → Parcel tracking: routes to
frontend/src/App.jsx - Public web app → Rate calculator: routes to
frontend/src/App.jsx - Parcel tracking → Express API: requests tracking
- Rate calculator → Express API: requests quote
- Operations staff → Admin console: uses
src/App.jsx - Admin console → Staff login: routes to
src/App.jsx - Admin console → KPI dashboard: routes to
src/App.jsx - Admin console → Parcel creation: routes to
src/App.jsx - Admin console → Parcel management: routes to
src/App.jsx - Admin console → Parcel details: routes to
src/App.jsx - Admin console → Checkpoint tracking: routes to
src/App.jsx - Admin console → Analytics reports: routes to
src/App.jsx - Admin console → Staff provisioning: routes to
src/App.jsx - Parcel creation → Parcel state: dispatches create
src/pages/CreateParcel.jsx - Parcel management → Parcel state: uses
src/pages/ManageParcels.jsx - KPI dashboard → Parcel state: uses
src/pages/Dashboard.jsx - KPI dashboard → Dashboard state: uses
src/pages/Dashboard.jsx - Staff login → Auth state: dispatches login
- Staff provisioning → Auth state: dispatches registration
src/pages/AddAdmin.jsx - Auth state → Express API: posts credentials
src/features/auth/authSlice.js - Parcel state → Express API: requests parcel actions
- Express API → Parcel routes: mounts route
backend/server.js - Express API → Auth routes: mounts route
backend/server.js - Express API → Dashboard routes: mounts route
backend/server.js - Express API → Analytics routes: mounts route
backend/server.js - Parcel routes → Parcel operations: dispatches handlers
backend/routes/parcelRoutes.js - Auth routes → Authentication: dispatches handlers
backend/routes/authRoutes.js - Dashboard routes → Dashboard metrics: dispatches handler
backend/routes/dashboardRoutes.js - Analytics routes → Analytics reporting: dispatches handlers
backend/routes/analyticsRoutes.js - Parcel routes → Access control: protects endpoints
backend/routes/parcelRoutes.js - Auth routes → Access control: protects endpoints
backend/routes/authRoutes.js - Parcel operations → Cost calculation: calculates price
backend/controllers/parcelController.js - Parcel operations → Tracking ID generation: generates ID
backend/controllers/parcelController.js - Parcel operations → Parcel records: reads and writes
backend/controllers/parcelController.js - Authentication → User records: uses user model
backend/controllers/authController.js - Access control → User records: looks up user
backend/middlewares/authMiddleware.js - Dashboard metrics → Analytics reporting: uses analytics service
- Express API → Database connection: connects at startup
backend/server.js - Database connection → MongoDB: connects when configured
README.md - Express API → Memory fallback: falls back to
README.md