# sajid019129/eco-cart architecture

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

- Interactive diagram: https://gitdiagram.com/sajid019129/eco-cart
- Repository: https://github.com/sajid019129/eco-cart

## Overview

Eco-Cart is a reuse-focused marketplace for buyers, sellers, and delivery personnel. Buyers browse and filter listings, add items to a cart, check out, and track orders; sellers manage listings and orders, while donated items have a separate marketplace and claim flow. The React application coordinates these experiences with an Express API backed by MongoDB. The README documents the major workflows; the sampled excerpts show selected frontend calls, route registration, and model use, but not every page-to-API interaction.

Main entry points: [`client/src/App.jsx`](https://github.com/sajid019129/eco-cart/blob/main/client/src/App.jsx) (App Router), [`server/index.js`](https://github.com/sajid019129/eco-cart/blob/main/server/index.js) (Express Server), [`server/routes/orders.js`](https://github.com/sajid019129/eco-cart/blob/main/server/routes/orders.js) (Order Routes), [`server/routes/products.js`](https://github.com/sajid019129/eco-cart/blob/main/server/routes/products.js) (Product Routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Marketplace UI"]
  node_app["App Router<br/>[App.jsx]"]
  node_navbar["Navigation<br/>[Navbar.jsx]"]
  node_market["Product Marketplace<br/>[App.jsx]"]
  node_search["Search Filters<br/>[ProductSearch.jsx]"]
  node_listing["Listing Editor<br/>[AddProduct.jsx]"]
  node_cart["Cart<br/>[Cart.jsx]"]
  node_checkout["Checkout<br/>[CheckoutModal.jsx]"]
  node_donate["Donation Submission<br/>[DonateProduct.jsx]"]
  node_donations["Donation Marketplace"]
  node_auth["Authentication Pages<br/>[Register.jsx]"]
  node_sellerdash["Seller Dashboard"]
  node_deliverydash["Logistics Dashboard"]
  node_tracking["Order Tracking<br/>[TrackOrder.jsx]"]
  node_invoice["Invoice View<br/>[InvoiceModal.jsx]"]
end

subgraph group_api["API Services"]
  node_server["Express Server<br/>[index.js]"]
  node_authroutes["Auth Routes<br/>[auth.js]"]
  node_productroutes["Product Routes<br/>[products.js]"]
  node_cartroutes["Cart Routes<br/>[cart.js]"]
  node_orderroutes["Order Routes<br/>[orders.js]"]
  node_notifieroutes["Notification Routes<br/>[notifications.js]"]
end

subgraph group_data["Marketplace Data"]
  node_users[("User Records<br/>[User.js]")]
  node_products[("Product Records<br/>[Product.js]")]
  node_carts[("Cart Records<br/>[Cart.js]")]
  node_orders[("Order Records<br/>[Order.js]")]
  node_notifications[("Notification Records<br/>[Notification.js]")]
  node_categories[("Category Records<br/>[Category.js]")]
end

node_buyer(("Buyer"))
node_seller(("Seller"))
node_delivery(("Delivery Staff"))
node_mongo[("MongoDB")]

node_buyer -->|"uses"| node_app
node_seller -->|"uses"| node_app
node_delivery -->|"uses"| node_app
node_app -->|"renders"| node_navbar
node_app -->|"routes"| node_market
node_market -->|"filters with"| node_search
node_app -->|"renders"| node_listing
node_app -->|"renders"| node_cart
node_cart -->|"opens"| node_checkout
node_app -->|"routes"| node_donate
node_app -->|"routes"| node_donations
node_app -->|"routes"| node_auth
node_app -->|"routes"| node_sellerdash
node_app -->|"routes"| node_deliverydash
node_app -->|"routes"| node_tracking
node_cart -->|"opens"| node_invoice
node_server -->|"mounts"| node_authroutes
node_server -->|"mounts"| node_productroutes
node_server -->|"mounts"| node_cartroutes
node_server -->|"mounts"| node_orderroutes
node_server -->|"mounts"| node_notifieroutes
node_app -->|"fetches listings"| node_productroutes
node_navbar -->|"updates profiles"| node_authroutes
node_navbar -->|"fetches notices"| node_notifieroutes
node_authroutes -->|"reads and writes"| node_users
node_authroutes -->|"uses"| node_products
node_authroutes -->|"uses"| node_carts
node_productroutes -->|"reads and writes"| node_products
node_productroutes -->|"looks up"| node_categories
node_productroutes -->|"uses"| node_users
node_productroutes -->|"cleans up"| node_carts
node_cartroutes -->|"reads and writes"| node_carts
node_cartroutes -->|"uses"| node_products
node_orderroutes -->|"reads and writes"| node_orders
node_orderroutes -->|"uses"| node_products
node_orderroutes -->|"uses"| node_users
node_orderroutes -->|"uses"| node_carts
node_orderroutes -->|"creates"| node_notifications
node_notifieroutes -->|"reads and updates"| node_notifications
node_server -->|"connects"| node_mongo

click node_app "https://github.com/sajid019129/eco-cart/blob/main/client/src/App.jsx"
click node_navbar "https://github.com/sajid019129/eco-cart/blob/main/client/src/components/Navbar.jsx"
click node_market "https://github.com/sajid019129/eco-cart/blob/main/client/src/App.jsx"
click node_search "https://github.com/sajid019129/eco-cart/blob/main/client/src/components/ProductSearch.jsx"
click node_listing "https://github.com/sajid019129/eco-cart/blob/main/client/src/components/AddProduct.jsx"
click node_cart "https://github.com/sajid019129/eco-cart/blob/main/client/src/components/Cart.jsx"
click node_checkout "https://github.com/sajid019129/eco-cart/blob/main/client/src/components/CheckoutModal.jsx"
click node_donate "https://github.com/sajid019129/eco-cart/blob/main/client/src/components/DonateProduct.jsx"
click node_donations "https://github.com/sajid019129/eco-cart/blob/main/client/src/components/DonationMarketplace.jsx"
click node_auth "https://github.com/sajid019129/eco-cart/blob/main/client/src/pages/Register.jsx"
click node_sellerdash "https://github.com/sajid019129/eco-cart/blob/main/client/src/pages/SellerDashboard.jsx"
click node_deliverydash "https://github.com/sajid019129/eco-cart/blob/main/client/src/pages/LogisticsDashboard.jsx"
click node_tracking "https://github.com/sajid019129/eco-cart/blob/main/client/src/pages/TrackOrder.jsx"
click node_invoice "https://github.com/sajid019129/eco-cart/blob/main/client/src/components/InvoiceModal.jsx"
click node_server "https://github.com/sajid019129/eco-cart/blob/main/server/index.js"
click node_authroutes "https://github.com/sajid019129/eco-cart/blob/main/server/routes/auth.js"
click node_productroutes "https://github.com/sajid019129/eco-cart/blob/main/server/routes/products.js"
click node_cartroutes "https://github.com/sajid019129/eco-cart/blob/main/server/routes/cart.js"
click node_orderroutes "https://github.com/sajid019129/eco-cart/blob/main/server/routes/orders.js"
click node_notifieroutes "https://github.com/sajid019129/eco-cart/blob/main/server/routes/notifications.js"
click node_users "https://github.com/sajid019129/eco-cart/blob/main/server/models/User.js"
click node_products "https://github.com/sajid019129/eco-cart/blob/main/server/models/Product.js"
click node_carts "https://github.com/sajid019129/eco-cart/blob/main/server/models/Cart.js"
click node_orders "https://github.com/sajid019129/eco-cart/blob/main/server/models/Order.js"
click node_notifications "https://github.com/sajid019129/eco-cart/blob/main/server/models/Notification.js"
click node_categories "https://github.com/sajid019129/eco-cart/blob/main/server/models/Category.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_app,node_navbar,node_market,node_search,node_listing,node_cart,node_checkout,node_donate,node_donations,node_auth,node_sellerdash,node_deliverydash,node_tracking,node_invoice toneBlue
class node_server,node_authroutes,node_productroutes,node_cartroutes,node_orderroutes,node_notifieroutes,node_mongo toneAmber
class node_users,node_products,node_carts,node_orders,node_notifications,node_categories toneMint
class node_buyer,node_seller,node_delivery toneIndigo
```

## Components

### Marketplace UI

- [App Router](https://github.com/sajid019129/eco-cart/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Navigation](https://github.com/sajid019129/eco-cart/blob/main/client/src/components/Navbar.jsx): `client/src/components/Navbar.jsx`
- [Product Marketplace](https://github.com/sajid019129/eco-cart/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Search Filters](https://github.com/sajid019129/eco-cart/blob/main/client/src/components/ProductSearch.jsx): `client/src/components/ProductSearch.jsx`
- [Listing Editor](https://github.com/sajid019129/eco-cart/blob/main/client/src/components/AddProduct.jsx): `client/src/components/AddProduct.jsx`
- [Cart](https://github.com/sajid019129/eco-cart/blob/main/client/src/components/Cart.jsx): `client/src/components/Cart.jsx`
- [Checkout](https://github.com/sajid019129/eco-cart/blob/main/client/src/components/CheckoutModal.jsx): `client/src/components/CheckoutModal.jsx`
- [Donation Submission](https://github.com/sajid019129/eco-cart/blob/main/client/src/components/DonateProduct.jsx): `client/src/components/DonateProduct.jsx`
- [Donation Marketplace](https://github.com/sajid019129/eco-cart/blob/main/client/src/components/DonationMarketplace.jsx): `client/src/components/DonationMarketplace.jsx`
- [Authentication Pages](https://github.com/sajid019129/eco-cart/blob/main/client/src/pages/Register.jsx): `client/src/pages/Register.jsx`
- [Seller Dashboard](https://github.com/sajid019129/eco-cart/blob/main/client/src/pages/SellerDashboard.jsx): `client/src/pages/SellerDashboard.jsx`
- [Logistics Dashboard](https://github.com/sajid019129/eco-cart/blob/main/client/src/pages/LogisticsDashboard.jsx): `client/src/pages/LogisticsDashboard.jsx`
- [Order Tracking](https://github.com/sajid019129/eco-cart/blob/main/client/src/pages/TrackOrder.jsx): `client/src/pages/TrackOrder.jsx`
- [Invoice View](https://github.com/sajid019129/eco-cart/blob/main/client/src/components/InvoiceModal.jsx): `client/src/components/InvoiceModal.jsx`

### API Services

- [Express Server](https://github.com/sajid019129/eco-cart/blob/main/server/index.js): `server/index.js`
- [Auth Routes](https://github.com/sajid019129/eco-cart/blob/main/server/routes/auth.js): `server/routes/auth.js`
- [Product Routes](https://github.com/sajid019129/eco-cart/blob/main/server/routes/products.js): `server/routes/products.js`
- [Cart Routes](https://github.com/sajid019129/eco-cart/blob/main/server/routes/cart.js): `server/routes/cart.js`
- [Order Routes](https://github.com/sajid019129/eco-cart/blob/main/server/routes/orders.js): `server/routes/orders.js`
- [Notification Routes](https://github.com/sajid019129/eco-cart/blob/main/server/routes/notifications.js): `server/routes/notifications.js`

### Marketplace Data

- [User Records](https://github.com/sajid019129/eco-cart/blob/main/server/models/User.js): `server/models/User.js`
- [Product Records](https://github.com/sajid019129/eco-cart/blob/main/server/models/Product.js): `server/models/Product.js`
- [Cart Records](https://github.com/sajid019129/eco-cart/blob/main/server/models/Cart.js): `server/models/Cart.js`
- [Order Records](https://github.com/sajid019129/eco-cart/blob/main/server/models/Order.js): `server/models/Order.js`
- [Notification Records](https://github.com/sajid019129/eco-cart/blob/main/server/models/Notification.js): `server/models/Notification.js`
- [Category Records](https://github.com/sajid019129/eco-cart/blob/main/server/models/Category.js): `server/models/Category.js`

### Other components

- **Buyer**
- **Seller**
- **Delivery Staff**
- **MongoDB**

## Connections

- Buyer → App Router: uses (evidence: `README.md`)
- Seller → App Router: uses (evidence: `README.md`)
- Delivery Staff → App Router: uses (evidence: `README.md`)
- App Router → Navigation: renders (evidence: `client/src/App.jsx`)
- App Router → Product Marketplace: routes (evidence: `client/src/App.jsx`)
- Product Marketplace → Search Filters: filters with (evidence: `client/src/App.jsx`)
- App Router → Listing Editor: renders (evidence: `client/src/App.jsx`)
- App Router → Cart: renders (evidence: `client/src/App.jsx`)
- Cart → Checkout: opens (evidence: `client/src/components/Cart.jsx`)
- App Router → Donation Submission: routes (evidence: `client/src/App.jsx`)
- App Router → Donation Marketplace: routes (evidence: `client/src/App.jsx`)
- App Router → Authentication Pages: routes (evidence: `client/src/App.jsx`)
- App Router → Seller Dashboard: routes (evidence: `client/src/App.jsx`)
- App Router → Logistics Dashboard: routes (evidence: `client/src/App.jsx`)
- App Router → Order Tracking: routes (evidence: `client/src/App.jsx`)
- Cart → Invoice View: opens (evidence: `client/src/components/Cart.jsx`)
- Express Server → Auth Routes: mounts (evidence: `server/index.js`)
- Express Server → Product Routes: mounts (evidence: `server/index.js`)
- Express Server → Cart Routes: mounts (evidence: `server/index.js`)
- Express Server → Order Routes: mounts (evidence: `server/index.js`)
- Express Server → Notification Routes: mounts (evidence: `server/index.js`)
- App Router → Product Routes: fetches listings (evidence: `client/src/App.jsx`)
- Navigation → Auth Routes: updates profiles (evidence: `client/src/components/Navbar.jsx`)
- Navigation → Notification Routes: fetches notices (evidence: `client/src/components/Navbar.jsx`)
- Auth Routes → User Records: reads and writes (evidence: `server/routes/auth.js`)
- Auth Routes → Product Records: uses (evidence: `server/routes/auth.js`)
- Auth Routes → Cart Records: uses (evidence: `server/routes/auth.js`)
- Product Routes → Product Records: reads and writes (evidence: `server/routes/products.js`)
- Product Routes → Category Records: looks up (evidence: `server/routes/products.js`)
- Product Routes → User Records: uses (evidence: `server/routes/products.js`)
- Product Routes → Cart Records: cleans up (evidence: `server/routes/products.js`)
- Cart Routes → Cart Records: reads and writes (evidence: `server/routes/cart.js`)
- Cart Routes → Product Records: uses (evidence: `server/routes/cart.js`)
- Order Routes → Order Records: reads and writes (evidence: `server/routes/orders.js`)
- Order Routes → Product Records: uses (evidence: `server/routes/orders.js`)
- Order Routes → User Records: uses (evidence: `server/routes/orders.js`)
- Order Routes → Cart Records: uses (evidence: `server/routes/orders.js`)
- Order Routes → Notification Records: creates (evidence: `server/routes/orders.js`)
- Notification Routes → Notification Records: reads and updates (evidence: `server/routes/notifications.js`)
- Express Server → MongoDB: connects (evidence: `server/index.js`)
