# jasonsaldua23-oss/capstone architecture

> Architecture diagram of the GitHub repository jasonsaldua23-oss/capstone, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jasonsaldua23-oss/capstone
- Repository: https://github.com/jasonsaldua23-oss/capstone

## Overview

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: [`backend/core/urls.py`](https://github.com/jasonsaldua23-oss/capstone/blob/main/backend/core/urls.py) (Django API), [`backend/core/models.py`](https://github.com/jasonsaldua23-oss/capstone/blob/main/backend/core/models.py) (Domain data models), [`src/components/portals/admin/AdminPortal.tsx`](https://github.com/jasonsaldua23-oss/capstone/blob/main/src/components/portals/admin/AdminPortal.tsx) (Admin portal), [`mobile/customer-app/App.tsx`](https://github.com/jasonsaldua23-oss/capstone/blob/main/mobile/customer-app/App.tsx) (Customer mobile app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["User interfaces"]
  node_customer_portal["Customer portal<br/>[CustomerPortal.tsx]"]
  node_admin_portal["Admin portal<br/>[AdminPortal.tsx]"]
  node_warehouse_portal["Warehouse portal"]
  node_driver_portal["Driver portal<br/>[DriverPortal.tsx]"]
  node_customer_mobile["Customer mobile app<br/>[App.tsx]"]
  node_driver_mobile["Driver mobile app<br/>[App.tsx]"]
end

subgraph group_operations["Order operations"]
  node_orders["Order lifecycle<br/>[order_lifecycle.py]"]
  node_fulfillment["Order fulfillment"]
  node_inventory["Inventory management"]
  node_returns["Returns and deposits"]
  node_warehousing["Warehouse operations"]
  node_feedback["Customer feedback<br/>[views_feedback.py]"]
  node_reports["Reports and analytics"]
end

subgraph group_logistics["Fleet and delivery"]
  node_transport["Trip planning"]
  node_driver_ops["Driver delivery<br/>[views_driver.py]"]
  node_tracking["Live tracking<br/>[views_trips.py]"]
end

subgraph group_platform["Backend platform"]
  node_api["Django API<br/>[urls.py]"]
  node_models[("Domain data models<br/>[models.py]")]
  node_storage["Object storage<br/>[object_storage.py]"]
end

node_customer(("Customer"))
node_staff(("Operations staff"))
node_driver(("Driver"))

node_customer -->|"uses"| node_customer_portal
node_staff -->|"manages"| node_admin_portal
node_staff -->|"operates"| node_warehouse_portal
node_driver -->|"delivers with"| node_driver_portal
node_customer -->|"uses"| node_customer_mobile
node_driver -->|"uses"| node_driver_mobile
node_customer_mobile -->|"places orders"| node_orders
node_customer_mobile -->|"submits feedback"| node_feedback
node_driver_mobile -->|"updates stops"| node_driver_ops
node_driver_mobile -.->|"shares location"| node_tracking
node_customer_portal -->|"calls API"| node_api
node_admin_portal -->|"calls API"| node_api
node_warehouse_portal -->|"calls API"| node_api
node_driver_portal -->|"calls API"| node_api
node_api -.->|"routes requests"| node_orders
node_api -.->|"routes requests"| node_inventory
node_api -.->|"routes requests"| node_transport
node_api -.->|"routes requests"| node_feedback
node_orders -.->|"persists"| node_models
node_fulfillment -.->|"reads and writes"| node_models
node_inventory -.->|"reads and writes"| node_models
node_returns -.->|"records returns"| node_models
node_warehousing -.->|"reads and writes"| node_models
node_transport -.->|"reads and writes"| node_models
node_driver_ops -.->|"updates delivery"| node_models
node_tracking -.->|"records positions"| node_models
node_feedback -.->|"stores feedback"| node_models
node_admin_portal -.->|"shows reports"| node_reports
node_api -.->|"serves media"| node_storage

click node_customer_portal "https://github.com/jasonsaldua23-oss/capstone/blob/main/src/components/portals/customer/CustomerPortal.tsx"
click node_admin_portal "https://github.com/jasonsaldua23-oss/capstone/blob/main/src/components/portals/admin/AdminPortal.tsx"
click node_warehouse_portal "https://github.com/jasonsaldua23-oss/capstone/blob/main/src/components/portals/warehouse/WarehousePortal.tsx"
click node_driver_portal "https://github.com/jasonsaldua23-oss/capstone/blob/main/src/components/portals/driver/DriverPortal.tsx"
click node_customer_mobile "https://github.com/jasonsaldua23-oss/capstone/blob/main/mobile/customer-app/App.tsx"
click node_driver_mobile "https://github.com/jasonsaldua23-oss/capstone/blob/main/mobile/driver-app/App.tsx"
click node_orders "https://github.com/jasonsaldua23-oss/capstone/blob/main/backend/core/order_lifecycle.py"
click node_fulfillment "https://github.com/jasonsaldua23-oss/capstone/blob/main/backend/core/order_fulfillment.py"
click node_inventory "https://github.com/jasonsaldua23-oss/capstone/blob/main/backend/core/inventory_allocation.py"
click node_returns "https://github.com/jasonsaldua23-oss/capstone/blob/main/backend/core/deposit_lifecycle.py"
click node_warehousing "https://github.com/jasonsaldua23-oss/capstone/blob/main/backend/core/views_warehouses.py"
click node_transport "https://github.com/jasonsaldua23-oss/capstone/blob/main/backend/core/views_trip_planning.py"
click node_driver_ops "https://github.com/jasonsaldua23-oss/capstone/blob/main/backend/core/views_driver.py"
click node_tracking "https://github.com/jasonsaldua23-oss/capstone/blob/main/backend/core/views_trips.py"
click node_feedback "https://github.com/jasonsaldua23-oss/capstone/blob/main/backend/core/views_feedback.py"
click node_api "https://github.com/jasonsaldua23-oss/capstone/blob/main/backend/core/urls.py"
click node_models "https://github.com/jasonsaldua23-oss/capstone/blob/main/backend/core/models.py"
click node_storage "https://github.com/jasonsaldua23-oss/capstone/blob/main/backend/core/object_storage.py"
click node_reports "https://github.com/jasonsaldua23-oss/capstone/blob/main/src/components/portals/admin/sections/reports/top-clients-report.tsx"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_customer_portal,node_admin_portal,node_warehouse_portal,node_driver_portal,node_customer_mobile,node_driver_mobile toneBlue
class node_orders,node_fulfillment,node_inventory,node_returns,node_warehousing,node_feedback,node_reports toneAmber
class node_transport,node_driver_ops,node_tracking toneMint
class node_api,node_models,node_storage toneRose
class node_customer,node_staff,node_driver toneIndigo
```

## Components

### User interfaces

- [Customer portal](https://github.com/jasonsaldua23-oss/capstone/blob/main/src/components/portals/customer/CustomerPortal.tsx): `src/components/portals/customer/CustomerPortal.tsx`
- [Admin portal](https://github.com/jasonsaldua23-oss/capstone/blob/main/src/components/portals/admin/AdminPortal.tsx): `src/components/portals/admin/AdminPortal.tsx`
- [Warehouse portal](https://github.com/jasonsaldua23-oss/capstone/blob/main/src/components/portals/warehouse/WarehousePortal.tsx): `src/components/portals/warehouse/WarehousePortal.tsx`
- [Driver portal](https://github.com/jasonsaldua23-oss/capstone/blob/main/src/components/portals/driver/DriverPortal.tsx): `src/components/portals/driver/DriverPortal.tsx`
- [Customer mobile app](https://github.com/jasonsaldua23-oss/capstone/blob/main/mobile/customer-app/App.tsx): `mobile/customer-app/App.tsx`
- [Driver mobile app](https://github.com/jasonsaldua23-oss/capstone/blob/main/mobile/driver-app/App.tsx): `mobile/driver-app/App.tsx`

### Order operations

- [Order lifecycle](https://github.com/jasonsaldua23-oss/capstone/blob/main/backend/core/order_lifecycle.py): `backend/core/order_lifecycle.py`
- [Order fulfillment](https://github.com/jasonsaldua23-oss/capstone/blob/main/backend/core/order_fulfillment.py): `backend/core/order_fulfillment.py`
- [Inventory management](https://github.com/jasonsaldua23-oss/capstone/blob/main/backend/core/inventory_allocation.py): `backend/core/inventory_allocation.py`
- [Returns and deposits](https://github.com/jasonsaldua23-oss/capstone/blob/main/backend/core/deposit_lifecycle.py): `backend/core/deposit_lifecycle.py`
- [Warehouse operations](https://github.com/jasonsaldua23-oss/capstone/blob/main/backend/core/views_warehouses.py): `backend/core/views_warehouses.py`
- [Customer feedback](https://github.com/jasonsaldua23-oss/capstone/blob/main/backend/core/views_feedback.py): `backend/core/views_feedback.py`
- [Reports and analytics](https://github.com/jasonsaldua23-oss/capstone/blob/main/src/components/portals/admin/sections/reports/top-clients-report.tsx): `src/components/portals/admin/sections/reports/top-clients-report.tsx`

### Fleet and delivery

- [Trip planning](https://github.com/jasonsaldua23-oss/capstone/blob/main/backend/core/views_trip_planning.py): `backend/core/views_trip_planning.py`
- [Driver delivery](https://github.com/jasonsaldua23-oss/capstone/blob/main/backend/core/views_driver.py): `backend/core/views_driver.py`
- [Live tracking](https://github.com/jasonsaldua23-oss/capstone/blob/main/backend/core/views_trips.py): `backend/core/views_trips.py`

### Backend platform

- [Django API](https://github.com/jasonsaldua23-oss/capstone/blob/main/backend/core/urls.py): `backend/core/urls.py`
- [Domain data models](https://github.com/jasonsaldua23-oss/capstone/blob/main/backend/core/models.py): `backend/core/models.py`
- [Object storage](https://github.com/jasonsaldua23-oss/capstone/blob/main/backend/core/object_storage.py): `backend/core/object_storage.py`

### Other components

- **Customer**
- **Operations staff**
- **Driver**

## Connections

- 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 (evidence: `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