| Ce dépôt GitHub concerne le site du ProjetADE, qui permet de visualiser les données et de contrôler les capteurs. |
| Pour consulter le code pour le Raspberry Pi, rendez-vous sur le Projet ADE Client. |
L’aquaponie est un écosystème interdépendant qui combine l’agriculture et la pisciculture. L’eau enrichie par les déchets des poissons, riche en azote, phosphore et potassium, est envoyée vers les plantes, qui utilisent les nutriments présents afin de croître. En chemin, des bactéries transforment les matières organiques en nitrate, ce qui joue un rôle crucial dans l’écosystème. Ces bactéries sont essentiellement un filtre biologique, puisque les déchets des poissons sont toxiques pour eux-mêmes. Donc, après être passée par les plantes, l’eau pourra être retournée vers les poissons. En lien avec l’informatique et les mathématiques, nous serons en mesure d’afficher les données importantes du système d’aquaponie sur un site Web directement relié aux capteurs du module. En consultant des graphiques et des données affichées, cela permettra à l’utilisateur de surveiller le processus de l’aquaponie, de s’assurer que tout va comme prévu et d’agir dès que quelque chose ne semble pas correct.
- Aquaponie
- Projet ADE Client
- Cas d’utilisation
- Guide d’utilisation
- Diagramme des fichiers du NodeJS
- Installations
Le projet ADE est séparé en deux parties. La première est est ce dépôt, le "Projet ADE", qui permet aux utilisateurs de se connecter à un site pour récupérer une clé API et voir les données des capteurs ainsi que des graphiques analysant les données affichées dedans. Elle permet aussi de contrôler les capteurs (allumer/éteindre).
La deuxième partie est le ProjetADE-Client qui est destiné à la partie "physique du projet". Il permet à n'importe quel utilisateur de connecter les capteurs souhaités (dans le choix des capteurs) à un Raspberry Pi 4 modèle B, d’accéder à une interface graphique et de se connecter au site du Projet ADE en ligne à l'aide d'une clé API.
- Agriculteurs urbains : Un cultivateur peut installer le système pour surveiller son installation d’aquaponie électroniquement.
- Écoles et universités : Les étudiants peuvent utiliser le projet pour apprendre les principes de l’aquaponie.
- Petites fermes et startups agricoles : Elles peuvent adopter le système pour automatiser leurs productions et améliorer leur rendement.
- Restaurants et chefs cuisiniers : Ils pourraient cultiver des aliments frais directement sur place, réduisant ainsi les coûts de production et de transport. Cela pourrait également améliorer la qualité et la traçabilité des aliments.
- Communautés et ONG : Elles pourraient utiliser le système dans des projets humanitaires pour assurer la sécurité alimentaire dans des milieux où l’accès à l’eau est limité et améliorer l’autosuffisance des fermes communautaires.
Vous avez deux options pour utiliser le site du ProjetADE. La première est d’accéder directement à notre site. La deuxième est d’héberger vous-même ce dépôt.
| Étapes | Description |
|---|---|
| 1 | Créez un compte. |
| 2 | Récupérez votre clé API en appuyant sur le bouton Voir clé API. |
| Étapes | Description |
|---|---|
| 3 | Accédez à l’interface sur le Raspberry Pi. |
| 4 | Assurez-vous que dans le code, la connexion se fait à la bonne URL (celle de notre site). |
| 5 | Dans l’interface du Raspberry Pi, collez votre clé API. |
| 6 | Appuyez sur Commencer. |
| Étapes | Description |
|---|---|
| 7 | Appuyez sur le bouton Regarder Données pour voir les graphiques et contrôler les données. |
| Étapes | Description |
|---|---|
| 1 | Installez VSCODE. |
| 2 | Installez NodeJS sur votre ordinateur. |
| 3 | Clonez ce dépôt GitHub à l’aide de Git sur VSCODE. |
| 4 | Dans le terminal du ProjetADE sur VSCODE, faites les installations npm nécessaires. |
| Étapes | Description |
|---|---|
| 5 | Installez la base de données MySQL sur votre ordinateur. |
| 6 | Créez une base de données et nommez-la projet_ade. |
| Étapes | Description |
|---|---|
| 7 | Sur le projet dans VSCODE, créez un fichier .env et ajoutez les informations suivantes :DB_HOST="localhost"DB_USER="root"DB_PASSWORD="dkehgj_d876'"DB_NAME="projet_ade" |
| 8 | Lancez le serveur avec npm start et accédez au site. |
| 9 | Suivez les étapes de la section Sur le site ProjetADE. |
| 10 | Voilà ! |
Note
La clé API va être passée dans l'URL, car autrement cela crée des conflits avec Cloudflare et Nginx.
Si vous hébergez vous-même et que le code retourne une erreur liée à la connexion Socket.IO ou à une clé API indéfinie, vous pouvez utiliser dans socketio-controleur.js :
const cleApi = socket.handshake.headers['cle_api'];
Dans ce cas, il faut également modifier le code de ProjetADE-Client, dans le fichier socketio_client.py, et utiliser :
self.sio.connect(self.__lien, headers={"cle_api": self.__cle_api}).
Pour plus de détails à propos de ce diagramme, consultez notre documentation Word.
| La section suivante concerne les installations à effectuer avec npm sur vscode. |
npm install socket.io
Cette librairie permet de gérer la communication en temps réel entre le serveur et les clients (protocole Socket.IO). Dans notre projet, elle est utilisée pour connecter un client à une "room" correspondant à sa clé API, ce qui permet d’échanger des données personnalisées en direct.
npm install express
Express simplifie la gestion des routes et le traitement des requêtes/réponses. Par exemple, lorsqu’un utilisateur visite le site site.com/page1, Express lui renvoie la page HTML correspondante.
npm install --save mysql2
mysql2 est une bibliothèque permettant de se connecter à une base de données MySQL et d’exécuter des requêtes (ajout, suppression, mise à jour, etc.). Elle est utilisée pour enregistrer les données des utilisateurs et des capteurs.
npm install dotenv
Cette bibliothèque permet de stocker localement des informations sensibles, comme les identifiants de connexion à la base de données. Ainsi, elles ne sont pas partagées lors d’un commit Git.
npm install bcrypt
bcrypt est utilisée pour le hachage des mots de passe. Elle permet de protéger les mots de passe enregistrés en base de données en évitant leur stockage en texte clair.
npm install generate-api-key
Cette librairie permet de générer des clés API aléatoires et uniques pour identifier chaque utilisateur de manière sécurisée.
npm install express-session
express-session permet de gérer les sessions utilisateurs. Elle conserve les informations de connexion (comme l’email et la clé API) entre les requêtes, ce qui évite à l’utilisateur de se reconnecter à chaque page.
npm install ejs
EJS est un moteur de templates HTML permettant d’injecter du JavaScript dans le code HTML. Il permet d’afficher des données dynamiques selon l’utilisateur (ex. : barre de navigation personnalisée) et d’éviter la répétition de code grâce à des fichiers partagés.
Aucune installation nécessaire : la bibliothèque est importée directement via une API dans le code front-end.
Cette bibliothèque est utilisée pour afficher des graphiques dans les pages HTML.
npm i nodemon
Cette bibliothèque facilite le développement. Elle redémarre le serveur lorsqu’un fichier est modifié.
npm i node-cron
Cette bibliothèque permet d'exécuter une tâche à intervalles réguliers sans bloquer entièrement le code, contrairement à l'utilisation de sleep(). Elle est idéale pour automatiser des commandes répétitives, comme la récupération des données des appareils connectés toutes les x minutes. Cette bibliothèque est optionnelle et n’est pas utilisée dans notre projet actuel, car la seule tâche requise est d’appeler une méthode toutes les 10 minutes, ce qui est facilement réalisable avec setInterval(). Ajouter node-cron alourdirait inutilement le projet. Toutefois, si une exécution à une heure précise devient nécessaire dans le futur, cette technologie pourrait alors être envisagée.