TP1 – Gestion de l'équipage

0 Le dépôt GitHub

Tout le projet vit dans un seul dépôt, que vous enrichirez de TP en TP.

1. Créez un dossier de projet et son environnement virtuel, puis initialisez votre dépôt Git :

   
             mkdir 4pyth-fondation
             cd 4pyth-fondation
             python3 -m venv .venv        # Windows : py -m venv .venv
             git init
           

2. Créez un fichier .gitignore, pour que l'environnement virtuel ne soit jamais envoyé sur GitHub :

   
             .venv/
             __pycache__/
           

3. Créez un fichier README.md avec au moins le titre du projet et votre nom. Vous le compléterez au fil des TP (mode d'emploi, bonus réalisés, déclaration d'usage de l'IA).
4. Sur GitHub, créez un dépôt privé nommé 4pyth-fondation-nom-prenom, sans README, puis reliez-le et poussez :

   
             git add .
             git commit -m "Initialisation du projet Fondation"
             git branch -M main
             git remote add origin https://github.com/votre-pseudo/4pyth-fondation-nom-prenom.git
             git push -u origin main
           

5. Dans Settings → Collaborators, invitez Chris-CHEVALIER, au plus tard le vendredi 9 octobre.

        git config --global user.name "Nom d'utilisateur"
        git config --global user.email "adresse@exemple.fr"
      

1 L'équipage

L'équipage est une liste de membres. Chaque membre est un dictionnaire contenant cinq clés :

Dans un fichier main.py, créez l'équipage de départ en copiant ces cinq membres :

      crew = [
          {"first_name": "Bel", "last_name": "Riose", "gender": "M", "age": 48, "role": "commandant"},
          {"first_name": "Gaal", "last_name": "Dornick", "gender": "F", "age": 34, "role": "technicien"},
          {"first_name": "Hugo", "last_name": "Crast", "gender": "M", "age": 37, "role": "pilote"},
          {"first_name": "Salvor", "last_name": "Hardin", "gender": "F", "age": 28, "role": "armurier"},
          {"first_name": "Novi", "last_name": "Sura", "gender": "F", "age": 25, "role": "entretien"},
      ]
    

Le reste de la flotte vous attend dans le jeu de données ci-dessous. Vous ajouterez ces membres avec votre propre fonction add_member. C'est la meilleure façon de la tester.

Jeu de données – flotte « Galactica », commandant Bel Riose

Trois mentalistes complètent la flotte : Tellem Bond (M, 48 ans), Yanna Seldon (F, 52 ans) et Joie (F, 25 ans). Ils ont des pouvoirs particuliers. Vous les modéliserez au TP2.

2 Les fonctions de gestion

Dans un fichier crew.py, écrivez les quatre fonctions suivantes. Chacune reçoit l'équipage en paramètre.

add_member(crew) – Ajouter un membre

1. Demande le prénom, le nom de famille, le genre, l'âge et le rôle du nouveau membre avec input().
2. Refuse toute saisie invalide et, grâce à une boucle while, la redemande tant qu'elle n'est pas correcte :
   • prénom et nom de famille : entre 3 et 15 caractères ;
   • nom de famille unique dans l'équipage, sans tenir compte de la casse ;
   • genre : "F" ou "M" ;
   • âge : un nombre entier écrit en chiffres. Une saisie comme vingt est refusée (on ne la convertit pas en 20) et ne doit pas faire planter le programme ;
   • rôle : uniquement une valeur de la liste ROLES, sans tenir compte de la casse.
3. Ajoute le dictionnaire du nouveau membre à la liste et affiche une confirmation.

      ROLES = ["commandant", "pilote", "technicien", "armurier", "marchand", "entretien"]
    

remove_member(crew) – Retirer un membre

1. Demande le nom de famille du membre à retirer.
2. Le retire de la liste et affiche une confirmation.
3. Affiche un message clair si aucun membre ne porte ce nom.

display_crew(crew) – Afficher l'équipage

1. Affiche toutes les informations de chaque membre sur une ligne, numérotée.
2. Affiche un message si l'équipage est vide.

check_crew(crew) – Vérifier l'équipage

1. Vérifie que l'équipage compte au moins 2 membres, dont au moins un pilote et un technicien.
2. Affiche L'équipage est prêt pour la mission ! ou, sinon, ce qui manque.
3. Renvoie True ou False.

3 Le menu interactif

1. Dans main.py, importez vos fonctions depuis crew.py.
2. Affichez le menu dans une boucle while True et traitez le choix avec match / case.
3. L'option [0] Quitter sort de la boucle. Les TP suivants ajouteront les options [5], [6], etc.
4. Un choix invalide (abc, 7…) affiche un message et ne fait jamais planter le programme.
5. Placez le lancement du menu sous if __name__ == "__main__":. Ainsi, le menu ne démarre que si l'on exécute main.py directement et pas si un autre fichier l'importe (pour réutiliser ses fonctions ou les tester, par exemple).

      ===== Flotte marchande – Gestion de l'équipage =====
      [1] Ajouter un membre
      [2] Retirer un membre
      [3] Afficher l'équipage
      [4] Vérifier l'équipage
      [0] Quitter
      Votre choix : 3
       1. Bel Riose (M, 48 ans) – commandant
       2. Gaal Dornick (F, 34 ans) – technicien
       3. Hugo Crast (M, 37 ans) – pilote
       4. Salvor Hardin (F, 28 ans) – armurier
       5. Novi Sura (F, 25 ans) – entretien
    

+ Pour aller plus loin

Bonus 1 – Terminal de bord sécurisé

• Au lancement, demandez un code d'accès avant d'afficher le menu. Masquez la saisie avec getpass.
• Après 3 codes incorrects, le programme s'arrête.
• Pour votre culture (rien à coder) : votre code d'accès est écrit en clair dans votre code source, ce qui est une mauvaise pratique. En production, on ne stocke jamais un secret en clair mais seulement son empreinte (hash), calculée par une fonction dédiée comme bcrypt ou argon2.

Bonus 2 – Contraintes d'âge

• Un pilote doit avoir au moins 25 ans, un technicien au moins 18 ans.
• Aucun membre ne peut avoir plus de 65 ans.

Bonus 3 – Promotions

• Ajoutez une clé experience (en années) aux membres.
• Un technicien ayant au moins 10 ans d'expérience peut être promu pilote, si les contraintes d'âge sont respectées.

Bonus 4 – Rapport d'équipage

• Ajoutez une option de menu qui affiche le nombre total de membres, la répartition par rôle et les membres proches de l'âge maximum.

✓ Avant de rendre

Vérifiez chaque point. Ils correspondent à la grille d'évaluation du projet Fondation.

• Les quatre options du menu fonctionnent et [0] quitte proprement.
• Aucune saisie ne fait planter le programme : lettres à la place d'un nombre, option inexistante, nom inconnu…
• Les règles de validation sont respectées : longueur des noms, nom unique, genre, rôle de la liste autorisée.
• Les messages guident l'utilisateur. Il sait toujours ce qui s'est passé et ce qu'il doit faire.
• Le code est réparti entre crew.py (fonctions) et main.py (menu).
• Noms de variables et de fonctions en snake_case et en anglais, avec une docstring par fonction.
• Le dépôt est sur GitHub, j'y suis invité et il contient plusieurs commits.
• Vous pouvez expliquer chaque ligne de votre code.