How safiyasajad/trendyoptical works
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: server.js Express server · db.js Database pool · middleware/auth.js JWT protection · routes/auth.js Staff access
Components 16
API and access
- Express server
backend/server.js - Staff access
backend/routes/auth.js - JWT protection
backend/middleware/auth.js - Staff email
backend/services/email.js
Shop operations
- Customers
backend/routes/customers.js - Dashboard
backend/routes/dashboard.js - Inventory
backend/routes/inventory.js - Suppliers
backend/routes/suppliers.js - Purchase orders
backend/routes/purchaseOrders.js - Orders
backend/routes/orders.js - Payments and memos
backend/routes/payments.js - Reports
backend/routes/reports.js
Persistence and stock
- Stock service
backend/services/stockService.js - Database pool
backend/config/db.js - PostgreSQL
Other components
- API client
Connections 30
- API client → Express server: sends API requests
README.md - Express server → Staff access: routes /api/auth
backend/server.js - Express server → Customers: routes /api/customers
backend/server.js - Express server → Dashboard: routes /api/dashboard
backend/server.js - Express server → Inventory: routes /api/inventory
backend/server.js - Express server → Suppliers: routes /api/suppliers
backend/server.js - Express server → Purchase orders: routes /api/purchase-orders
backend/server.js - Express server → Orders: routes /api/orders
backend/server.js - Express server → Payments and memos: routes /api/payments
backend/server.js - Express server → Reports: routes /api/reports
backend/server.js - Staff access → JWT protection: uses protection
backend/routes/auth.js - Staff access → Staff email: sends account email
backend/routes/auth.js - Staff access → Database pool: queries users
backend/routes/auth.js - JWT protection → Database pool: loads user
backend/middleware/auth.js - Customers → JWT protection: uses protection
backend/routes/customers.js - Customers → Database pool: queries records
backend/routes/customers.js - Dashboard → Database pool: queries summaries
backend/routes/dashboard.js - Inventory → Database pool: queries inventory
backend/routes/inventory.js - Inventory → Stock service: delegates stock work
backend/routes/inventory.js - Suppliers → Database pool: queries records
backend/routes/suppliers.js - Purchase orders → Database pool: queries records
backend/routes/purchaseOrders.js - Purchase orders → Stock service: delegates stock changes
backend/routes/purchaseOrders.js - Orders → JWT protection: uses protection
backend/routes/orders.js - Orders → Database pool: queries records
backend/routes/orders.js - Orders → Stock service: delegates stock work
backend/routes/orders.js - Payments and memos → JWT protection: protects payment entry
backend/routes/payments.js - Payments and memos → Database pool: stores payments and memos
backend/routes/payments.js - Reports → Database pool: queries report data
backend/routes/reports.js - Stock service → PostgreSQL: queries stock tables
backend/services/stockService.js - Database pool → PostgreSQL: connects to
backend/config/db.js