How shivshaktisahoo/django-vue-logistics-app works
CargoPulse is a multi-tenant freight-forwarding and shipment-visibility platform. Its main workflow spans shipment booking and milestone updates, carrier tendering, trip execution and delivery proof, with tracking and exception handling alongside it. The Vue SPA serves operations staff, carriers and customers through a Django REST API. The README documents the platform boundaries; source excerpts and index references support the shown internal service calls. Some UI-to-endpoint wiring and unsampled subsystems are not shown, so those links are omitted.
Main entry points: shipments/services.py Shipment lifecycle · App.vue Vue application · urls.py Django REST API · trips/services.py Trip execution
Components 23
Web application
- Vue application
frontend/src/App.vue - Login and registration
frontend/src/modules/auth/pages/LoginPage.vue - Shipment workflows
frontend/src/modules/shipments/pages/ShipmentFormPage.vue - Tender workflows
frontend/src/modules/tenders/pages/TendersPage.vue - Trip workflows
frontend/src/modules/trips/pages/TripDetailPage.vue - Tracking views
frontend/src/modules/tracking/pages/LiveMapPage.vue - Exception workflow
frontend/src/modules/exceptions/pages/ExceptionsPage.vue
Tenant platform
- Django REST API
backend/config/urls.py - Accounts and tenancy
backend/apps/organizations/services.py
Freight operations
- Freight master data
backend/apps/masterdata/models.py - Shipment lifecycle
backend/apps/shipments/services.py - Shipment domain rules
backend/apps/shipments/domain.py - Carrier tendering
backend/apps/tenders/services.py - Trip execution
backend/apps/trips/services.py
Tracking and records
- Position calculation
backend/apps/tracking/services.py - Exception detection
backend/apps/exceptions/detection.py - Exception handling
backend/apps/exceptions/services.py - Shipment documents
backend/apps/documents/services.py - Audit history
backend/apps/audit/services.py
Runtime services
- PostgreSQL
- Redis
- Celery worker and beat
backend/config/celery.py
Other components
- Admin, ops, carrier, customer
Connections 31
- Admin, ops, carrier, customer → Vue application: use
- Vue application → Django REST API: calls /api
- Login and registration → Vue application: renders in
- Shipment workflows → Vue application: renders in
- Tender workflows → Vue application: renders in
- Trip workflows → Vue application: renders in
- Tracking views → Vue application: renders in
- Exception workflow → Vue application: renders in
- Django REST API → Accounts and tenancy: routes requests
- Accounts and tenancy → PostgreSQL: stores membership
- Django REST API → Shipment lifecycle: serves shipment operations
- Django REST API → Carrier tendering: serves bidding
- Django REST API → Position calculation: serves visibility
- Django REST API → Exception handling: serves exception actions
- Shipment lifecycle → Shipment domain rules: uses rules
backend/apps/shipments/services.py - Shipment lifecycle → Exception detection: checks exceptions
backend/apps/shipments/services.py - Shipment lifecycle → Exception handling: invokes handling
backend/apps/shipments/services.py - Shipment lifecycle → Audit history: records changes
backend/apps/shipments/services.py - Carrier tendering → Shipment lifecycle: books award
backend/apps/tenders/services.py - Carrier tendering → Trip execution: creates trip
backend/apps/tenders/services.py - Trip execution → Shipment lifecycle: updates milestones
backend/apps/trips/services.py - Trip execution → Shipment documents: uploads proof
backend/apps/trips/services.py - Trip execution → Audit history: records actions
backend/apps/trips/services.py - Shipment documents → Audit history: records file changes
backend/apps/documents/services.py - Exception handling → Audit history: records actions
backend/apps/exceptions/services.py - Exception detection → Shipment domain rules: evaluates logistics
backend/apps/exceptions/detection.py - Position calculation → Shipment domain rules: uses status rules
backend/apps/tracking/services.py - Shipment lifecycle → PostgreSQL: persists freight
- Carrier tendering → PostgreSQL: persists bids
- Trip execution → PostgreSQL: persists execution
- Celery worker and beat → Redis: uses broker