Aller au contenu principal

TP4 - Raidite (25%)

Bannière à la reddit

📥 Remise​

  • 📍 Où : sur Git uniquement.
    • Vous allez recevoir une invitation à un repo GitHub.
    • Si vous n'avez pas reçu d'invitation ou que ne savez pas comment accéder à votre TP, venez voir votre enseignant.
  • ⏰ Quand :
    • Si votre enseignant est Pierre-Olivier : 8 décembre 23h59.
    • Si votre enseignant est Philippe : 9 décembre 23h59. Vous avez 6 cours consacrés au TP.
  • ⛔ Attention, il y a une remise partielle à présenter pour la partie C.
    • Si votre enseignant est Pierre-Olivier : 27 novembre 23h59.
    • Si votre enseignant est Philippe : 27 novembre 23h59.

📝 Consignes​

  • 👥 Le TP est fait en équipe de deux imposée.
  • 📦 Le projet client utilise le framework Next.js et le projet serveur utilise le framework ASP.NET Core. (Projets de départ fournis)
  • 👽 Attention au plagiat. Il est interdit de copier en partie ou complètement le code d'une autre personne ou de générer son code avec l'IA. Le niveau d'usage de l'intelligence artificielle générative permis pour ce TP est de 1. (Se référer au plan de cours)
  • 🖥 Il faudra respecter la structure existante dans les deux projets.
astuce

Pendant le TP, ne vous cassez jamais la tête à régler les conflits de merge pour les migrations. Faites simplement une nouvelle migration dans chaque nouvelle branche.

danger

Si votre travail est suspecté de plagiat (code copié d'un(e) autre étudiant(e), code généré par IA, notions non abordées en classe, etc.), deux choses peuvent se produire :

  • Le plagiat est prouvé par nos outils : Note de 0, automatiquement.
  • Le plagiat est plutôt évident, mais une validation est requise : vous serez convoqué(e) au bureau de votre enseignant(e). Vous devrez répondre à certaines questions pour prouver que vous comprenez et maîtrisez le code qui a été utilisé dans votre TP. Si vous ne réussissez pas à répondre à certaines questions, vous aurez la note de 0. (Si vous ne comprenez pas votre propre code, c'est que vous avez plagié, d'une manière ou d'une autre.)
attention

Ce TP sera probablement plus long et sophistiqué que les autres TPs que vous avez faits jusqu'à maintenant dans le programme. Voyez cela comme un rite de passage, sachant que le cours 5W5 - Programmation Web avancée est largement plus difficile que ce cours. Malgré tout, les 6 séances de 3 heures consacrées au TP4 sont censées être suffisantes pour ceux qui ont fait tous leurs laboratoires.

📦 Projets de départ​

Les projets Next.js + ASP.NET Core sont fournis pour ce TP.

Une application qui sert de multi-forums de discussion vous est fournie. Vous devrez ajouter des fonctionnalités à l'application, principalement pour la gestion d'images et de rôles.

En résumé, l'application contient des hubs (forums), des posts (publications) et des commentaires.

  • Un hub contient des posts sur un thème commun et un post contient des commentaires.
  • On peut répondre à un commentaire avec des sous-commentaires à l'infini.

Ci-dessous, on peut voir une publication (post) avec plusieurs commentaires. La publication a été créée dans le forum (hub) nommé « conspirations ».

Démo de PostHub
`

Exemple HTML:

avatar r/conspiration 03/03/2026 23:40:34

bob

L'homme n'est pas allé sur la lune

Ses clairemen des images genereaits par AI !! Les homme ne sont pas aller sur la lune.

Deux photos d'astronautes sur la lunes

bouton upvote et downvote avec total de -3. bouton commentaires à 3

Zone de texte «Rejoindre la conversation» avec un bouton image et un bouton commentaire pour publier.

Un filtre en combobox sur Récents

La liste de discussion

Tom 03.03.2026 23:43:51

haha tu penses que la lune existe ? censure !! La Terre n'a pas de lunes

Photo de la lune

bouton Upvote et Downvote à 0, bouton Répondre et bouton «...»

S'en suit une chaîne de réponse...

📜 Résumé des fonctionnalités​

👥 Chaque équipe aura un membre hot-doye 🌭 et un membre sushi 🍣. Vous serez évalués séparément pour la plupart des fonctionnalités. Vous êtes obligés d'implémenter seulement vos propres fonctionnalités, telles que listées ci-dessous.

🔍 Ceci n'est qu'un résumé des fonctionnalités, vérifiez les énoncés par membre pour avoir tous les détails et indices. La quantité de travail est très similaire, sauf que 🌭 aura un peu plus de travail lors de F-G-H et 🍣 aura un peu plus de travail lors de C-D-E.

Membre 🌭Membre 🍣

Étape A-🌭🍣

Décidez quel membre sera 🍣 et quel membre sera 🌭. Si votre partenaire est absent(e), vous êtes obligé(e) de choisir seul(e) pour pouvoir commencer le travail dès maintenant.

Étape B-🌭🍣

Suivez les étapes dans les notes de cours sur Git :

  • Assurez vous que vous et votre partenaire avez bien accès au repo sur lequel votre prof devrait vous avoir ajouté.
  • Créez la branche dev. Il faudra créer une nouvelle branche individuelle pour chaque étape du TP. Il faudra effectuer un merge une fois chaque étape terminée.

Étape C-🌭

Lorsqu’on crée un commentaire, on doit être capable d’y joindre de zéro à plusieurs images.

Étape C-🍣

Lorsqu’on crée une publication (post), on doit être capable d’y joindre de zéro à plusieurs images.

🛑 HALTE !

  • Au plus tard le 27 novembre à 17h59, vous devez, à deux, vous présenter en classe et prendre 5 minutes pour montrer les étapes A, B et C à l'enseignant(e).
  • Si vous ne le faites pas, il y aura une pénalité de 25%.
  • Il n'y a rien à préparer pour la présentation, à part le TP.
  • Si à cette date votre partenaire est absent(e), vous pouvez présenter votre partie seul(e) pour ne pas avoir la pénalité.

Étape D-🌭

Les utilisateurs doivent pouvoir choisir un avatar personnalisé. Il sera affiché à plusieurs endroits dans les pages Web. L’avatar peut être changé à tout moment.

Étape D-🍣

Lorsqu'on crée un forum (hub), on doit pouvoir choisir une image qui servira d'icône, optionnellement. Les aperçus des publications doivent contenir leur première image, lorsqu'applicable.

Étape E-🌭

Cliquer sur une image doit permettre de l’afficher en pleine taille, dans un autre onglet.

Étape E-🍣

On peut « sauvegarder » des publications pour les ajouter à nos favoris. Les publications sauvegardées seront affichées dans notre profil, dans l'onglet « Favoris ». On peut également retirer une publication de nos favoris.

Étape F-🌭

On doit pouvoir supprimer les images d’un commentaire / post, individuellement.

Étape F-🍣

Lorsqu’on supprime un commentaire ou un post, toutes ses images doivent être supprimées.

Étape G-🌭

Les utilisateurs peuvent signaler (Report) les commentaires / posts des autres utilisateurs.

Étape G-🍣

Les utilisateurs doivent pouvoir se connecter en utilisant leur nom d’utilisateur OU leur adresse courriel. (Plutôt que seulement leur nom d’utilisateur) Les utilisateurs doivent pouvoir changer leur mot de passe.

Étape H-🌭

Un rôle modérateur doit être créé. Les modérateurs peuvent voir la liste des commentaires signalés. Ils peuvent supprimer les commentaires de leur choix via cette liste. Un utilisateur avec le rôle modérateur est ajouté dans le seed.

Étape H-🍣

Un rôle administrateur doit être créé. Les administrateurs peuvent ajouter le rôle modérateur à des utilisateurs. Un utilisateur avec le rôle administrateur est ajouté dans le seed.

Étape I-🌭🍣

S’assurer que les critères communs (Voir grille de correction) sont respectés. S’assurer que tout a été merge dans dev, puis dans main. S’assurer que tout fonctionne.

✅ Grille de correction​

Bien entendu, il y a plus de détails sur les fonctionnalités demandées dans les énoncés du TP.

Membre 🌭 (32 pts)​

CritèrePoints
On peut ajouter des images lorsqu’on crée un commentaire et les voir ensuite.10 pts
Les utilisateurs peuvent choisir un avatar (et le prévisualiser) et le modifier à volonté.4 pts
Toute image (sauf les avatars) peut être cliquée pour être affichée en grand dans un nouvel onglet.2 pts
Les images des posts et des commentaires peuvent être supprimées individuellement par l’auteur.6 pts
Les posts / commentaires des autres utilisateurs peuvent être signalés si on est connecté.4 pts
Le rôle de modérateur existe, permet de supprimer des commentaires signalés et présente un utilisateur avec le rôle dans le seed.6 pts

Membre 🍣 (32 pts)​

CritèrePoints
On peut ajouter des images lorsqu’on crée un post et les voir ensuite.11 pts
On peut choisir une icône lorsqu'on crée un forum.4 pts
La première image d'une publication est affichée dans son aperçu.1 pt
La sauvegarde de publications est fonctionnelle.6 pts
Supprimer un post ou un commentaire supprime ses images.2 pts
La connexion fonctionne avec le nom d’utilisateur et le courriel.1 pt
On peut modifier son mot de passe à volonté.2 pts
Le rôle d’administrateur existe, permet de nommer des modérateurs et présente un utilisateur avec le rôle dans le seed.5 pts

Commun 👥 (18 pts)​

CritèrePoints
L’architecture du projet serveur respecte les lignes directrices vues dans les notes de cours. (Les contrôleurs n’ont pas accès au DbContext, usage de Models et de DTOs au besoin, etc.) De plus, sur le serveur, évitez la répétition de code dans la mesure du raisonnable.2 pts

Git a été utilisé de manière appropriée, c’est-à-dire :

  • Branches main et dev bien utilisées.
  • Une branche créée et un merge par fonctionnalité du TP.
  • ⛔ Le français est évalué dans les messages des commits. Évitez les commits trop courts !
  • Les titres et les descriptions des commits sont présents, appropriés et clairs.



2 pts
6 pts
5 pts
3 pts

☢ Pénalités variées possibles :

  • Fonctionnalités déjà implémentées devenues brisées.
  • Au moins une des applications ne compile pas.
  • Remise partielle non réalisée.
  • Interface déformée et / ou ne correspond pas aux exemples illustrés.
  • Structure des projets fournis non respectée.



-25%
-25%
-25%
-10%
-10%

📶 Liste des requêtes pour référence​

  • ✅ Déjà complétée et n'aura jamais à être modifiée.
  • 📝 Fonctionne déjà mais devra être modifiée pour ajouter des fonctionnalités.
  • 🥚 Devra être créée à partir de zéro.
Vue swagger

Comments:

POST /api/Comments/PostComment/{parentCommentId}

PUT /api/Comments/PutComment/{commentId}

PUT /api/Comments/UpvotePutComment/{commentId}

PUT /api/Comments/DownvotePutComment/{commentId}

DELETE /api/Comments/DeleteComment/{commentId}

GET /api/Comments/GetPicture/{size}/{id}

DELETE /api/Comments/DeletePicture/{id}

PUT /api/Comments/ReportComment/{id}

GET /api/Comments/GetReportedComments

Hubs:

GET /api/Hubs/GetUserHubs

POST /api/Hubs/PostHub

GET /api/Hubs/GetHub/{id}

PUT /api/Hubs/ToggleJoinHub/{hubId}

GET /api/Hubs/GetPicture/{id}

Posts:

POST /api/Posts/PostPost/{hubId}

GET /api/Posts/GetPosts/{tabName}/{sorting}

GET /api/Posts/SearchPosts/{searchText}/{sorting}

GET /api/Posts/GetHubPosts/{hubId}/{sorting}

GET /api/Posts/GetFullPosts/{postId}/{sorting}

GET /api/Posts/GetSavedPost/{postId}

Users:

POST /api/Users/Register

POST /api/Users/Login

GET /api/Users/GetAvatar/{username}

PUT /api/Users/ChangeAvatar

PUT /api/Users/ChangePassword

PUT /api/Users/MakeModerator/{username}

🔍 Organisation du projet Next.js​

Vous n'aurez aucun composant à créer pendant le TP4, à priori. Cependant il faudra s'y retrouver parmi tous les composants existants.

🗺 Composants chargés par routage​

La plupart des noms de ces composants parlent d'eux-mêmes.

  • FullPost sert à afficher une publication en entier, avec ses commentaires.
  • FullHub permet d'afficher un aperçu de toutes les publications d'un forum.
  • Home affiche des aperçus de publications qui viennent généralement de plusieurs forums.
Routes

Exemple des routes ayant pour racine http://localhost:3000/ :

[feed] > Home

account/login > Login

account/register > Register

account/profile > Profile

hub/[id] > FullHub

hub/create > CreateHub

post/create/[hubId]/[hubName] > CreatePost

post/[id] > FullPost

♻ Composants réutilisables​

Composants réutilisables

Liste de composants réutilisables:

/app/components/_minicomponents/

account-menu.tsx

comment-stats.tsx

orange-button.tsx

search-bar.tsx

/app/components/

comment-box.tsx

left-bar.tsx

post-thumbnail.tsx

reply.tsx

Petit menu déroulant en haut à droite de la page qui propose des options différentes lorsque nous sommes connectés. Il est intégré dans le HomeLayout.

Affiche les options de connexion/déconnexion, le profil, l'inscription

👽 Exception pour l'usage de l'IA​

La génération de code par IA sera permise pour un seul cas précis dans ce devoir, à condition d'indiquer que l'IA a été utilisée.

attention

Si le code généré par IA est maladroit ou loin d'être optimal, vous pouvez perdre des points. L'IA est un outil pour bonifier la productivité, mais il faut être capable de valider le code généré !

Le code situé après une requête permettant de mettre à jour des états après une requête HTTP peut être généré par IA. Voici un exemple :

async myFunction(id : number){

const x = await axios.delete("... requête ...");
console.log(x.data);

// 👽 Début du code généré par IA
setState(state.filter(s => s.id != id));
// 👽 Fin du code généré par IA

}
danger

Aucun code côté serveur ne peut être généré par IA.