How aksp42/supplyiq-ai-powered-inventory-supply-chain-intelligence-platform works
SupplyIQ is a multi-tenant retail inventory and supply-chain dashboard. A store user signs in, then uses the frontend to access store-scoped sales, inventory, stock movements, purchase orders, imports, assistant, and forecast capabilities through the API; results are persisted in MySQL. Forecasting also has a Python ML pipeline for data preparation, feature engineering, model evaluation, and stored forecasts. The graph follows documented capabilities and source-index references; some UI-to-API wiring and unsampled subsystem internals are not directly shown, so those links are left dashed where appropriate.
Main entry points: server.js Express API · forecast_pipeline.py Forecast pipeline · mysql.js MySQL access · auth.js Client authentication
Components 23
Store experience
- Web client
frontend/js/api.js - Client authentication
frontend/js/auth.js
API and identity
- Express API
backend/server.js - Auth and tenancy
backend/auth.js
Inventory operations
- Store and catalog
backend/catalog.js - Sales and KPIs
backend/server.js - Stock ledger
backend/stock.js - Purchase orders
backend/server.js - Data imports
backend/imports.js - TradeSaarthi assistant
backend/server.js
Forecast intelligence
- Forecast API
backend/forecast.js - Forecast pipeline
backend/ml/ml/pipelines/forecast_pipeline.py - Sales features
backend/ml/ml/features/sales_features.py - Inventory features
backend/ml/ml/features/inventory_features.py - Baseline models
backend/ml/ml/models/baseline.py - Backtesting
backend/ml/ml/evaluation/backtest.py - Forecast metrics
backend/ml/ml/evaluation/metrics.py - Synthetic sales data
backend/ml/ml/data/synthetic_generator.py
Data persistence
- ML data access
backend/ml/ml/database.py - MySQL access
backend/mysql.js - MySQL store
Other components
- Store user
- Firebase identity
Connections 28
- Store user → Web client: uses
README.md - Web client → Client authentication: uses
- Client authentication → Express API: requests API
- Client authentication → Firebase identity: requests reset / sign-in
README.md - Express API → Auth and tenancy: guards routes
backend/server.js - Express API → Store and catalog: routes to
backend/server.js - Express API → Sales and KPIs: serves
backend/server.js - Express API → Stock ledger: routes to
backend/server.js - Express API → Data imports: routes to
backend/server.js - Express API → Forecast API: routes to
backend/server.js - Express API → Purchase orders: serves
README.md - Express API → TradeSaarthi assistant: serves
README.md - Auth and tenancy → MySQL access: reads users
backend/auth.js - Stock ledger → MySQL access: writes movements
backend/stock.js - Data imports → Stock ledger: uses stock
backend/imports.js - MySQL access → MySQL store: queries
backend/mysql.js - Forecast API → MySQL access: reads data
backend/forecast.js - Forecast pipeline → ML data access: loads and saves
backend/ml/ml/pipelines/forecast_pipeline.py - Forecast pipeline → Synthetic sales data: generates fallback
backend/ml/ml/pipelines/forecast_pipeline.py - Forecast pipeline → Sales features: builds features
backend/ml/ml/pipelines/forecast_pipeline.py - Forecast pipeline → Inventory features: builds features
backend/ml/ml/pipelines/forecast_pipeline.py - Forecast pipeline → Baseline models: runs model
backend/ml/ml/pipelines/forecast_pipeline.py - Forecast pipeline → Backtesting: evaluates forecasts
backend/ml/ml/pipelines/forecast_pipeline.py - Forecast pipeline → Forecast metrics: calculates metrics
backend/ml/ml/pipelines/forecast_pipeline.py - Sales features → Inventory features: combines features
backend/ml/ml/features/inventory_features.py - ML data access → MySQL store: queries
backend/ml/ml/database.py - Baseline models → Forecast metrics: scores models
backend/ml/ml/models/baseline.py - Backtesting → Forecast metrics: calculates metrics
backend/ml/ml/evaluation/backtest.py