How tsebo200/aureum-elegance-frontend works
Project type and purpose
• This is a full-stack Warehouse Management System (WMS) for the perfume industry.
• Frontend: Electron-packed React/TypeScript app (“client” folder)
• Backend: .NET Core Web API (separate repo)
• Database: PostgreSQL (hosted via Aiven)
• Auth: JWT + optional Google OAuth
File structure
• Top-level “client/” folder holds the entire frontend.
• src/electron: Electron main process (main.ts, util.ts, builder config)
• src/ui: React UI
– Components by feature (AlertCards, Forms, Graphs, Tabs)
– Pages by route (Dashboard, Production, StockRequest, AddStock, AdminManagement, StockManagement, etc.)
– services/: API-client modules for each backend endpoint
– assets/, Sass/, styling (SCSS & CSS modules)
• Configuration: vite.config.ts, tsconfig*.json, babel, jest.config, eslint.config
• Tests: __tests__ (Jest + Testing Library)
• README details frontend tech stack (Vite, React Router, Material-UI, Chart.js) and integration with the .NET Core backend and PostgreSQL.
README insights
• 3-tier architecture: UI → API → DB
• Auth flow: JWT, role-based
• Major modules:
• Authentication & routing
• Dashboard (alerts, charts)
• Production workflows (Fragrances, Ingredients, Packaging, Batches, FinishedProducts)
• Stock Requests & Transfers
• Stock & Deliveries
• Warehouse & Admin management
• Waste Loss tracking