How evereverton28/demandlens works
DemandLens turns a retailer’s transaction ledger into weekly demand analysis, forecasts and actionable stock decisions, then presents those results in a Flask dashboard. The main workflow is file import or ledger entry → analytics pipeline → stored analysis → dashboard/API. The README documents forecasting, backtesting, product profiling, risk, anomaly detection and recommendations; these remain distinct branches. The excerpts establish key pipeline, ingestion and persistence links; unsampled API and pipeline details limit some internal call edges.
Main entry points: pipeline.py Analysis orchestrator · evaluate.py Backtesting · api_analytics.py Analytics API · db.py SQLite access
Components 21
Retailer app
- Accounts and sessions
app/auth.py - Data API
app/api_data.py - Analytics API
app/api_analytics.py - Dashboard views
app/views.py
Ledger and imports
- SQLite access
app/db.py - Transaction ledger
app/db.py - File importer
app/importer.py
Demand analytics
- File normalization
analytics/ingest.py - Weekly demand panel
analytics/preprocess.py - Product profiling
analytics/segmentation.py - Trend analysis
analytics/trends.py - Forecast features
analytics/features.py - Baseline forecasts
analytics/baselines.py - Global forecasting
analytics/forecasting.py - Backtesting
analytics/evaluate.py - Analysis orchestrator
analytics/pipeline.py
Decision outputs
- Stock risk
analytics/risk.py - Anomaly detection
analytics/anomalies.py - Recommendations
analytics/recommend.py - Saved results
app/saves.py
Other components
- Retailer
Connections 25
- Retailer → Accounts and sessions: signs in
app/auth.py - Retailer → Data API: manages data
app/api_data.py - Accounts and sessions → SQLite access: queries users
app/auth.py - Data API → SQLite access: queries ledger
app/api_data.py - File importer → File normalization: normalizes files
app/importer.py - File importer → Transaction ledger: writes movements
app/importer.py - SQLite access → Transaction ledger: accesses
app/db.py - Analytics API → Analysis orchestrator: runs analysis
analytics/pipeline.py - Analysis orchestrator → Transaction ledger: loads movements
analytics/pipeline.py - Analysis orchestrator → Weekly demand panel: builds panel
analytics/pipeline.py - Weekly demand panel → Product profiling: profiles demand
analytics/segmentation.py - Analysis orchestrator → Forecast features: builds features
analytics/pipeline.py - Analysis orchestrator → Backtesting: backtests methods
analytics/pipeline.py - Backtesting → Baseline forecasts: scores methods
analytics/evaluate.py - Backtesting → Global forecasting: evaluates model
analytics/evaluate.py - Forecast features → Weekly demand panel: reads panel
analytics/features.py - Analysis orchestrator → Baseline forecasts: selects forecasts
analytics/pipeline.py - Analysis orchestrator → Global forecasting: forecasts demand
analytics/pipeline.py - Analysis orchestrator → Trend analysis: analyzes trends
analytics/pipeline.py - Analysis orchestrator → Stock risk: estimates stock risk
analytics/pipeline.py - Analysis orchestrator → Anomaly detection: detects anomalies
analytics/pipeline.py - Analysis orchestrator → Recommendations: generates actions
analytics/pipeline.py - Analytics API → Saved results: serves results
- Dashboard views → Analytics API: requests analysis
- Retailer → Dashboard views: views decisions
app/views.py