Accueil › Angular › Organiser un projet Angular
Organiser un projet Angular
Architecture et bonnes pratiquesintermediaire
Le style guide officiel d'Angular (v21) recommande d'organiser le code par fonctionnalité, pas par type technique. Concrètement : éviter des dossiers globaux components/, services/, directives/ qui mélangent des dizaines de fonctionnalités sans rapport, et préférer un dossier par domaine métier (panier/, catalogue/, compte-client/), chacun regroupant ses propres composants, services et modèles.
src/app/
panier/
panier.routes.ts
panier-page.ts
panier-page.html
panier.service.ts
panier.model.ts
catalogue/
catalogue.routes.ts
catalogue-page.ts
produit-carte.ts
produit.service.ts
Autre changement du style guide actuel : les fichiers de composant n'ont plus besoin du suffixe .component.ts. Une classe ProduitCarte se met dans produit-carte.ts, avec produit-carte.html et produit-carte.css à côté — mêmes noms de base, extensions différentes. Les tests gardent le suffixe .spec.ts.
Beaucoup d'équipes ajoutent à cette base deux dossiers transverses : core/ pour ce qui est instancié une seule fois pour toute l'application (authentification, intercepteurs), et shared/ pour ce qui est réutilisé par plusieurs fonctionnalités sans porter de logique métier (un composant de bouton, un pipe de formatage). Ce découpage core / shared / features est une convention d'équipe très répandue, pas un nom ou une structure imposée par le style guide Angular — celui-ci ne va pas jusqu'à prescrire ces noms de dossiers précis, seulement le principe d'organisation par fonctionnalité.
Les termes à connaître
- Organisation par fonctionnalité
Principe du style guide officiel : regrouper les fichiers par domaine métier (
panier/,catalogue/) plutôt que par type technique (components/,services/). Chaque dossier de fonctionnalité contient tout ce qu'il faut pour cette fonctionnalité.- core (dossier)
Convention d'équipe répandue, non prescrite telle quelle par le style guide officiel : dossier pour les services transverses instanciés une seule fois pour toute l'application (authentification, intercepteurs HTTP, configuration).
- shared (dossier)
Convention d'équipe répandue pour les éléments réutilisés par plusieurs fonctionnalités sans logique métier propre : composants de présentation génériques, pipes, directives utilitaires.
- features (dossier)
Convention d'équipe répandue : un sous-dossier par fonctionnalité métier de l'application, chacun autonome (composants, services, modèles, routes propres à cette fonctionnalité).
- Fichier de routes de fonctionnalité
Fichier (ex.
panier.routes.ts) qui exporte un tableauRoutespropre à une fonctionnalité, chargé parloadChildrendepuis les routes racine. Convention de nommage répandue, pas un nom imposé par Angular.- Barrel
Fichier
index.tsqui ré-exporte le contenu d'un dossier (export * from './produit.service') pour simplifier les imports. Concept JavaScript/TypeScript général, pas une recommandation du style guide Angular.- Un concept par fichier
Principe du style guide officiel : un fichier ne doit contenir qu'une seule responsabilité claire, nommée d'après son contenu. Évite les fichiers
helpers.tsouutils.tsqui accumulent du code sans lien.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.