Agrivoltaic monitoring platform for solar and agricultural data collection, visualization and management across multiple field sites in West Africa. | Plateforme de monitoring agrivoltaïque pour la collecte, visualisation et gestion des données solaires et agricoles sur plusieurs sites de terrain en Afrique de l'Ouest.
# APV-MaGa Dashboard
**Agrivoltaic monitoring platform for solar, water, irrigation, weather and agricultural data collection, visualization and management across multiple field sites in West Africa.**
**Plateforme de monitoring agrivoltaïque pour la collecte, visualisation et gestion des données solaires, hydriques, d'irrigation, météorologiques et agricoles sur plusieurs sites de terrain en Afrique de l'Ouest.**
---
## Overview
APV-MaGa is a full-stack web application built with Laravel for monitoring agrivoltaic installations. It enables real-time data collection from IoT sensors and modules, manual data entry by field agents, remote control of field equipment (valves, pumps, cooling fans), and dynamic visualization through configurable dashboards.
Developed by **Saratech**, funded by **UNU (United Nations University)**.
---
## Features
- **Multi-site monitoring** — manage multiple agrivoltaic field sites, each with its own categories, parameters, charts and API key; sites can be duplicated (categories, parameters, groups and charts included) to speed up onboarding similar installations
- **Real-time sensor data** — receive data from IoT sensors and modules via REST API, with per-parameter min/max validation at ingestion and rate limiting to protect against flooding
- **Remote actuator control** — toggle switches (valves, pumps, cooling fans) remotely, with sync status tracking (Synced / Pending / No device report / Stale)
- **Parameter groups & alert thresholds** — organize related parameters into color-coded, drag-and-drop-orderable groups; configure warning/critical thresholds per parameter with direction-aware alerting (below or above the threshold, depending on what "bad" means for that reading)
- **Offline detection** — configurable per-category threshold; dashboards flag parameters as "No data" or "Stale" when devices stop reporting
- **Manual data entry** — field agents can input agricultural, water, irrigation or weather readings (crop yield, plan …