Labo 18

Author: MaximePelletier15

web/docs/03-labos/10-labo17.md

@@ -1,91 +1 @@
-# Laboratoire 17½ 💩
-
-Ce laboratoire couvre les notions des cours 17 et 18.
-
-<center>![Stime](../../static/img/labo16/stime.png)</center>
-
-Téléchargez les [projets de départ](../../static/files/labo16.zip). N'oubliez pas de mettre à jour la base de données avec `dotnet ef database update`.
-
-**Ce labo peut sembler intimidant**, mais au final c'est principalement (presque) copier-coller 5 actions à partir des exemples dans la section Access Control du cours 17.
-
-## 🔍 Qui êtes-vous ?
-
-La gestion des utilisateurs (inscription et connexion) est déjà largement implémentée **côté serveur**. Il restera juste à compléter l'implémentation **côté client**.
-
-Vous aurez à faire toute l'implémentation **côté serveur** en faisant le **TP3** très bientôt et ce sera déjà assez.
-
-<center>![Inscription et connexion](../../static/img/labo16/user.png)</center>
-
-### 1 - Inscription
-
-[💡](/cours/rencontre8.2#-inscription) Complétez le code **côté Angular** pour que l'inscription soit fonctionnelle.
-
-Testez si cela fonctionne en créant un utilisateur.
-
-### 2 - Connexion
-
-[💡](/cours/rencontre8.2#-connexion) Complétez le code **côté Angular** pour que la connexion soit fonctionnelle.
-
-Testez si cela fonctionne en vous connectant.
-
-## 💼 Et que voulez-vous ?
-
-Dans cette section, vous aurez à compléter toutes les actions de `ReviewsController`. Pas besoin d'utiliser un **service** (À part **UserManager**) dans ce laboratoire. Codez tout directement dans les actions du contrôleur.
-
-<center>![Critiques](../../static/img/labo16/review1.png)</center>
-
-### 3 - PostReview
-
-:::note
-
-Oui il y a beaucoup d'ampoules... Vous n'avez pas forcément besoin de toutes les consulter. C'est seulement si vous ne vous souvenez plus comment procéder.
-
-:::
-
-[💡](/cours/rencontre9.1#-post) Complétez l'action `Post` qui permettra d'ajouter un `Review` dans la base de données.
-
-[💡](/cours/rencontre8.2#-action-réservée-aux-utilisateurs) Cette action devra seulement être utilisable par les utilisateurs authentifiés.
-
-[💡](/cours/rencontre8.2#-exemple-de-requête-utilisant-le-token) Assurez-vous de joindre le token à la requête puisqu'elle nécessitera l'authentification.
-
-[💡](/cours/rencontre8.1#-data-transfer-objects) Il faudra un DTO pour envoyer le **nom du jeu** et le **texte de la critique**.
-
-[💡](/cours/rencontre8.2#%EF%B8%8F%EF%B8%8F-déterminer-qui-envoie-la-requête) Il faudra vérifier qui envoie la requête pour l'associer à la nouvelle `Review`.
-
-[💡](/cours/rencontre9.1#-data-transfer-objects) Il faudra retourner, avec `Ok(...)`, un objet un peu différent du modèle `Review`. Vérifiez le modèle `Review` côté Angular pour créer et utiliser le parfait **DTO** !
-
-### 4 - GetReview
-
-:::note
-
-Gardez à l'esprit que cette requête est déjà automatiquement appelée lorsque la page Web est réactualisée.
-
-:::
-
-[💡](/cours/rencontre9.1#-data-transfer-objects) Il faudra simplement retourner la liste de tous les `Review` convertis avec le même **DTO** que créé plus haut pour `Post`.
-
-[💡](/cours/rencontre8.2#-action-réservée-aux-utilisateurs) Cette action doit être disponible pour tous, même si nous ne sommes pas authentifiés.
-
-### 5 - DeleteReview
-
-[💡](/cours/rencontre9.1#-delete) Seul l'auteur d'une critique doit être capable de la supprimer.
-
-### 6 - EditReview
-
-<center>![Modifier une critique](../../static/img/labo16/review2.png)</center>
-
-[💡](/cours/rencontre9.1#-put) Seul l'auteur d'une critique doit être capable de la modifier.
-
-[💡](/cours/rencontre9.1#-put) Seul le texte de la critique doit pouvoir être modifié. (Utilisez le même **DTO** que pour `Post` et ignorez le nom du jeu, par exemple !)
-
-### 7 - UpvoteReview
-
-[💡](/cours/rencontre9.1#-put) Seul un utilisateur authentifié **qui N'est PAS** l'auteur d'une critique doit être capable de la _posivoter_.
-
-Notez que si on _posivote_ une critique qu'on a **déjà _posivoté_**, ça doit annuler / retirer notre upvote.
-
-## 🔑 Qualité > Quantité
-
-### 8 - Interceptor
-
-[💡](/cours/rencontre8.2#-intercepteurs) Normalement, vous avez joint un token pour plusieurs requêtes dans le **projet Angular**. Remplacez ce code répétitif par un **intercepteur**.
+# Laboratoire 17 💩

web/docs/03-labos/11-labo18.md

@@ -0,0 +1,73 @@
+# Laboratoire 18
+
+<center>![Stime](../../static/img/labo16/stime.png)</center>
+
+Téléchargez les [projets de départ](../../static/files/labo16.zip). N'oubliez pas de mettre à jour la base de données avec `dotnet ef database update`.
+
+La gestion des utilisateurs est déjà fonctionnelle et un intercepteur est déjà complété. (Vous n'aurez jamais à joindre token vous-mêmes, mais il faudra quand même être connecté !) Notez qu'il y a déjà deux `reviews` existantes dans la base de données. Elles ont été créées par l'utilisateur `bob` dont le mot de passe est `allo`. Sacré *Bob*.
+
+Pendant le laboratoire, vous aurez **cinq requêtes** à rendre fonctionnelles, principalement dans le `ReviewsController`.
+
+## 🔥 Retour de flamme
+
+Dans cette section, vous aurez à compléter deux actions de `ReviewsController`. Ce sont des `reviews` qui devront être retournées par le serveur, mais il faudra un *DisplayDTO* vu que les classes `Review` du client et du serveur sont différentes.
+
+### 1 - ReviewDisplayDTO
+
+[💡](/notes/rencontre9.2#-data-transfer-objects) Comparez les classes `Review.cs` (serveur) et `review.ts` (client). Créez un *DisplayDTO* qui permettra d'envoyer au client des `Review` avec les données nécessaires.
+
+### 2 - GetReview
+
+[💡](/notes/rencontre9.2#-data-transfer-objects) Pour le moment, les `reviews` ne s'affichent pas dans la page Web. C'est normal, il faut implémenter l'action `GetReview` d'abord. Elle va simplement récupérer toutes les `reviews` dans la base de données et les convertir en `ReviewDisplayDTO` pour les envoyer au client. Une fois que ce sera fait, *décommentez* l'instruction `getReviews()` dans le `useEffect()` du composant `Home`.
+
+<center>![Liste des reviews](../../static/img/labo16/reviews.png)</center>
+
+### 3 - PostReview
+
+:::warning
+
+Pour cette requête et les suivantes, vous pourriez être agacé(e)s par le fait que les notes de cours montrent des exemples **avec contrôleur + service**, alors que dans ce projet, il n'y a **pas de service**. Vous devriez être capables de rassembler toutes les opérations nécessaires dans le contrôleur malgré tout. Sinon, sachez que dans le **TP3** il y aura des services, alors ces exemples vous serviront.
+
+:::
+
+:::info
+
+Connectez-vous avant de poster une `Review` !
+
+:::
+
+[💡](/notes/rencontre9.2#-post) Complétez l'action `PostReview` qui permettra d'ajouter un `Review` dans la base de données. La `Review` créée devra être associé à l'auteur qui a envoyé la requête.
+
+[💡](/notes/rencontre9.2#-data-transfer-objects) Il faudra retourner, avec `Ok(...)`, le nouveau `Review`... converti en `ReviewDisplayDTO`, bien entendu
+
+Le code côté **Next.js** est déjà complété. un **DTO** est envoyé avec le texte et le nom du jeu.
+
+<center>![Créer un review](../../static/img/labo16/post.png)</center>
+
+## 🔒 Critiques sécuritaires
+
+<center>![Opérations pour une critique](../../static/img/labo16/review1.png)</center>
+
+### 4 - DeleteReview
+
+[💡](/notes/rencontre9.2#-delete) Seul l'**auteur** d'une critique doit être capable de la supprimer. 
+
+Le code côté client est déjà complété.
+
+### 5 - UpvoteReview
+
+[💡](/notes/rencontre9.2#-put) Seul un utilisateur authentifié **qui N'est PAS** l'auteur d'une critique doit être capable de la _posivoter_.
+
+Notez que si on _posivote_ une critique qu'on a **déjà _posivoté_**, ça doit annuler / retirer notre upvote.
+
+Le code côté client est déjà complété.
+
+### 6 - EditReview
+
+<center>![Modifier une critique](../../static/img/labo16/review2.png)</center>
+
+[💡](/notes/rencontre9.2#-put) Seul l'auteur d'une critique doit être capable de la modifier.
+
+[💡](/notes/rencontre9.2#-put) Seul le texte de la critique doit pouvoir être modifié. (Utilisez le même **DTO** que pour `PostReview` et ignorez le nom du jeu, par exemple !)
+
+Le code côté client est déjà complété.