🌱 README — Smart Irrigation System

Système d’irrigation intelligent basé sur l’IoT, l’automatisation et l’analyse de données

---

---

Présentation du projet

Smart Irrigation System est une solution intelligente permettant d’automatiser l’irrigation agricole grâce à des capteurs IoT, une API centralisée, des règles d’irrigation dynamiques et un tableau de bord moderne.

Le système optimise l’utilisation de l’eau, améliore la productivité agricole et permet une gestion intelligente des ressources.

Ce projet fait partie de l’écosystème technologique d’API Business Technology.

---

Objectifs du système

Smart Irrigation permet de :

• Automatiser l’irrigation selon l’humidité du sol, la météo et les règles définies
• Collecter et analyser les données des capteurs en temps réel
• Contrôler les pompes à distance via MQTT
• Réduire la consommation d’eau
• Améliorer la productivité agricole
• Offrir une interface moderne pour la supervision complète du système

---

Fonctionnalités principales

Capteurs IoT

• Humidité du sol
• Température
• Luminosité
• Débit d’eau
• Niveau de réservoir

Automatisation intelligente

• Activation/désactivation automatique des pompes
• Règles d’irrigation personnalisées
• Gestion des cycles d’arrosage
• Mode manuel ou automatique

Tableau de bord moderne

• Visualisation des capteurs
• Statistiques d’irrigation
• Historique des actions
• Graphiques de consommation d’eau

Alertes intelligentes

• Niveau d’eau bas
• Capteur inactif
• Débit anormal
• Pompes hors service

---

Architecture globale

Smart Irrigation System
│
├── IoT (ESP32 + Capteurs)
│   ├── Humidité du sol
│   ├── Température
│   ├── Luminosité
│   └── Débit d’eau
│
├── Communication (MQTT)
│   ├── Broker
│   └── Topics IoT
│
├── Backend (Node.js / NestJS)
│   ├── API REST
│   ├── Règles d’irrigation
│   ├── Gestion des pompes
│   └── Sécurité & Authentification
│
├── Frontend (Next.js / React)
│   ├── Tableau de bord
│   ├── Capteurs
│   └── Historique
│
└── DevOps
    ├── GitLab CI/CD
    ├── Tests automatisés
    ├── SonarQube
    ├── Stryker
    ├── Monitoring
    └── Infrastructure sécurisée

---

Objectif du Projet

Le projet Smart Irrigation vise à optimiser l’utilisation de l’eau dans les exploitations agricoles grâce à l’IoT, l’automatisation et l’analyse intelligente.
Il permet de réduire la consommation d’eau tout en améliorant la santé des cultures.

---

Rôle dans l’Écosystème API Business Technology

Ce projet fait partie de la suite Smart Farm.
Il occupe le rôle suivant :

• Fonction technique : Backend + IoT + Automatisation
• Responsabilité :
  • Gestion intelligente de l’irrigation
  • Analyse des données des sols
  • Déclenchement automatique de l’arrosage
  • Intégration avec Smart Farm Animal et Smart Farm Dashboard

---

Problème résolu

• Surconsommation d’eau
• Irrigation non contrôlée
• Absence de données sur l’humidité des sols
• Manque d’automatisation dans les fermes

---

Utilisateurs ciblés

• Fermes agricoles
• Serres intelligentes
• Coopératives
• Municipalités (espaces verts)

---

Intégration avec les autres services

• Smart Farm Animal
• Smart Farm Dashboard
• Modules IA internes
• Services IoT

Technologies utilisées

IoT

• ESP32
• Capteurs analogiques et numériques
• MQTT

Backend

• Node.js
• NestJS
• TypeScript

Frontend

• React
• Next.js
• TailwindCSS

DevOps

• GitLab CI/CD
• SonarQube
• Stryker Mutation Testing
• Docker
• Azure

---

Installation & Déploiement

Backend

npm install
npm run build
npm start

Frontend

npm install
npm run dev

IoT

• Configurer les topics MQTT
• Définir les seuils d’humidité
• Connecter les capteurs à l’ESP32

Déploiement

• Pipeline GitLab CI/CD
• Environnements : dev → staging → production
• Déploiement sécurisé via Azure

---

Documentation API (aperçu)

Capteurs

• GET /sensors
• POST /sensors/update

Pompes

• POST /pump/on
• POST /pump/off
• GET /pump/status

Règles d’irrigation

• GET /rules
• POST /rules/create

Historique

• GET /history

---

Documentation Fonctionnelle / API

Cette section présente les fonctionnalités principales du projet ainsi que la structure générale de son API.

---

Endpoints principaux

Méthode	Endpoint	Description
GET	/resource	Récupération des données principales
POST	/resource	Création d’une nouvelle ressource
PUT	/resource/:id	Mise à jour d’une ressource existante
DELETE	/resource/:id	Suppression d’une ressource

Remplacer resource par le nom réel selon le projet
(ex : /animals, /stocks, /alerts, /users, etc.)

---

Paramètres importants

• id : Identifiant unique de la ressource
• token : Jeton d’authentification (JWT)
• animalId / stockId / userId : Identifiants spécifiques selon le projet
• limit / page : Paramètres de pagination
• filter : Filtrage des données

---

Réponses de l’API

• 200 – Succès
  La requête a été traitée correctement.

• 201 – Créé
  Une nouvelle ressource a été ajoutée.

• 400 – Erreur de validation
  Paramètres manquants ou invalides.

• 401 – Non authentifié
  Jeton invalide ou absent.

• 403 – Non autorisé
  L’utilisateur n’a pas les permissions nécessaires.

• 404 – Introuvable
  Ressource inexistante.

• 500 – Erreur serveur
  Problème interne du système.

---

Sécurité

• JWT pour l’authentification
• RBAC (Role-Based Access Control) pour la gestion des permissions
• Chiffrement des données sensibles
• Audit logs pour tracer les actions importantes
• Validation stricte des entrées utilisateur

---

Modules / Fonctionnalités principales

• Fonctionnalité 1 : [Décrire la fonction principale du projet]
• Fonctionnalité 2 : [Décrire une fonction secondaire]
• Fonctionnalité 3 : [Décrire une interaction avec un autre service]

Remplacer ces lignes par les vraies fonctionnalités selon le repo.

---

Intégration dans l’écosystème API Business Technology

Ce projet fait partie de l’écosystème global et interagit avec :

• [Nom du produit principal]
• [Backend / Frontend / DevOps / IA / IoT]
• [Autres services liés]

---

Roadmap

2026

• IoT v1
• Dashboard v1
• Règles d’irrigation basiques

2027

• IA prédictive (analyse météo + sol)
• Optimisation automatique des cycles
• Détection d’anomalies avancée

2028

• Version entreprise
• Intégration cloud complète
• Gestion multi‑fermes

---

Licence

Ce projet est UNLICENSED.
Aucune permission n’est accordée pour utiliser, copier, modifier ou distribuer ce logiciel sans autorisation explicite du propriétaire.

Tous droits réservés.
© API Business Technology – Projet Smart Irrigation System

---

Contact

Fondateur & CEO : Pierre Richard Saint Louis
API Business Technology
Ottawa, Ontario, Canada

---