Méthodologie de projet

Au programme

1. Git et GitHub : faire le point
2. Où en êtes-vous ?
3. Le cahier des charges complet
4. Rechercher l’existant
5. Garder la trace

2

Le cycle de base

graph LR
    A[Pull<br/>récupérer] --> B[Modifier<br/>les fichiers]
    B --> C[Commit<br/>enregistrer]
    C --> D[Push<br/>envoyer]
    D -.à la séance suivante.-> A

Git, GitHub Desktop et VSCode

4

Les bons réflexes

• Pull en arrivant, avant de toucher à quoi que ce soit
• Commit souvent, avec un message qui dit ce qui change : « Ajoute FC3 au cahier des charges », pas « modif »
• Push en partant : un travail resté sur votre PC n’existe pas pour l’équipe
• Vérifiez sur GitHub que c’est arrivé, puis sur le site publié (onglet Actions au vert)
• Évitez d’éditer le même fichier à plusieurs en même temps : répartissez-vous les pages

5

Les problèmes les plus fréquents

Résoudre un conflit Git Modifier son site depuis GitHub

6

Activité : le tour complet

Individuel10 minSur PC

1. Pull sur le repo de votre équipe
2. Complétez votre entrée de journal de la séance 1 (une précision, une photo, une faute corrigée)
3. Commit avec un message clair, puis Push
4. Vérifiez sur GitHub, puis sur le site publié

Bloqué à une étape ? Levez la main : c’est le moment de régler ça, pas la veille du rendu.

7

Activité : où en êtes-vous ?

Binôme de projets différents5 minSur GitHub

Ouvrez le repo de votre équipe et montrez à votre binôme :

1. objectifs.md : lisez le besoin sans l’expliquer. Votre binôme le comprend-il ?
2. equipe.md : chaque rôle a-t-il un responsable et un backup ?
3. Votre journal : une entrée pour la séance 1, et pour chaque séance de projet depuis ?

Notez ce qui manque : vous le compléterez pendant la séance.

8

Rappel : fonctions et contraintes

Chaque ligne a aussi une flexibilité : de F0 (impératif) à F3 (négociable).

Le tableau des fonctions

10

Trouver les fonctions qui manquent

graph LR
    U[Utilisateur] --- M((Machine))
    F[Feuille] --- M
    S[Stylo] --- M
    M --- P[Plaque percée]
    M --- K[Kit fourni]
    M --- Pu[Public du stand]
    M --- A[Alimentation]
    style M fill:#ef2e31,stroke:#ef2e31,color:#ffffff

Pour chaque élément autour : que doit faire la machine avec lui, ou respecter à cause de lui ? Chaque réponse est une fonction de plus.

Le diagramme pieuvre

11

Et pour fixer les niveaux ?

• Mesurez : la taille de la feuille, la place sur une table, la course d’un servo
• Regardez l’existant : ce que d’autres machines atteignent vraiment
• Partez des contraintes : le calendrier et le kit fournis limitent ce qui est réaliste
• Assumez la flexibilité : un niveau incertain peut être F2, à revoir après les premiers essais

Un niveau inventé « pour remplir la case » ne sert à rien : il faut pouvoir dire d’où il vient.

12

Activité : complétez votre cahier des charges

Individuel15 minSur PC

1. Pull avant tout : vos coéquipiers modifient le même fichier
2. Dans objectifs.md, ajoutez au moins deux fonctions ou contraintes, avec critère, niveau et flexibilité
3. Pour chaque niveau, sachez dire d’où il vient
4. Commit et Push tout de suite, pour limiter les conflits

Si le Push est refusé, faites un Pull puis recommencez : Git fusionne seul tant que vous n’avez pas modifié la même ligne.

Git, GitHub Desktop et VSCode

13

Pourquoi chercher avant de concevoir

• Gagner du temps : quelqu’un a sûrement déjà résolu une partie de votre problème
• Fixer des niveaux réalistes : ce que d’autres machines atteignent vraiment
• Éviter les pièges : les problèmes rencontrés par les autres sont souvent documentés
• Justifier vos choix : « on a comparé trois solutions » vaut mieux que « c’était la première idée »

L’an dernier, moins de la moitié des équipes Machine That Draws ont documenté leur recherche de l’existant.

Rechercher l’existant et étudier la faisabilité

15

Où chercher

• Les projets des années précédentes : repos et documentations sur makerspace-amiens.fr/makerspace-projects
• Les projets en ligne : Hackaday, Instructables, GitHub, Printables
• Les produits du commerce : leurs fiches techniques donnent des niveaux de performance
• Les vidéos : pour voir une machine fonctionner, et ses défauts

Cherchez aussi ce qui n’a pas marché : un échec documenté vous évite de le reproduire.

16

Chercher aussi par sous-système

Ne cherchez pas que des « machines qui dessinent » : découpez votre machine en fonctions, et cherchez qui a déjà résolu chacune.

On reprendra cette démarche à la prochaine séance, pour choisir les solutions techniques de chaque sous-système.

Rechercher l’existant et étudier la faisabilité

17

Quoi en retenir : une fiche par solution

La dernière colonne est la plus importante : c’est elle qui relie l’existant à votre projet.

Comment présenter sa recherche

18

Un extrait réel : qu’est-ce qui manque ?

Extrait d’un repo Machine That Draws de l’an dernier, anonymisé.

19

Exemple : trois solutions étudiées

Chaque ligne se termine par une décision reliée au cahier des charges.

20

Activité : votre fiche de l’existant

Individuel20 minSur PC

1. Pull, puis ouvrez etudes.md, section Recherche de l’existant
2. Ajoutez deux lignes au tableau : une autre machine qui dessine (un projet de l’an dernier, par exemple), et une solution trouvée ailleurs pour une partie de votre machine (lever le stylo, tenir la feuille…)
3. Remplissez toutes les colonnes, avec une source cliquable
4. Commit et Push
5. Votre binôme relit : la source s’ouvre-t-elle ? Comprend-il ce que vous en retenez ?

Entre coéquipiers : une ligne par solution, et un Pull juste avant d’écrire.

21

Activité : le journal de la séance

Individuel7 minSur PC

Une nouvelle entrée datée dans votre dossier :

• Fait : les fonctions ajoutées au cahier des charges, les solutions étudiées
• Pourquoi : d’où viennent vos niveaux, pourquoi vous écartez une solution
• Reste à faire : ce que l’équipe doit encore trancher

Une capture de votre tableau ou de la machine étudiée rend l’entrée plus parlante.

Tenir un journal de bord

23

D’ici la prochaine séance

Avec votre équipe projet

1. Relisez ensemble le cahier des charges et mettez-vous d’accord sur les niveaux
2. Mettez en commun l’existant et listez les grandes parties de votre machine
3. Une entrée de journal à chaque séance, projet comme méthodologie

La prochaine séance : découper la machine en sous-systèmes, et organiser le travail avec un GitHub Project.

Rechercher l’existant et étudier la faisabilité Gérer son projet avec GitHub

24