How shalvi-surve/neuralretail works
NeuralRetail is a Streamlit retail-intelligence application: users explore business KPIs, customer segments and churn risk, sales forecasts, and inventory recommendations. The documented analytical workflow transforms retail transactions through preprocessing and feature engineering into segmentation, churn, forecasting, and inventory outputs, which the dashboard presents. Shared dashboard initialization and data-loading utilities form the internal application layer. Pipeline sequencing and several product capabilities are documented in the README; unsampled page and model implementation details are not assumed.
Main entry points: dashboard_base.py Dashboard setup · 2_Customers.py Customer intelligence · 3_Churn.py Churn center · 4_Forecast.py Forecast center
Components 23
Analytics Pipeline
- Data cleaning
src/preprocessing.py - Feature engineering
src/feature_engineering.py - Generated datasets
artifacts
Customer Intelligence
- Customer segmentation
src/customer_segmentation.py - Churn prediction
src/churn_prediction.py
Demand and Inventory
- Demand forecasting
src/demand_forecasting.py - Inventory optimization
src/inventory.py
Dashboard Experience
- Streamlit entry
app.py - Executive dashboard
pages/1_Dashboard.py - Customer intelligence
pages/2_Customers.py - Churn center
pages/3_Churn.py - Forecast center
pages/4_Forecast.py - Inventory center
pages/5_Inventory.py - Page headers
components/header.py - KPI and insight cards
components/cards.py - Interactive charts
components/charts.py - Data tables
components/tables.py - Metric components
components/metrics.py - Insight components
components/insights.py
Shared Services
- Dashboard setup
src/dashboard_base.py - Data repository
src/utils.py - Navigation sidebar
components/sidebar.py
Other components
- Retail user
Connections 36
- Retail user → Streamlit entry: opens
README.md - Data cleaning → Feature engineering: cleans for
README.md - Feature engineering → Customer segmentation: engineers inputs
README.md - Feature engineering → Churn prediction: engineers inputs
README.md - Feature engineering → Demand forecasting: engineers inputs
README.md - Feature engineering → Inventory optimization: engineers inputs
README.md - Customer segmentation → Generated datasets: generates outputs
README.md - Churn prediction → Generated datasets: generates outputs
README.md - Demand forecasting → Generated datasets: generates outputs
README.md - Inventory optimization → Generated datasets: generates outputs
README.md - Streamlit entry → Executive dashboard: hosts
- Executive dashboard → Dashboard setup: initializes via
pages/1_Dashboard.py - Customer intelligence → Dashboard setup: initializes via
pages/2_Customers.py - Churn center → Dashboard setup: initializes via
pages/3_Churn.py - Forecast center → Dashboard setup: initializes via
pages/4_Forecast.py - Inventory center → Dashboard setup: initializes via
pages/5_Inventory.py - Dashboard setup → Data repository: creates
src/dashboard_base.py - Dashboard setup → Navigation sidebar: imports
src/dashboard_base.py - Data repository → Generated datasets: loads datasets
src/utils.py - Executive dashboard → Page headers: renders
pages/1_Dashboard.py - Customer intelligence → Page headers: renders
pages/2_Customers.py - Customer intelligence → KPI and insight cards: renders
pages/2_Customers.py - Customer intelligence → Interactive charts: renders
pages/2_Customers.py - Customer intelligence → Data tables: renders
pages/2_Customers.py - Churn center → Page headers: renders
pages/3_Churn.py - Churn center → KPI and insight cards: renders
pages/3_Churn.py - Churn center → Interactive charts: renders
pages/3_Churn.py - Churn center → Data tables: renders
pages/3_Churn.py - Forecast center → Page headers: renders
pages/4_Forecast.py - Forecast center → KPI and insight cards: renders
pages/4_Forecast.py - Forecast center → Interactive charts: renders
pages/4_Forecast.py - Forecast center → Data tables: renders
pages/4_Forecast.py - Inventory center → Page headers: renders
pages/5_Inventory.py - Inventory center → KPI and insight cards: renders
pages/5_Inventory.py - Inventory center → Interactive charts: renders
pages/5_Inventory.py - Inventory center → Data tables: renders
pages/5_Inventory.py