🛡️ AgriShield - Agricultural Intelligence System

AgriShield is a professional-grade, IoT-driven agricultural monitoring and diagnostic system built for farmers in low-connectivity environments. It features a high-performance ESP32-based hardware module, a stunning web dashboard, and a Flutter mobile application with on-device edge intelligence.

🚀 Key Features

• 📶 Offline-First Logic: Direct WiFi communication with ESP32 sensors for real-time field data collection without internet.
• 🤖 Gemini AI Diagnostics: Hyper-local farming advice provided by Google Gemini 1.5, analyzing live sensor readings against personalized crop thresholds.
• 🌍 Multi-Language Support: Full application and AI interface available in both French and English.
• 📊 Offline Analytics: Historical sensor data visualization through real-time graphs accessible even when the module is offline.
• 🌱 AI Crop Configuration: Effortlessly generate localized crop thresholds (Tomato, Cocoa, Banana, etc.) using AI-powered agronomic intelligence.
• 🔇 Remote Control: Stop the module's critical buzzer and manage hardware states directly from the mobile or web dashboard.
• 🏗️ 3D Modular Design: Custom-designed waterproof enclosure with modular sensor integration for field longevity.
• 📸 Working Prototype: Fully integrated hardware system verified and tested in field-like conditions.

📂 Project Structure

• /mobile_app: Flutter Application (Resigned with Gemini AI).
• /agrishield-dashboard: React + Vite professional monitoring dashboard (API v2.3.0).
• /AgriShield_Firmware: ESP32 C++ Code for real-time sensor broadcasting (v2.3.0).
• /website: Landing page and project showcase.
• /tools: Hardware proxy and simulation servers for development.
• /docs: Full Architecture Reports, API Specs (v2.3.0), and PROJECT_SUMMARY.

🛠️ Development & Simulation

You can test the entire ecosystem without physical hardware using the simulation server:

1. Start Simulation:

   cd tools
   npm install
   node simulation_server.js

   The server runs at http://localhost:5001.

2. Launch Dashboard:

   cd agrishield-dashboard
   npm install
   npm run dev

   Access via http://localhost:5173.

🏗️ Automated Builds (CI/CD)

The project includes a GitHub Actions workflow for field-testing:

• Build Field Test APK: Automatically strips Google Play dependency requirements to allow clean operation on Android devices without internet access.
• Artifacts: Download the signed/debug APK directly from the GitHub Actions tab.

🌳 Roadmap (Updated)

• API v2.3.0 Alignment (Standardized sensor keys and buzzer control).
• Working Prototype & 3D Enclosure Design.
• Resilient Mobile Sync Hub (Fixed dashboard white-screen issues).
• Remote Module Buzzer Muting.
• AI-Powered Crop Profile Generation.
• Visual Plant Disease Scanning (TFLite Integration).
• Multi-module Sector Management (Irrigation Hub).

---

🌱 Protect today. Harvest tomorrow.

Last Updated: 2026-04-14
Lead Developer: PSYCHO