# junaidanser65/whole_project architecture

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

- Interactive diagram: https://gitdiagram.com/junaidanser65/whole_project
- Repository: https://github.com/junaidanser65/whole_project

## Overview

Fiesta Carts is a multi-client vendor marketplace: customers discover vendors and menus, book services, pay, and communicate; vendors manage bookings, menus, availability, and profiles; administrators manage users and vendors. The backend exposes these capabilities through Express routes backed by MySQL, with WebSockets for live vendor-location updates. The graph follows the main customer booking path and preserves the separate vendor and admin branches. Relationships are limited to explicit imports, route mounts, and API paths in the excerpts or SOURCE INDEX; unsampled client and route details are not inferred.

Main entry points: [`FYP_Backend_Server_User/server.js`](https://github.com/junaidanser65/whole_project/blob/master/FYP_Backend_Server_User/server.js) (HTTP server), [`FYP_Backend_Server_User/config/database.js`](https://github.com/junaidanser65/whole_project/blob/master/FYP_Backend_Server_User/config/database.js) (MySQL data), [`FYP_Backend_Server_User/middleware/auth.js`](https://github.com/junaidanser65/whole_project/blob/master/FYP_Backend_Server_User/middleware/auth.js) (User auth checks), [`fiestacarts_new/src/api/apiService.js`](https://github.com/junaidanser65/whole_project/blob/master/fiestacarts_new/src/api/apiService.js) (Customer API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_admin["Admin Console"]
  node_admin_ui["Admin screens"]
  node_admin_auth["Admin login<br/>[authService.ts]"]
  node_admin_api["Admin API client<br/>[api.ts]"]
end

subgraph group_customer["Customer App"]
  node_customer_app["Customer screens"]
  node_customer_nav["Customer navigation<br/>[AppNavigator.js]"]
  node_customer_auth["Customer auth state<br/>[AuthContext.js]"]
  node_booking_state["Booking state<br/>[BookingContext.js]"]
  node_customer_api["Customer API client<br/>[apiService.js]"]
end

subgraph group_vendor["Vendor App"]
  node_vendor_app["Vendor screens"]
  node_vendor_nav["Vendor navigation<br/>[AppNavigator.js]"]
  node_vendor_auth["Vendor auth state<br/>[AuthContext.js]"]
  node_vendor_api["Vendor API client<br/>[api.js]"]
end

subgraph group_backend["Backend API"]
  node_backend_server["HTTP server<br/>[server.js]"]
  node_user_auth["User authentication<br/>[auth.js]"]
  node_bookings["Bookings<br/>[bookings.js]"]
  node_availability["Availability<br/>[availability.js]"]
  node_menus["Menus<br/>[menu.js]"]
  node_vendor_routes["Vendor directory<br/>[vendors.js]"]
  node_profile["Profiles<br/>[profile.js]"]
  node_chat["Chat<br/>[chat.js]"]
  node_reviews["Reviews<br/>[reviews.js]"]
  node_admin_routes["Admin routes"]
  node_auth_middleware["User auth checks<br/>[auth.js]"]
  node_admin_middleware["Admin auth checks<br/>[adminAuth.js]"]
  node_database[("MySQL data<br/>[database.js]")]
end

subgraph group_realtime["Live Location"]
  node_location_service["Location updates<br/>[server.js]"]
  node_location_clients["Connected clients<br/>[server.js]"]
end

node_admin_actor(("Administrator"))
node_customer_actor(("Customer"))
node_vendor_actor(("Vendor"))

node_admin_actor -->|"uses"| node_admin_ui
node_admin_ui -.->|"authenticates via"| node_admin_auth
node_admin_auth -->|"posts login"| node_admin_api
node_customer_actor -->|"uses"| node_customer_app
node_customer_app -.->|"navigates via"| node_customer_nav
node_customer_auth -->|"calls"| node_customer_api
node_customer_api -->|"posts login and signup"| node_user_auth
node_customer_api -.->|"requests bookings"| node_bookings
node_customer_api -.->|"gets vendor menu"| node_menus
node_customer_nav -.->|"routes screens"| node_customer_app
node_booking_state -.->|"supports booking"| node_customer_app
node_vendor_actor -->|"uses"| node_vendor_app
node_vendor_app -.->|"navigates via"| node_vendor_nav
node_vendor_auth -->|"calls"| node_vendor_api
node_vendor_nav -.->|"routes screens"| node_vendor_app
node_vendor_api -.->|"sends requests"| node_backend_server
node_backend_server -->|"mounts routes"| node_user_auth
node_backend_server -->|"mounts routes"| node_bookings
node_backend_server -->|"mounts routes"| node_availability
node_backend_server -->|"mounts routes"| node_menus
node_backend_server -->|"mounts routes"| node_vendor_routes
node_backend_server -->|"mounts routes"| node_profile
node_backend_server -->|"mounts routes"| node_chat
node_backend_server -->|"mounts routes"| node_reviews
node_backend_server -->|"mounts routes"| node_admin_routes
node_user_auth -->|"reads and writes"| node_database
node_bookings -->|"reads and writes"| node_database
node_availability -->|"queries"| node_database
node_menus -->|"queries"| node_database
node_vendor_routes -->|"queries"| node_database
node_profile -->|"queries"| node_database
node_chat -->|"queries"| node_database
node_reviews -->|"reads and writes"| node_database
node_admin_routes -.->|"queries"| node_database
node_bookings -->|"uses auth"| node_auth_middleware
node_availability -->|"uses auth"| node_auth_middleware
node_menus -->|"uses auth"| node_auth_middleware
node_profile -->|"uses auth"| node_auth_middleware
node_chat -->|"uses auth"| node_auth_middleware
node_reviews -->|"uses auth"| node_auth_middleware
node_admin_routes -.->|"guards routes"| node_admin_middleware
node_admin_middleware -->|"checks admin"| node_database
node_backend_server -->|"hosts WebSocket"| node_location_service
node_location_service -->|"tracks and broadcasts"| node_location_clients

click node_admin_ui "https://github.com/junaidanser65/whole_project/tree/master/FYP_Admin/components"
click node_admin_auth "https://github.com/junaidanser65/whole_project/blob/master/FYP_Admin/services/authService.ts"
click node_admin_api "https://github.com/junaidanser65/whole_project/blob/master/FYP_Admin/services/api.ts"
click node_customer_app "https://github.com/junaidanser65/whole_project/tree/master/fiestacarts_new/src/screens"
click node_customer_nav "https://github.com/junaidanser65/whole_project/blob/master/fiestacarts_new/src/navigation/AppNavigator.js"
click node_customer_auth "https://github.com/junaidanser65/whole_project/blob/master/fiestacarts_new/src/contexts/AuthContext.js"
click node_booking_state "https://github.com/junaidanser65/whole_project/blob/master/fiestacarts_new/src/contexts/BookingContext.js"
click node_customer_api "https://github.com/junaidanser65/whole_project/blob/master/fiestacarts_new/src/api/apiService.js"
click node_vendor_app "https://github.com/junaidanser65/whole_project/tree/master/Vendor_App-FYP/src/screens"
click node_vendor_nav "https://github.com/junaidanser65/whole_project/blob/master/Vendor_App-FYP/src/navigation/AppNavigator.js"
click node_vendor_auth "https://github.com/junaidanser65/whole_project/blob/master/Vendor_App-FYP/src/contexts/AuthContext.js"
click node_vendor_api "https://github.com/junaidanser65/whole_project/blob/master/Vendor_App-FYP/src/services/api.js"
click node_backend_server "https://github.com/junaidanser65/whole_project/blob/master/FYP_Backend_Server_User/server.js"
click node_user_auth "https://github.com/junaidanser65/whole_project/blob/master/FYP_Backend_Server_User/routes/auth.js"
click node_bookings "https://github.com/junaidanser65/whole_project/blob/master/FYP_Backend_Server_User/routes/bookings.js"
click node_availability "https://github.com/junaidanser65/whole_project/blob/master/FYP_Backend_Server_User/routes/availability.js"
click node_menus "https://github.com/junaidanser65/whole_project/blob/master/FYP_Backend_Server_User/routes/menu.js"
click node_vendor_routes "https://github.com/junaidanser65/whole_project/blob/master/FYP_Backend_Server_User/routes/vendors.js"
click node_profile "https://github.com/junaidanser65/whole_project/blob/master/FYP_Backend_Server_User/routes/profile.js"
click node_chat "https://github.com/junaidanser65/whole_project/blob/master/FYP_Backend_Server_User/routes/chat.js"
click node_reviews "https://github.com/junaidanser65/whole_project/blob/master/FYP_Backend_Server_User/routes/reviews.js"
click node_admin_routes "https://github.com/junaidanser65/whole_project/tree/master/FYP_Backend_Server_User/routes/admin"
click node_auth_middleware "https://github.com/junaidanser65/whole_project/blob/master/FYP_Backend_Server_User/middleware/auth.js"
click node_admin_middleware "https://github.com/junaidanser65/whole_project/blob/master/FYP_Backend_Server_User/middleware/adminAuth.js"
click node_database "https://github.com/junaidanser65/whole_project/blob/master/FYP_Backend_Server_User/config/database.js"
click node_location_service "https://github.com/junaidanser65/whole_project/blob/master/FYP_Backend_Server_User/server.js"
click node_location_clients "https://github.com/junaidanser65/whole_project/blob/master/FYP_Backend_Server_User/server.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_admin_ui,node_admin_auth,node_admin_api toneBlue
class node_customer_app,node_customer_nav,node_customer_auth,node_booking_state,node_customer_api toneAmber
class node_vendor_app,node_vendor_nav,node_vendor_auth,node_vendor_api toneMint
class node_backend_server,node_user_auth,node_bookings,node_availability,node_menus,node_vendor_routes,node_profile,node_chat,node_reviews,node_admin_routes,node_auth_middleware,node_admin_middleware,node_database toneRose
class node_location_service,node_location_clients,node_admin_actor,node_customer_actor,node_vendor_actor toneIndigo
```

## Components

### Admin Console

- [Admin screens](https://github.com/junaidanser65/whole_project/tree/master/FYP_Admin/components): `FYP_Admin/components`
- [Admin login](https://github.com/junaidanser65/whole_project/blob/master/FYP_Admin/services/authService.ts): `FYP_Admin/services/authService.ts`
- [Admin API client](https://github.com/junaidanser65/whole_project/blob/master/FYP_Admin/services/api.ts): `FYP_Admin/services/api.ts`

### Customer App

- [Customer screens](https://github.com/junaidanser65/whole_project/tree/master/fiestacarts_new/src/screens): `fiestacarts_new/src/screens`
- [Customer navigation](https://github.com/junaidanser65/whole_project/blob/master/fiestacarts_new/src/navigation/AppNavigator.js): `fiestacarts_new/src/navigation/AppNavigator.js`
- [Customer auth state](https://github.com/junaidanser65/whole_project/blob/master/fiestacarts_new/src/contexts/AuthContext.js): `fiestacarts_new/src/contexts/AuthContext.js`
- [Booking state](https://github.com/junaidanser65/whole_project/blob/master/fiestacarts_new/src/contexts/BookingContext.js): `fiestacarts_new/src/contexts/BookingContext.js`
- [Customer API client](https://github.com/junaidanser65/whole_project/blob/master/fiestacarts_new/src/api/apiService.js): `fiestacarts_new/src/api/apiService.js`

### Vendor App

- [Vendor screens](https://github.com/junaidanser65/whole_project/tree/master/Vendor_App-FYP/src/screens): `Vendor_App-FYP/src/screens`
- [Vendor navigation](https://github.com/junaidanser65/whole_project/blob/master/Vendor_App-FYP/src/navigation/AppNavigator.js): `Vendor_App-FYP/src/navigation/AppNavigator.js`
- [Vendor auth state](https://github.com/junaidanser65/whole_project/blob/master/Vendor_App-FYP/src/contexts/AuthContext.js): `Vendor_App-FYP/src/contexts/AuthContext.js`
- [Vendor API client](https://github.com/junaidanser65/whole_project/blob/master/Vendor_App-FYP/src/services/api.js): `Vendor_App-FYP/src/services/api.js`

### Backend API

- [HTTP server](https://github.com/junaidanser65/whole_project/blob/master/FYP_Backend_Server_User/server.js): `FYP_Backend_Server_User/server.js`
- [User authentication](https://github.com/junaidanser65/whole_project/blob/master/FYP_Backend_Server_User/routes/auth.js): `FYP_Backend_Server_User/routes/auth.js`
- [Bookings](https://github.com/junaidanser65/whole_project/blob/master/FYP_Backend_Server_User/routes/bookings.js): `FYP_Backend_Server_User/routes/bookings.js`
- [Availability](https://github.com/junaidanser65/whole_project/blob/master/FYP_Backend_Server_User/routes/availability.js): `FYP_Backend_Server_User/routes/availability.js`
- [Menus](https://github.com/junaidanser65/whole_project/blob/master/FYP_Backend_Server_User/routes/menu.js): `FYP_Backend_Server_User/routes/menu.js`
- [Vendor directory](https://github.com/junaidanser65/whole_project/blob/master/FYP_Backend_Server_User/routes/vendors.js): `FYP_Backend_Server_User/routes/vendors.js`
- [Profiles](https://github.com/junaidanser65/whole_project/blob/master/FYP_Backend_Server_User/routes/profile.js): `FYP_Backend_Server_User/routes/profile.js`
- [Chat](https://github.com/junaidanser65/whole_project/blob/master/FYP_Backend_Server_User/routes/chat.js): `FYP_Backend_Server_User/routes/chat.js`
- [Reviews](https://github.com/junaidanser65/whole_project/blob/master/FYP_Backend_Server_User/routes/reviews.js): `FYP_Backend_Server_User/routes/reviews.js`
- [Admin routes](https://github.com/junaidanser65/whole_project/tree/master/FYP_Backend_Server_User/routes/admin): `FYP_Backend_Server_User/routes/admin`
- [User auth checks](https://github.com/junaidanser65/whole_project/blob/master/FYP_Backend_Server_User/middleware/auth.js): `FYP_Backend_Server_User/middleware/auth.js`
- [Admin auth checks](https://github.com/junaidanser65/whole_project/blob/master/FYP_Backend_Server_User/middleware/adminAuth.js): `FYP_Backend_Server_User/middleware/adminAuth.js`
- [MySQL data](https://github.com/junaidanser65/whole_project/blob/master/FYP_Backend_Server_User/config/database.js): `FYP_Backend_Server_User/config/database.js`

### Live Location

- [Location updates](https://github.com/junaidanser65/whole_project/blob/master/FYP_Backend_Server_User/server.js): `FYP_Backend_Server_User/server.js`
- [Connected clients](https://github.com/junaidanser65/whole_project/blob/master/FYP_Backend_Server_User/server.js): `FYP_Backend_Server_User/server.js`

### Other components

- **Administrator**
- **Customer**
- **Vendor**

## Connections

- Administrator → Admin screens: uses
- Admin screens → Admin login: authenticates via
- Admin login → Admin API client: posts login (evidence: `FYP_Admin/services/authService.ts`)
- Customer → Customer screens: uses
- Customer screens → Customer navigation: navigates via
- Customer auth state → Customer API client: calls (evidence: `fiestacarts_new/src/contexts/AuthContext.js`)
- Customer API client → User authentication: posts login and signup (evidence: `fiestacarts_new/src/api/apiService.js`)
- Customer API client → Bookings: requests bookings (evidence: `fiestacarts_new/src/api/apiService.js`)
- Customer API client → Menus: gets vendor menu (evidence: `fiestacarts_new/src/api/apiService.js`)
- Customer navigation → Customer screens: routes screens
- Booking state → Customer screens: supports booking
- Vendor → Vendor screens: uses
- Vendor screens → Vendor navigation: navigates via
- Vendor auth state → Vendor API client: calls (evidence: `Vendor_App-FYP/src/contexts/AuthContext.js`)
- Vendor navigation → Vendor screens: routes screens
- Vendor API client → HTTP server: sends requests
- HTTP server → User authentication: mounts routes (evidence: `FYP_Backend_Server_User/server.js`)
- HTTP server → Bookings: mounts routes (evidence: `FYP_Backend_Server_User/server.js`)
- HTTP server → Availability: mounts routes (evidence: `FYP_Backend_Server_User/server.js`)
- HTTP server → Menus: mounts routes (evidence: `FYP_Backend_Server_User/server.js`)
- HTTP server → Vendor directory: mounts routes (evidence: `FYP_Backend_Server_User/server.js`)
- HTTP server → Profiles: mounts routes (evidence: `FYP_Backend_Server_User/server.js`)
- HTTP server → Chat: mounts routes (evidence: `FYP_Backend_Server_User/server.js`)
- HTTP server → Reviews: mounts routes (evidence: `FYP_Backend_Server_User/server.js`)
- HTTP server → Admin routes: mounts routes (evidence: `FYP_Backend_Server_User/server.js`)
- User authentication → MySQL data: reads and writes (evidence: `FYP_Backend_Server_User/routes/auth.js`)
- Bookings → MySQL data: reads and writes (evidence: `FYP_Backend_Server_User/routes/bookings.js`)
- Availability → MySQL data: queries (evidence: `FYP_Backend_Server_User/routes/availability.js`)
- Menus → MySQL data: queries (evidence: `FYP_Backend_Server_User/routes/menu.js`)
- Vendor directory → MySQL data: queries (evidence: `FYP_Backend_Server_User/routes/vendors.js`)
- Profiles → MySQL data: queries (evidence: `FYP_Backend_Server_User/routes/profile.js`)
- Chat → MySQL data: queries (evidence: `FYP_Backend_Server_User/routes/chat.js`)
- Reviews → MySQL data: reads and writes (evidence: `FYP_Backend_Server_User/routes/reviews.js`)
- Admin routes → MySQL data: queries (evidence: `FYP_Backend_Server_User/routes/admin/auth.js`)
- Bookings → User auth checks: uses auth (evidence: `FYP_Backend_Server_User/routes/bookings.js`)
- Availability → User auth checks: uses auth (evidence: `FYP_Backend_Server_User/routes/availability.js`)
- Menus → User auth checks: uses auth (evidence: `FYP_Backend_Server_User/routes/menu.js`)
- Profiles → User auth checks: uses auth (evidence: `FYP_Backend_Server_User/routes/profile.js`)
- Chat → User auth checks: uses auth (evidence: `FYP_Backend_Server_User/routes/chat.js`)
- Reviews → User auth checks: uses auth (evidence: `FYP_Backend_Server_User/routes/reviews.js`)
- Admin routes → Admin auth checks: guards routes (evidence: `FYP_Backend_Server_User/routes/admin/vendors.js`)
- Admin auth checks → MySQL data: checks admin (evidence: `FYP_Backend_Server_User/middleware/adminAuth.js`)
- HTTP server → Location updates: hosts WebSocket (evidence: `FYP_Backend_Server_User/server.js`)
- Location updates → Connected clients: tracks and broadcasts (evidence: `FYP_Backend_Server_User/server.js`)
