nafissa011/SolarDecide-DZ

AI-Powered Solar Energy Planning & Forecasting Platform for Algeria # 🌞 SolarDecide DZ ### AI-Powered Solar Energy Planning & Forecasting Platform for Algeria *A solar decision-support platform powered by AI — built for investors, public authorities, grid operators, EPC engineering firms, and field teams.* --- ## 📖 Table of Contents 1. Overview 2. Key Features 3. Dataset 4. AI Models 5. Large Files (Dataset & Models) 6. Technical Architecture 7. Tech Stack 8. Installation & Setup 9. REST API 10. Subscription Plans 11. Project Structure 12. Preview 13. Roadmap 14. License & Contributors --- ## 🌍 Overview **SolarDecide DZ** is a **full-stack** web application supporting decision-making for the deployment of photovoltaic power plants in Algeria. It combines: - 🛰️ A real **NASA POWER dataset** of **12.7 million** hourly measurements covering **58 wilayas** and **287 communes** across Algeria over **5 years** (2019-2023), - 🤖 Several **trained AI models** (Random Forest, Hybrid Ridge + MLP, and the Transformer family: PatchTST) for **GHI forecasting** and **multi-criteria ranking** of zones, - 💰 A **financial ROI calculation** engine (CAPEX, OPEX, NPV, IRR, LCOE, payback) with **3 scenarios** (conservative / base / optimistic), - 📄 **Automatic PDF report generation** (Investor / Government / EPC), - 🌐 A **multilingual SPA interface** (FR/EN) with offline mode (**PWA**), 13 business pages, and a full **admin panel**. > **Target audience**: solar investors, energy ministries, EPC firms, grid operators (Sonelgaz / OS), researchers. --- ## ✨ Key Features ### 🏠 Front-office (13 pages) | # | Page | Description | |---|---|---| | 1 | **Landing** | Animated hero, particles, quick search, interactive Leaflet map of wilayas | | 2 | **National Ranking** | Sortable table of the 58 wilayas, climate/region filters, top-10 GHI, CSV export | | 3 | **Wilaya Dashboard** | 6 KPIs (GHI, DNI, Kt, T°, MW, demand), composite score radar, summer/winter hourly profiles | | 4 | **Zone Analysis** ⭐ | *Build / Study / Wait* verdict, "Why th …