# rayan-ite/sped-go architecture

> Architecture diagram of the GitHub repository rayan-ite/sped-go, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rayan-ite/sped-go
- Repository: https://github.com/rayan-ite/sped-go

## Overview

Spedgo is a multi-surface logistics platform for customers, drivers, store owners, and administrators. Customers browse products, place orders with a selected driver, and track delivery; drivers accept and complete deliveries while broadcasting GPS; store owners manage stores and inventory; administrators monitor operations and fleet activity. The mobile and web clients use an ASP.NET API backed by SQL Server, with SignalR for live updates. The graph preserves the documented product areas; some client-to-API links are based on README descriptions because their implementations were not sampled.

Main entry points: [`backend/new/AuthApi/Data/AppDbContext.cs`](https://github.com/rayan-ite/sped-go/blob/master/backend/new/AuthApi/Data/AppDbContext.cs) (Entity data context), [`services/apiClient.js`](https://github.com/rayan-ite/sped-go/blob/master/services/apiClient.js) (API client), [`App.js`](https://github.com/rayan-ite/sped-go/blob/master/App.js) (Mobile app entry), [`spedgo-web/src/App.tsx`](https://github.com/rayan-ite/sped-go/blob/master/spedgo-web/src/App.tsx) (Web application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_mobile["Mobile app"]
  node_mobileapp["Mobile app entry<br/>[App.js]"]
  node_mobilenav["Role navigation<br/>[AppNavigator.js]"]
  node_mobileauth["Session and auth<br/>[AuthContext.js]"]
  node_mobilemarket["Marketplace and checkout<br/>[CheckoutScreen.js]"]
  node_mobileorders["Orders and tracking<br/>[FleetScreen.js]"]
  node_mobiledriver["Driver operations<br/>[DriverScreen.js]"]
  node_mobilestore["Store management"]
  node_mobileadmin["Admin fleet"]
  node_mobileapi["API client<br/>[apiClient.js]"]
  node_mobilelive["SignalR client<br/>[signalrService.js]"]
  node_mobilestoreage["Session storage<br/>[storage.js]"]
end

subgraph group_web["Web app"]
  node_webapp["Web application<br/>[App.tsx]"]
  node_webroutes["Role-based routes<br/>[index.tsx]"]
  node_webcustomer["Customer pages"]
  node_webdriver["Driver deliveries<br/>[DeliveriesPage.tsx]"]
  node_webstore["Store-owner page<br/>[StorePage.tsx]"]
  node_webadmin["Admin dashboard<br/>[OverviewPage.tsx]"]
  node_webfleet["Live fleet map<br/>[FleetMap.tsx]"]
  node_webapi["Web API client<br/>[client.ts]"]
  node_weblive["Web SignalR<br/>[signalr.ts]"]
end

subgraph group_api["Backend API"]
  node_authapi["Authentication API<br/>[AuthController.cs]"]
  node_ordersapi["Orders API"]
  node_driverapi["Driver API"]
  node_catalogapi["Products and stores"]
  node_adminapi["Administration API<br/>[AdminController.cs]"]
  node_ridesapi["Rides API<br/>[RidesController.cs]"]
  node_usersapi["Users API<br/>[UsersController.cs]"]
end

subgraph group_state["Data and realtime"]
  node_dbcontext["Entity data context<br/>[AppDbContext.cs]"]
  node_sqlserver[("SQL Server")]
  node_driverhub["DriverHub realtime<br/>[DriverHub.cs]"]
end

node_customer(("Customer"))
node_driver(("Driver"))
node_storeowner(("Store owner"))
node_admin(("Administrator"))

node_customer -->|"uses"| node_mobileapp
node_driver -->|"uses"| node_mobileapp
node_storeowner -->|"uses"| node_mobileapp
node_admin -->|"uses"| node_mobileapp
node_mobileapp -->|"renders"| node_mobilenav
node_mobilenav -->|"checks session"| node_mobileauth
node_mobileauth -->|"restores session"| node_mobilestoreage
node_mobileauth -->|"uses"| node_mobileapi
node_customer -->|"browses and checks out"| node_mobilemarket
node_customer -->|"tracks orders"| node_mobileorders
node_driver -->|"manages deliveries"| node_mobiledriver
node_storeowner -->|"manages inventory"| node_mobilestore
node_admin -->|"monitors fleet"| node_mobileadmin
node_mobilemarket -.->|"requests"| node_mobileapi
node_mobileorders -->|"requests"| node_mobileapi
node_mobileorders -->|"subscribes"| node_mobilelive
node_mobiledriver -->|"requests"| node_mobileapi
node_mobiledriver -.->|"broadcasts location"| node_mobilelive
node_mobilestore -->|"manages products"| node_mobileapi
node_mobileadmin -.->|"requests fleet data"| node_mobileapi
node_mobileapi -.->|"calls"| node_ordersapi
node_mobilelive -.->|"connects"| node_driverhub
node_customer -->|"uses"| node_webapp
node_driver -->|"uses"| node_webapp
node_storeowner -->|"uses"| node_webapp
node_admin -->|"uses"| node_webapp
node_webapp -.->|"routes"| node_webroutes
node_customer -->|"shops and tracks"| node_webcustomer
node_driver -->|"manages deliveries"| node_webdriver
node_storeowner -->|"manages store"| node_webstore
node_admin -->|"reviews operations"| node_webadmin
node_webadmin -->|"shows live fleet"| node_webfleet
node_webcustomer -.->|"requests"| node_webapi
node_webdriver -.->|"requests"| node_webapi
node_webstore -.->|"requests"| node_webapi
node_webadmin -.->|"requests"| node_webapi
node_webfleet -.->|"receives live drivers"| node_weblive
node_webapi -.->|"calls"| node_authapi
node_weblive -.->|"connects"| node_driverhub
node_ordersapi -->|"reads and writes"| node_dbcontext
node_driverapi -->|"reads and writes"| node_dbcontext
node_adminapi -->|"queries"| node_dbcontext
node_ordersapi -->|"notifies drivers"| node_driverhub
node_driverhub -->|"updates driver state"| node_dbcontext
node_authapi -.->|"persists accounts"| node_dbcontext
node_catalogapi -.->|"manages catalog"| node_dbcontext
node_ridesapi -.->|"manages rides"| node_dbcontext
node_usersapi -.->|"manages users"| node_dbcontext

click node_mobileapp "https://github.com/rayan-ite/sped-go/blob/master/App.js"
click node_mobilenav "https://github.com/rayan-ite/sped-go/blob/master/navigation/AppNavigator.js"
click node_mobileauth "https://github.com/rayan-ite/sped-go/blob/master/context/AuthContext.js"
click node_mobilemarket "https://github.com/rayan-ite/sped-go/blob/master/screens/CheckoutScreen.js"
click node_mobileorders "https://github.com/rayan-ite/sped-go/blob/master/screens/FleetScreen.js"
click node_mobiledriver "https://github.com/rayan-ite/sped-go/blob/master/screens/DriverScreen.js"
click node_mobilestore "https://github.com/rayan-ite/sped-go/blob/master/screens/StoreOwnerScreen.js"
click node_mobileadmin "https://github.com/rayan-ite/sped-go/blob/master/screens/AdminFleetScreen.js"
click node_mobileapi "https://github.com/rayan-ite/sped-go/blob/master/services/apiClient.js"
click node_mobilelive "https://github.com/rayan-ite/sped-go/blob/master/services/signalrService.js"
click node_mobilestoreage "https://github.com/rayan-ite/sped-go/blob/master/services/storage.js"
click node_webapp "https://github.com/rayan-ite/sped-go/blob/master/spedgo-web/src/App.tsx"
click node_webroutes "https://github.com/rayan-ite/sped-go/blob/master/spedgo-web/src/routes/index.tsx"
click node_webcustomer "https://github.com/rayan-ite/sped-go/blob/master/spedgo-web/src/pages/customer/MarketplacePage.tsx"
click node_webdriver "https://github.com/rayan-ite/sped-go/blob/master/spedgo-web/src/pages/driver/DeliveriesPage.tsx"
click node_webstore "https://github.com/rayan-ite/sped-go/blob/master/spedgo-web/src/pages/store-owner/StorePage.tsx"
click node_webadmin "https://github.com/rayan-ite/sped-go/blob/master/spedgo-web/src/dashboard/pages/OverviewPage.tsx"
click node_webfleet "https://github.com/rayan-ite/sped-go/blob/master/spedgo-web/src/dashboard/fleet/FleetMap.tsx"
click node_webapi "https://github.com/rayan-ite/sped-go/blob/master/spedgo-web/src/api/client.ts"
click node_weblive "https://github.com/rayan-ite/sped-go/blob/master/spedgo-web/src/services/signalr.ts"
click node_authapi "https://github.com/rayan-ite/sped-go/blob/master/backend/new/AuthApi/Controllers/AuthController.cs"
click node_ordersapi "https://github.com/rayan-ite/sped-go/blob/master/backend/new/AuthApi/Controllers/OrdersController.cs"
click node_driverapi "https://github.com/rayan-ite/sped-go/blob/master/backend/new/AuthApi/Controllers/DriverController.cs"
click node_catalogapi "https://github.com/rayan-ite/sped-go/blob/master/backend/new/AuthApi/Controllers/ProductsController.cs"
click node_adminapi "https://github.com/rayan-ite/sped-go/blob/master/backend/new/AuthApi/Controllers/AdminController.cs"
click node_ridesapi "https://github.com/rayan-ite/sped-go/blob/master/backend/new/AuthApi/Controllers/RidesController.cs"
click node_usersapi "https://github.com/rayan-ite/sped-go/blob/master/backend/new/AuthApi/Controllers/UsersController.cs"
click node_dbcontext "https://github.com/rayan-ite/sped-go/blob/master/backend/new/AuthApi/Data/AppDbContext.cs"
click node_driverhub "https://github.com/rayan-ite/sped-go/blob/master/backend/new/AuthApi/Hubs/DriverHub.cs"

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_mobileapp,node_mobilenav,node_mobileauth,node_mobilemarket,node_mobileorders,node_mobiledriver,node_mobilestore,node_mobileadmin,node_mobileapi,node_mobilelive,node_mobilestoreage toneBlue
class node_webapp,node_webroutes,node_webcustomer,node_webdriver,node_webstore,node_webadmin,node_webfleet,node_webapi,node_weblive toneAmber
class node_authapi,node_ordersapi,node_driverapi,node_catalogapi,node_adminapi,node_ridesapi,node_usersapi toneMint
class node_dbcontext,node_sqlserver,node_driverhub toneRose
class node_customer,node_driver,node_storeowner,node_admin toneIndigo
```

## Components

### Mobile app

- [Mobile app entry](https://github.com/rayan-ite/sped-go/blob/master/App.js): `App.js`
- [Role navigation](https://github.com/rayan-ite/sped-go/blob/master/navigation/AppNavigator.js): `navigation/AppNavigator.js`
- [Session and auth](https://github.com/rayan-ite/sped-go/blob/master/context/AuthContext.js): `context/AuthContext.js`
- [Marketplace and checkout](https://github.com/rayan-ite/sped-go/blob/master/screens/CheckoutScreen.js): `screens/CheckoutScreen.js`
- [Orders and tracking](https://github.com/rayan-ite/sped-go/blob/master/screens/FleetScreen.js): `screens/FleetScreen.js`
- [Driver operations](https://github.com/rayan-ite/sped-go/blob/master/screens/DriverScreen.js): `screens/DriverScreen.js`
- [Store management](https://github.com/rayan-ite/sped-go/blob/master/screens/StoreOwnerScreen.js): `screens/StoreOwnerScreen.js`
- [Admin fleet](https://github.com/rayan-ite/sped-go/blob/master/screens/AdminFleetScreen.js): `screens/AdminFleetScreen.js`
- [API client](https://github.com/rayan-ite/sped-go/blob/master/services/apiClient.js): `services/apiClient.js`
- [SignalR client](https://github.com/rayan-ite/sped-go/blob/master/services/signalrService.js): `services/signalrService.js`
- [Session storage](https://github.com/rayan-ite/sped-go/blob/master/services/storage.js): `services/storage.js`

### Web app

- [Web application](https://github.com/rayan-ite/sped-go/blob/master/spedgo-web/src/App.tsx): `spedgo-web/src/App.tsx`
- [Role-based routes](https://github.com/rayan-ite/sped-go/blob/master/spedgo-web/src/routes/index.tsx): `spedgo-web/src/routes/index.tsx`
- [Customer pages](https://github.com/rayan-ite/sped-go/blob/master/spedgo-web/src/pages/customer/MarketplacePage.tsx): `spedgo-web/src/pages/customer/MarketplacePage.tsx`
- [Driver deliveries](https://github.com/rayan-ite/sped-go/blob/master/spedgo-web/src/pages/driver/DeliveriesPage.tsx): `spedgo-web/src/pages/driver/DeliveriesPage.tsx`
- [Store-owner page](https://github.com/rayan-ite/sped-go/blob/master/spedgo-web/src/pages/store-owner/StorePage.tsx): `spedgo-web/src/pages/store-owner/StorePage.tsx`
- [Admin dashboard](https://github.com/rayan-ite/sped-go/blob/master/spedgo-web/src/dashboard/pages/OverviewPage.tsx): `spedgo-web/src/dashboard/pages/OverviewPage.tsx`
- [Live fleet map](https://github.com/rayan-ite/sped-go/blob/master/spedgo-web/src/dashboard/fleet/FleetMap.tsx): `spedgo-web/src/dashboard/fleet/FleetMap.tsx`
- [Web API client](https://github.com/rayan-ite/sped-go/blob/master/spedgo-web/src/api/client.ts): `spedgo-web/src/api/client.ts`
- [Web SignalR](https://github.com/rayan-ite/sped-go/blob/master/spedgo-web/src/services/signalr.ts): `spedgo-web/src/services/signalr.ts`

### Backend API

- [Authentication API](https://github.com/rayan-ite/sped-go/blob/master/backend/new/AuthApi/Controllers/AuthController.cs): `backend/new/AuthApi/Controllers/AuthController.cs`
- [Orders API](https://github.com/rayan-ite/sped-go/blob/master/backend/new/AuthApi/Controllers/OrdersController.cs): `backend/new/AuthApi/Controllers/OrdersController.cs`
- [Driver API](https://github.com/rayan-ite/sped-go/blob/master/backend/new/AuthApi/Controllers/DriverController.cs): `backend/new/AuthApi/Controllers/DriverController.cs`
- [Products and stores](https://github.com/rayan-ite/sped-go/blob/master/backend/new/AuthApi/Controllers/ProductsController.cs): `backend/new/AuthApi/Controllers/ProductsController.cs`
- [Administration API](https://github.com/rayan-ite/sped-go/blob/master/backend/new/AuthApi/Controllers/AdminController.cs): `backend/new/AuthApi/Controllers/AdminController.cs`
- [Rides API](https://github.com/rayan-ite/sped-go/blob/master/backend/new/AuthApi/Controllers/RidesController.cs): `backend/new/AuthApi/Controllers/RidesController.cs`
- [Users API](https://github.com/rayan-ite/sped-go/blob/master/backend/new/AuthApi/Controllers/UsersController.cs): `backend/new/AuthApi/Controllers/UsersController.cs`

### Data and realtime

- [Entity data context](https://github.com/rayan-ite/sped-go/blob/master/backend/new/AuthApi/Data/AppDbContext.cs): `backend/new/AuthApi/Data/AppDbContext.cs`
- **SQL Server**
- [DriverHub realtime](https://github.com/rayan-ite/sped-go/blob/master/backend/new/AuthApi/Hubs/DriverHub.cs): `backend/new/AuthApi/Hubs/DriverHub.cs`

### Other components

- **Customer**
- **Driver**
- **Store owner**
- **Administrator**

## Connections

- Customer → Mobile app entry: uses
- Driver → Mobile app entry: uses
- Store owner → Mobile app entry: uses
- Administrator → Mobile app entry: uses
- Mobile app entry → Role navigation: renders (evidence: `App.js`)
- Role navigation → Session and auth: checks session (evidence: `navigation/AppNavigator.js`)
- Session and auth → Session storage: restores session (evidence: `context/AuthContext.js`)
- Session and auth → API client: uses (evidence: `context/AuthContext.js`)
- Customer → Marketplace and checkout: browses and checks out
- Customer → Orders and tracking: tracks orders
- Driver → Driver operations: manages deliveries
- Store owner → Store management: manages inventory
- Administrator → Admin fleet: monitors fleet
- Marketplace and checkout → API client: requests
- Orders and tracking → API client: requests (evidence: `screens/FleetScreen.js`)
- Orders and tracking → SignalR client: subscribes (evidence: `screens/FleetScreen.js`)
- Driver operations → API client: requests (evidence: `screens/DriverScreen.js`)
- Driver operations → SignalR client: broadcasts location (evidence: `screens/DriverScreen.js`)
- Store management → API client: manages products (evidence: `screens/StoreOwnerScreen.js`)
- Admin fleet → API client: requests fleet data
- API client → Orders API: calls
- SignalR client → DriverHub realtime: connects
- Customer → Web application: uses
- Driver → Web application: uses
- Store owner → Web application: uses
- Administrator → Web application: uses
- Web application → Role-based routes: routes
- Customer → Customer pages: shops and tracks
- Driver → Driver deliveries: manages deliveries
- Store owner → Store-owner page: manages store
- Administrator → Admin dashboard: reviews operations
- Admin dashboard → Live fleet map: shows live fleet
- Customer pages → Web API client: requests
- Driver deliveries → Web API client: requests
- Store-owner page → Web API client: requests
- Admin dashboard → Web API client: requests
- Live fleet map → Web SignalR: receives live drivers
- Web API client → Authentication API: calls
- Web SignalR → DriverHub realtime: connects
- Orders API → Entity data context: reads and writes (evidence: `backend/new/AuthApi/Controllers/OrdersController.cs`)
- Driver API → Entity data context: reads and writes (evidence: `backend/new/AuthApi/Controllers/DriverController.cs`)
- Administration API → Entity data context: queries (evidence: `backend/new/AuthApi/Controllers/AdminController.cs`)
- Orders API → DriverHub realtime: notifies drivers (evidence: `backend/new/AuthApi/Controllers/OrdersController.cs`)
- DriverHub realtime → Entity data context: updates driver state (evidence: `backend/new/AuthApi/Hubs/DriverHub.cs`)
- Authentication API → Entity data context: persists accounts
- Products and stores → Entity data context: manages catalog
- Rides API → Entity data context: manages rides
- Users API → Entity data context: manages users
