Méthodologie de projet
Au programme
- Découper la machine en sous-systèmes
- S’organiser avec GitHub
- Garder la trace
Où en êtes-vous ?
- Le cahier des charges : les niveaux sont-ils validés par toute l’équipe ?
- L’existant :
etudes.mdcontient-il des solutions avec leurs sources ? - Les grandes parties de la machine : en avez-vous parlé ensemble ?
Ce qui manque se rattrape aujourd’hui : c’est justement le point de départ du découpage.
Découper la machine
Un gros problème, c’est plusieurs petits problèmes
Pourquoi découper
- Répartir le travail : un sous-système, un responsable
- Chercher des solutions partie par partie, pas pour toute la machine d’un coup
- Tester séparément : on valide le porte-stylo avant d’avoir le reste
- Documenter clairement : une page par sous-système dans
conception/
Le template le prévoit déjà : conception/index.md commence par l’architecture globale, et les rôles de equipe.md peuvent suivre ce découpage.
Constituer et organiser son équipe
Comment découper
- Partez des fonctions du cahier des charges : chacune est assurée par une partie de la machine
- Regroupez ce qui travaille ensemble : 4 à 7 sous-systèmes, pas 20
- Tracez les liens : qui alimente quoi, qui commande quoi, qui est fixé sur quoi
- Repérez les interfaces : là où deux sous-systèmes se touchent
Une interface oubliée, c’est deux pièces qui ne s’assemblent pas le jour du montage.
Activité : découpez votre machine
- Listez les sous-systèmes de votre machine, avec la fonction que chacun assure
- Dessinez un schéma bloc : une boîte par sous-système, une flèche par lien
- Entourez les interfaces : fixation, connecteur, format de fichier…
Puis, en binôme de projets différents (6 min) : expliquez votre schéma. Votre binôme voit-il une partie oubliée ?
Correction : Machine That Draws
graph LR
L[Logiciel<br/>image vers G-code] -->|USB, G-code| E[Électronique<br/>de commande]
A[Alimentation] --> E
E --> D[Déplacement XY]
E --> P[Porte-stylo]
D --- P
D --- S[Structure<br/>sur plaque percée]
S --- F[Maintien<br/>de la feuille]
Six sous-systèmes, dont deux qu’on oublie souvent : le logiciel qui prépare le tracé, et le maintien de la feuille.
Correction : les interfaces à ne pas oublier
| Interface | Entre | À fixer ensemble |
|---|---|---|
| Fixation du stylo | Porte-stylo et déplacement XY | Encombrement, points de fixation |
| Fixation au châssis | Structure et plaque percée | Entraxe des trous, visserie |
| Format du tracé | Logiciel et électronique | G-code accepté par le firmware |
| Alimentation | Alimentation et électronique | Tension, courant, connecteur |
Chaque interface a un responsable : sinon, chacun pense que c’est l’autre.
S’organiser avec GitHub
Qui fait quoi, pour quand
Le vocabulaire
| Mot | C’est… | Exemple |
|---|---|---|
| Issue | Une tâche, un bug ou une question à trancher | « Tester la levée du stylo par servo » |
| Assignee | La personne qui s’en charge | Vous |
| Label | Une étiquette pour trier | porte-stylo, logiciel |
| Milestone | Un jalon daté qui regroupe des issues | « POC fonctionnel », fin du S1 |
| Project | Le tableau qui affiche les issues par avancement | À faire, En cours, Terminé |
Optionnel dans le template, mais évalué dans ce cours.
Une issue qu’on peut vraiment traiter
❌ Vague
Titre : Problème moteur
Description : (vide)
✅ Exploitable
Titre : Le moteur pas à pas ne tourne pas avec le driver A4988
Description : le moteur reste bloqué, le driver chauffe. Câblage vérifié. Piste : réglage du courant. Fini quand le moteur fait 10 tours sans décrocher.
Un titre précis, le contexte, et comment on sait que c’est fini.
Un tableau par sous-système
| À faire | En cours | Terminé |
|---|---|---|
porte-stylo Tester la levée par servo |
déplacement-xy Comparer courroie et tige filetée |
structure Relever l’entraxe des trous de la plaque |
logiciel Générer un carré en G-code |
électronique Régler le courant des drivers |
|
feuille Essayer le maintien par aimants |
Une étiquette par sous-système, une personne par issue, et un tableau qui reflète la réalité : une carte « En cours » depuis trois semaines, ça se discute en équipe.
Les jalons : des dates, pas des intentions
- Un jalon (milestone) est une étape datée : on sait ce qui doit être fini à cette date
- Chaque issue est rattachée à un jalon, et GitHub affiche le pourcentage terminé
- Exemples : « Architecture validée », « Premier trait tracé », « POC fonctionnel » (fin du S1)
- Dans le repo : onglet Issues, bouton Milestones, puis New milestone
Un jalon qui glisse n’est pas une faute : c’est une information, à écrire dans le journal avec sa raison.
Activité : vos premières issues
- Onglet Projects du repo : si le tableau de l’équipe n’existe pas, créez-le (New project, modèle Board)
- Onglet Issues, bouton Labels : l’étiquette de votre sous-système existe-t-elle ? Sinon, créez-la
- Créez trois issues pour votre partie : titre précis, description, fini quand, étiquette, assignée à vous
- Ajoutez-les au Project
- Votre binôme relit une issue : sait-il quoi faire, et quand c’est fini ?
Garder la trace
Le journal, à chaque séance
Activité : le journal de la séance
- Fait : votre découpage de la machine, vos premières issues
- Pourquoi : les regroupements que vous avez choisis, les interfaces repérées
- Reste à faire : ce que l’équipe doit trancher ensemble
Ajoutez une photo ou une capture de votre schéma bloc : c’est la base de l’architecture globale.
D’ici la prochaine séance
- Mettez en commun vos découpages dans
conception/index.md, section Architecture globale - Dans
equipe.md, un responsable par sous-système, et un responsable par interface - Créez les jalons, dont le POC de fin de S1, et rattachez-y les issues
- Au début de chaque séance de projet, passez le tableau en revue ensemble
La prochaine séance : choisir les solutions de chaque sous-système, et tracer ses choix.
Tracer ses choix techniques Communiquer en équipe
