Hackathon - Ynov Toulouse 2025

Ce repository contient les ressources ainsi que le code source développé lors du hackathon Ynov Toulouse 2025.

Cette template de README est un guide pour vous aider à structurer votre rendu de projet. N'hésitez pas à l'adapter ou surtout à le compléter avec des sections supplémentaires si nécessaire.

Contexte

Et si on réinventait l’expérience babyfoot à Ynov ? L’objectif de ce hackathon est de moderniser et digitaliser l’usage des babyfoots présents dans le Souk pour créer un service next-gen, pensé pour près de 1000 étudiants !

Que ce soit via des gadgets connectés, un système de réservation intelligent, des statistiques en temps réel ou des fonctionnalités robustes pour une utilisation massive, nous cherchons des solutions innovantes qui allient créativité et technologie.

Toutes les filières sont invitées à contribuer : Dev, Data, Infra, IoT, Systèmes embarqués… chaque idée compte pour rendre le babyfoot plus fun, plus pratique et plus connecté.

Votre mission : transformer le babyfoot classique en expérience high-tech pour Ynov !

Bienvenue dans le Hackathon Ynov Toulouse 2025 !

Retrouvez vos guidelines techniques dans le fichier SPECIFICATIONS.md.

P.S C'est un projet de groupe, pas autant de sous-projets que de filières dans votre équipe. Travaillez ensemble pour un seul et même projet au nom de votre équipe toute entière. Les guidelines sont là pour vous aider, pas pour vous diviser. Profitez de ce moment pour apprendre à travailler ensemble, partager vos compétences, et créer quelque chose d'unique.

Equipe

• Dev' FullStack 1 : Breton Swan
• Dev' FullStack 2 : Douville Léo
• Dev' FullStack 3 : Mamie Melissa
• Cloud & Infrastructure 1 : ARROUD Rayan
• Cloud & Infrastructure 2 : MOUMINE Wassim
• IA & Data 1 : FOURNET Charly
• IA & Data 2 : RAVEL Arthur
• IoT/Mobile / Systèmes Embarqués 1 : Bertaud Nathan
• IoT/Mobile / Systèmes Embarqués 2 : Reungoat Nathan

Préciser qui est le porte parole de l'équipe, c'est lui qui répondra aux questions si nécessaire.

• Reungoat Nathan

Table des matières

• Contexte
• Equipe
• Contenu du projet
• Technologies utilisées
• Architecture
• Guide de déploiement
• Etat des lieux

Contenu du projet

Le projet consiste à créer une plateforme web connectée pour la gestion et le suivi des matchs de babyfoot. Les joueurs peuvent s’y inscrire, rejoindre une équipe et consulter les scores en direct. Les administrateurs disposent d’un dashboard leur permettant de gérer les utilisateurs, les babyfoots et les données des matchs.

Technologies utilisées

• DATA : SQL, Python, DAX (PowerBI)
• IOT : C++, platformIO
• Frontend : HTML, CSS, js
• Backend : express.js, js
• INFRA : Ansible, NGINX, Docker, Docker-compose, Shell

Architecture

1. Babyfoot (Partie matérielle)

Le babyfoot intègre deux capteurs ultrason connectés par fil à une carte Arduino ESP32.
Les capteurs détectent le passage de la balle pour identifier les buts.
L’ESP32 lit ces données et envoie une requête API HTTP vers le serveur hébergé sur le Raspberry Pi.

2. Raspberry Pi (Partie serveur)

Le Raspberry Pi exécute plusieurs conteneurs Docker :

• Back-end (Node.js) : reçoit les données de l’ESP32, les traite et les enregistre.
• Base de données (SQLite) : stocke les informations de jeu (buts, temps, scores).
• Front-end (HTML/CSS/JavaScript) : affiche les données et interagit avec le back-end via une API REST.

Le back-end communique avec la base SQLite via des requêtes SQL,
et utilise une API REST pour communiquer avec le front-end.

3. Interface Web (Front-end)

Le front-end, exécuté dans un conteneur Docker, est développé en HTML, CSS et JavaScript.
Il interroge régulièrement l’API du back-end pour récupérer les dernières données (scores, statistiques, etc.).
Les informations sont ensuite affichées sur une interface web accessible depuis un navigateur.

4. Flux global de données

1. Les capteurs ultrason détectent le passage de la balle.
2. L’ESP32 envoie une requête API HTTP au back-end du Raspberry Pi.
3. Le back-end enregistre l’événement dans la base SQLite.
4. Le front-end (dans son conteneur Docker) interroge l’API du back-end.
5. Les informations (scores, statistiques, etc.) sont affichées en temps réel sur l’interface web.

Guide de déploiement

Pré-requis

Avant de commencer, voici les pré-requis pour que le déploiement se passe bien :

1. Serveur Linux (Debian/Ubuntu) avec 4 Go de RAM et 2 CPU (x86_64).
2. Accès SSH à la machine où le projet sera déployé.
3. Git installé pour cloner le repository.
4. Le script deploy.sh sera utilisé pour automatiser l'installation et le déploiement des services.

---

Étapes de déploiement

1. Clonez le repository contenant le projet :

   Sur votre machine cible (où vous souhaitez déployer l'application), clonez le repository contenant le code source de l'application :

   git clone https://github.com/BertaudNathan/domotrap.git
   cd domotrap
   cd INFRA

2. Lancer le script deploy.sh :

   Le script deploy.sh est responsable de l'installation de Docker, Docker Compose, ainsi que du déploiement de toute l'infrastructure (frontend, backend, base de données).

   Ce script s'occupe de :

   • Installer Docker et Docker Compose.
   • Déployer les services nécessaires en utilisant Docker Compose.
   • Configurer les volumes et monter les fichiers nécessaires pour le frontend et le backend.
   • Lancer les conteneurs avec les services appropriés (frontend, backend, base de données).

   Pour exécuter le script deploy.sh, utilisez la commande suivante depuis la racine du projet :

   sudo ./deploy.sh

   Après cela vous devriez avoir les dépendances qui s'installent et le playbook qui se lance avec toutes les tâches (TASK) :

3. Explication du script deploy.sh :

   Voici ce que fait le script deploy.sh en détails :

   • Installation de Docker et Docker Compose : Le script utilise un playbook Ansible pour installer Docker et Docker Compose.
   • Déploiement avec Docker Compose : Le script exécute ensuite les commandes Docker Compose pour déployer l'infrastructure :
     • Il récupère l'image de Docker si nécessaire.
     • Il monte les volumes du frontend, backend, et base de données.
     • Il démarre les services en arrière-plan.
   • Serveur accessible via localhost : Une fois le déploiement terminé, l'application sera accessible via localhost dans votre navigateur.

4. Vérifiez le bon fonctionnement du déploiement :

   Après avoir lancé le script, l'application devrait être accessible via localhost sur votre machine. Ouvrez un navigateur et accédez à :

   http://localhost

5. Vérifications post-déploiement :

   Une fois l'infrastructure déployée, vous pouvez vérifier que tout fonctionne correctement en utilisant Docker Compose pour lister les conteneurs en cours d'exécution :

   docker-compose ps

   Vous devriez voir les services frontend, backend et db actifs.

6. Redémarrer les services si nécessaire :

   Si vous avez besoin de redémarrer ou de mettre à jour les services après le déploiement, vous pouvez utiliser la commande suivante :

   docker-compose up -d --build

Etat des lieux

Section d'honnêteté, décrivez ce qui n'a pas été fait, ce qui aurait pu être amélioré, les limitations de votre solution actuelle. Montrez que vous avez une vision critique de votre travail, de ce qui a été accompli durant ces deux demi-journées.

Le projet est dans un bon état d'avancement. Il manque néanmoins une liaison entre le backend et les capteurs, donc les capteurs détectent la balle mais ne remontent pas l'information. Il y a également differentes parties du front qui ne sont pas assemblé ensemble.