How arnab-royy/shipsense- works
ShipSense is a shipment tracking and delay-analysis web application. Users enter through the React app; admins can manage shipments, users, and delay codes, and view analytics. The documented supplier and customer tracking experiences are included as product capabilities, but their frontend and route wiring is not present in the sampled source. The reports route explicitly aggregates shipment, user, and delay-code data. Other backend route behavior and model persistence details were not sampled, so their internal links are omitted.
Main entry points: server.js Express server · App.jsx React app · Reports.js Reports API · AdminDashboardLight.jsx Admin dashboard
Components 23
Web experience
- React app
FRONTEND/src/App.jsx - Public pages
FRONTEND/src/Home - Admin dashboard
FRONTEND/src/Admin/AdminDashboardLight.jsx - Supplier and customer tracking
Shipment operations
- Shipment management
FRONTEND/src/Admin/Shipments/ShipmentsPageDark.jsx - Add shipment
FRONTEND/src/Admin/Shipments/AddShipmentDark.jsx - Delay-code management
FRONTEND/src/Admin/DelayCodes/DelayCodesPageDark.jsx - Add delay code
FRONTEND/src/Admin/DelayCodes/AddDelayCodeDark.jsx - User management
FRONTEND/src/Admin/Users/UserManagementPageDark.jsx
Analytics
- Reports
FRONTEND/src/Admin/Reports/ReportsPageDark.jsx
Backend services
- Express server
BACKEND/server.js - Shipment API
BACKEND/Routes/Shipments.js - User API
BACKEND/Routes/Users.js - Delay-code API
BACKEND/Routes/DelayCodes.js - Reports API
BACKEND/Routes/Reports.js - Shipment model
BACKEND/Models/Shipment.js - User model
BACKEND/Models/User.js - Delay-code model
BACKEND/Models/DelayCode.js - Database connection
BACKEND/DataBase/Db.js
Other components
- Admin
- Supplier
- Customer
- MongoDB
Connections 25
- Admin → React app: opens
- Supplier → Supplier and customer tracking: tracks orders
- Customer → Supplier and customer tracking: views orders
- React app → Public pages: routes to
- React app → Admin dashboard: routes to
- React app → Shipment management: routes to
- React app → Add shipment: routes to
- React app → Delay-code management: routes to
- React app → Add delay code: routes to
- React app → User management: routes to
- React app → Reports: routes to
- Admin dashboard → Express server: fetches reports and shipments
- Shipment management → Express server: fetches shipments
- User management → Express server: fetches users
- Delay-code management → Express server: fetches delay codes
- Reports → Express server: fetches reports
- Express server → Shipment API: mounts API
- Express server → User API: mounts API
- Express server → Delay-code API: mounts API
- Express server → Reports API: mounts API
- Express server → Database connection: connects
- Database connection → MongoDB: connects
- Reports API → Shipment model: aggregates shipments
- Reports API → User model: counts users
- Reports API → Delay-code model: counts delay codes