How krishna199766-arch/essa-master-final works
Essa is a textile-warehouse system centered on turning supplier invoices into validated purchase receipts and inventory. Its main workflow is invoice upload, supplier-aware extraction and confirmation, GRN posting, then stock and cost updates. The desktop also supports transport registers, stock movement, returns, supplier payments, pricing, and reports; the warehouse phone app handles consignment receipt and bundle breakdown. The graph combines README-documented capabilities with sampled API, extraction, storage, and model structure; unsampled feature internals are represented at their existing router-directory paths.
Main entry points: documents.py Document intake · main.py API application · database.py Warehouse database · purchases.py Purchases & GRN
Components 20
Document intake
- Document intake
backend/app/routers/documents.py - Extraction engine
backend/app/extraction/engine.py - Supplier profiles
backend/app/models.py
Warehouse operations
- LR register
backend/app/routers/lr.py - Purchases & GRN
backend/app/routers/purchases.py - Bundle breakdown
backend/app/routers/bundles.py - Inventory & costing
backend/app/routers/inventory.py - Stock outward / inward
backend/app/routers/outward.py
Purchasing & accounts
- Returns & shortages
backend/app/routers/returns.py - Supplier payments
backend/app/routers/payments.py - Price changer
backend/app/routers/pricing.py - Reports & questions
backend/app/routers/reports.py
User interfaces
- Desktop app
frontend/src/App.jsx - Warehouse phone app
mobile-app/App.js
Shared platform
- API application
backend/app/main.py - Document storage
backend/app/services/storage.py - Suppliers & masters
backend/app/routers/suppliers.py - Warehouse database
backend/app/database.py - Authentication & permissions
backend/app/routers/auth.py
Other components
- Warehouse staff
Connections 24
- Warehouse staff → Desktop app: uses
- Warehouse staff → Warehouse phone app: uses
- Desktop app → API application: operates
- Warehouse phone app → API application: connects to
- API application → Document intake: routes requests
backend/app/main.py - Document intake → Extraction engine: runs extraction
backend/app/routers/documents.py - Extraction engine → Supplier profiles: learns supplier format
backend/app/extraction/engine.py - Document intake → Document storage: stores uploads
backend/app/routers/documents.py - Document intake → Suppliers & masters: uses supplier data
backend/app/routers/documents.py - Document intake → Purchases & GRN: confirmed invoice to GRN
- Warehouse staff → LR register: records consignments
- Warehouse staff → Bundle breakdown: details received sizes
- Purchases & GRN → Inventory & costing: posts stock
- Bundle breakdown → Inventory & costing: creates variant stock
backend/app/routers/inventory.py - Warehouse staff → Stock outward / inward: dispatches and receives stock
- Warehouse staff → Returns & shortages: claims returns or shortages
- Warehouse staff → Supplier payments: settles supplier bills
- Warehouse staff → Price changer: revises selling prices
- Warehouse staff → Reports & questions: requests reports
- API application → Authentication & permissions: serves sign-in
backend/app/main.py - Authentication & permissions → Warehouse database: checks user records
backend/app/routers/auth.py - API application → Warehouse database: uses sessions
backend/app/main.py - Purchases & GRN → Warehouse database: records receipt
- Inventory & costing → Warehouse database: records stock ledger
backend/app/routers/inventory.py