MarwaOB/HisDevcamp

AI-powered demand forecasting tool for Algerian wholesale businesses — Predict stock needs with ML-driven insights, connected via REST APIs to an intuitive frontend dashboard. # 🚀 StockFlow – AI-Powered Demand Forecasting Platform An intelligent demand forecasting platform designed for Algerian wholesalers, built during the **DEVCAMP 3.0 Hackathon**. StockFlow leverages machine learning to predict seasonal demand patterns and prevent stock shortages. ## 🎯 Project Overview StockFlow helps wholesalers optimize their inventory management by providing accurate demand predictions using advanced machine learning algorithms. The platform analyzes historical sales data, seasonal trends, and promotional impacts to deliver actionable insights. ## ✨ Key Features ### 🤖 AI-Powered Predictions - **XGBoost Algorithm** - Advanced machine learning for accurate demand forecasting - **Seasonal Analysis** - Identifies and predicts seasonal demand patterns - **Promotional Impact** - Analyzes the effect of promotions on sales - **Real-time Analytics** - Live dashboard with up-to-date predictions ### 📊 Data Management - **CSV Import** - Easy bulk data import functionality - **Data Preprocessing** - Automated data cleaning and preparation - **Feature Engineering** - Advanced feature creation for better predictions - **Hyperparameter Tuning** - Optimized ML models via RandomizedSearchCV ### 💼 Business Features - **Multi-tier Subscriptions** - Flexible pricing plans for different business sizes - **Interactive Dashboards** - Visual trend analysis and forecasting charts - **Stock Alerts** - Automated notifications for potential stock shortages - **Historical Analysis** - Comprehensive sales history insights ## 🛠️ Tech Stack ### Frontend - **React.js** - Modern component-based UI framework - **Tailwind CSS** - Utility-first CSS framework for responsive design - **Axios** - HTTP client for API communication ### Backend - **Django** - Python web framework - **Django REST Framework** - API development - **PostgreSQL** - Robust relational database ### Machine Learning - **XGBoost** - Gradient boosting algorithm - **Scikit-learn** - ML preprocessing and model …