Devoir/projet/TP fil rouge

2025-2026

Un tiers de la note pour le module « Programmation d'applications web avancées » est un DM/projet en binôme, qui a été fait en partie en TP lors des séances 7 et 8. (Les deux tiers restants sont la note de l'examen sur machine qui aura lieu le 1er décembre.)

Il est question de construire incrémentalement un site web conformément à l'architecture présentée en cours. Le résultat de ce « TP fil rouge » constituera votre DM/projet. Le travail correspondant à l'énoncé des TP est à faire en binôme. On vous demande également un complément par étudiant·e, à faire individuellement. (NB: si vous n'avez pas de binôme, il n'est pas attendu que vous rendiez deux compléments.)

Votre rendu fera l'objet d'un oral obligatoire très court (une dizaine de minutes), visant à nous assurer que vous avez compris ce que vous avez rendu. Chaque étudiant·e sera interrogé·e en particulier sur « son » complément.

Sauf cas exceptionnels, les binômes sont à former au sein des groupes de TP (notamment car les oraux sont organisés par groupe, et les corrections sont faites par les chargé·es de TP).

Création des groupes

Merci d'inscrire vos binômes sur l'appli progest : https://progest.users.info.unicaen.fr (cours «TW4b : Programmation d'applications web avancées») — attention, ce lien n'est accessible que depuis le réseau de l'université (en salle TP ou via bureau-distant).

La deadline pour créer les binômes sur progest est lundi 24 novembre 16h (attention, la deadline indiquée sur progest est fantaisiste, ne pas en tenir compte). Cependant, le plus tôt est le mieux (je devrais pouvoir créer plus tôt les dépôts des groupes déjà inscrits).

Si vous n'avez pas de binôme, vous pouvez rejoindre un groupe et attendre que quelqu'un vous rejoigne ; si vous préférez rester seul·e, choisissez un des groupes de la fin de la liste, ils n'ont qu'une seule place. Merci de ne pas rejoindre un groupe sans vous être mis d'accord avec la personne en question.

Dépôts Git

Normalement, vous avez chacun·e un dépôt Git local avec la construction du site des animaux des TP 7 et 8. Vous n'aurez besoin que d'un seul dépôt : mettez-vous d'accord au sein de chaque binôme sur quel dépôt sera gardé. Une fois les groupes constitués, nous allons créer des dépôts distants sur le gitlab de l'université. Je vous expliquerai alors comment y transférer votre dépôt local.

NB: rien ne vous empêche de continuer à travailler sur votre dépôt local en attendant d'avoir le dépôt distant.

Complément en groupe

En premier lieu, vous devez compléter, toujours en binôme, le travail fait en TP, en mettant en place, de façon propre, l'utilisation d'une base de données MySQL pour stocker les animaux. Pour ce faire, vous pouvez suivre le déroulé de cet exercice.

NB: il n'est pas nécessaire d'avoir fait le complément en groupe avant de s'attaquer aux compléments individuels.

Compléments individuels

Voilà les deux compléments que chaque binôme doit réaliser. Attention, encore une fois, chaque complément doit être réalisé individuellement : il faut donc s'accorder sur qui fait quoi au sein du binôme, et la répartition devra être explicitée dans le README sur le dépôt Git. Cependant il doit bien y avoir un seul rendu final, dans lequel les deux compléments devront être présents ensemble. NB: si vous n'avez pas de binôme, on attend un seul complément.

NB: le 2e complément est plus long à décrire mais pas plus long ou difficile que le premier. Les deux compléments se veulent équilibrés, et indépendants.

[Complément 1] Upload

Ajouter la possibilité d'uploader une image de chaque animal. Cela nécessitera de modifier le modèle (ajout d'un attribut « chemin vers l'image »), la vue (formulaire de création), et d'intégrer proprement la gestion de l'upload au contrôleur, dans le respect des bonnes pratiques de sécurité.

[Complément 2] Mise en place d'une mini-API

Mettre en place un autre script, api.php, qui va faire appel à un autre routeur qui devra reconnaître les URL suivantes :

api.php?collection=animaux doit renvoyer une représentation JSON de la liste des noms des animaux, de la forme suivante :
```
[
  {
    "id": 42,
    "nom": "Médor"
  },
  {
    "id": 83,
    "nom": "Félix"
  },
  {
    "id": 128,
    "nom": "Denver"
  }
]
```
NB, en particulier, qu'on veut les identifiants et les noms, mais rien d'autre.
api.php?collection=animaux&id=42 (avec 42 remplacé par un identifiant d'animal) doit renvoyer une représentation JSON de l'animal d'identifiant 42, de la forme suivante :
```
{
  "nom": "Médor",
  "espece": "chien",
  "age": 23
}
```

Ces représentations JSON doivent être générées par une nouvelle classe de vue (notre classe View est spécialisée pour générer du HTML, or ce n'est pas ce qu'on veut ici). On veut cependant utiliser les méthodes showInformation et showList du contrôleur sans les modifier.

Vous pouvez tester votre API avec cette page. NB: votre API doit retourner un document dont le content-type est identifié comme du JSON.

Barème indicatif

TP 07 : 5 points
TP 08 : 5 points
Complément en groupe : 4 points
Complément individuel : 6 points (note individuelle)

Vous pouvez avoir un bonus jusqu'à 2 points si vous implémentez (proprement) les URL avec PATH_INFO (partie optionnelle à la fin du TP07).

Contraintes techniques

Le non-respect des contraintes ci-dessous entraînera des pénalités pouvant aller jusqu'à annuler la note.

Les pages générées devront être valides HTML5 selon le validateur du W3C (« Validate by URI » devrait fonctionner).
Le site devra être sécurisé contre les attaques de type XSS (cross-site scripting), comme expliqué en cours.
Les contraintes de rendu ci-dessous doivent être respectées.

Rendu

Pour que votre travail soit considéré comme rendu, vous devez remplir les trois conditions suivantes avant le samedi 6 décembre 20h :

Vous devez avoir pushé tout votre travail sur le dépôt Git créé pour votre binôme sur le gitlab unicaen
Votre site doit être déployé sur le serveur dev-LOGIN.users.info.unicaen.fr d'un des membres du binôme ; l'URL doit être présente dans le README sur le dépôt Git.
Un·e des membres du binôme doit déposer une archive .zip contenant le répertoire exoMVCR sur ecampus. Cette archive fera foi en cas de doute. Le nom de la personne ayant effectué le dépôt doit être précisé dans le README sur le dépôt Git.

Précisions sur le dépôt Git

Les énoncés des TP 07 et 08 indiquaient de faire des commits à plusieurs endroits. On s'attend à retrouver ces commits dans l'historique de votre dépôt. Dans le cas contraire vous serez pénalisé·es. NB: si vous avez déjà suivi l'unité l'an passé, vous devez refaire l'exercice.

Par ailleurs, il faudra au minimum un commit par complément. N'oubliez pas de pusher vos modifications vers le dépôt distant, et de puller régulièrement.

Récapitulatif du contenu du README sur le dépôt Git :

les noms, numéros étudiants et logins des membres du binôme, avec la répartition des compléments (qui a fait quoi)
l'URL du site déployé sur le serveur d'un·e des membres
le nom de l'étudiant·e qui a déposé le .zip sur ecampus

Planning des oraux

Les oraux auront lieu la semaine du 8 décembre, planning à préciser. L'oral est obligatoire, les travaux remis sans soutenance seront évalués à 0.