Revue de PR (écran de relecture GitHub par projet)

Doc fonctionnelle : décrit le quoi et le pourquoi (point de vue utilisateur / chef de projet).

À quoi ça sert

L'interface de review de GitHub est mal intégrée à notre flux. Cet écran, dans ISI-APP, centralise les pull requests ouvertes à relire, permet d'affecter un relecteur simplement, et donne à chacun sa liste « Mes PR à relire ».

Il couvre aussi les PR qui ne sont rattachées à aucun backlog : sans elles, une PR dont la branche ne suit pas la convention backlog-‹id› (correctif à chaud, montée de version, contribution externe, dependabot) échappait totalement au suivi de relecture.

Comment ça marche (côté utilisateur)

Sous-onglet « Revue de PR » du Backlog d'un projet.

• Liste : les PR ouvertes des dépôts du connecteur GitHub. Chaque ligne : titre, dépôt #numéro, auteur, backlog lié (ou badge « Non rattachée »), et deux raccourcis :
  • un bouton branche (icône ⌥) qui copie une commande de bascule prête à coller dans le presse-papier (« Copié ! » en retour) : elle remet d'abord à jour la base (develop, ou master si c'est une branche hotfix/…) avant de basculer sur la branche de la PR — pour ne pas la relire sur une base locale périmée ;
  • un bouton « GitHub » qui ouvre la PR dans un nouvel onglet.
• Affecter un relecteur : liste déroulante recherchable par ligne → choisir un membre du projet (ou vider la sélection pour retirer l'affectation). C'est interne (chez nous) : aucune action côté GitHub. Affecter un relecteur déclenche le workflow « Relecteur de PR affecté » (voir Automatisations du backlog) : on peut, par exemple, notifier automatiquement une ou plusieurs personnes à ce moment-là — y compris sur une PR non rattachée à aucun backlog (seule l'action « Notifier » s'y applique).
• Filtre de rattachement : trois onglets avec compteurs — Toutes, Rattachées (à un backlog de ce projet, liaison automatique par le nom de branche backlog-‹id›) et Non rattachées (aucun backlog). Utile pour repérer d'un coup d'œil les PR qui ont échappé à la convention de nommage de branche.
• Mes PR à relire : bascule qui ne montre que les PR dont je suis le relecteur, dans le filtre courant (compteur affiché).
• Labels : les labels GitHub de la PR sont affichés en badges (avec leur couleur d'origine), pour donner l'état d'avancement réel côté GitHub sans quitter ISI-APP.

Règles d'accès

• Accès réservé aux membres du projet (même garde que les autres écrans du projet).
• L'affectation d'un relecteur nécessite le droit de modifier le projet.
• La partie « GitHub & Workflow » doit être activée pour le projet (interrupteur dans l'onglet Paramètres, désactivée par défaut) : sinon le sous-onglet n'apparaît pas.
• Nécessite en plus un connecteur GitHub actif pour le tenant : sans connecteur, le sous-onglet n'apparaît pas (le composant n'est même pas monté). Il réapparaît dès qu'un connecteur GitHub actif est branché.

Points d'attention

• Seules les PR ouvertes apparaissent (une PR fermée/mergée disparaît).
• Une PR rattachée au backlog d'un autre projet n'apparaît pas ici : elle est suivie dans l'écran de revue de ce projet-là. Elle n'est donc jamais comptée comme « non rattachée ».
• Les PR non rattachées n'appartiennent, par définition, à aucun projet : les mêmes apparaissent dans l'onglet « Revue de PR » de tous les projets ayant « GitHub & Workflow » activé. De même, le relecteur affecté à une PR est partagé : l'affecter depuis un projet le rend visible depuis les autres.
• Le périmètre scanné correspond au champ « Dépôts » du connecteur GitHub (Store, SuperDev). S'il n'est pas renseigné, seuls les premiers dépôts de l'installation GitHub sont scannés et un message d'avertissement l'indique — renseignez le champ pour couvrir tout le périmètre.
• Affecter un relecteur sur une PR non rattachée déclenche quand même le workflow « Relecteur de PR affecté » du projet (notification au relecteur qui vient d'être affecté, et/ou aux membres explicites d'une règle) : seules les automatisations qui modifient un item de backlog (changer son statut, l'assigner, poser un label sur sa PR) n'ont pas de sens ici et sont ignorées, faute d'item auquel se raccrocher.
• L'affectation est interne : elle ne pose pas de reviewer sur GitHub (pas de mapping utilisateur ISI ↔ compte GitHub). Le suivi d'avancement GitHub passe par les labels, désormais affichés dans la colonne dédiée (en lecture seule : les labels se gèrent côté GitHub).
• Les PR sont lues en direct depuis GitHub (cache court ~3 min) : un léger délai d'actualisation est normal.

Voir aussi

• Doc technique : ../../.claude/technical-docs/projects/backlog-pr-review.md
• Connecteur GitHub : ../integrations/github-connector.md