Projet MakerLens : Centraliser les Tutoriels Low-Tech

Envoyé par l’équipe MakerLens le 15 Décembre 2024

Équipe :

Bérénice CARDOSO-FAUCHER, Pol TYMEN, Alex PEIRANO, Marc DUBOC, Divine BANON, Lucas OLIVER

---

I – Contexte

Durant le cursus Ingénieur généraliste de l’IMT Atlantique, les élèves doivent réaliser un projet fil rouge TAF COUAD. C’est dans ce cadre que nous avons développé MakerLens, une application web pour centraliser et rendre accessible la documentation low-tech.

L’idée derrière ce projet est de répondre à un problème concret identifié lors de notre enquête terrain : la fragmentation de la documentation. En effet, les tutoriels low-tech existent mais sont éparpillés sur de multiples plateformes (YouTube, Wikis, Blogs), souvent mal structurés et difficiles à filtrer.

Résultat : les débutants abandonnent et les médiateurs (fab managers, enseignants) perdent un temps considérable à chercher des ressources adaptées.

Ainsi, nous avons réalisé une plateforme web qui grâce à un moteur de recherche intelligent et des filtres pratiques (coût, difficulté, durée) permet de trouver rapidement le bon tutoriel. L’application ne crée pas de nouveau contenu mais agrège et standardise l’existant pour le rendre accessible à tous.

Lien vers l’application : https://promaaa.github.io/maker_lens/

Vidéo de présentation

Présentation complète du projet MakerLens (5 minutes)

---

II – Réalisation

1) Matériel nécessaire

L’avantage de MakerLens : c’est une solution 100% logicielle qui ne nécessite aucun matériel spécifique !

Côté utilisateur :

• N’importe quel appareil avec un navigateur web (ordinateur, tablette, smartphone)
• Une connexion Internet (ou version téléchargeable pour utilisation hors-ligne)

Côté développement :

• Un ordinateur pour coder
• Un compte GitHub (gratuit)
• Python 3 installé (pour les scripts de récupération de données)

Justification low-tech : En étant 100% logiciel, MakerLens maximise l’utilisation des équipements existants et évite la création de nouveaux déchets électroniques.

2) Architecture globale

L’application repose sur une architecture simple en 3 couches :

Couche 1 – Collecte des données (Scripts Python)

• Des scripts Python scrapent les sites sources (Low-Tech Lab, Instructables, etc.)
• Les données sont extraites et converties dans un format standardisé JSON
• Validation manuelle pour garantir la qualité

Couche 2 – Hébergement (GitHub Pages)

• Le site est hébergé gratuitement sur GitHub Pages
• Architecture « fichiers statiques » = pas de serveur complexe à gérer
• Consommation énergétique minimale

Couche 3 – Interface utilisateur (HTML + JavaScript)

• Interface web légère en HTML/CSS/JavaScript pur (pas de frameworks lourds)
• Moteur de recherche côté client avec Fuse.js (~26 Ko seulement)
• Filtres dynamiques sans rechargement de page

Interface principale de MakerLens

3) Fonctionnalités principales

a) Mode Création vs Mode Recyclage

• Mode Création : Pour fabriquer un objet à partir de zéro
• Mode Recyclage : Pour transformer et réutiliser des objets existants

Cette séparation encourage l’économie circulaire en valorisant le réemploi.

Mode Création : Fabriquer des objets à partir de zéro

Mode Recyclage : Transformer et réutiliser des objets existants

b) Recherche intelligente

Le moteur de recherche tolère les fautes de frappe : tapez « arduin » et vous trouverez quand même tous les tutoriels Arduino ! La recherche se fait instantanément côté client, sans appeler de serveur.

Exemple d’utilisation : Un étudiant cherche « panneau solaire » → L’application trouve tous les tutoriels contenant ces mots dans le titre, la description ou les mots-clés.

Exemple de recherche avec faute d’orthographe : « arduin » trouve quand même les tutoriels Arduino 

c) Filtres pratiques

Trois filtres pour affiner la recherche :

Filtre	Options	Utilité
Coût	€ (moins de 10€) €€ (10-50€) €€€ (plus de 50€)	Adapter à son budget
Difficulté	Facile Moyen Difficile	Choisir selon son niveau
Durée	Temps en heures	Planifier son projet

Exemple d’utilisation : Un débutant sélectionne « Facile » + « € » → Il obtient uniquement des projets simples et peu coûteux.

d) Format standardisé des tutoriels

Tous les tutoriels suivent la même structure :

1. En-tête : Titre, difficulté, coût, durée, source
2. Introduction : Description du projet
3. Matériel requis : Liste complète
4. Instructions étape par étape : Numérotées et illustrées
5. Notes et conseils : Astuces pratiques

Fini les tutoriels incomplets ou mal organisés !

4) Technologies utilisées

Nous avons privilégié des technologies simples et pérennes :

Technologie	Utilisation	Pourquoi ce choix ?
HTML5 + CSS3	Structure et design	Standards web, légers et durables
JavaScript Vanilla	Logique de l’application	Pas de framework lourd type React
Fuse.js	Recherche floue	Bibliothèque ultra-légère (26 Ko)
Python 3	Scripts de scraping	Langage standard et bien documenté
BeautifulSoup	Extraction de données web	Simple et efficace
JSON	Format de données	Lisible, éditable, interopérable
GitHub Pages	Hébergement	Gratuit, pas de serveur à gérer

5) Structure des données (format JSON)

Chaque tutoriel est stocké dans un fichier JSON qui contient :

{
  "titre": "Marmite norvégienne",
  "description": "Cuiseur économe en énergie",
  "difficulte": "facile",
  "cout": "€",
  "duree_heures": 2,
  "mode": "creation",
  "mots_cles": ["cuisine", "isolation", "économie d'énergie"],
  "materiel": ["Caisse en bois", "Isolant", "Couvercle"],
  "etapes": [
    {
      "numero": 1,
      "titre": "Préparation de la caisse",
      "description": "Nettoyer la caisse..."
    }
  ],
  "source": {
    "nom": "Low-Tech Lab",
    "url": "https://wiki.lowtechlab.org/...",
    "licence": "CC BY-SA"
  }
}

Ce format permet :

• Une lecture facile par l’humain
• Une modification sans outil spécialisé
• Une exportation vers d’autres plateformes
• Un suivi des versions avec Git

6) Processus de développement (Méthode Scrum)

Nous avons organisé le projet en 3 sprints agiles :

Sprint 1 (Septembre 2024) – Enquête & Prototype

• Entretiens avec fab managers, enseignants et makers
• Validation des besoins utilisateurs
• Création de personas (Aude la fabmanageuse, Daniel le débutant, Ethan l’enseignant)
• Première version du format JSON

Sprint 2 (Octobre 2024) – Moteur de recherche & Scraping

• Développement du moteur de recherche avec Fuse.js
• Scripts de scraping pour extraire les tutoriels du Low-Tech Lab
• Implémentation des filtres (coût, difficulté, durée)
• Intégration de la base de données à l’interface

Sprint 3 (Novembre 2024) – Interface & Accessibilité

• Finalisation de l’interface responsive (mobile, tablette, desktop)
• Optimisation pour les daltoniens (contraste, couleurs)
• Nettoyage de la base de données (suppression des doublons)
• Déploiement sur GitHub Pages

7) Difficultés rencontrées

Problème 1 : Sources hétérogènes

Situation : Les tutoriels scrapés depuis différents sites ont des formats très variés (listes à puces, paragraphes, images manquantes…).

Solution : Nous avons créé un format JSON standardisé et écrit un convertisseur spécifique pour chaque source. Une validation manuelle garantit la qualité finale.

Problème 2 : Précision de la recherche

Situation : Un utilisateur cherche « vélo » et tombe sur un tutoriel de « biosphère autonome » qui utilise un pédalier…

Solution : Nous avons ajusté les poids dans Fuse.js pour privilégier le titre et les mots-clés principaux. La précision est passée de ~65% à ~85%.

Problème 3 : Accessibilité visuelle

Situation : Lors du Sprint Review, les évaluateurs ont signalé que nos couleurs (jaune/vert) manquaient de contraste pour certains daltoniens.

Solution : Tests avec simulateurs de daltonisme et ajustement des nuances pour respecter les normes WCAG 2.1. Ajout d’icônes en complément des couleurs.

---

III – Résultats

Notre projet de création d’une plateforme de centralisation des tutoriels low-tech s’est soldé par la mise en ligne d’une application web fonctionnelle accessible à tous.

Points forts du projet

• ~150 tutoriels harmonisés et accessibles
• Recherche instantanée : temps de réponse ~50 ms
• Poids léger : page d’accueil de seulement 350 Ko
• Open source : code disponible sur GitHub pour contributions futures
• Zéro déchet électronique : solution 100% logicielle

Limites et améliorations possibles

Comme tout prototype, MakerLens peut encore être amélioré :

1. Dépendance Internet : L’application nécessite une connexion web. Solution envisagée :
   développer une Progressive Web App (PWA) pour un fonctionnement hors-ligne complet.
2. Langue unique : Actuellement en français seulement. Solution : internationalisation de
   l’interface pour toucher une audience mondiale.
3. Contribution communautaire : Pour l’instant, seule l’équipe dev peut ajouter des tutoriels.
   Solution : créer un éditeur visuel permettant à tous de contribuer facilement.

Feuille de route pour la communauté (Roadmap)

Le code étant Open Source, nous invitons les étudiants, développeurs et makers à s’approprier MakerLens. Voici une liste de fonctionnalités concrètes que nous identifions pour la suite, prêtes à être développées par d’autres :

• Ajout d’autres sites scrapés : Étendre la base de données en développant de nouveaux scripts pour intégrer d’autres sources de tutoriels libres.
• Système de favoris local (LocalStorage) : Développer une fonction permettant aux utilisateurs de marquer des tutoriels comme « À faire ». Le défi est de stocker ces données directement dans le navigateur (via localStorage) pour éviter toute gestion de compte et respecter la vie privée.
• Filtre par « Outillage disponible » : Créer un « filtre inversé » innovant où l’utilisateur coche les outils qu’il possède (ex: scie sauteuse, fer à souder). L’algorithme ne proposerait alors que les projets réalisables immédiatement, réduisant la frustration des débutants.
• Comparateur de solutions : Implémenter une vue permettant d’afficher deux tutoriels côte à côte (ex: deux versions de « Marmite norvégienne ») pour comparer le matériel requis et la complexité.
• Intégration d’un bouton « Signaler une erreur » : Ajouter un lien simple sur chaque tutoriel qui pré-remplit une « Issue » sur GitHub. Cela permettrait à la communauté de signaler un lien mort sans complexifier l’infrastructure.
• Calculateur d’impact environnemental : Concevoir un algorithme estimant le CO2 évité pour chaque réparation ou recyclage.
• API publique : Ouvrir le catalogue via une API pour que d’autres fablabs puissent intégrer nos données.

Retours utilisateurs

Lors des Sprint Reviews et tests utilisateurs, nous avons reçu des retours encourageants :

« C’est exactement ce dont j’aurais besoin pour préparer mes ateliers ! »
– Fab Manager interrogé

« Le fait de pouvoir filtrer par difficulté me rassure. »
– Professeur de technologie interrogé

Conclusion

MakerLens démontre qu’il est possible de créer une solution numérique utile tout en respectant les principes
low-tech. En agrégeant et standardisant la documentation existante, nous répondons à un besoin réel sans créer
de sur-ingénierie.

Le projet est entièrement open source et peut être forké, modifié et amélioré par la communauté.
Nous espérons qu’il servira de base pour développer des outils similaires dans d’autres domaines (cuisine, jardinage, etc.).

Liens utiles :

• Application : https://promaaa.github.io/maker_lens/
• Code source : https://github.com/promaaa/maker_lens
• Vidéo : https://www.youtube.com/watch?v=mN9q2muRL1g
• Manuel utilisateur : Manuel utilisateur

---

Projet réalisé dans le cadre du Fil Rouge TAF COUAD 2025 – IMT Atlantique

Series Navigation

<< MAKER LENS – Synthèse de l’enquête terrain et personas