Aller au contenu

Le projet : une application de gestion pour l'école

Temps 3 · séance 1 · ~30 min

Les slides du chapitre (PDF)PDF

  • Dire ce que le projet demande : sept exigences, des bonus, un rapport.
  • Former un groupe de deux ou trois et choisir un sujet.
  • Situer chaque séance dans le planning, de l'entretien avec le client à la présentation.

Remise : au plus tard le mardi 8 décembre 2026, au début de la séance 8, dans le devoir Teams du temps 3.

1. Ce que vous allez construire

Une application de gestion est une application où plusieurs personnes, derrière une connexion, encodent des données, les consultent et prennent des décisions dessus. Le secrétariat encode, le professeur valide, l'étudiant consulte son dossier. Chacun voit un écran différent, parce que chacun a un rôle différent.

Vous en construisez une en groupe de deux ou trois, en huit séances, pour un client. Le client est le professeur. Il joue le responsable du matériel, le superviseur des stages ou le secrétariat, selon votre sujet. Il répond à vos questions, il valide votre cahier des charges, et il assiste à votre présentation.

Les cinq sujets sont décrits au chapitre 3.02. Ce sont cinq applications que l'école n'a pas encore : le prêt de matériel, les présences, le stage, l'épreuve intégrée, les dispenses. Chaque sujet arrive avec les documents du client, des formulaires et des tableurs qu'il utilise aujourd'hui. Vous pouvez aussi proposer votre propre sujet, s'il sert l'école : le chapitre 3.02 dit comment le faire valider.

Huit séances, c'est court. Visez une application qui fait bien une chose. Un seul parcours qui marche de bout en bout, avec deux comptes et une règle respectée, vaut mieux que dix écrans à moitié finis.

Vous savez déjà une bonne partie du travail. Le portfolio vous a appris le formulaire, le téléversement, les tests et la mise en ligne. Le Tamagotchi troué vous a appris la policy, qui dit qui a le droit de faire quoi. Ce qui est nouveau ici : travailler à plusieurs dans le même dépôt, gérer plusieurs rôles, écrire une règle métier et la tester, construire un tableau de gestion et un tableau de bord.

2. Les sept exigences

Les sept exigences forment le minimum noté. Elles valent pour les cinq sujets.

N° Ce que l'application fait Comment on le vérifie
O1 Elle applique la règle métier de votre sujet. Un test par exemple de la règle, et le cas refusé montré à la présentation.
O2 Elle garde ses données dans trois à cinq modèles Eloquent reliés, avec leurs enums. Le diagramme de classes du rapport, et php artisan migrate:fresh --seed qui donne une application remplie.
O3 Elle distingue deux rôles au moins, et le serveur vérifie les droits de chacun. Le tableau des droits du rapport, et un test pour chaque action interdite.
O4 Elle offre un tableau de gestion avec un tri, une recherche, un filtre et une pagination. À l'écran, sur les données du seeder.
O5 Elle a un formulaire long, validé par le serveur, avec un fichier téléversé. Envoyé vide, le formulaire affiche une erreur en français sous chaque champ.
O6 Elle montre un tableau de bord dont les chiffres viennent d'une requête agrégée. Un chiffre change quand vous ajoutez une ligne.
O7 Elle est en ligne, sa CI est verte, et un autre groupe l'installe avec votre README. L'adresse, l'onglet Actions de GitHub, et l'essai de l'autre groupe.

Une règle métier est une contrainte qui vient du travail du client, pas de la technique. « Un appareil ne peut pas être prêté à deux personnes en même temps » en est une. Elle resterait vraie si la Réserve tenait ses prêts dans un classeur. Le chapitre 3.04 en donne d'autres et montre où les écrire dans le code.

Une requête agrégée compte ou additionne des lignes au lieu de les afficher : le nombre de prêts en retard par catégorie, le total des heures de stage validées par étudiant.

Pour O7, vous mettez en ligne chez OVH, comme pour le portfolio, ou chez l'hébergeur de votre choix.

Terminé veut dire

Ces cinq points valent pour chaque écran. Ils sont écrits ici une fois, et vous ne les recopiez pas dans votre rapport.

  • Le serveur valide chaque formulaire, avec une Form Request.
  • Les erreurs s'affichent en français, sous le champ concerné.
  • Une action réussie affiche un message de confirmation.
  • Une action interdite répond 403, même quand le bouton est caché.
  • Le code est en anglais, les adresses et les textes affichés sont en français.

3. Les bonus

Un bonus ne remplace pas une exigence. Il compte au niveau « maîtrisé » de la grille, une fois les sept exigences en place.

  • Un e-mail envoyé par une action, comme au chapitre 1.20.
  • Un import ou un export CSV.
  • Une page imprimable, pour un reçu ou une fiche.
  • Un test dans le navigateur, qui joue le parcours principal.
  • Un audit d'accessibilité complet d'un écran.
  • Une idée à vous, écrite dans le rapport avec sa vérification.

Un bonus bien fini vaut mieux que trois bonus commencés.

4. En groupe dans un dépôt

Vous travaillez en groupe de deux ou trois. Chaque groupe prend un sujet différent. Un groupe de trois réalise aussi un bonus de son choix.

Le groupe a un seul dépôt GitHub. Personne n'écrit directement sur main. Chaque morceau de travail vit sur une branche, puis passe par une pull request, la demande de fusion que GitHub affiche avec les lignes changées. Un autre membre la relit, la CI passe au vert, et la branche est fusionnée. Le chapitre 3.03 vous fait essayer tout le trajet à la première séance, conflit compris.

À chaque séance, chaque membre fusionne au moins une pull request relue par un autre membre. L'historique du dépôt montre ainsi qui a fait quoi.

La règle du cours sur l'IA ne change pas. Les assistants sont permis, les agents de code qui écrivent dans votre projet ne le sont pas. Ce projet ne demande pas de carnet IA. Chacun doit pouvoir expliquer chaque ligne du dépôt, même celles qu'un autre membre a écrites.

5. Le rapport

Le rapport est un seul document Word, que vous commencez à la première séance et que vous finissez pour la remise. Il a deux parties. Téléchargez le gabarit du rapport en WordDOCX, que vous remplirez puis rendrez en PDF. La version PDFPDF sert à le lire.

La première partie est le cahier des charges. Elle tient en six pages courtes, et le client la valide à la séance 2, avant que vous écriviez du code.

  1. Le client et son problème, en cinq lignes.
  2. Deux ou trois scénarios. Un scénario raconte, en cinq à huit lignes, ce qu'une personne fait avec l'application, du début à la fin.
  3. Le tableau des droits. Une ligne par modèle, une colonne par rôle. Chaque case dit ce que le rôle peut faire : voir les siens, tout voir, créer, modifier, supprimer, ou rien.
  4. Les règles métier. Chaque règle tient en une phrase, suivie de deux exemples : un cas accepté et un cas refusé.
  5. La liste des écrans. Une ligne par écran : son adresse, qui y accède, ce qu'on y fait.
  6. Le diagramme de classes de vos modèles Eloquent et de vos enums, dans la notation de 5XCOS, puis l'estimation en heures, écran par écran et règle par règle.

Vous n'écrivez pas la liste de toutes les fonctionnalités. Le tableau des droits dit en une page qui peut faire quoi, et il devient vos policies. Les exemples des règles deviennent vos tests. Le chapitre 3.05 montre comment remplir ces six pages à partir des documents du client et de l'entretien.

La seconde partie est le dossier technique, que vous remplissez pour la remise : l'application en captures d'écran, les tests et la CI, la mise en ligne, le cadre légal, l'estimé contre le réel, et qui a fait quoi.

6. Ce que vous remettez sur Teams

Élément Forme
L'adresse de l'application en ligne un lien, avec un compte de démonstration par rôle
L'adresse du dépôt GitHub un lien vers un dépôt public, ou partagé avec votre professeur
Le README à la racine du dépôt
Le rapport, avec les noms de tous les membres un PDF
Le support de votre présentation un PowerPoint ou un PDF

Un élément absent de la remise ne peut pas être évalué. Le projet reçoit une note de suivi sur 20, qui ne compte pas dans la note finale du cours.

7. Le planning

Séance En classe Votre projet, à la fin de la séance
1 Le projet, les cinq sujets, Git à deux, les règles métier Groupe formé, sujet choisi, dépôt créé ensemble, entretien avec le client
2 Le cahier des charges, les rôles Cahier des charges validé par le client, modèles, migrations et seeders
3 Le tableau de gestion Un premier tableau, avec ses droits
4 Le formulaire long, les tests de la règle et des droits La règle métier appliquée et testée
5 Première revue, le tableau de bord Le parcours principal marche de bout en bout, tableau de bord
6 La page publique : cadre légal et accessibilité Page publique, mentions légales, un bonus
7 La mise en ligne Application en ligne, README essayé par un autre groupe
8 Présentations Remise

8. Les trois rendez-vous avec le client

À la séance 2, la validation. Vous présentez la première partie du rapport au client. Il la valide, ou il demande une correction. Vous ne codez pas le métier avant ce feu vert.

À la séance 5, la première revue. Chaque groupe a cinq minutes : le parcours principal joué à l'écran, un point fort, un point faible, et l'objectif pour les trois séances restantes.

À la séance 8, la présentation. Chaque groupe présente son application à la classe, en dix minutes au plus, avec un support PowerPoint. Vous la présentez comme un produit, à des personnes qui pourraient s'en servir. Cet exercice prépare la présentation de votre épreuve intégrée devant un jury.

  1. Le métier et le public. Dites dans quel service l'application sert, et qui l'utilise.
  2. Le problème. Dites ce qui tourne mal aujourd'hui avec le papier et les tableurs. Dites ensuite ce que l'application change : le temps gagné, les erreurs évitées, le travail rendu plus simple.
  3. Les fonctionnalités marquantes, dans les grandes lignes. Trois ou quatre suffisent.
  4. Une courte démonstration, sur l'application en ligne. Vous jouez un scénario du rapport, comme le ferait une personne du public, jusqu'au cas que la règle métier refuse.

Vous ne présentez pas les outils techniques. Tous les groupes utilisent les mêmes.

À retenir

  • Le projet demande sept exigences, vérifiables à l'écran, dans les tests ou dans le rapport.
  • Le client valide votre cahier des charges à la séance 2, avant le code du métier.
  • Le cahier des charges tient en six pages : des scénarios, un tableau des droits, des règles avec leurs exemples, des écrans, un diagramme, une estimation.
  • Chaque morceau de travail passe par une branche et une pull request relue par un autre membre.
  • La remise réunit l'application en ligne, le dépôt, le rapport en PDF et le support de la présentation.
  • À la séance 8, vous présentez l'application comme un produit : son public, le problème réglé, ses fonctionnalités, une courte démonstration.