# 68319010007-gif/wedapp-inventra architecture

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

- Interactive diagram: https://gitdiagram.com/68319010007-gif/wedapp-inventra
- Repository: https://github.com/68319010007-gif/wedapp-inventra

## Overview

Inventra combines staff inventory/sales administration with an online customer storefront. Customers browse products, manage a cart, check out, track orders, and submit payment; staff manage stock, purchasing, sales, payments, and reporting. The React app routes these experiences to an Express REST API backed by Prisma/PostgreSQL, with documented real-time stock updates. The graph preserves major README capabilities, but several route implementations were not sampled, so uncertain links are omitted.

Main entry points: [`backend/src/app.js`](https://github.com/68319010007-gif/wedapp-inventra/blob/main/backend/src/app.js) (REST route mount), [`frontend/src/App.jsx`](https://github.com/68319010007-gif/wedapp-inventra/blob/main/frontend/src/App.jsx) (Web app routing), [`backend/src/config/database.js`](https://github.com/68319010007-gif/wedapp-inventra/blob/main/backend/src/config/database.js) (Prisma database client), [`backend/src/routes/store.routes.js`](https://github.com/68319010007-gif/wedapp-inventra/blob/main/backend/src/routes/store.routes.js) (Store catalog and orders)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["React experiences"]
  node_webapp["Web app routing<br/>[App.jsx]"]
  node_storefront["Storefront"]
  node_account["Customer account"]
  node_adminui["Admin workspace"]
  node_cart["Cart state<br/>[CartContext.jsx]"]
  node_customerauth["Customer session"]
  node_settingsui["Store settings"]
  node_storeapi["Store API client<br/>[storeApi.js]"]
  node_adminapi["Admin API client<br/>[api.js]"]
  node_socketclient["Stock updates<br/>[useStockUpdates.js]"]
end

subgraph group_commerce["Commerce API"]
  node_storeauthapi["Store authentication"]
  node_storeapi_routes["Store catalog and orders<br/>[store.routes.js]"]
  node_addresses["Customer addresses"]
end

subgraph group_operations["Operations API"]
  node_products["Product catalog<br/>[products.routes.js]"]
  node_inventory["Inventory movements"]
  node_sales["Sales orders<br/>[sales.routes.js]"]
  node_purchases["Purchasing"]
  node_payments["Payment review<br/>[payments.routes.js]"]
  node_channels["Payment channels"]
  node_reports["Reports and dashboard<br/>[reports.routes.js]"]
  node_adminfeatures["Staff and settings"]
end

subgraph group_platform["Shared platform"]
  node_approuter["REST route mount<br/>[app.js]"]
  node_authmw["Staff authorization<br/>[auth.js]"]
  node_customermw["Customer authorization<br/>[customerAuth.js]"]
  node_audit["Audit logging<br/>[auditLog.js]"]
  node_upload["File uploads<br/>[upload.js]"]
  node_stocklogic["Stock operations<br/>[stock.js]"]
  node_realtime["Socket.IO service<br/>[socket.js]"]
  node_settingslogic["Public settings<br/>[siteSettings.js]"]
  node_dbclient[("Prisma database client<br/>[database.js]")]
end

node_customer(("Customer"))
node_staff(("Staff"))
node_postgres[("PostgreSQL")]

node_customer -->|"uses storefront"| node_webapp
node_staff -->|"uses admin"| node_webapp
node_webapp -->|"routes storefront"| node_storefront
node_webapp -->|"routes account"| node_account
node_webapp -->|"routes admin"| node_adminui
node_storefront -.->|"uses cart state"| node_cart
node_account -.->|"uses customer session"| node_customerauth
node_webapp -->|"provides settings"| node_settingsui
node_settingsui -->|"fetches settings"| node_storeapi
node_customerauth -->|"sends auth requests"| node_storeapi
node_storefront -.->|"requests store data"| node_storeapi
node_adminui -.->|"requests admin data"| node_adminapi
node_webapp -.->|"uses stock updates"| node_socketclient
node_storeapi -.->|"calls REST API"| node_approuter
node_adminapi -.->|"calls REST API"| node_approuter
node_approuter -->|"mounts routes"| node_storeauthapi
node_approuter -->|"mounts routes"| node_storeapi_routes
node_approuter -->|"mounts routes"| node_addresses
node_approuter -->|"mounts routes"| node_products
node_approuter -->|"mounts routes"| node_inventory
node_approuter -->|"mounts routes"| node_sales
node_approuter -->|"mounts routes"| node_purchases
node_approuter -->|"mounts routes"| node_reports
node_approuter -->|"mounts routes"| node_adminfeatures
node_approuter -->|"mounts routes"| node_payments
node_approuter -->|"mounts routes"| node_channels
node_storeapi_routes -->|"authenticates customers"| node_customermw
node_addresses -->|"authenticates customers"| node_customermw
node_sales -->|"authenticates staff"| node_authmw
node_products -->|"authenticates staff"| node_authmw
node_sales -->|"adjusts stock"| node_stocklogic
node_storeapi_routes -->|"restores stock"| node_stocklogic
node_purchases -->|"broadcasts stock changes"| node_realtime
node_sales -->|"records actions"| node_audit
node_channels -->|"records actions"| node_audit
node_storeapi_routes -->|"accepts payment slips"| node_upload
node_products -->|"accepts product images"| node_upload
node_storeapi_routes -->|"formats public settings"| node_settingslogic
node_storeauthapi -->|"reads and writes"| node_dbclient
node_addresses -->|"reads and writes"| node_dbclient
node_storeapi_routes -->|"reads and writes"| node_dbclient
node_products -->|"reads and writes"| node_dbclient
node_sales -->|"reads and writes"| node_dbclient
node_purchases -->|"reads and writes"| node_dbclient
node_dbclient -.->|"persists data"| node_postgres
node_realtime -.->|"broadcasts stock events"| node_socketclient

click node_webapp "https://github.com/68319010007-gif/wedapp-inventra/blob/main/frontend/src/App.jsx"
click node_storefront "https://github.com/68319010007-gif/wedapp-inventra/tree/main/frontend/src/pages/store"
click node_account "https://github.com/68319010007-gif/wedapp-inventra/tree/main/frontend/src/pages/store"
click node_adminui "https://github.com/68319010007-gif/wedapp-inventra/tree/main/frontend/src/pages"
click node_cart "https://github.com/68319010007-gif/wedapp-inventra/blob/main/frontend/src/store/CartContext.jsx"
click node_customerauth "https://github.com/68319010007-gif/wedapp-inventra/blob/main/frontend/src/store/StoreAuthContext.jsx"
click node_settingsui "https://github.com/68319010007-gif/wedapp-inventra/blob/main/frontend/src/store/SiteSettingsContext.jsx"
click node_storeapi "https://github.com/68319010007-gif/wedapp-inventra/blob/main/frontend/src/services/storeApi.js"
click node_adminapi "https://github.com/68319010007-gif/wedapp-inventra/blob/main/frontend/src/services/api.js"
click node_socketclient "https://github.com/68319010007-gif/wedapp-inventra/blob/main/frontend/src/utils/useStockUpdates.js"
click node_approuter "https://github.com/68319010007-gif/wedapp-inventra/blob/main/backend/src/app.js"
click node_storeauthapi "https://github.com/68319010007-gif/wedapp-inventra/blob/main/backend/src/routes/storeAuth.routes.js"
click node_storeapi_routes "https://github.com/68319010007-gif/wedapp-inventra/blob/main/backend/src/routes/store.routes.js"
click node_addresses "https://github.com/68319010007-gif/wedapp-inventra/blob/main/backend/src/routes/addresses.routes.js"
click node_products "https://github.com/68319010007-gif/wedapp-inventra/blob/main/backend/src/routes/products.routes.js"
click node_inventory "https://github.com/68319010007-gif/wedapp-inventra/blob/main/backend/src/routes/inventory.routes.js"
click node_sales "https://github.com/68319010007-gif/wedapp-inventra/blob/main/backend/src/routes/sales.routes.js"
click node_purchases "https://github.com/68319010007-gif/wedapp-inventra/blob/main/backend/src/routes/purchases.routes.js"
click node_payments "https://github.com/68319010007-gif/wedapp-inventra/blob/main/backend/src/routes/payments.routes.js"
click node_channels "https://github.com/68319010007-gif/wedapp-inventra/blob/main/backend/src/routes/paymentChannels.routes.js"
click node_reports "https://github.com/68319010007-gif/wedapp-inventra/blob/main/backend/src/routes/reports.routes.js"
click node_adminfeatures "https://github.com/68319010007-gif/wedapp-inventra/tree/main/backend/src/routes"
click node_authmw "https://github.com/68319010007-gif/wedapp-inventra/blob/main/backend/src/middleware/auth.js"
click node_customermw "https://github.com/68319010007-gif/wedapp-inventra/blob/main/backend/src/middleware/customerAuth.js"
click node_audit "https://github.com/68319010007-gif/wedapp-inventra/blob/main/backend/src/middleware/auditLog.js"
click node_upload "https://github.com/68319010007-gif/wedapp-inventra/blob/main/backend/src/middleware/upload.js"
click node_stocklogic "https://github.com/68319010007-gif/wedapp-inventra/blob/main/backend/src/utils/stock.js"
click node_realtime "https://github.com/68319010007-gif/wedapp-inventra/blob/main/backend/src/socket.js"
click node_settingslogic "https://github.com/68319010007-gif/wedapp-inventra/blob/main/backend/src/utils/siteSettings.js"
click node_dbclient "https://github.com/68319010007-gif/wedapp-inventra/blob/main/backend/src/config/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_storefront,node_account,node_adminui,node_cart,node_customerauth,node_settingsui,node_storeapi,node_adminapi,node_socketclient toneBlue
class node_storeauthapi,node_storeapi_routes,node_addresses,node_postgres toneAmber
class node_products,node_inventory,node_sales,node_purchases,node_payments,node_channels,node_reports,node_adminfeatures toneMint
class node_approuter,node_authmw,node_customermw,node_audit,node_upload,node_stocklogic,node_realtime,node_settingslogic,node_dbclient toneRose
class node_customer,node_staff toneIndigo
```

## Components

### React experiences

- [Web app routing](https://github.com/68319010007-gif/wedapp-inventra/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Storefront](https://github.com/68319010007-gif/wedapp-inventra/tree/main/frontend/src/pages/store): `frontend/src/pages/store`
- [Customer account](https://github.com/68319010007-gif/wedapp-inventra/tree/main/frontend/src/pages/store): `frontend/src/pages/store`
- [Admin workspace](https://github.com/68319010007-gif/wedapp-inventra/tree/main/frontend/src/pages): `frontend/src/pages`
- [Cart state](https://github.com/68319010007-gif/wedapp-inventra/blob/main/frontend/src/store/CartContext.jsx): `frontend/src/store/CartContext.jsx`
- [Customer session](https://github.com/68319010007-gif/wedapp-inventra/blob/main/frontend/src/store/StoreAuthContext.jsx): `frontend/src/store/StoreAuthContext.jsx`
- [Store settings](https://github.com/68319010007-gif/wedapp-inventra/blob/main/frontend/src/store/SiteSettingsContext.jsx): `frontend/src/store/SiteSettingsContext.jsx`
- [Store API client](https://github.com/68319010007-gif/wedapp-inventra/blob/main/frontend/src/services/storeApi.js): `frontend/src/services/storeApi.js`
- [Admin API client](https://github.com/68319010007-gif/wedapp-inventra/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`
- [Stock updates](https://github.com/68319010007-gif/wedapp-inventra/blob/main/frontend/src/utils/useStockUpdates.js): `frontend/src/utils/useStockUpdates.js`

### Commerce API

- [Store authentication](https://github.com/68319010007-gif/wedapp-inventra/blob/main/backend/src/routes/storeAuth.routes.js): `backend/src/routes/storeAuth.routes.js`
- [Store catalog and orders](https://github.com/68319010007-gif/wedapp-inventra/blob/main/backend/src/routes/store.routes.js): `backend/src/routes/store.routes.js`
- [Customer addresses](https://github.com/68319010007-gif/wedapp-inventra/blob/main/backend/src/routes/addresses.routes.js): `backend/src/routes/addresses.routes.js`

### Operations API

- [Product catalog](https://github.com/68319010007-gif/wedapp-inventra/blob/main/backend/src/routes/products.routes.js): `backend/src/routes/products.routes.js`
- [Inventory movements](https://github.com/68319010007-gif/wedapp-inventra/blob/main/backend/src/routes/inventory.routes.js): `backend/src/routes/inventory.routes.js`
- [Sales orders](https://github.com/68319010007-gif/wedapp-inventra/blob/main/backend/src/routes/sales.routes.js): `backend/src/routes/sales.routes.js`
- [Purchasing](https://github.com/68319010007-gif/wedapp-inventra/blob/main/backend/src/routes/purchases.routes.js): `backend/src/routes/purchases.routes.js`
- [Payment review](https://github.com/68319010007-gif/wedapp-inventra/blob/main/backend/src/routes/payments.routes.js): `backend/src/routes/payments.routes.js`
- [Payment channels](https://github.com/68319010007-gif/wedapp-inventra/blob/main/backend/src/routes/paymentChannels.routes.js): `backend/src/routes/paymentChannels.routes.js`
- [Reports and dashboard](https://github.com/68319010007-gif/wedapp-inventra/blob/main/backend/src/routes/reports.routes.js): `backend/src/routes/reports.routes.js`
- [Staff and settings](https://github.com/68319010007-gif/wedapp-inventra/tree/main/backend/src/routes): `backend/src/routes`

### Shared platform

- [REST route mount](https://github.com/68319010007-gif/wedapp-inventra/blob/main/backend/src/app.js): `backend/src/app.js`
- [Staff authorization](https://github.com/68319010007-gif/wedapp-inventra/blob/main/backend/src/middleware/auth.js): `backend/src/middleware/auth.js`
- [Customer authorization](https://github.com/68319010007-gif/wedapp-inventra/blob/main/backend/src/middleware/customerAuth.js): `backend/src/middleware/customerAuth.js`
- [Audit logging](https://github.com/68319010007-gif/wedapp-inventra/blob/main/backend/src/middleware/auditLog.js): `backend/src/middleware/auditLog.js`
- [File uploads](https://github.com/68319010007-gif/wedapp-inventra/blob/main/backend/src/middleware/upload.js): `backend/src/middleware/upload.js`
- [Stock operations](https://github.com/68319010007-gif/wedapp-inventra/blob/main/backend/src/utils/stock.js): `backend/src/utils/stock.js`
- [Socket.IO service](https://github.com/68319010007-gif/wedapp-inventra/blob/main/backend/src/socket.js): `backend/src/socket.js`
- [Public settings](https://github.com/68319010007-gif/wedapp-inventra/blob/main/backend/src/utils/siteSettings.js): `backend/src/utils/siteSettings.js`
- [Prisma database client](https://github.com/68319010007-gif/wedapp-inventra/blob/main/backend/src/config/database.js): `backend/src/config/database.js`

### Other components

- **Customer**
- **Staff**
- **PostgreSQL**

## Connections

- Customer → Web app routing: uses storefront (evidence: `README.md`)
- Staff → Web app routing: uses admin (evidence: `README.md`)
- Web app routing → Storefront: routes storefront (evidence: `frontend/src/App.jsx`)
- Web app routing → Customer account: routes account (evidence: `frontend/src/App.jsx`)
- Web app routing → Admin workspace: routes admin (evidence: `frontend/src/App.jsx`)
- Storefront → Cart state: uses cart state
- Customer account → Customer session: uses customer session
- Web app routing → Store settings: provides settings (evidence: `frontend/src/App.jsx`)
- Store settings → Store API client: fetches settings (evidence: `frontend/src/store/SiteSettingsContext.jsx`)
- Customer session → Store API client: sends auth requests (evidence: `frontend/src/store/StoreAuthContext.jsx`)
- Storefront → Store API client: requests store data (evidence: `frontend/src/pages/store/AddressesPage.jsx`)
- Admin workspace → Admin API client: requests admin data (evidence: `frontend/src/pages/SalesPage.jsx`)
- Web app routing → Stock updates: uses stock updates
- Store API client → REST route mount: calls REST API
- Admin API client → REST route mount: calls REST API
- REST route mount → Store authentication: mounts routes (evidence: `backend/src/app.js`)
- REST route mount → Store catalog and orders: mounts routes (evidence: `backend/src/app.js`)
- REST route mount → Customer addresses: mounts routes (evidence: `backend/src/app.js`)
- REST route mount → Product catalog: mounts routes (evidence: `backend/src/app.js`)
- REST route mount → Inventory movements: mounts routes (evidence: `backend/src/app.js`)
- REST route mount → Sales orders: mounts routes (evidence: `backend/src/app.js`)
- REST route mount → Purchasing: mounts routes (evidence: `backend/src/app.js`)
- REST route mount → Reports and dashboard: mounts routes (evidence: `backend/src/app.js`)
- REST route mount → Staff and settings: mounts routes (evidence: `backend/src/app.js`)
- REST route mount → Payment review: mounts routes (evidence: `backend/src/app.js`)
- REST route mount → Payment channels: mounts routes (evidence: `backend/src/app.js`)
- Store catalog and orders → Customer authorization: authenticates customers (evidence: `backend/src/routes/store.routes.js`)
- Customer addresses → Customer authorization: authenticates customers (evidence: `backend/src/routes/addresses.routes.js`)
- Sales orders → Staff authorization: authenticates staff (evidence: `backend/src/routes/sales.routes.js`)
- Product catalog → Staff authorization: authenticates staff (evidence: `backend/src/routes/products.routes.js`)
- Sales orders → Stock operations: adjusts stock (evidence: `backend/src/routes/sales.routes.js`)
- Store catalog and orders → Stock operations: restores stock (evidence: `backend/src/routes/store.routes.js`)
- Purchasing → Socket.IO service: broadcasts stock changes (evidence: `backend/src/routes/purchases.routes.js`)
- Sales orders → Audit logging: records actions (evidence: `backend/src/routes/sales.routes.js`)
- Payment channels → Audit logging: records actions (evidence: `backend/src/routes/paymentChannels.routes.js`)
- Store catalog and orders → File uploads: accepts payment slips (evidence: `backend/src/routes/store.routes.js`)
- Product catalog → File uploads: accepts product images (evidence: `backend/src/routes/products.routes.js`)
- Store catalog and orders → Public settings: formats public settings (evidence: `backend/src/routes/store.routes.js`)
- Store authentication → Prisma database client: reads and writes (evidence: `backend/src/routes/storeAuth.routes.js`)
- Customer addresses → Prisma database client: reads and writes (evidence: `backend/src/routes/addresses.routes.js`)
- Store catalog and orders → Prisma database client: reads and writes (evidence: `backend/src/routes/store.routes.js`)
- Product catalog → Prisma database client: reads and writes (evidence: `backend/src/routes/products.routes.js`)
- Sales orders → Prisma database client: reads and writes (evidence: `backend/src/routes/sales.routes.js`)
- Purchasing → Prisma database client: reads and writes (evidence: `backend/src/routes/purchases.routes.js`)
- Prisma database client → PostgreSQL: persists data
- Socket.IO service → Stock updates: broadcasts stock events
