How chandru-webdev/jewellry-shop---billing-sysyem works
Opal Line ERP is a jewellery-business billing and operations system. Staff use the React application to manage products, silver-rate pricing, inventory, POS sales, purchasing, accounts, and reporting; requests pass through the Express API and business services to PostgreSQL. Authentication and role permissions protect the workflow, while Shopify synchronization is an optional integration. The README documents the broad backend layering and product capabilities; several domain-specific route and service implementations were not sampled, so their internal links are not expanded.
Main entry points: services Business services · App.jsx React application · controllers HTTP controllers · client.js API client
Components 20
Web application
- React application
frontend/src/App.jsx - Session and permissions
frontend/src/context/AuthContext.jsx - API client
frontend/src/api/client.js - ERP screens
frontend/src/pages
Backend API
- Express application
backend/src/app.js - API routes
backend/src/routes - HTTP controllers
backend/src/controllers - Business services
backend/src/services - Prisma client
backend/src/prisma/client.js
Commerce operations
- Products and categories
backend/src/services/product.service.js - Silver pricing
backend/src/services/metalRate.service.js - Inventory ledger
backend/src/services/inventory.service.js - POS and invoices
backend/src/services/order.service.js - Purchases and suppliers
backend/src/services/purchaseOrder.service.js
Finance and insights
- Payments and ledger
backend/src/services/payment.service.js - Dashboard and reports
backend/src/services/report.service.js
Integrations
- Shopify synchronization
backend/src/services/shopify.service.js
Other components
- Staff user
- ERP database
- Shopify
Connections 20
- Staff user → React application: uses
- React application → ERP screens: routes to
frontend/src/App.jsx - React application → Session and permissions: provides session
frontend/src/main.jsx - Session and permissions → API client: requests identity
frontend/src/context/AuthContext.jsx - ERP screens → API client: calls
- API client → Express application: sends API requests
- Express application → API routes: mounts
backend/src/app.js - API routes → HTTP controllers: dispatches
backend/src/routes/shopify.routes.js - HTTP controllers → Business services: delegates
backend/src/controllers/shopify.controller.js - Business services → Prisma client: uses
backend/src/services/auth.service.js - Prisma client → ERP database: queries
backend/src/prisma/client.js - Business services → Products and categories: implements
- Business services → Silver pricing: implements
- Business services → Inventory ledger: implements
- Business services → POS and invoices: implements
- Business services → Purchases and suppliers: implements
- Business services → Payments and ledger: implements
- Business services → Dashboard and reports: implements
- HTTP controllers → Shopify synchronization: invokes
backend/src/controllers/shopify.controller.js - Shopify synchronization → Shopify: synchronizes