# m-ayaz-xyz/recycle_connect architecture

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

- Interactive diagram: https://gitdiagram.com/m-ayaz-xyz/recycle_connect
- Repository: https://github.com/m-ayaz-xyz/recycle_connect

## Overview

Recycle Connect is a portfolio web app for connecting users with nearby recycling vendors and arranging pickups. Its principal workflow is account access, vendor discovery, pickup scheduling, and order tracking; vendors also manage profiles and respond to orders. The graph separates the Next.js experience from Express routing, domain controllers, and MongoDB-backed models. README capabilities guide the frontend branches, but frontend source excerpts were not provided, so those internal links are left unverified rather than inferred from page names.

Main entry points: [`backend/routes/dashboardRoute.js`](https://github.com/m-ayaz-xyz/recycle_connect/blob/main/backend/routes/dashboardRoute.js) (Dashboard routes), [`backend/controllers/locationController.js`](https://github.com/m-ayaz-xyz/recycle_connect/blob/main/backend/controllers/locationController.js) (Location discovery), [`backend/controllers/orderController.js`](https://github.com/m-ayaz-xyz/recycle_connect/blob/main/backend/controllers/orderController.js) (Order management), [`backend/server.js`](https://github.com/m-ayaz-xyz/recycle_connect/blob/main/backend/server.js) (Express server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_auth_ui["Sign in/up<br/>[page.jsx]"]
  node_user_home["User dashboard<br/>[page.jsx]"]
  node_vendor_discovery["Vendor discovery<br/>[page.jsx]"]
  node_schedule["Pickup scheduling<br/>[page.jsx]"]
  node_orders_ui["Order tracking<br/>[page.jsx]"]
  node_maps["Interactive maps<br/>[MapView.jsx]"]
  node_vendor_map["Vendor map<br/>[VendorMap.jsx]"]
end

subgraph group_api["API and access"]
  node_server["Express server<br/>[server.js]"]
  node_auth_routes["Auth routes<br/>[authRoutes.js]"]
  node_dashboard_routes["Dashboard routes<br/>[dashboardRoute.js]"]
  node_auth_middleware["JWT authentication<br/>[authMiddleware.js]"]
  node_role_middleware["Role authorization<br/>[roleMiddleware.js]"]
end

subgraph group_domain["Domain services"]
  node_auth_service["Account service<br/>[authController.js]"]
  node_vendor_service["Vendor profiles"]
  node_location_service["Location discovery"]
  node_distance["Distance calculation<br/>[haversine.js]"]
  node_order_service["Order management<br/>[orderController.js]"]
end

subgraph group_data["Persistence"]
  node_database_config["Database connection<br/>[db.js]"]
  node_user_model[("User records<br/>[User.js]")]
  node_vendor_model[("Vendor records<br/>[Vendor.js]")]
  node_order_model[("Order records<br/>[Order.js]")]
end

node_user(("User"))
node_vendor_actor(("Vendor"))
node_mongodb[("MongoDB")]
node_osm["OpenStreetMap"]

node_user -.->|"authenticates"| node_auth_ui
node_user -.->|"uses"| node_user_home
node_user_home -.->|"discovers vendors"| node_vendor_discovery
node_vendor_discovery -.->|"schedules pickup"| node_schedule
node_schedule -.->|"tracks orders"| node_orders_ui
node_vendor_actor -.->|"views map"| node_vendor_map
node_server -->|"connects"| node_database_config
node_server -->|"mounts"| node_auth_routes
node_server -->|"mounts"| node_dashboard_routes
node_auth_routes -->|"dispatches"| node_auth_service
node_auth_routes -->|"guards profile"| node_auth_middleware
node_dashboard_routes -->|"guards routes"| node_auth_middleware
node_dashboard_routes -->|"checks roles"| node_role_middleware
node_dashboard_routes -->|"dispatches"| node_vendor_service
node_dashboard_routes -->|"dispatches"| node_location_service
node_dashboard_routes -->|"dispatches"| node_order_service
node_auth_service -->|"reads/writes"| node_user_model
node_vendor_service -->|"reads/writes"| node_vendor_model
node_location_service -->|"reads/writes"| node_user_model
node_location_service -->|"reads"| node_vendor_model
node_location_service -->|"calculates distance"| node_distance
node_order_service -->|"reads/writes"| node_order_model
node_order_service -->|"reads"| node_user_model
node_order_service -->|"reads"| node_vendor_model
node_database_config -.->|"connects"| node_mongodb
node_maps -.->|"uses map data"| node_osm

click node_auth_ui "https://github.com/m-ayaz-xyz/recycle_connect/blob/main/frontend/src/app/auth/login/page.jsx"
click node_user_home "https://github.com/m-ayaz-xyz/recycle_connect/blob/main/frontend/src/app/dashboard/user/page.jsx"
click node_vendor_discovery "https://github.com/m-ayaz-xyz/recycle_connect/blob/main/frontend/src/app/dashboard/user/%5Busername%5D/page.jsx"
click node_schedule "https://github.com/m-ayaz-xyz/recycle_connect/blob/main/frontend/src/app/dashboard/user/%5Busername%5D/schedule/page.jsx"
click node_orders_ui "https://github.com/m-ayaz-xyz/recycle_connect/blob/main/frontend/src/app/dashboard/user/orders/page.jsx"
click node_maps "https://github.com/m-ayaz-xyz/recycle_connect/blob/main/frontend/src/components/ui/MapView.jsx"
click node_vendor_map "https://github.com/m-ayaz-xyz/recycle_connect/blob/main/frontend/src/components/ui/VendorMap.jsx"
click node_server "https://github.com/m-ayaz-xyz/recycle_connect/blob/main/backend/server.js"
click node_auth_routes "https://github.com/m-ayaz-xyz/recycle_connect/blob/main/backend/routes/authRoutes.js"
click node_dashboard_routes "https://github.com/m-ayaz-xyz/recycle_connect/blob/main/backend/routes/dashboardRoute.js"
click node_auth_middleware "https://github.com/m-ayaz-xyz/recycle_connect/blob/main/backend/middleware/authMiddleware.js"
click node_role_middleware "https://github.com/m-ayaz-xyz/recycle_connect/blob/main/backend/middleware/roleMiddleware.js"
click node_auth_service "https://github.com/m-ayaz-xyz/recycle_connect/blob/main/backend/controllers/authController.js"
click node_vendor_service "https://github.com/m-ayaz-xyz/recycle_connect/blob/main/backend/controllers/vendorprofileController.js"
click node_location_service "https://github.com/m-ayaz-xyz/recycle_connect/blob/main/backend/controllers/locationController.js"
click node_distance "https://github.com/m-ayaz-xyz/recycle_connect/blob/main/backend/utils/haversine.js"
click node_order_service "https://github.com/m-ayaz-xyz/recycle_connect/blob/main/backend/controllers/orderController.js"
click node_database_config "https://github.com/m-ayaz-xyz/recycle_connect/blob/main/backend/config/db.js"
click node_user_model "https://github.com/m-ayaz-xyz/recycle_connect/blob/main/backend/models/User.js"
click node_vendor_model "https://github.com/m-ayaz-xyz/recycle_connect/blob/main/backend/models/Vendor.js"
click node_order_model "https://github.com/m-ayaz-xyz/recycle_connect/blob/main/backend/models/Order.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_auth_ui,node_user_home,node_vendor_discovery,node_schedule,node_orders_ui,node_maps,node_vendor_map,node_user toneBlue
class node_server,node_auth_routes,node_dashboard_routes,node_auth_middleware,node_role_middleware,node_mongodb toneAmber
class node_auth_service,node_vendor_service,node_location_service,node_distance,node_order_service toneMint
class node_database_config,node_user_model,node_vendor_model,node_order_model toneRose
class node_vendor_actor,node_osm toneIndigo
```

## Components

### Web experience

- [Sign in/up](https://github.com/m-ayaz-xyz/recycle_connect/blob/main/frontend/src/app/auth/login/page.jsx): `frontend/src/app/auth/login/page.jsx`
- [User dashboard](https://github.com/m-ayaz-xyz/recycle_connect/blob/main/frontend/src/app/dashboard/user/page.jsx): `frontend/src/app/dashboard/user/page.jsx`
- [Vendor discovery](https://github.com/m-ayaz-xyz/recycle_connect/blob/main/frontend/src/app/dashboard/user/%5Busername%5D/page.jsx): `frontend/src/app/dashboard/user/[username]/page.jsx`
- [Pickup scheduling](https://github.com/m-ayaz-xyz/recycle_connect/blob/main/frontend/src/app/dashboard/user/%5Busername%5D/schedule/page.jsx): `frontend/src/app/dashboard/user/[username]/schedule/page.jsx`
- [Order tracking](https://github.com/m-ayaz-xyz/recycle_connect/blob/main/frontend/src/app/dashboard/user/orders/page.jsx): `frontend/src/app/dashboard/user/orders/page.jsx`
- [Interactive maps](https://github.com/m-ayaz-xyz/recycle_connect/blob/main/frontend/src/components/ui/MapView.jsx): `frontend/src/components/ui/MapView.jsx`
- [Vendor map](https://github.com/m-ayaz-xyz/recycle_connect/blob/main/frontend/src/components/ui/VendorMap.jsx): `frontend/src/components/ui/VendorMap.jsx`

### API and access

- [Express server](https://github.com/m-ayaz-xyz/recycle_connect/blob/main/backend/server.js): `backend/server.js`
- [Auth routes](https://github.com/m-ayaz-xyz/recycle_connect/blob/main/backend/routes/authRoutes.js): `backend/routes/authRoutes.js`
- [Dashboard routes](https://github.com/m-ayaz-xyz/recycle_connect/blob/main/backend/routes/dashboardRoute.js): `backend/routes/dashboardRoute.js`
- [JWT authentication](https://github.com/m-ayaz-xyz/recycle_connect/blob/main/backend/middleware/authMiddleware.js): `backend/middleware/authMiddleware.js`
- [Role authorization](https://github.com/m-ayaz-xyz/recycle_connect/blob/main/backend/middleware/roleMiddleware.js): `backend/middleware/roleMiddleware.js`

### Domain services

- [Account service](https://github.com/m-ayaz-xyz/recycle_connect/blob/main/backend/controllers/authController.js): `backend/controllers/authController.js`
- [Vendor profiles](https://github.com/m-ayaz-xyz/recycle_connect/blob/main/backend/controllers/vendorprofileController.js): `backend/controllers/vendorprofileController.js`
- [Location discovery](https://github.com/m-ayaz-xyz/recycle_connect/blob/main/backend/controllers/locationController.js): `backend/controllers/locationController.js`
- [Distance calculation](https://github.com/m-ayaz-xyz/recycle_connect/blob/main/backend/utils/haversine.js): `backend/utils/haversine.js`
- [Order management](https://github.com/m-ayaz-xyz/recycle_connect/blob/main/backend/controllers/orderController.js): `backend/controllers/orderController.js`

### Persistence

- [Database connection](https://github.com/m-ayaz-xyz/recycle_connect/blob/main/backend/config/db.js): `backend/config/db.js`
- [User records](https://github.com/m-ayaz-xyz/recycle_connect/blob/main/backend/models/User.js): `backend/models/User.js`
- [Vendor records](https://github.com/m-ayaz-xyz/recycle_connect/blob/main/backend/models/Vendor.js): `backend/models/Vendor.js`
- [Order records](https://github.com/m-ayaz-xyz/recycle_connect/blob/main/backend/models/Order.js): `backend/models/Order.js`

### Other components

- **User**
- **Vendor**
- **MongoDB**
- **OpenStreetMap**

## Connections

- User → Sign in/up: authenticates
- User → User dashboard: uses
- User dashboard → Vendor discovery: discovers vendors
- Vendor discovery → Pickup scheduling: schedules pickup
- Pickup scheduling → Order tracking: tracks orders
- Vendor → Vendor map: views map
- Express server → Database connection: connects (evidence: `backend/server.js`)
- Express server → Auth routes: mounts (evidence: `backend/server.js`)
- Express server → Dashboard routes: mounts (evidence: `backend/server.js`)
- Auth routes → Account service: dispatches (evidence: `backend/routes/authRoutes.js`)
- Auth routes → JWT authentication: guards profile (evidence: `backend/routes/authRoutes.js`)
- Dashboard routes → JWT authentication: guards routes (evidence: `backend/routes/dashboardRoute.js`)
- Dashboard routes → Role authorization: checks roles (evidence: `backend/routes/dashboardRoute.js`)
- Dashboard routes → Vendor profiles: dispatches (evidence: `backend/routes/dashboardRoute.js`)
- Dashboard routes → Location discovery: dispatches (evidence: `backend/routes/dashboardRoute.js`)
- Dashboard routes → Order management: dispatches (evidence: `backend/routes/dashboardRoute.js`)
- Account service → User records: reads/writes (evidence: `backend/controllers/authController.js`)
- Vendor profiles → Vendor records: reads/writes (evidence: `backend/controllers/vendorprofileController.js`)
- Location discovery → User records: reads/writes (evidence: `backend/controllers/locationController.js`)
- Location discovery → Vendor records: reads (evidence: `backend/controllers/locationController.js`)
- Location discovery → Distance calculation: calculates distance (evidence: `backend/controllers/locationController.js`)
- Order management → Order records: reads/writes (evidence: `backend/controllers/orderController.js`)
- Order management → User records: reads (evidence: `backend/controllers/orderController.js`)
- Order management → Vendor records: reads (evidence: `backend/controllers/orderController.js`)
- Database connection → MongoDB: connects
- Interactive maps → OpenStreetMap: uses map data
