How jasonsaldua23-oss/capstone works
LogiTrack Pro is a multi-portal logistics system for customers, drivers, warehouse staff, and administrators. The principal workflow runs from customer order placement through inventory and fulfillment, warehouse trip planning, driver delivery and GPS updates, then customer tracking and feedback. The Django backend and shared relational models support these domain stages; web and mobile clients provide role-specific interfaces. The README documents the major capabilities and Django API mode. Several backend view implementations and portal internals were not sampled, so those links are documented rather than inferred from imports.
Main entry points: urls.py Django API · models.py Domain data models · AdminPortal.tsx Admin portal · App.tsx Customer mobile app
Components 22
User interfaces
- Customer portal
src/components/portals/customer/CustomerPortal.tsx - Admin portal
src/components/portals/admin/AdminPortal.tsx - Warehouse portal
src/components/portals/warehouse/WarehousePortal.tsx - Driver portal
src/components/portals/driver/DriverPortal.tsx - Customer mobile app
mobile/customer-app/App.tsx - Driver mobile app
mobile/driver-app/App.tsx
Order operations
- Order lifecycle
backend/core/order_lifecycle.py - Order fulfillment
backend/core/order_fulfillment.py - Inventory management
backend/core/inventory_allocation.py - Returns and deposits
backend/core/deposit_lifecycle.py - Warehouse operations
backend/core/views_warehouses.py - Customer feedback
backend/core/views_feedback.py - Reports and analytics
src/components/portals/admin/sections/reports/top-clients-report.tsx
Fleet and delivery
- Trip planning
backend/core/views_trip_planning.py - Driver delivery
backend/core/views_driver.py - Live tracking
backend/core/views_trips.py
Backend platform
- Django API
backend/core/urls.py - Domain data models
backend/core/models.py - Object storage
backend/core/object_storage.py
Other components
- Customer
- Operations staff
- Driver
Connections 29
- Customer → Customer portal: uses
- Operations staff → Admin portal: manages
- Operations staff → Warehouse portal: operates
- Driver → Driver portal: delivers with
- Customer → Customer mobile app: uses
- Driver → Driver mobile app: uses
- Customer mobile app → Order lifecycle: places orders
- Customer mobile app → Customer feedback: submits feedback
- Driver mobile app → Driver delivery: updates stops
mobile/driver-app/App.tsx - Driver mobile app → Live tracking: shares location
- Customer portal → Django API: calls API
- Admin portal → Django API: calls API
- Warehouse portal → Django API: calls API
- Driver portal → Django API: calls API
- Django API → Order lifecycle: routes requests
- Django API → Inventory management: routes requests
- Django API → Trip planning: routes requests
- Django API → Customer feedback: routes requests
- Order lifecycle → Domain data models: persists
- Order fulfillment → Domain data models: reads and writes
- Inventory management → Domain data models: reads and writes
- Returns and deposits → Domain data models: records returns
- Warehouse operations → Domain data models: reads and writes
- Trip planning → Domain data models: reads and writes
- Driver delivery → Domain data models: updates delivery
- Live tracking → Domain data models: records positions
- Customer feedback → Domain data models: stores feedback
- Admin portal → Reports and analytics: shows reports
- Django API → Object storage: serves media