# misitha01/smart_vending_machine architecture

> Architecture diagram of the GitHub repository misitha01/smart_vending_machine, 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/misitha01/smart_vending_machine
- Repository: https://github.com/misitha01/smart_vending_machine

## Overview

This repository contains two parallel Express vending-store backends: a root-level product API and a broader backend API. The main user flow is product browsing and payment; the broader API also exposes authentication, discounts, inventory administration, transactions, dashboard reporting, and machine routes. PostgreSQL is the shared persistence layer in both copies. Route mounting is visible in the sampled entry points; some substantial route implementations were not excerpted, so their internal behavior is represented only at the subsystem level.

Main entry points: [`backend/index.js`](https://github.com/misitha01/smart_vending_machine/blob/main/backend/index.js) (Backend Entry), [`backend/db.js`](https://github.com/misitha01/smart_vending_machine/blob/main/backend/db.js) (Backend PostgreSQL), [`db.js`](https://github.com/misitha01/smart_vending_machine/blob/main/db.js) (Root PostgreSQL), [`index.js`](https://github.com/misitha01/smart_vending_machine/blob/main/index.js) (Root Entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_backend["Backend API"]
  node_backend_entry["Backend Entry<br/>[index.js]"]
  node_auth["Authentication<br/>[auth.js]"]
  node_admin["Administration<br/>[admin.js]"]
end

subgraph group_catalog["Catalog &amp; Offers"]
  node_discounts["Discount Offers<br/>[discountRoutes.js]"]
  node_discount_logic["Offer Logic"]
  node_backend_products["Product Routes<br/>[products.js]"]
  node_backend_product_controller["Product Controller"]
  node_machines["Machine Routes<br/>[machines.js]"]
end

subgraph group_commerce["Sales &amp; Reporting"]
  node_transactions["Transactions<br/>[transactions.js]"]
  node_backend_db[("Backend PostgreSQL<br/>[db.js]")]
end

subgraph group_root["Root API"]
  node_root_server["Root Server<br/>[server.js]"]
  node_root_product_routes["Product API Routes<br/>[productRoutes.js]"]
  node_root_controller["Product Controller"]
  node_root_products["Sales &amp; Admin API<br/>[products.js]"]
  node_root_entry["Root Entry<br/>[index.js]"]
  node_root_db[("Root PostgreSQL<br/>[db.js]")]
end

node_user(("Store User"))

node_user -->|"requests API"| node_backend_entry
node_backend_entry -->|"mounts routes"| node_auth
node_backend_entry -->|"mounts routes"| node_admin
node_backend_entry -->|"mounts routes"| node_discounts
node_backend_entry -->|"mounts routes"| node_backend_products
node_backend_entry -->|"mounts routes"| node_transactions
node_auth -->|"queries users"| node_backend_db
node_admin -->|"queries data"| node_backend_db
node_discounts -->|"queries products"| node_backend_db
node_backend_products -->|"reads and updates"| node_backend_db
node_transactions -->|"uses database"| node_backend_db
node_backend_product_controller -->|"queries products"| node_backend_db
node_backend_entry -->|"queries users"| node_backend_db
node_user -->|"requests API"| node_root_server
node_root_server -->|"mounts routes"| node_root_product_routes
node_root_product_routes -->|"dispatches to"| node_root_controller
node_root_controller -->|"queries products"| node_root_db
node_root_entry -->|"mounts routes"| node_root_products
node_root_entry -->|"uses database"| node_root_db
node_root_products -->|"queries and updates"| node_root_db

click node_backend_entry "https://github.com/misitha01/smart_vending_machine/blob/main/backend/index.js"
click node_auth "https://github.com/misitha01/smart_vending_machine/blob/main/backend/routes/auth.js"
click node_admin "https://github.com/misitha01/smart_vending_machine/blob/main/backend/routes/admin.js"
click node_discounts "https://github.com/misitha01/smart_vending_machine/blob/main/backend/routes/discountRoutes.js"
click node_discount_logic "https://github.com/misitha01/smart_vending_machine/blob/main/backend/controllers/discountController.js"
click node_backend_products "https://github.com/misitha01/smart_vending_machine/blob/main/backend/routes/products.js"
click node_backend_product_controller "https://github.com/misitha01/smart_vending_machine/blob/main/backend/controllers/productController.js"
click node_machines "https://github.com/misitha01/smart_vending_machine/blob/main/backend/routes/machines.js"
click node_transactions "https://github.com/misitha01/smart_vending_machine/blob/main/backend/routes/transactions.js"
click node_backend_db "https://github.com/misitha01/smart_vending_machine/blob/main/backend/db.js"
click node_root_server "https://github.com/misitha01/smart_vending_machine/blob/main/server.js"
click node_root_product_routes "https://github.com/misitha01/smart_vending_machine/blob/main/routes/productRoutes.js"
click node_root_controller "https://github.com/misitha01/smart_vending_machine/blob/main/controllers/productController.js"
click node_root_products "https://github.com/misitha01/smart_vending_machine/blob/main/routes/products.js"
click node_root_entry "https://github.com/misitha01/smart_vending_machine/blob/main/index.js"
click node_root_db "https://github.com/misitha01/smart_vending_machine/blob/main/db.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_backend_entry,node_auth,node_admin,node_user toneBlue
class node_discounts,node_discount_logic,node_backend_products,node_backend_product_controller,node_machines toneAmber
class node_transactions,node_backend_db toneMint
class node_root_server,node_root_product_routes,node_root_controller,node_root_products,node_root_entry,node_root_db toneRose
```

## Components

### Backend API

- [Backend Entry](https://github.com/misitha01/smart_vending_machine/blob/main/backend/index.js): `backend/index.js`
- [Authentication](https://github.com/misitha01/smart_vending_machine/blob/main/backend/routes/auth.js): `backend/routes/auth.js`
- [Administration](https://github.com/misitha01/smart_vending_machine/blob/main/backend/routes/admin.js): `backend/routes/admin.js`

### Catalog & Offers

- [Discount Offers](https://github.com/misitha01/smart_vending_machine/blob/main/backend/routes/discountRoutes.js): `backend/routes/discountRoutes.js`
- [Offer Logic](https://github.com/misitha01/smart_vending_machine/blob/main/backend/controllers/discountController.js): `backend/controllers/discountController.js`
- [Product Routes](https://github.com/misitha01/smart_vending_machine/blob/main/backend/routes/products.js): `backend/routes/products.js`
- [Product Controller](https://github.com/misitha01/smart_vending_machine/blob/main/backend/controllers/productController.js): `backend/controllers/productController.js`
- [Machine Routes](https://github.com/misitha01/smart_vending_machine/blob/main/backend/routes/machines.js): `backend/routes/machines.js`

### Sales & Reporting

- [Transactions](https://github.com/misitha01/smart_vending_machine/blob/main/backend/routes/transactions.js): `backend/routes/transactions.js`
- [Backend PostgreSQL](https://github.com/misitha01/smart_vending_machine/blob/main/backend/db.js): `backend/db.js`

### Root API

- [Root Server](https://github.com/misitha01/smart_vending_machine/blob/main/server.js): `server.js`
- [Product API Routes](https://github.com/misitha01/smart_vending_machine/blob/main/routes/productRoutes.js): `routes/productRoutes.js`
- [Product Controller](https://github.com/misitha01/smart_vending_machine/blob/main/controllers/productController.js): `controllers/productController.js`
- [Sales & Admin API](https://github.com/misitha01/smart_vending_machine/blob/main/routes/products.js): `routes/products.js`
- [Root Entry](https://github.com/misitha01/smart_vending_machine/blob/main/index.js): `index.js`
- [Root PostgreSQL](https://github.com/misitha01/smart_vending_machine/blob/main/db.js): `db.js`

### Other components

- **Store User**

## Connections

- Store User → Backend Entry: requests API (evidence: `backend/index.js`)
- Backend Entry → Authentication: mounts routes (evidence: `backend/index.js`)
- Backend Entry → Administration: mounts routes (evidence: `backend/index.js`)
- Backend Entry → Discount Offers: mounts routes (evidence: `backend/index.js`)
- Backend Entry → Product Routes: mounts routes (evidence: `backend/index.js`)
- Backend Entry → Transactions: mounts routes (evidence: `backend/index.js`)
- Authentication → Backend PostgreSQL: queries users (evidence: `backend/routes/auth.js`)
- Administration → Backend PostgreSQL: queries data (evidence: `backend/routes/admin.js`)
- Discount Offers → Backend PostgreSQL: queries products (evidence: `backend/routes/discountRoutes.js`)
- Product Routes → Backend PostgreSQL: reads and updates (evidence: `backend/routes/products.js`)
- Transactions → Backend PostgreSQL: uses database (evidence: `backend/routes/transactions.js`)
- Product Controller → Backend PostgreSQL: queries products (evidence: `backend/controllers/productController.js`)
- Backend Entry → Backend PostgreSQL: queries users (evidence: `backend/index.js`)
- Store User → Root Server: requests API (evidence: `server.js`)
- Root Server → Product API Routes: mounts routes (evidence: `server.js`)
- Product API Routes → Product Controller: dispatches to (evidence: `routes/productRoutes.js`)
- Product Controller → Root PostgreSQL: queries products (evidence: `controllers/productController.js`)
- Root Entry → Sales & Admin API: mounts routes (evidence: `index.js`)
- Root Entry → Root PostgreSQL: uses database (evidence: `index.js`)
- Sales & Admin API → Root PostgreSQL: queries and updates (evidence: `routes/products.js`)
