# erriswheel/dormdishmobile architecture

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

- Interactive diagram: https://gitdiagram.com/erriswheel/dormdishmobile
- Repository: https://github.com/erriswheel/dormdishmobile

## Overview

DormDish is a campus food-ordering and delivery product: customers browse stores, order individually or as a group, and track fulfillment; managers, riders, and administrators operate role-specific workflows. The React application selects those screens and uses a shared API client to reach an Express backend, which persists data through SQLite or PostgreSQL implementations. The README documents image uploads, address handling, verification, support, and the Android WebView shell; some of these branches are included based on documentation rather than sampled implementation. Arrows reflect explicit calls or documented connections; unsampled backend route wiring is omitted.

Main entry points: [`src/App.jsx`](https://github.com/erriswheel/dormdishmobile/blob/main/src/App.jsx) (Role Screens), [`src/lib/api.js`](https://github.com/erriswheel/dormdishmobile/blob/main/src/lib/api.js) (API Client), [`server/sqlite-index.js`](https://github.com/erriswheel/dormdishmobile/blob/main/server/sqlite-index.js) (Express API), [`src/pages/customer/CustomerOrdersPage.jsx`](https://github.com/erriswheel/dormdishmobile/blob/main/src/pages/customer/CustomerOrdersPage.jsx) (Customer Orders)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Customer Experience"]
  node_webapp["Role Screens<br/>[App.jsx]"]
  node_customer["Customer Orders"]
  node_grouporder["Group Ordering"]
  node_addresses["Address Book"]
  node_uploads["Image Uploads"]
  node_images["Image Display<br/>[MediaImage.jsx]"]
  node_support["Support<br/>[SupportPage.jsx]"]
  node_verification["Email Verification"]
  node_tracking["Live Tracking<br/>[LiveRiderMap.jsx]"]
  node_android["Android WebView<br/>[App.js]"]
end

subgraph group_operations["Operations Workflows"]
  node_manager_ui["Store Manager"]
  node_rider_ui["Rider Dashboard<br/>[RiderDashboard.jsx]"]
  node_admin_ui["Administration<br/>[AdminDashboard.jsx]"]
end

subgraph group_services["API Services"]
  node_api_client["API Client<br/>[api.js]"]
  node_api["Express API<br/>[sqlite-index.js]"]
  node_auth["Authentication<br/>[auth.js]"]
  node_group_service["Group Order Logic<br/>[group-orders.js]"]
  node_pg_api["PostgreSQL API<br/>[postgres-index.js]"]
end

subgraph group_persistence["Persistence"]
  node_db[("SQLite Database<br/>[database.js]")]
  node_image_store[("Image Storage<br/>[database.js]")]
end

node_student(("Student"))
node_staff(("Store Staff"))
node_rider(("Delivery Rider"))
node_admin(("Administrator"))
node_map_lookup["OpenStreetMap Lookup"]

node_student -->|"uses"| node_webapp
node_staff -->|"uses"| node_webapp
node_rider -->|"uses"| node_webapp
node_admin -->|"uses"| node_webapp
node_webapp -->|"requests"| node_api_client
node_customer -->|"requests"| node_api_client
node_grouporder -->|"requests"| node_api_client
node_addresses -->|"searches"| node_map_lookup
node_uploads -->|"uploads through"| node_api_client
node_uploads -->|"previews with"| node_images
node_webapp -->|"routes to"| node_manager_ui
node_webapp -->|"routes to"| node_rider_ui
node_webapp -->|"routes to"| node_admin_ui
node_webapp -->|"routes to"| node_support
node_webapp -->|"routes to"| node_verification
node_manager_ui -->|"requests"| node_api_client
node_rider_ui -->|"requests"| node_api_client
node_admin_ui -->|"requests"| node_api_client
node_support -->|"requests"| node_api_client
node_verification -->|"requests"| node_api_client
node_customer -->|"renders"| node_tracking
node_api_client -->|"calls API"| node_api
node_api -->|"uses"| node_auth
node_api -->|"uses"| node_group_service
node_api -.->|"reads and writes"| node_db
node_pg_api -.->|"uses database layer"| node_db
node_api -.->|"stores uploads"| node_image_store
node_android -->|"loads hosted site"| node_webapp
node_android -->|"sends API requests"| node_api_client

click node_webapp "https://github.com/erriswheel/dormdishmobile/blob/main/src/App.jsx"
click node_customer "https://github.com/erriswheel/dormdishmobile/blob/main/src/pages/customer/CustomerOrdersPage.jsx"
click node_grouporder "https://github.com/erriswheel/dormdishmobile/blob/main/src/pages/customer/GroupOrderPanel.jsx"
click node_addresses "https://github.com/erriswheel/dormdishmobile/blob/main/src/components/AddressMapPicker.jsx"
click node_uploads "https://github.com/erriswheel/dormdishmobile/blob/main/src/components/ImageUploadField.jsx"
click node_images "https://github.com/erriswheel/dormdishmobile/blob/main/src/components/MediaImage.jsx"
click node_api_client "https://github.com/erriswheel/dormdishmobile/blob/main/src/lib/api.js"
click node_manager_ui "https://github.com/erriswheel/dormdishmobile/blob/main/src/pages/manager/ManagerDashboard.jsx"
click node_rider_ui "https://github.com/erriswheel/dormdishmobile/blob/main/src/pages/rider/RiderDashboard.jsx"
click node_admin_ui "https://github.com/erriswheel/dormdishmobile/blob/main/src/pages/admin/AdminDashboard.jsx"
click node_support "https://github.com/erriswheel/dormdishmobile/blob/main/src/pages/SupportPage.jsx"
click node_verification "https://github.com/erriswheel/dormdishmobile/blob/main/src/pages/VerificationPage.jsx"
click node_tracking "https://github.com/erriswheel/dormdishmobile/blob/main/src/components/LiveRiderMap.jsx"
click node_api "https://github.com/erriswheel/dormdishmobile/blob/main/server/sqlite-index.js"
click node_auth "https://github.com/erriswheel/dormdishmobile/blob/main/server/auth.js"
click node_group_service "https://github.com/erriswheel/dormdishmobile/blob/main/server/group-orders.js"
click node_db "https://github.com/erriswheel/dormdishmobile/blob/main/server/database.js"
click node_pg_api "https://github.com/erriswheel/dormdishmobile/blob/main/server/postgres-index.js"
click node_android "https://github.com/erriswheel/dormdishmobile/blob/main/mobile/App.js"
click node_image_store "https://github.com/erriswheel/dormdishmobile/blob/main/server/database.js"

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_webapp,node_customer,node_grouporder,node_addresses,node_uploads,node_images,node_support,node_verification,node_tracking,node_android toneBlue
class node_manager_ui,node_rider_ui,node_admin_ui toneAmber
class node_api_client,node_api,node_auth,node_group_service,node_pg_api toneMint
class node_db,node_image_store toneRose
class node_student,node_staff,node_rider,node_admin,node_map_lookup toneIndigo
```

## Components

### Customer Experience

- [Role Screens](https://github.com/erriswheel/dormdishmobile/blob/main/src/App.jsx): `src/App.jsx`
- [Customer Orders](https://github.com/erriswheel/dormdishmobile/blob/main/src/pages/customer/CustomerOrdersPage.jsx): `src/pages/customer/CustomerOrdersPage.jsx`
- [Group Ordering](https://github.com/erriswheel/dormdishmobile/blob/main/src/pages/customer/GroupOrderPanel.jsx): `src/pages/customer/GroupOrderPanel.jsx`
- [Address Book](https://github.com/erriswheel/dormdishmobile/blob/main/src/components/AddressMapPicker.jsx): `src/components/AddressMapPicker.jsx`
- [Image Uploads](https://github.com/erriswheel/dormdishmobile/blob/main/src/components/ImageUploadField.jsx): `src/components/ImageUploadField.jsx`
- [Image Display](https://github.com/erriswheel/dormdishmobile/blob/main/src/components/MediaImage.jsx): `src/components/MediaImage.jsx`
- [Support](https://github.com/erriswheel/dormdishmobile/blob/main/src/pages/SupportPage.jsx): `src/pages/SupportPage.jsx`
- [Email Verification](https://github.com/erriswheel/dormdishmobile/blob/main/src/pages/VerificationPage.jsx): `src/pages/VerificationPage.jsx`
- [Live Tracking](https://github.com/erriswheel/dormdishmobile/blob/main/src/components/LiveRiderMap.jsx): `src/components/LiveRiderMap.jsx`
- [Android WebView](https://github.com/erriswheel/dormdishmobile/blob/main/mobile/App.js): `mobile/App.js`

### Operations Workflows

- [Store Manager](https://github.com/erriswheel/dormdishmobile/blob/main/src/pages/manager/ManagerDashboard.jsx): `src/pages/manager/ManagerDashboard.jsx`
- [Rider Dashboard](https://github.com/erriswheel/dormdishmobile/blob/main/src/pages/rider/RiderDashboard.jsx): `src/pages/rider/RiderDashboard.jsx`
- [Administration](https://github.com/erriswheel/dormdishmobile/blob/main/src/pages/admin/AdminDashboard.jsx): `src/pages/admin/AdminDashboard.jsx`

### API Services

- [API Client](https://github.com/erriswheel/dormdishmobile/blob/main/src/lib/api.js): `src/lib/api.js`
- [Express API](https://github.com/erriswheel/dormdishmobile/blob/main/server/sqlite-index.js): `server/sqlite-index.js`
- [Authentication](https://github.com/erriswheel/dormdishmobile/blob/main/server/auth.js): `server/auth.js`
- [Group Order Logic](https://github.com/erriswheel/dormdishmobile/blob/main/server/group-orders.js): `server/group-orders.js`
- [PostgreSQL API](https://github.com/erriswheel/dormdishmobile/blob/main/server/postgres-index.js): `server/postgres-index.js`

### Persistence

- [SQLite Database](https://github.com/erriswheel/dormdishmobile/blob/main/server/database.js): `server/database.js`
- [Image Storage](https://github.com/erriswheel/dormdishmobile/blob/main/server/database.js): `server/database.js`

### Other components

- **Student**
- **Store Staff**
- **Delivery Rider**
- **Administrator**
- **OpenStreetMap Lookup**

## Connections

- Student → Role Screens: uses (evidence: `README.md`)
- Store Staff → Role Screens: uses (evidence: `README.md`)
- Delivery Rider → Role Screens: uses (evidence: `README.md`)
- Administrator → Role Screens: uses (evidence: `README.md`)
- Role Screens → API Client: requests (evidence: `src/App.jsx`)
- Customer Orders → API Client: requests (evidence: `src/pages/customer/CustomerOrdersPage.jsx`)
- Group Ordering → API Client: requests (evidence: `src/pages/customer/GroupOrderPanel.jsx`)
- Address Book → OpenStreetMap Lookup: searches (evidence: `src/components/AddressMapPicker.jsx`)
- Image Uploads → API Client: uploads through (evidence: `src/components/ImageUploadField.jsx`)
- Image Uploads → Image Display: previews with (evidence: `src/components/ImageUploadField.jsx`)
- Role Screens → Store Manager: routes to (evidence: `src/App.jsx`)
- Role Screens → Rider Dashboard: routes to (evidence: `src/App.jsx`)
- Role Screens → Administration: routes to (evidence: `src/App.jsx`)
- Role Screens → Support: routes to (evidence: `src/App.jsx`)
- Role Screens → Email Verification: routes to (evidence: `src/App.jsx`)
- Store Manager → API Client: requests (evidence: `src/pages/manager/ManagerDashboard.jsx`)
- Rider Dashboard → API Client: requests (evidence: `src/pages/rider/RiderDashboard.jsx`)
- Administration → API Client: requests (evidence: `src/pages/admin/AdminDashboard.jsx`)
- Support → API Client: requests (evidence: `src/pages/SupportPage.jsx`)
- Email Verification → API Client: requests (evidence: `src/pages/VerificationPage.jsx`)
- Customer Orders → Live Tracking: renders (evidence: `src/pages/customer/CustomerOrdersPage.jsx`)
- API Client → Express API: calls API (evidence: `README.md`)
- Express API → Authentication: uses (evidence: `server/sqlite-index.js`)
- Express API → Group Order Logic: uses (evidence: `server/sqlite-index.js`)
- Express API → SQLite Database: reads and writes (evidence: `server/sqlite-index.js`)
- PostgreSQL API → SQLite Database: uses database layer
- Express API → Image Storage: stores uploads (evidence: `server/sqlite-index.js`)
- Android WebView → Role Screens: loads hosted site (evidence: `README.md`)
- Android WebView → API Client: sends API requests (evidence: `README.md`)
