How nirrajkadam/mobile_billing_app works
LotusERP is a cross-platform ERP for furnishing and decor businesses. Users authenticate, then manage sales and custom orders, inventory and fabric rolls, manufacturing, deliveries, and financial records and reports. The Expo frontend communicates with a FastAPI backend, which applies role checks and persists business data in MongoDB. Backend responsibilities are grouped by domain, although the sampled implementation places them in one server file. The frontend-to-backend connection is documented; individual screen-to-client calls were not shown in the excerpts.
Main entry points: server.py Authentication and RBAC · client.ts API and offline sync · login.tsx Sign in and roles · billing.tsx POS billing
Components 23
Frontend
- Sign in and roles
frontend/app/(auth)/login.tsx - POS billing
frontend/app/(tabs)/billing.tsx - Inventory
frontend/app/(tabs)/inventory.tsx - Custom orders
frontend/app/custom-orders.tsx - Manufacturing
frontend/app/manufacturing.tsx - Fabric rolls
frontend/app/rolls.tsx - Deliveries
frontend/app/deliveries.tsx - Parties
frontend/app/(tabs)/parties.tsx - Expenses
frontend/app/expenses.tsx - Reports
frontend/app/reports.tsx - Dashboard
frontend/app/(tabs)/dashboard.tsx - API and offline sync
frontend/src/api/client.ts
Business operations
- Billing and invoices
backend/server.py - Inventory and parties
backend/server.py - Custom orders
backend/server.py - Manufacturing batches
backend/server.py - Roll lifecycle
backend/server.py - OTP deliveries
backend/server.py
Finance
- Expenses and ledgers
backend/server.py - GST and P&L reports
backend/server.py
Platform
- Authentication and RBAC
backend/server.py - MongoDB
Other components
- Business user
Connections 21
- Business user → Sign in and roles: signs in
- Business user → POS billing: records sales
- Business user → Inventory: manages stock
- Business user → Custom orders: manages orders
- Business user → Manufacturing: tracks batches
- Business user → Fabric rolls: tracks rolls
- Business user → Deliveries: assigns deliveries
- Business user → Parties: manages parties
- Business user → Expenses: records expenses
- Business user → Reports: views reports
- Business user → Dashboard: views dashboard
- API and offline sync → Authentication and RBAC: sends API requests
frontend/src/api/client.ts - Authentication and RBAC → MongoDB: reads users
backend/server.py - Billing and invoices → MongoDB: reads and writes
backend/server.py - Inventory and parties → MongoDB: reads and writes
backend/server.py - Custom orders → MongoDB: reads and writes
backend/server.py - Manufacturing batches → MongoDB: updates stock
- Roll lifecycle → MongoDB: reads and writes
backend/server.py - OTP deliveries → MongoDB: reads and writes
backend/server.py - Expenses and ledgers → MongoDB: reads and writes
- GST and P&L reports → MongoDB: reads records
backend/server.py