Avez-vous une question? (216) 97 656 803 hajjriadh@gmail.com
NestJS

Architecture d'une application Full-Stack Angular + NestJS

Cette leçon présente l'architecture d'une application Full-Stack. Angular est le client qui s'exécute dans le navigateur, NestJS l'API qui applique les règles et la sécurité, MySQL la base de données....

0 chapitres 0 QCM Accès gratuit
Architecture d'une application Full-Stack Angular + NestJS

À propos de ce cours

Cette leçon présente l'architecture d'une application Full-Stack. Angular est le client qui s'exécute dans le navigateur, NestJS l'API qui applique les règles et la sécurité, MySQL la base de données. Elle précise ce qui revient à chaque partie et le contrat qui les relie : des requêtes HTTP et des réponses JSON typées. Elle compare le développement, avec deux serveurs sur deux ports, et la production derrière une seule origine. Elle décrit le projet fil rouge du chapitre, un catalogue de formations, et le démarre réellement avec une seule commande. Activités corrigées.

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

Architecture Full-Stack Angular + NestJS

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écutedans le navigateur de chaque utilisateursur le serveursur le serveur
Rôleafficher, saisir, naviguer, rendre l'interface agréablerègles métier, validation, droits, accès aux donnéesstocker les données
Confianceaucune: le code est lisible et modifiable par l'utilisateurtotale : c'est le seul arbitreaccessible uniquement par l'API
Chapitresvotre cours Angular, ce chapitrechapitres 05 à 17chapitres 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 AngularRéponse NestJSCe qu'Angular en fait
GET /api/formations?niveau=avance200 { donnees: Formation[], total }affiche les cartes
POST /api/formations + jeton201 la formation crééeva sur la page de détail
données invalides400 { message: string[] }affiche les messages sous le formulaire
sans jeton ou jeton expiré401renvoie vers la connexion
rôle insuffisant403message « 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 serve sur http://localhost:4200 (avec rechargement automatique) et nest start --watch sur http://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 build produit 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é ?