How dehboris/tp-calculatrice-21 works
1. Nature du dépôt
- Ce repository ne contient pas une application exécutable ni de code métier.
- C’est un dépôt de consignes pédagogiques pour un exercice Git/GitHub autour d’un projet nommé tp-calculatrice-21.
2. Contenu réel du dépôt
- README.md : document principal, décrit le workflow demandé à l’étudiant.
- changelog.md : fichier prévu pour tracer l’historique des changements, mais son rôle exact n’est pas détaillé dans l’arborescence fournie.
- LICENSE : cadre juridique du dépôt.
- Il n’y a pas de dossier source, de dépendance runtime, ni de configuration d’exécution visibles.
3. Fonction principale du repository
- Le dépôt sert de support de distribution et de soumission.
- L’objectif est de récupérer un projet depuis un fork, travailler sur une branche nommée selon la convention imposée, puis soumettre les modifications via un pull request.
4. Flux de travail central
- Le flux suit une chaîne GitHub classique :
1. création d’un compte GitHub,
2. fork du projet,
3. clone du fork localement,
4. création d’une branche de travail,
5. ajout du contenu du projet dans le dossier,
6. commit,
7. push vers le fork,
8. pull request vers le dépôt d’origine.
- L’architecture à représenter est donc surtout un flux de contribution, pas un flux applicatif.
5. Frontières importantes
- GitHub est l’hôte distant principal.
- Poste local de l’étudiant : espace de travail pour le clone, la branche et les commits.
- Dépôt forké : zone de staging côté utilisateur.
- Dépôt source d’origine : cible du pull request final.
- La séparation la plus importante est entre le fork utilisateur et le repo upstream.
6. Convention de branche
- Le README impose une règle stricte de nommage de branche : nom-prenom en minuscules.
- Cette contrainte fait partie du contrôle de conformité du dépôt et structure le travail individuel.
7. Données échangées
- Les seuls “artefacts” manipulés sont des fichiers Git : contenu du projet copié dans le dossier, commits, puis push.
- Aucun format d’entrée/sortie applicatif, API, base de données ou service externe n’est mentionné.
8. Technologies et infrastructure pertinentes
- La seule infrastructure réellement impliquée est Git et GitHub.
- Aucun framework, langage d’exécution, conteneur, CI/CD ou service tiers n’apparaît dans les fichiers fournis.
9. Implication pour un diagramme d’architecture
- Le diagramme devrait montrer un référentiel de consignes alimentant un workflow de contribution.
- Les composants à dessiner sont : utilisateur, clone local, fork GitHub, dépôt source GitHub, et pull request.
- Il ne faut pas dessiner de modules applicatifs internes, car ils ne sont pas présents dans ce dépôt.
10. Conclusion
- Ce repository est avant tout un cadre de travail et de soumission.
- Son architecture est minimale : documentation + licence + journal de changements, autour d’un processus Git/GitHub.
Main entry points: README.md README · changelog.md Changelog · LICENSE License
Components 9
Docs
Repository guidance and reference files
Workflow
Git/GitHub contribution path
- Student · Learner completing the exercise
- Local clone · Working copy on the student machine
- Work branch · Named branch following nom-prenom convention
- Fork repo · Student-owned GitHub fork
- Upstream repo · Original GitHub repository
- Pull request · Final review and submission step
Connections 11
- README → Student: gives instructions · Defines the required contribution workflow and naming convention
- README → Local clone: cloned to · Student clones the fork into a local workspace
- Student → Fork repo: creates fork · Student forks the exercise repository on GitHub
- Fork repo → Local clone: clone · Local working copy is taken from the fork
- Local clone → Work branch: checkout · Work happens on a branch named nom-prenom
- Work branch → Local clone: commits · Changes are committed in the local repository
- Local clone → Fork repo: push · Branch and commits are pushed to the student fork
- Fork repo → Pull request: open PR · A pull request is opened from the fork
- Pull request → Upstream repo: targets · The pull request is submitted against the original repository
- Changelog → Fork repo: tracks changes · Change history is maintained as part of the submitted work
- License → Upstream repo: governs · Licensing applies to the repository content