Api Nest : Boutique en ligne

Objectifs

Votre mission si vous l'acceptez est de créer une API simple de petites annonces avec Nest qui permettra à des utilisateurs de votre site web d'enregitrer les articles qu'ils souhaitent vendre. Cela implique que les utilisateurs doivent pouvoir ajouter des articles, ainsi que retirer leurs articles de votre site. Ils doivent aussi pouvoir consulter les articles mis en ligne par d'autres utilisateurs.

Prise en main

Persistance de données

ORM : Prisma

15. Installer prisma en tant que dépendance de développement du projet Nest.
16. Installer le client prisma (paquet @prisma/client) en tant que dépendance du projet.
17. Initialiser prisma dans le projet Nest.
18. Importer ce schéma dans le projet Nest.

Schéma

generator client {
  provider = "prisma-client-js"
}

datasource db {
  provider = "postgresql"
  url      = env("DB_URL")
}

model Products {
  UUID        String @id(map: "products_uuid") @unique() @default(uuid()) @db.VarChar(36) //UUIDv4
  Name        String @db.VarChar(50)
  Price       Int
  Description String @db.Text()
  authorUUID  String @db.VarChar(36) // Ref to UUIDv4
  Author      Users  @relation(map: "product_author", fields: [authorUUID], references: [UUID])
}

model Users {
  UUID     String     @id(map: "users_uuid") @unique() @default(uuid()) @db.VarChar(36) //UUIDv4
  Pseudo   String     @unique() @db.VarChar(50)
  Mail     String     @unique() @db.VarChar(75)
  Products Products[]
}

19. Migrer le schéma vers la base de données.
20. Créer le service Prisma.
21. Vérifier que la structure de la base de données correspond à la définition du schéma Prisma.

Création des utilisateurs

Documentation de l'API : Swagger

33. Installer Swagger en tant que dépendance du projet.
34. Initialiser Swagger pour être utilisé par Nest.
35. Utiliser le décorateur Swagger approprié pour documenter les routes du controller Users séparément.
36. Documenter les champs du DTO de création d'utilisateur en utilisant le décorateur Swagger approprié.
37. Tester la documentation Swagger en se rendant à l'URL http://localhost:3000/api (s'y rendre)

CRUD pour les produits

38. Créer une route et ses besoins annexes pour enregistrer de nouveaux article.
39. Créer une route pour récupérer un article par son UUID.
40. Créer une route et ses besoins annexes pour modifier les informations d'un article par son UUID.
41. Créer une route pour supprimer un article par son UUID.

Utilisation d'un service depuis un autre module

42. Définir le service Products en tant que provider du module Users.
43. Créer une méthode dans le service Products pour récupérer tous les articles d'un utilisateur en fonction de l'UUID de l'utilisateur.
44. Créer une route dans le controller Users qui retourne les articles d'un utilisateur.
45. Faire la même chose pour supprimer les articles d'un utilisateur.

Authentification

Préparation

46. Modifier le schéma Prisma pour permettre l'authentification des utilisateurs.
47. Migrer le nouveau schéma Prisma pour mettre à jour la structure de la base de données.
48. Installer les paquets @nestjs/passport, passport, @nestjs/passport-jwt, @nestjs/jwt ainsi que le paquet @types/passport-jwt (en tant que devDep).
49. Installer les paquets bcrypt ainsi que @types/bcrypt (en tant que devDep)

50. Créer un module Auth dédié à l'authentification des utilisateurs.
51. Modifier la route et ses besoins connexes pour enregister de nouveaux utilisateurs.
- Adapter le dto pour enregistrer les nouveaux comptes.
- Adapter la logique pour cette route :
- Hasher le mot de passe avec bcrypt avant de l'enregistrer en base de données.
  - Enregistrer le nouvel utilisateur en base de données.
52. Créer une route pour la connexion des utilisateurs.
- Créer une méthode dans le service Users pour récupérer un utilisateur par le nom d'utilisateur.
- Utiliser le Jwt Service et le Users Service dans le module Auth.
- Créer la logique pour authentifier un utilisateur.
  - Renvoyez uniquement un objet contenant un champ : access_token contenant le JWT signé avec les informations suivantes :
    - Le nom d'utilisateur de l'utilisateur.
    - L'UUID de l'utilisateur.
53. Implémenter la stratégie Jwt pour le module Auth.
54. Créer un Guard d'authentification.
55. Rendre l'authentication globale à l'API (faire que chaque route de l'API nécessite une authentification).
56. Permettre à certaines routes de ne pas nécessiter d'authentification grâce à un décorateur personnalisé.

HachemiH/E-Commerce-API-NestJS-Workshop