NeoteemTools

Fonctionnalités pour les projets Neoteem dans VS Code : branches, commits, merges, circuit des composants, tickets Jira et dépôts Bitbucket.

Règles de workflow appliquées par l'outil : Confluence DTI, P1.2 « Web - Process & Charte développement » (section 10) et P1.2.1 « Pull Requests obligatoires ».

Le panneau Neoteem

Un menu s'ajoute à gauche sous le logo Lojii :

Le panneau n'affiche que les actions permises par la branche courante, et se met à jour tout seul au changement de branche.

Serveur, version de Node, environnement WS, ticket Jira et projet Bitbucket restent toujours visibles.

En tête, la carte « Branche courante » indique la branche, son type et le nombre de fichiers modifiés. Trois actions sont toujours disponibles : Suivi des branches (onglet dédié, statut Jira de chaque branche, recherche et filtres), Changer de branche (branches locales et distantes, recherche par nom, ticket, trigramme ou marqueur ; refuse si des modifications ne sont pas commitées) et Doc du workflow (parcours sprint et bloquant prod avec leurs schémas, circuit -CMP, actions et liens Confluence).

Tirer une branche

F1 > Neoteem: Create branch

Lit le ticket Jira (type, titre, priorité) et crée la branche type/TRI/P-N2-XXXXX_titre (type = us, bug, ou hot si le ticket est « Bloquant »), tirée de pilote (P-) ou de master (M-). Pour un composant, l'outil demande si vous créez l'epic (tirée de master, M-CMP-EPIC-, une seule par composant ; ou de pilote, P-CMP-EPIC-, si la version actuelle du composant n'est que dans la release) ou un ticket (tiré de l'epic, dont il reprend le marqueur, cas habituel). Si une epic existe déjà pour ce composant, il la cite et propose de créer un ticket à la place. Push avec tracking ; bascule sur la branche existante si le ticket en a déjà une.

Commiter un changement

F1 > Neoteem: Commit

Message normalisé type TRI N2-XXXXX description, suggestion générée depuis le diff. La case « Push » est enregistrée dans les paramètres utilisateur de VS Code. Commit quick : commit, push, puis au choix merge develop + test, develop seul, ou rien (non proposé sur un tronc, une epic ou un ticket composant).

Merge branch on test and develop

Permet de merger la branche ouverte sur test et/ou develop. Les deux cibles sont indépendantes : cocher test seul ne merge que sur test. Quand les deux sont cochées (comportement par défaut), develop est traité en premier. Le passage du ticket « mettre à tester » n'est déclenché que si test fait partie des cibles.

Greffer une epic composant

F1 > Neoteem: Greffer une epic composant

Sur une branche métier : liste les epics -CMP-EPIC- d'origin avec le nombre de commits que chacune apporterait, et merge la choisie en --no-ff. Refuse un tronc, une branche composant ou une source qui n'est pas une epic. Avertit sur un métier bloquant M-, où l'epic partirait en prod.

PR du ticket vers l'epic du composant

F1 > Neoteem: PR du ticket composant vers l'epic

Sur un ticket -CMP- : committer d'abord (le bouton prévient s'il reste des modifications non commitées), puis le bouton lance yarn pr, qui pousse la branche, trouve l'epic parente et ouvre la PR avec ses validateurs. Ne pas merger le ticket soi-même sur l'epic : le push est refusé par le hook, et le Git intégré de VS Code n'affiche alors que failed to push some refs. La PR se merge depuis Bitbucket en stratégie Merge commit (pas Fast forward, pas Squash).

Mettre à tester le ticket

Transition Jira « À tester », assignation au testeur de l'epic, versions corrigées.

Ticket validé : merge and close branch

Quand un ticket est validé : (https://neoteem.atlassian.net/browse/N2-94066) Merge la branche sur ses cibles selon d'où elle a été tirée (une epic composant ne propose que prepilote puis pilote) Demande et supprime la branche Ajoute la bonne étiquette de version corrigée dans le ticket (si master) Demande et met en prêt à livrer au rapporteur du ticket Ajoute un commentaire automatique disant que c'est mergé, sur quelle branche et la prochaine maj.

Non proposé sur un tronc ni sur un ticket composant.

Ouvrir le ticket associé

Ajoute le bouton "Ticket Jira" dans la status bar de VScode (en bas à gauche) qui ouvre le ticket associé au numéro dans la branche en cours.

Pré-requis : -> Paramétrage -> settings vscode, bien mettre le bon profile chrome (trouvez le profil en ouvrant le bon profil chrome, en allant sur chrome://version/ et en mettant juste le dernier element de "Chemin d'accès au profil") -> recharger vscode.

Ouvrir le projet BitBucket

Ajoute le bouton "Bitbucket nom-projet" dans la status bar (en bas à gauche) de VScode qui ouvre le projet dans bitbucket.

Pré-requis : -> Paramétrage -> settings vscode, bien mettre le bon profile chrome (trouvez le profil en ouvrant le bon profil chrome, en allant sur chrome://version/ et en mettant juste le dernier element de "Chemin d'accès au profil") -> recharger vscode.

Changement de WS

Onglet Lojii bandeau de gauche -> Sélectionner WS -> Modifie l'objet ws de config/env.json