Par où commencer

stablemis à jour 2026-10-25

Cinq parcours selon qui tu es. Chacun est ordonné : les étapes se construisent l’une sur l’autre, et chaque parcours dit pourquoi cet ordre. Si tu cherches une brique précise plutôt qu’un chemin, retourne à l’accueil : tout y est rangé par type.

📍 Documentation › Par où commencer

🧑‍💼 Directeur technique#

Ce que tu évalues, c’est la reprise. Rien ici ne promet un support : tout montre ce qui permet à une équipe de corriger ou de maintenir le code seule. L’ordre va de l’engagement légal à ce qui le rend tenable.

Licence Apache 2.0 Le code se reprend, se modifie et se redistribue — y compris pour maintenir soi-même une version que le projet ne suit plus. Compatibilité et support Ce que la garantie couvre (exports, comportement compris) et la règle de support : seule la dernière majeure reçoit des correctifs. Courte, et tenue. Monter de version Les paquets montent ensemble ; ce qu'un npm install ne refait pas dans l'application. Politique de sécurité Comment signaler une faille, et des délais dits plutôt que promis. Contribuer Prérequis, règles non négociables, tests : ce qu'il faut pour qu'un correctif soit accepté.

⚙️ Exploitation#

Un process = un conteneur, le reste se délègue à l’orchestrateur. Le premier bloc déploie ; le second est la passe qu’on regrette de ne pas avoir faite avant d’ouvrir au public.

Déployer#

Docker & cloud-native Un process = un conteneur, scaling délégué à l'orchestrateur. Kubernetes Les manifests, l'identité du pod, et les migrations qui passent avant les exemplaires. Reverse-proxy nginx, HAProxy, Traefik — et la configuration qui se dérive de l'app au lieu de dériver. Variables d'environnement Ce que le framework lit, et ce qui se passe quand une variable manque. Stockage de session Le choix qui décide de ton scaling horizontal. Studio L'administration web : voir l'intérieur du framework en marche.

Avant d’ouvrir au public#

C’est qui met en ligne qui tient cette liste : en-têtes et CORS parlent d’origines et de domaines.

En-têtes de sécurité CSP, HSTS, COOP/COEP : ce que le navigateur applique pour toi. CSRF Empêcher un site tiers d'agir au nom de ton utilisateur. CORS Qui a le droit de LIRE tes réponses. Journal d'audit Prouver après coup qui a fait quoi.

🎨 Développeur front#

Deux serveurs en développement, un seul en production, et le navigateur n’en voit jamais qu’un. L’ordre suit le trajet : déclarer l’interface, comprendre qui la sert, puis ce qui se passe quand ça casse.

Servir une interface Une SPA avec le rechargement à chaud de Vite. Le module frontend Le modèle mental — deux serveurs, un seul site — et la déclaration registerEntry. Le superviseur Vite : le trajet Qui lance Vite, quand, ce qu'il relaie sous /_vite/, et comment il l'arrête. Quand Vite tombe Port occupé, plantage, gel : ce que le superviseur fait à ta place. Livrer en production Ce qui remplace Vite quand il n'est plus là, et qui décide. La socket Nodefony Une connexion, N canaux : le temps réel côté client.

🗄️ Développeur back#

Du squelette à la donnée persistée, puis protégée. Trois blocs qui se suivent — construire, persister, sécuriser — et chaque étage suppose le précédent.

Construire#

Tutoriel : ta première application Si tu débutes, commence ici : de create app à une entité persistée, pas à pas. Les briques ci-dessous approfondissent chaque étape. Configuration nodefony.config.ts + env.ts : la seule source de vérité, validée au boot. Écrire des routes Contrôleurs, décorateurs, résolution des paramètres. Éprouver ce que tu as écrit Le harnais de test livré avec l'application : ce qu'il fait, et comment en écrire un second.

Persister#

Générer une entité nodefony create entity : l'aperçu avant d'écrire, le code produit, et pourquoi partir de là plutôt que de la main. Choisir sa base Brancher une persistance et écrire du code portable entre bases. Drizzle, l'ORM par défaut Trois étages, une seule vérité, et les stores du framework clé en main. Migrations de schéma Du schéma dérivé en développement au déploiement sans interruption : orm:generate, orm:migrate, et ce qui passe avant les exemplaires. MongoDB avec Mongoose Le modèle documentaire : connexions, schémas, et ce qui n'exige aucune migration. Le contrat `IRepository` La prise de courant que les deux moteurs honorent — pour du code portable, ou pour brancher un autre moteur.

Sécuriser#

Authentifier sans autoriser ne protège rien.

Firewall Zones et Zero Trust : la fondation dont tout le reste dépend. Authenticators Les six façons de prouver QUI appelle. Autorisation Rôles, scopes et voters : ce qu'il a le DROIT de faire. Jetons Ce qui matérialise une identité prouvée, et comment on la révoque.

🏛️ Architecte#

Comprendre l’ossature avant de juger les choix — chaque page suppose la précédente. Les décisions écrites viennent en dernier, parce qu’elles ne se lisent bien qu’avec le modèle en tête.

Vue d'ensemble Ce qu'est le framework, ce qu'il n'est pas, et ce que ses partis pris coûtent. Injection & portées Chaque requête pose un calque sur le conteneur de l'application : elle lit tout, n'écrit que sur le sien, et le calque part avec elle. Le mécanisme qui isole deux requêtes concurrentes. Cycle de boot du Kernel Ce qui se passe entre npm run dev et le premier octet servi. Pipeline de requête Le trajet exact d'une requête — HTTP comme WebSocket. Décisions d'architecture Les ADR : pourquoi tel choix, ce qu'il coûte, et ce qu'il a remplacé. Étendre le framework Les endroits où brancher le tien sans modifier une ligne du framework.

🔗 Pour aller plus loin#

⬆️ Retour : Accueil de la documentation — tout le catalogue, rangé par type.
📖 Lexique général — le vocabulaire du framework en un seul endroit.