À propos de ce cours
Objectifs de la leçon
- Identifier le rôle de chaque partie d'une application Full-Stack.
- Décrire le contrat entre Angular et NestJS.
- Comprendre la différence entre l'environnement de développement et la production.
- Démarrer le client et l'API ensemble.
Versions: Angular 22.2 (ng new: composants autonomes, signaux, sans zone.js, esbuild), NestJS 12.5 (projet CommonJS), TypeScript 6, Node.js 24. Les deux applications ont été construites et exécutées ensemble ; les parcours ont été réalisés dans Chrome et les captures sont réelles. Les notions de ce chapitre s'appliquent aussi à Angular 17 à 21 et à NestJS 11, à quelques détails de syntaxe près.
Trois parties, trois rôles
Le navigateur exécute Angular ; Angular parle à l'API en JSON ; l'API est la seule à accéder à la base.
| Angular (client) | NestJS (API) | MySQL | |
|---|---|---|---|
| S'exécute | dans le navigateur de chaque utilisateur | sur le serveur | sur le serveur |
| Rôle | afficher, saisir, naviguer, rendre l'interface agréable | règles métier, validation, droits, accès aux données | stocker les données |
| Confiance | aucune: le code est lisible et modifiable par l'utilisateur | totale : c'est le seul arbitre | accessible uniquement par l'API |
| Chapitres | votre cours Angular, ce chapitre | chapitres 05 à 17 | chapitres 11 et 12 |
Conséquence importante : tout ce que fait Angular pour la sécurité est du confort. Cacher un bouton « Supprimer » ou valider un formulaire améliore l'interface, mais l'API doit refaire toutes les vérifications, puisque n'importe qui peut l'appeler directement (curl, Postman, console du navigateur). Nous le vérifierons à la leçon 18.4.
Le contrat entre les deux
Angular et NestJS ne partagent ni mémoire ni code à l'exécution : ils communiquent uniquement par HTTP. Le contrat est l'ensemble des routes, des données JSON échangées et des codes de statut :
| Requête Angular | Réponse NestJS | Ce qu'Angular en fait |
|---|---|---|
GET /api/formations?niveau=avance | 200 { donnees: Formation[], total } | affiche les cartes |
POST /api/formations + jeton | 201 la formation créée | va sur la page de détail |
| données invalides | 400 { message: string[] } | affiche les messages sous le formulaire |
| sans jeton ou jeton expiré | 401 | renvoie vers la connexion |
| rôle insuffisant | 403 | message « accès refusé » |
Ce contrat doit être identique des deux côtés : à la leçon 18.5, les types TypeScript (Formation, Page<T>…) seront écrits une seule fois et partagés par les deux applications.
Développement et production
- En développement, deux serveurs tournent en même temps :
ng servesurhttp://localhost:4200(avec rechargement automatique) etnest start --watchsurhttp://localhost:3000. Le navigateur considère ces deux adresses comme deux origines différentes (le port fait partie de l'origine) : il faut configurer CORS (leçon 18.2). - En production,
ng buildproduit de simples fichiers (HTML, JS, CSS) qu'un serveur web comme nginx distribue. Le même nginx transmet les requêtes/apià NestJS : une seule origine, plus de CORS (chapitre 20).
Le projet du chapitre
Nous construisons un catalogue de formations: liste publique avec recherche et filtre, page de détail, connexion, création et suppression réservées aux administrateurs. Il est organisé en un seul dépôt (un monorepo, détaillé à la leçon 18.5) :
catalogue-formations/
├── package.json ← scripts communs (npm run dev, npm run build)
├── apps/
│ ├── api/ ← NestJS (nest new, CommonJS)
│ └── web/ ← Angular (ng new)
└── packages/
└── partage/ ← interfaces TypeScript communes
📄 package.json (racine)
{
"name": "catalogue-formations",
"private": true,
"workspaces": [
"apps/*",
"packages/*"
],
"scripts": {
"dev:api": "npm run start:dev -w api",
"dev:web": "npm start -w web",
"dev": "concurrently -n api,web -c red,blue \"npm run dev:api\" \"npm run dev:web\"",
"build": "npm run build -w api && npm run build -w web"
},
"devDependencies": {
"concurrently": "^9.2.1"
}
}
concurrently lance les deux serveurs dans un seul terminal, avec un préfixe coloré par application :
npm run dev (extrait) :
> dev
> concurrently -n api,web -c red,blue "npm run dev:api" "npm run dev:web"
[api] > dev:api
[api] > npm run start:dev -w api
[web] > dev:web
[web] > npm start -w web
[api] > api@0.0.1 start:dev
[api] > nest start --watch
[web] > web@0.0.0 start
[web] > ng serve
[api] [4:39:01 PM] Starting compilation in watch mode...
[web] ➜ Local: http://localhost:4200/
[api] [4:39:05 PM] Found 0 errors. Watching for file changes.
[api] [Nest] 3944 - 11/15/2026, 4:39:06 PM LOG [NestApplication] Nest application successfully started +2ms
Activités
Activité 1 Qui fait quoi ?
Pour chaque tâche, Angular, NestJS ou les deux ? (a) Vérifier qu'un e-mail est bien formé. (b) Vérifier qu'un e-mail n'est pas déjà utilisé. (c) Masquer le bouton « Supprimer » pour un stagiaire. (d) Refuser la suppression par un stagiaire. (e) Afficher « Chargement… ». (f) Calculer le nombre de places restantes.
Voir le corrigé
(a) Les deux : Angular pour un retour immédiat, NestJS parce que c'est la seule vérification fiable. (b) NestJS : il faut la base. (c) Angular (confort). (d) NestJS (sécurité). (e) Angular. (f) NestJS : une règle métier, calculée à partir des données ; Angular l'affiche.
Activité 2 Même origine ?
Une origine = schéma + domaine + port. Ces paires d'adresses ont-elles la même origine ? (a) http://localhost:4200 et http://localhost:3000; (b) https://formation.tn et https://formation.tn/api; (c) http://formation.tn et https://formation.tn; (d) https://formation.tn et https://api.formation.tn.
Voir le corrigé
(a) Non : ports différents. (b) Oui : le chemin ne compte pas. (c) Non : schémas différents (http et https). (d) Non : domaines différents (un sous-domaine est un autre domaine). Seul le cas (b), celui de la production derrière nginx, se passe de CORS.
Activité 3 Mettre en place le monorepo
Créez le dossier catalogue-formations sur votre machine et dans un dépôt GitHub. Créez apps/api avec nest new api --directory apps/api (CommonJS) et apps/web avec ng new web --directory apps/web --style=css --ssr=false. Ajoutez le package.json racine de la leçon, puis lancez npm install et npm run dev.
Voir le corrigé
Avant npm install à la racine, supprimez les dossiers node_modules et les fichiers package-lock.json créés dans apps/api et apps/web: avec les workspaces, une seule installation à la racine les remplace (leçon 18.5). Ajoutez node_modules/, dist/ et .angular/ au .gitignore racine. Commit : chore: monorepo Angular + NestJS.
Activité 4 Lire un contrat
À partir du tableau « contrat » de la leçon, rédigez dans le README la documentation des routes du catalogue (méthode, URL, qui peut l'appeler, corps envoyé, réponses possibles). Quel outil du chapitre 14 produit cette documentation automatiquement ?
Voir le corrigé
Swagger (@nestjs/swagger, chapitre 14) génère ce contrat à partir du code de l'API, et Swagger UI permet de l'essayer. Le fichier openapi.json peut même servir à générer les types du client Angular (leçon 14.3), une alternative au paquet partagé de la leçon 18.5.
À retenir
- Angular (navigateur) : interface ; NestJS (serveur) : règles, validation, droits ; MySQL : données, accessibles seulement par l'API.
- Le contrat : routes, JSON et codes de statut ; il doit être identique des deux côtés.
- Toute vérification faite par Angular est du confort ; l'API doit tout revérifier.
- Développement : localhost:4200 et localhost:3000, deux origines → CORS ; production : une origine derrière nginx.
- Un monorepo et concurrently : npm run dev lance les deux applications.
Cet article vous a-t-il aidé ?
Merci pour votre avis sur cet article 🙏
Merci, votre message nous a bien été transmis 🙏
Cette leçon vous a été utile ? Partagez-la !