# 🌾 AL BARAKA (البركة) - Smart Irrigation System
**WiEmpower Hackathon Project**
*Empowering Tunisian Women Farmers with AI-Powered Irrigation*
A mobile-first web application designed for rural Tunisian women farmers (like Mabrouka) to manage irrigation intelligently using AI, IoT sensors, and conversational interfaces in Tunisian Arabic dialect.
---
## 🎯 Project Overview
AL BARAKA is a complete smart irrigation solution that combines:
- 🤖 **AI-Powered Recommendations** (GPT-4 + RAG)
- 📱 **Mobile-First Interface** (Tunisian Arabic)
- 🌡️ **IoT Sensor Integration** (Soil moisture, temperature, weather)
- 💧 **Automated Irrigation Control** (Start/Stop pump remotely)
- 📊 **Predictive Analytics** (7-day irrigation forecasts)
- 🗣️ **Conversational Stories** (Natural language explanations)
---
## 🏆 Hackathon Missions Coverage
### ✅ Mission 1: IoT Integration & Data Collection
**Status:** COMPLETE ✅
**Implementation:**
- Real-time sensor data collection (soil moisture, temperature, humidity)
- Weather API integration (Open-Meteo)
- Historical data storage and retrieval
- Mock data fallback for demo purposes
**Files:**
- `backend/services/weather_service.py` - Weather API integration
- `backend/models/sensor_data.py` - Sensor data models
- `src/services/irrigationService.js` - Frontend API integration
**Features:**
- ✅ Real-time sensor readings
- ✅ Weather forecast integration
- ✅ Historical data tracking
- ✅ Automatic data refresh (10-second intervals)
---
### ✅ Mission 2: AI-Powered Decision Making
**Status:** COMPLETE ✅
**Implementation:**
- GPT-4 integration for irrigation recommendations
- RAG (Retrieval-Augmented Generation) for context-aware advice
- Tunisian Arabic dialect responses
- Confidence scoring for recommendations
**Files:**
- `backend/services/ai_service.py` - GPT-4 integration
- `backend/services/rag_service.py` - RAG implementation
- `backend/routers/irrigation.py` - AI recommendation endpoints
**Features:**
- ✅ Intelligent irrigation reco …