How prince200510/business-operations-erp works
Nexora is a multi-tenant business operations ERP/POS. Users enter through the React application, authenticate, then use its dashboard to reach sales, inventory, procurement, invoicing, reporting, and business-management features; FastAPI exposes the corresponding backend API. The graph includes the documented invoice/PDF capability, though its implementation details are not shown in the excerpts. Backend route-to-model links follow the SOURCE INDEX; frontend-to-API requests are dashed because the sampled service module does not show their wiring.
Main entry points: reports.py Reports API · main.py API entry · Dashboard.jsx Dashboard · auth.py Authentication
Components 27
Frontend
- App routing
frontend/src/App.jsx - Dashboard
frontend/src/Dashboard.jsx - POS checkout
frontend/src/NewSale.jsx - Inventory UI
frontend/src/Product.jsx - Purchases UI
frontend/src/Purchase.jsx - Reports UI
frontend/src/Report1.jsx - Invoice UI
frontend/src/Invoices.jsx
API workflows
- API entry
backend/app/main.py - Authentication
backend/app/api/auth.py - Sales API
backend/app/api/sales.py - Products API
backend/app/api/products.py - Purchases API
backend/app/api/purchases.py - Reports API
backend/app/api/reports.py - Other workflows
backend/app/api
Business domain
- Sales records
backend/app/modules/sale_order.py - Product inventory
backend/app/modules/product.py - Purchase records
backend/app/modules/purchase.py - Supplier records
backend/app/modules/supplier.py - User accounts
backend/app/modules/user.py
Backend platform
- SQL database
backend/app/core/database.py - Redis cache
backend/app/core/redis.py - JWT security
backend/app/core/security.py - Auth dependencies
backend/app/core/dependencies.py - Configuration
backend/app/core/config.py
Other components
- Business user
- EmailJS
- PostgreSQL
Connections 41
- Business user → App routing: uses
- App routing → Dashboard: routes to
frontend/src/App.jsx - Dashboard → POS checkout: opens
frontend/src/Dashboard.jsx - Dashboard → Inventory UI: opens
frontend/src/Dashboard.jsx - Dashboard → Purchases UI: opens
frontend/src/Dashboard.jsx - Dashboard → Reports UI: opens
frontend/src/Dashboard.jsx - Dashboard → Invoice UI: opens
frontend/src/Dashboard.jsx - App routing → Authentication: requests
- POS checkout → Sales API: submits sale
- Inventory UI → Products API: manages products
- Purchases UI → Purchases API: records purchase
- Reports UI → Reports API: requests analytics
- Invoice UI → Sales API: requests invoice data
- API entry → Authentication: registers
backend/app/main.py - API entry → Sales API: registers
backend/app/main.py - API entry → Products API: registers
backend/app/main.py - API entry → Purchases API: registers
backend/app/main.py - API entry → Reports API: registers
backend/app/main.py - API entry → Other workflows: registers
backend/app/main.py - Authentication → User accounts: queries
backend/app/api/auth.py - Authentication → Redis cache: tracks attempts
backend/app/api/auth.py - Authentication → JWT security: hashes and signs
backend/app/api/auth.py - Authentication → EmailJS: sends OTP
backend/app/api/auth.py - Sales API → Sales records: creates and reads
backend/app/api/sales.py - Sales API → Product inventory: updates stock
backend/app/api/sales.py - Sales API → Supplier records: uses
- Products API → Product inventory: manages
backend/app/api/products.py - Products API → Supplier records: references
backend/app/api/products.py - Purchases API → Purchase records: records
backend/app/api/purchases.py - Purchases API → Product inventory: updates stock
backend/app/api/purchases.py - Purchases API → Supplier records: references
backend/app/api/purchases.py - Reports API → Sales records: aggregates
backend/app/api/reports.py - Reports API → Product inventory: aggregates
backend/app/api/reports.py - Reports API → Purchase records: aggregates
backend/app/api/reports.py - Reports API → Supplier records: aggregates
backend/app/api/reports.py - Reports API → Redis cache: caches results
backend/app/api/reports.py - SQL database → PostgreSQL: connects
- SQL database → Configuration: loads settings
backend/app/core/database.py - JWT security → Configuration: loads secret
backend/app/core/security.py - Auth dependencies → JWT security: uses JWT rules
backend/app/core/dependencies.py - Redis cache → Configuration: loads URL
backend/app/core/redis.py