Formations — 1 037 leçons en français

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 tableau Routes propre à une fonctionnalité, chargé par loadChildren depuis les routes racine. Convention de nommage répandue, pas un nom imposé par Angular.

Barrel

Fichier index.ts qui 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.ts ou utils.ts qui accumulent du code sans lien.

Lire l'explication détaillée et faire le quiz →

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.