Update README.md

Author: JacksonJS12

README.md

@@ -1 +1,72 @@
-# SunNext
+# ☀️ SunNext – Smart Solar Energy Optimization Platform
+
+**SunNext** is a B2B web platform designed to help solar park owners, energy storage managers, and traders **maximize profits from renewable energy** production.
+
+It brings together **solar asset monitoring**, **simulations**, and **IBEX electricity market integration**. The platform uses a **centralized virtual battery system** and a **decoupled data API** to manage and optimize energy usage and trading.
+
+> ⚡ Created by **Deniz Ivanov**  
+> 🎓 ASP.NET Advanced Final Project – June 2025 (SoftUni)  
+> 📡 Market data powered by [IBEX-Scraper-API](https://github.com/JacksonJS12/IBEX-Scraper-API)
+
+---
+
+## 🔍 Key Features
+
+### ⚙️ Solar Asset Monitoring
+- Manage solar systems (Grid-Tied, Off-Grid, Hybrid)
+- Track real-time performance: generation, capacity, and efficiency
+- Use built-in simulation engine for forecasting and analysis
+
+### 🔋 Virtual Battery Wallet (Energy-as-Currency)
+All energy generated by a user’s solar assets is routed into a **shared virtual wallet**:
+
+- Modeled as a **battery collection**, decoupled from the grid
+- Surplus energy is stored and shown as a **balance**
+- This balance can later be **sold like cryptocurrency** on the energy market
+- The energy is stored into batteries on one place
+- The electricity travels trough the grid into one place where is stored
+- Wallet capacity depends on user subscription plan (Small, Medium, Large)
+
+### 📈 Smart Market Integration
+- Fetches **daily IBEX Day-Ahead prices** automatically
+- Calculates optimal hourly **trading targets** for each solar asset
+- Visualizes actual vs. target prices using **Chart.js**
+- Enables users to optimize profit by selling energy at peak hours
+
+---
+
+## 🛰 Powered by IBEX-Scraper-API
+
+SunNext **does not scrape IBEX directly**.:
+
+> [`IBEX-Scraper-API`](https://github.com/JacksonJS12/IBEX-Scraper-API) – An ASP.NET Core Web API that scrapes **IBEX Day-Ahead segment prices** and stores them in an Azure SQL database.
+
+### 🧠 Why a Separate API?
+- **Decouples scraping logic** from the main platform
+- Ensures **secure**, **stable**, and **reusable** data access
+- Makes it easy to extend to other platforms or external tools
+
+### 🔄 How It Works:
+- Scrapes **next-day hourly prices**
+- Triggered daily at **14:00 BG time** via **Azure Logic App**
+- Calls `POST /api/Scrape/scrape-and-save` only if new data
+- Stores data as:
+  - `Date` (`dd/MM/yyyy`)
+  - `Hour` (1–24 CET)
+  - `PricePerMWh`
+
+🔗 **Live API Docs:** [Swagger UI](https://ibex-scraper-api-e5bwewdyfacgetaf.swedencentral-01.azurewebsites.net/swagger/index.html)
+
+---
+
+## 🧱 Tech Stack
+
+| Layer              | Technology                                      |
+|--------------------|-------------------------------------------------|
+| Platform Backend    | ASP.NET Core 8.0 MVC (based on [Nikolay Kostov’s Template](https://github.com/NikolayIT/ASP.NET-Core-Template)) |
+| Models              | Data Models / Prototypes / ViewModels Separation |
+| Market Integration  | [IBEX-Scraper-API](https://github.com/JacksonJS12/IBEX-Scraper-API) |
+| Scraping            | AngleSharp + Azure Logic App Scheduler          |
+| Storage             | Azure SQL + Local MS SQL + EF Core 8                           |
+| UI & Charts         | Bootstrap 5 + Chart.js                         |
+| Authentication      | ASP.NET Identity with Roles                    |