meta données pour cette page
  •  

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentesRévision précédente
Prochaine révision
Révision précédente
certif:procedure:develop:angular [2026/04/24 13:35] – [Bonne pratique] nicolascertif:procedure:develop:angular [2026/10/02 07:10] (Version actuelle) – nicolas
Ligne 1: Ligne 1:
-|{{:undo-2.svg?30|}}| [[certif:do#procedures|Retour au Dossier Organisationnel]]| +|{{:undo-2.svg?30|}} [[certif:do#procedures|Retour au Dossier Organisationnel]]|| 
-|{{:connexe.jpg?40|}} **Sujets connexes**|| +|{{:connexe.jpg?40|}} **Sujets connexes**|[[https://cartographie-fonctionnelle.logeas-web.fr/|Cartographie fonctionnelle de LoGeAs]]\\ [[certif:procedure:develop:protectiondonnees|Protection des données dans le développement]]\\ [[certif:procedure:usageclasseinterface|Règles sur les classes]]\\ [[certif:procedure:develop:angular:nommage|Conventions de nommage Angular]]\\ [[certif:procedure:develop:angular:validator|Mise en place des dx-validator]]| 
-====== ANGULAR : Installation, Bonne pratique, Astuces... ====== +====== Proc#179 - Développement : règles et bonnes pratiques ====== 
-===== Installation ===== + 
-  * [[certif:procedure:develop:angular:install]] +===== Informations qualité ===== 
-===== Bonne pratique ===== + 
-  * [[certif:procedure:usageclasseinterface]] +^Suivi des modifications majeures^^^ 
-  * [[certif:procedure:develop:angular:nommage]] +^Date^Auteur^Modifications^ 
-  * [[certif:procedure:develop:angular:validator]] +|1 octobre 2026|Nicolas MARCHAND|Création : la page sommaire devient une procédure ; les pages d'installation, de référentiel et d'astuces deviennent des documents techniques rattachés| 
-===== Astuces ===== +|2 octobre 2026|Nicolas MARCHAND|Procédure étendue à tous les développements (ancien titre : « Développement Angular : règles et bonnes pratiques ») : règles communes, dont la protection des données (point de vigilance n°24 de l'audit NF 552 de novembre 2025), puis règles propres à Angular| 
-  * [[certif:procedure:develop:angular:graphe-composant]]+ 
 +|**Suivi des approbations** |[[https://cartographie-fonctionnelle.logeas-web.fr/UniversProcedure?id=179|Cartographie fonctionnelle – fiche de la procédure]]| 
 +|**Objet** |Fixer les règles que respecte tout développement de LoGeAs (interfaces Angular, serveurs, client lourd, bibliothèques), afin que le code reste homogène, lisible, maintenable par toute l'équipe et conforme aux exigences de certification.| 
 +|**Destinataires** |**- Validation des modifications :** Chef de projet \\ **- Approbation du document :** Équipe Développement| 
 + 
 +\\ 
 + 
 +===== Principe ===== 
 + 
 +Tout développement respecte les **règles communes** ci-dessous ; un développement Angular (applications, bibliothèque ''ngx-logeasweb-ui'') respecte en plus les **règles Angular**. Le détail et les exemples sont dans les documents techniques ; en cas de doute, ils font foi sur la manière de faire.\\ 
 +Une règle nouvelle ou modifiée est d'abord inscrite dans le document technique concerné, puis, si elle est générale, résumée ici (modification majeure : nouvelle approbation). 
 + 
 +===== Règles communes ===== 
 + 
 +^ Domaine ^ Règle ^ Détail ^ 
 +| Protection des données | toutes les données personnelles sont traitées comme sensibles ; une donnée personnelle n'est ajoutée que pour une finalité identifiée, déclarée « nominative » dans la cartographie, couverte par les droits des personnes ; aucune donnée personnelle dans les journaux, les traces ni les jeux de test ; aucun secret dans le code | [[certif:procedure:develop:protectiondonnees|Protection des données dans le développement]] | 
 +| Tickets | toute correction ou évolution part d'un ticket qualifié (type, gravité) | [[certif:procedure:develop:gestionprojeqtor|Proc#8]] | 
 +| Versions et code | travail sur branche personnelle, intégration, tags et dépôt légal selon les règles de gestion des versions | [[certif:procedure:develop:gestionversion|Proc#145]], [[certif:procedure:develop:gestionversionpratique|Proc#170]] | 
 +| Qualification et livraison | aucune version n'est livrée sans rapport qualité validé portant sur son code exact | [[certif:procedure:develop:chainequalificationlivraison|Proc#168]] | 
 + 
 +===== Règles Angular ===== 
 + 
 +^ Domaine ^ Règle ^ Détail ^ 
 +| Nommage | fichiers en kebab-case selon le modèle ''nom.type.ts'' ; classes en PascalCase avec le suffixe de leur rôle (''…Component'', ''…Service'') ; sélecteurs préfixés ; un fichier ''.spec.ts'' par fichier testé | [[certif:procedure:develop:angular:nommage|Conventions de nommage]] | 
 +| Classes de données | une table de la base = une classe ''TSQL<Table>'' ; une classe interne au front est préfixée ''T'' et hérite de la classe ''TSQL'' plutôt que de la copier ; une structure d'affichage est une interface ''I<Table>Grid'' | [[certif:procedure:usageclasseinterface|Règles sur les classes]] | 
 +| Accès au back | on ne charge, n'enregistre et n'efface les données qu'au travers des services (''chargeFromBDD$'', ''sauveToBDD$'', ''effaceFromBDD$'') ; une classe de données n'appelle jamais un service | [[certif:procedure:usageclasseinterface|Règles sur les classes]] | 
 +| Validation des saisies | les contrôles de saisie utilisent les ''dx-validator'' regroupés par ''validationGroup'' ; un validateur maison est déclaré dans la bibliothèque (''custom-validation-rule.ts'') et appelé par ''customValidatorService'' | [[certif:procedure:develop:angular:validator|Mise en place des dx-validator]] | 
 + 
 +===== Documents techniques ===== 
 + 
 +^ Document ^ Portée ^ Contenu ^ 
 +| [[certif:procedure:develop:protectiondonnees|Protection des données dans le développement]] | tous les développements | minimisation, déclaration des données nominatives, droits des personnes, conservation, journaux, données de test, sécurité | 
 +| [[certif:procedure:develop:angular:install|Installation]] | Angular | installation du poste de développement Angular | 
 +| [[certif:procedure:develop:angular:nommage|Conventions de nommage Angular]] | Angular | fichiers, classes, sélecteurs, tests | 
 +| [[certif:procedure:usageclasseinterface|Règles sur les classes]] | Angular | classes de données et fonctions d'accès au back | 
 +| [[certif:procedure:develop:angular:validator|Mise en place des dx-validator]] | Angular | validateurs de saisie, organisation des contrôles | 
 +| [[certif:procedure:develop:angular:graphe-composant|Graphe de dépendances]] | Angular | astuce : tracer les dépendances et repérer les boucles (dependency-cruiser, Graphviz) | 
 + 
 +===== Responsabilités ===== 
 + 
 +^ Qui ^ Quoi ^ 
 +| Chef de projet | valide les règles et leurs modifications | 
 +| Équipe Développement | applique les règles, tient les documents techniques à jour |