Administration
Installer
- Jira > Paramètres > Apps > Explorer les apps, cherchez « Design Reviews & Baselines », Installer. L'essai gratuit dure 30 jours ; l'app est gratuite jusqu'à 10 utilisateurs.
- Ouvrez un projet : l'entrée Revues et configuration apparaît dans la barre latérale du projet (rubrique Apps). Dans un projet créé à l'instant, elle peut mettre 10 à 20 minutes à apparaître : rechargez la page. Le panneau Revues de conception est disponible sur les tickets, dans le menu View app actions du ticket.
- Paramètres > Apps > Revues de conception et configuration ouvre les réglages du site (administrateurs Jira).
Rien d'autre à installer : l'app tourne sur Atlassian Forge, dans l'infrastructure d'Atlassian.
Réglages du site
| Réglage | Effet |
|---|---|
| Types de revue proposés | Les types offerts à la création d'une revue (au moins un). |
| Critères de sortie par défaut | Copiés dans chaque nouvelle revue, qui peut ensuite les ajuster. |
| Qui peut créer une revue | Toute personne qui consulte le projet, ou les administrateurs du projet seulement. |
| Séparateur des exports CSV | Selon la langue (point-virgule en français, virgule en anglais), ou imposé. |
Dans chaque projet, l'onglet Configuration > Gestionnaires permet à un administrateur du projet de désigner les gestionnaires de configuration.
Autorisations demandées (scopes Forge)
| Scope | Pourquoi |
|---|---|
read:jira-work |
Lire les projets, tickets et vos droits sur le projet (Parcourir, Administrer). |
write:jira-work |
Créer, à votre demande, le ticket de suivi d'une action décidée en revue. |
read:jira-user |
Afficher le nom et l'avatar des participants. |
storage:app |
Enregistrer revues, RID, articles, référentiels et journal dans le stockage Forge de votre site. |
Les appels à Jira sont faits au nom de l'utilisateur : l'app ne voit que ce que la personne voit. Les outils de l'agent ont un mode de repli, décrit ci-dessous.
Agent Rovo et serveur MCP
- Agent Rovo. Il faut que Rovo soit activé sur votre site. L'agent Design Review Assistant apparaît alors dans la liste des agents du chat Rovo. Rien à régler dans l'app.
- Avec quels droits. Chaque outil s'exécute pour la personne qui parle à l'agent. L'app demande d'abord à Jira qui est l'utilisateur, par un appel fait en son nom ; Jira applique ensuite ses propres droits à chaque appel. Si la plateforme ne fournit pas de session utilisateur à une action de l'agent, l'app prend le compte que Forge déclare pour l'invocation, appelle Jira en tant qu'app et vérifie elle-même les droits de ce compte avant de renvoyer quoi que ce soit : Parcourir le projet, visibilité du ticket, Parcourir les utilisateurs et les groupes. Si cette vérification ne peut pas se faire, rien n'est renvoyé. Un appel sans aucun utilisateur, par exemple une automatisation, n'obtient aucune donnée.
- Une seule écriture. Dix outils ne font que lire. Un seul,
raise-rid, émet un RID au nom de l'utilisateur, après que l'agent a montré le brouillon et que l'utilisateur l'a confirmé. Il suit les règles de l'app et il est refusé quand la licence est inactive. - Serveur MCP. L'app déclare un serveur MCP nommé « Design Reviews & Baselines » avec les onze mêmes outils, pour les agents construits dans Rovo Studio. Les outils sont aussi exposés aux agents construits dans Rovo Studio par le module
rovo:mcp. Les clients MCP externes sont fermés par défaut et un administrateur du site les ouvre dans Atlassian Administration. Quand un client externe est connecté, les résultats d'outils qu'il demande (contenu de revues et de RID que l'utilisateur peut lire) lui sont envoyés. Laissez cette option fermée si les données de revue doivent rester chez Atlassian.
Programme d'exemple
Dans un projet qui n'a encore ni revue ni article de configuration, un administrateur du projet voit Charger le programme d'exemple ALTAIR sous la liste vide des revues. Le projet reçoit un programme fictif de micro-satellite : 4 revues à des phases différentes, 22 RID, 9 articles de configuration, un référentiel, 6 modifications et 2 commissions, plus 4 tickets d'exemple dans le projet Jira quand ses champs obligatoires le permettent. La personne qui le charge tient tous les rôles ; les relecteurs sont des noms fictifs dans le champ Émetteur. Le chargement prend une minute ou deux et se reprend si la page a été fermée. À la fin, la liste peut mettre quelques secondes à montrer les revues (la page se rafraîchit seule) ; si elle reste vide, rechargez la page.
Si vous venez de créer le projet et que le bouton manque, attendez quelques minutes et rechargez la page : Jira peut mettre environ 4 minutes à signaler aux apps le droit d'administrateur du projet (et 10 à 20 minutes avant que la page de l'app apparaisse dans un projet neuf), et l'exemple n'est proposé qu'à un administrateur du projet.
Prenez un projet d'essai : une revue, un RID ou une ligne du journal ne se suppriment pas ensuite. Désinstaller l'app supprime toutes ses données.
Données
Toutes les données de l'app sont dans le stockage Forge de votre site Atlassian. L'app n'a aucun serveur tiers et les données ne quittent pas l'infrastructure d'Atlassian, sauf si un administrateur du site ouvre les outils MCP à un client externe (voir ci-dessus). Sauvegarde : exportez les RID (CSV), les procès-verbaux (PDF), l'état de configuration (CSV, PDF) et les relevés de commission (PDF). À la désinstallation, Atlassian supprime les données de l'app selon ses règles de conservation Forge.
Licence
Si la licence expire ou n'est pas renouvelée, l'app passe en consultation seule : tout reste lisible et exportable, rien ne se modifie. Un administrateur Jira la réactive depuis Paramètres > Apps > Gérer les apps.
Support
Onglet « Support » de la fiche Marketplace, ou support@consignestudio.fr. Première réponse sous 1 à 3 jours ouvrés selon la gravité (voir la politique de support).