DefiAudit0x/wildfire-observatory

Open-source geospatial early-warning platform for North African wildfires: NASA FIRMS satellite hotspots, AI-assisted verification (Gemini), citizen reports, geo-clustering, PWA offline, Docker + CI/CD. المرصد الجزائري لحرائق الغابات والكوارث Observatoire algérien des feux de forêt et des catastrophes Algerian Wildfire and Disaster Observatory — Community-Driven Early Warning System --- ## 📋 Table of Contents / فهرس المحتويات - Overview / نظرة عامة - Features / الميزات - Tech Stack / التقنيات - Satellite & Data Sources / الأقمار ومصادر البيانات - Architecture / البنية - Getting Started / التشغيل - API Documentation / توثيق API - Testing / الاختبارات - Docker - CI/CD - Project Status / حالة المشروع --- ## 🌍 Overview / نظرة عامة **AR:** منصة إنسانية مفتوحة المصدر تهدف إلى إنقاذ الأرواح في المناطق المعرضة لحرائق الغابات في شمال أفريقيا (الجزائر، تونس، المغرب، ليبيا). تعتمد المنصة على الذكاء الاصطناعي (Google Gemini) وبيانات الأقمار الصناعية (NASA FIRMS، شبه فورية Near-real-time) والإجماع البشري للتحقق من البلاغات. **FR:** Plateforme humanitaire open source visant à sauver des vies dans les zones sujettes aux feux de forêt en Afrique du Nord (Algérie, Tunisie, Maroc, Libye). Elle s'appuie sur l'IA (Google Gemini), les données satellitaires (NASA FIRMS, quasi temps réel / near-real-time) et le consensus citoyen pour la vérification des signalements. --- ## ✨ Features / الميزات | Feature | Description | |---|---| | 🗺️ **Interactive Map** | Near-real-time wildfire monitoring with Leaflet, satellite hotspots (MODIS/VIIRS) & citizen reports | | 🤖 **AI Verification** | Google Gemini Vision API analyzes uploaded images for fire/smoke detection | | 🛰️ **Satellite Data** | NASA FIRMS integration (near-real-time over a Cloudflare proxy; graceful static fallback when unreachable) | | 📊 **Fire Risk Index** | Deterministic 0–100 risk indicator from citizen reports, satellite hotspots & wilaya severity | | 📈 **History & Open Export** | 30-day activity chart + public CSV/GeoJSON export of reports and hotspots | | 👥 **Consensus Engine** | Citizen upvoting system — 5+ confirmations auto-verifies a report | | 📍 **Geo-Clustering** | Automatic grouping of nearb …