# safiyasajad/trendyoptical architecture

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

## Overview

Opticals is an optical-shop management application: its visible runtime is an Express API for staff access and shop operations, backed by PostgreSQL. The principal workflow spans inventory and purchasing, customer orders, stock changes, payments, and cash-memo retrieval; the README specifically documents the cash-memo endpoint. Flutter platform launchers appear in the tree, but the Dart application sources are absent, so the client UI and its API calls cannot be mapped. Edges reflect sampled server wiring and SOURCE INDEX references; unsampled route behavior is represented only at subsystem level.

Main entry points: [`backend/server.js`](https://github.com/safiyasajad/trendyoptical/blob/main/backend/server.js) (Express server), [`backend/config/db.js`](https://github.com/safiyasajad/trendyoptical/blob/main/backend/config/db.js) (Database pool), [`backend/middleware/auth.js`](https://github.com/safiyasajad/trendyoptical/blob/main/backend/middleware/auth.js) (JWT protection), [`backend/routes/auth.js`](https://github.com/safiyasajad/trendyoptical/blob/main/backend/routes/auth.js) (Staff access)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and access"]
  node_server["Express server<br/>[server.js]"]
  node_auth["Staff access<br/>[auth.js]"]
  node_guard["JWT protection<br/>[auth.js]"]
  node_email["Staff email<br/>[email.js]"]
end

subgraph group_operations["Shop operations"]
  node_customers["Customers<br/>[customers.js]"]
  node_dashboard["Dashboard<br/>[dashboard.js]"]
  node_inventory["Inventory<br/>[inventory.js]"]
  node_suppliers["Suppliers<br/>[suppliers.js]"]
  node_purchasing["Purchase orders<br/>[purchaseOrders.js]"]
  node_orders["Orders<br/>[orders.js]"]
  node_payments["Payments and memos<br/>[payments.js]"]
  node_reports["Reports<br/>[reports.js]"]
end

subgraph group_persistence["Persistence and stock"]
  node_stock["Stock service<br/>[stockService.js]"]
  node_pool["Database pool<br/>[db.js]"]
  node_postgres[("PostgreSQL")]
end

node_client(("API client"))

node_client -->|"sends API requests"| node_server
node_server -->|"routes /api/auth"| node_auth
node_server -->|"routes /api/customers"| node_customers
node_server -->|"routes /api/dashboard"| node_dashboard
node_server -->|"routes /api/inventory"| node_inventory
node_server -->|"routes /api/suppliers"| node_suppliers
node_server -->|"routes /api/purchase-orders"| node_purchasing
node_server -->|"routes /api/orders"| node_orders
node_server -->|"routes /api/payments"| node_payments
node_server -->|"routes /api/reports"| node_reports
node_auth -->|"uses protection"| node_guard
node_auth -->|"sends account email"| node_email
node_auth -->|"queries users"| node_pool
node_guard -->|"loads user"| node_pool
node_customers -->|"uses protection"| node_guard
node_customers -->|"queries records"| node_pool
node_dashboard -->|"queries summaries"| node_pool
node_inventory -->|"queries inventory"| node_pool
node_inventory -->|"delegates stock work"| node_stock
node_suppliers -->|"queries records"| node_pool
node_purchasing -->|"queries records"| node_pool
node_purchasing -->|"delegates stock changes"| node_stock
node_orders -->|"uses protection"| node_guard
node_orders -->|"queries records"| node_pool
node_orders -->|"delegates stock work"| node_stock
node_payments -->|"protects payment entry"| node_guard
node_payments -->|"stores payments and memos"| node_pool
node_reports -->|"queries report data"| node_pool
node_stock -->|"queries stock tables"| node_postgres
node_pool -->|"connects to"| node_postgres

click node_server "https://github.com/safiyasajad/trendyoptical/blob/main/backend/server.js"
click node_auth "https://github.com/safiyasajad/trendyoptical/blob/main/backend/routes/auth.js"
click node_guard "https://github.com/safiyasajad/trendyoptical/blob/main/backend/middleware/auth.js"
click node_email "https://github.com/safiyasajad/trendyoptical/blob/main/backend/services/email.js"
click node_customers "https://github.com/safiyasajad/trendyoptical/blob/main/backend/routes/customers.js"
click node_dashboard "https://github.com/safiyasajad/trendyoptical/blob/main/backend/routes/dashboard.js"
click node_inventory "https://github.com/safiyasajad/trendyoptical/blob/main/backend/routes/inventory.js"
click node_suppliers "https://github.com/safiyasajad/trendyoptical/blob/main/backend/routes/suppliers.js"
click node_purchasing "https://github.com/safiyasajad/trendyoptical/blob/main/backend/routes/purchaseOrders.js"
click node_orders "https://github.com/safiyasajad/trendyoptical/blob/main/backend/routes/orders.js"
click node_payments "https://github.com/safiyasajad/trendyoptical/blob/main/backend/routes/payments.js"
click node_reports "https://github.com/safiyasajad/trendyoptical/blob/main/backend/routes/reports.js"
click node_stock "https://github.com/safiyasajad/trendyoptical/blob/main/backend/services/stockService.js"
click node_pool "https://github.com/safiyasajad/trendyoptical/blob/main/backend/config/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_server,node_auth,node_guard,node_email,node_client toneBlue
class node_customers,node_dashboard,node_inventory,node_suppliers,node_purchasing,node_orders,node_payments,node_reports toneAmber
class node_stock,node_pool,node_postgres toneMint
```

## Components

### API and access

- [Express server](https://github.com/safiyasajad/trendyoptical/blob/main/backend/server.js): `backend/server.js`
- [Staff access](https://github.com/safiyasajad/trendyoptical/blob/main/backend/routes/auth.js): `backend/routes/auth.js`
- [JWT protection](https://github.com/safiyasajad/trendyoptical/blob/main/backend/middleware/auth.js): `backend/middleware/auth.js`
- [Staff email](https://github.com/safiyasajad/trendyoptical/blob/main/backend/services/email.js): `backend/services/email.js`

### Shop operations

- [Customers](https://github.com/safiyasajad/trendyoptical/blob/main/backend/routes/customers.js): `backend/routes/customers.js`
- [Dashboard](https://github.com/safiyasajad/trendyoptical/blob/main/backend/routes/dashboard.js): `backend/routes/dashboard.js`
- [Inventory](https://github.com/safiyasajad/trendyoptical/blob/main/backend/routes/inventory.js): `backend/routes/inventory.js`
- [Suppliers](https://github.com/safiyasajad/trendyoptical/blob/main/backend/routes/suppliers.js): `backend/routes/suppliers.js`
- [Purchase orders](https://github.com/safiyasajad/trendyoptical/blob/main/backend/routes/purchaseOrders.js): `backend/routes/purchaseOrders.js`
- [Orders](https://github.com/safiyasajad/trendyoptical/blob/main/backend/routes/orders.js): `backend/routes/orders.js`
- [Payments and memos](https://github.com/safiyasajad/trendyoptical/blob/main/backend/routes/payments.js): `backend/routes/payments.js`
- [Reports](https://github.com/safiyasajad/trendyoptical/blob/main/backend/routes/reports.js): `backend/routes/reports.js`

### Persistence and stock

- [Stock service](https://github.com/safiyasajad/trendyoptical/blob/main/backend/services/stockService.js): `backend/services/stockService.js`
- [Database pool](https://github.com/safiyasajad/trendyoptical/blob/main/backend/config/db.js): `backend/config/db.js`
- **PostgreSQL**

### Other components

- **API client**

## Connections

- API client → Express server: sends API requests (evidence: `README.md`)
- Express server → Staff access: routes /api/auth (evidence: `backend/server.js`)
- Express server → Customers: routes /api/customers (evidence: `backend/server.js`)
- Express server → Dashboard: routes /api/dashboard (evidence: `backend/server.js`)
- Express server → Inventory: routes /api/inventory (evidence: `backend/server.js`)
- Express server → Suppliers: routes /api/suppliers (evidence: `backend/server.js`)
- Express server → Purchase orders: routes /api/purchase-orders (evidence: `backend/server.js`)
- Express server → Orders: routes /api/orders (evidence: `backend/server.js`)
- Express server → Payments and memos: routes /api/payments (evidence: `backend/server.js`)
- Express server → Reports: routes /api/reports (evidence: `backend/server.js`)
- Staff access → JWT protection: uses protection (evidence: `backend/routes/auth.js`)
- Staff access → Staff email: sends account email (evidence: `backend/routes/auth.js`)
- Staff access → Database pool: queries users (evidence: `backend/routes/auth.js`)
- JWT protection → Database pool: loads user (evidence: `backend/middleware/auth.js`)
- Customers → JWT protection: uses protection (evidence: `backend/routes/customers.js`)
- Customers → Database pool: queries records (evidence: `backend/routes/customers.js`)
- Dashboard → Database pool: queries summaries (evidence: `backend/routes/dashboard.js`)
- Inventory → Database pool: queries inventory (evidence: `backend/routes/inventory.js`)
- Inventory → Stock service: delegates stock work (evidence: `backend/routes/inventory.js`)
- Suppliers → Database pool: queries records (evidence: `backend/routes/suppliers.js`)
- Purchase orders → Database pool: queries records (evidence: `backend/routes/purchaseOrders.js`)
- Purchase orders → Stock service: delegates stock changes (evidence: `backend/routes/purchaseOrders.js`)
- Orders → JWT protection: uses protection (evidence: `backend/routes/orders.js`)
- Orders → Database pool: queries records (evidence: `backend/routes/orders.js`)
- Orders → Stock service: delegates stock work (evidence: `backend/routes/orders.js`)
- Payments and memos → JWT protection: protects payment entry (evidence: `backend/routes/payments.js`)
- Payments and memos → Database pool: stores payments and memos (evidence: `backend/routes/payments.js`)
- Reports → Database pool: queries report data (evidence: `backend/routes/reports.js`)
- Stock service → PostgreSQL: queries stock tables (evidence: `backend/services/stockService.js`)
- Database pool → PostgreSQL: connects to (evidence: `backend/config/db.js`)
