feat(technos): ajouter les guidelines frontend Angular, React et Vue
Contexte
shared/guidelines couvre actuellement le backend (Java, Spring Boot, JPA, PostgreSQL, Flyway...) et TypeScript, mais aucun framework front. Il faut ajouter Angular, React et Vue pour couvrir les stacks frontend des projets.
Format attendu
Suivre le format existant (cf. java.md/java-21.md, typescript.md/typescript-5.0.md) : dans guidelines/technos/, chaque techno est composée de :
-
Un fichier de base
{nom}.mdavec frontmattercategories: [tech], conventions génériques applicables à toutes les versions (composants, gestion d'état, structure de projet, conventions de nommage, anti-patterns...) -
Un ou plusieurs fichiers de version
{nom}-{version}.mdpour les nouveautés spécifiques à une version majeure/mineure
Tâches
-
Créer guidelines/technos/angular.md(base) +angular-19.md,angular-21.md(versions) -
Créer guidelines/technos/react.md(base) +react-18.md,react-19.md(versions) -
Créer guidelines/technos/vue.md(base) +vue-3.md(une seule version — Vue 3.x n'a pas la même rupture inter-mineures que TS/Java, pas besoin de scinder 3.4/3.5) -
Déclarer les 3 entrées dans guidelines/technos/techs.yaml(description, base, versions, latest, versionFiles), sur le modèle de l'entréetypescript -
Valider avec scripts/check-structure.js(règledocFrontmatterCategoriesValidnotamment)
Critères d'acceptation
- Les 3 frameworks sont installables via le mécanisme
--techsexistant -
Aucune nouvelle catégorie créée dans
categories.json— rester surcategories: [tech], commespring-boot.md/jpa.md/api-rest.md. Aucunframework-backendn'existe en miroir pour ces frameworks backend : ne pas créerframework-frontend. - Chaque entrée
versions/latest/versionFilesdetechs.yamldoit correspondre à un fichier réellement présent dansguidelines/technos/— vérifier manuellement avecls guidelines/technos/ | grep <nom>avant publication (aucune règle automatique decheck-structure.jsne le fait actuellement :resolveInheritanceChaindansscripts/install-guidelines.jséchoue silencieusement si unversionFilesest manquant, sans crash ni warning). - Chaque fichier de base doit couvrir, au niveau de détail de
java.md/typescript.md: composants/gestion d'état, structure de projet, stratégie de testing, conventions de naming, anti-patterns/interdictions. -
check-structure.jspasse sans erreur
Note de suivi (hors scope de ce ticket)
Un bug similaire au point ci-dessus préexiste sur spring-boot-4.md (déclaré latest dans techs.yaml sans fichier correspondant). À traiter avec un garde-fou automatique (nouvelle règle check-structure.js de type techsYamlVersionFilesExist) dans un ticket séparé, indépendant de celui-ci.
Edited by Mathéo ALLARD