Design Reviews & Baselines

Guide utilisateur

Design Reviews & Baselines for Jira (en français : « Revues de conception et configuration ») ajoute à chaque projet Jira une page Revues et configuration, un panneau Revues de conception sur les tickets et une page d'administration. L'interface suit la langue de votre profil Jira (français ou anglais) et son thème (clair ou sombre).

1. Revues de conception

Créer une revue

Page projet > Revues de conception > Nouvelle revue. Choisissez le type (SRR, PDR, CDR, QR, TRR, AR, ORR, revue de document ou autre), donnez un objet, un jalon et les dates : lancement, date limite des RID, date du comité. Vous devenez président de la revue si vous n'en désignez pas d'autre.

Avant l'ouverture, la revue est en préparation :

Les phases

Phase Ce qui se passe
Préparation Documents, participants et critères se règlent.
Relecture Le paquet est figé : son empreinte SHA-256 est calculée et inscrite au journal. Les relecteurs émettent les RID.
Réponses Le titulaire répond à chaque RID.
Comité Le président ou le secrétaire saisit la décision du comité sur chaque RID.
Clôturée Le procès-verbal est figé avec son empreinte, puis signé. Les RID, décisions et critères ne bougent plus ; seules les actions décidées se soldent encore, avec leur preuve, et le procès-verbal signé reste tel quel.

Le président, le secrétaire, le créateur de la revue et les administrateurs du projet changent de phase (bouton en haut à droite). Un retour en arrière est possible tant que la revue n'est pas clôturée ; le retour en préparation est refusé dès qu'un RID existe, parce que le paquet relu ne peut plus changer.

Émettre un RID

Onglet RID > Nouveau RID (ou depuis le panneau d'un ticket, voir § 3). Un RID porte : le document et l'emplacement (§, page, tableau), une classe (Majeur : remet en cause la conception, une exigence ou la sécurité, et bloque la sortie de revue ; Mineur ; Éditorial), un titre, le constat et la correction proposée, et éventuellement le ticket visé (l'exigence ou le composant concerné). Un RID émis après la date limite est marqué « tardif ».

Le relecteur modifie son RID tant qu'il est ouvert et que la revue est en relecture ; il peut le retirer avec un motif tant qu'aucune décision n'est prise.

Importer des RID : onglet RID > Importer un CSV. Le fichier CSV vient du formulaire Excel envoyé aux relecteurs externes (modèle gratuit) ou de votre propre gabarit : les en-têtes usuels en français et en anglais sont reconnus (document, emplacement, classe, titre, constat, correction proposée, émetteur…). Vérifier contrôle tout le fichier (documents, classes, longueurs, tickets visés, lignes en double) et ne crée rien tant qu'une ligne est en erreur. L'import se fait ensuite par lots de 20 avec une barre de progression ; une ligne déjà présente dans la revue est ignorée, si bien qu'un import interrompu se relance sans créer de doublon. 500 lignes au plus par fichier.

Répondre et décider

Tableau de bord

Les indicateurs (RID émis, majeurs sans décision, en attente de réponse ou de décision, actions ouvertes et en retard, RID tardifs) sont cliquables et filtrent la liste. La matrice classe × état, la répartition par document et par émetteur, l'état des critères de sortie et les échéances complètent la vue. Exporter en CSV produit la liste complète des RID (séparateur selon la langue, protection contre l'injection de formules).

Clôture, procès-verbal et signatures

Clôturer la revue demande la conclusion :

Un motif est demandé sauf pour « prononcée ». La fenêtre de clôture relève aussi les présents : décochez les membres absents, le procès-verbal l'indique. Les critères de sortie sont figés dès l'entrée en comité. À la clôture, le procès-verbal (participants, documents et éditions, empreinte du paquet, tableau des RID, critères, décisions, actions, conclusion) est figé et son empreinte SHA-256 inscrite au journal. Le président, le secrétaire, le titulaire et les membres du comité le signent dans l'onglet Procès-verbal (signature électronique simple : compte Jira, date et empreinte, inscrites au journal). Télécharger le PDF produit le PV au format A4, avec l'empreinte en pied de page. À l'ouverture de l'onglet, l'app recalcule l'empreinte du PV stocké et vous alerte s'il ne correspond plus.

2. Gestion de configuration

Page projet > Configuration. Les gestionnaires de configuration (désignés par un administrateur du projet, qui l'est d'office) créent et modifient les articles, figent les référentiels, convoquent les commissions et appliquent les modifications. Tout utilisateur du projet consulte, et peut rédiger et soumettre une demande de modification.

Articles de configuration

Un article a un identifiant unique dans le projet (ex. EQ-ALIM-01), une désignation, une nature (matériel, logiciel, document, interface, système), un indice, un article parent, un ticket lié et ses documents de définition. Changer l'indice à la main demande un motif ; la voie normale est une modification approuvée (voir plus bas). Un article obsolète reste dans l'historique.

État de configuration (CSA)

L'onglet État de configuration montre l'arborescence des articles avec, pour chacun : son indice, le dernier référentiel qui le contient (et s'il a changé depuis), les modifications en cours et les dérogations en vigueur. Exports CSV et PDF.

Référentiels

Nouveau référentiel fige l'état courant (type fonctionnel, alloué, produit ou autre) avec la liste des articles, leurs indices, leur arborescence et les dérogations ou concessions en vigueur, sous une empreinte SHA-256. Comparer affiche les écarts entre deux référentiels, ou entre un référentiel et l'état courant : articles ajoutés, retirés, indices changés.

Modifications : ECR, dérogations, concessions

Type Usage
ECR (demande de modification) Change la définition : chaque article touché passe d'un indice à un autre.
Dérogation Écart autorisé avant réalisation, avec son effectivité (numéros de série, lots, durée).
Concession Écart constaté après réalisation, accepté en l'état.

Cycle : brouillon > soumise > (décision de la commission) approuvée, rejetée ou ajournée > appliquée > close. Appliquer une ECR approuvée n'est possible qu'une fois la séance qui l'a approuvée close ; l'app vérifie que chaque article est toujours à l'indice de départ, puis passe les indices et l'inscrit au journal avec la référence de l'ECR. Une application interrompue se relance sans doubler les indices.

Commissions de configuration (CCB)

Une commission a une date, des membres (président, secrétaire, membres) et un ordre du jour composé de demandes soumises. Le président ou le secrétaire saisit la décision de la commission sur chaque demande (motif obligatoire sauf approbation). Approuver une modification de classe I (qui touche aux engagements contractuels) exige la référence de l'accord du client, reprise au relevé. Une demande décidée ne peut plus être retirée de l'ordre du jour. Clore la séance fige le relevé de décisions sous une empreinte SHA-256 ; il se télécharge en PDF.

3. Panneau de ticket

Sur chaque ticket, ouvrez le panneau Revues de conception depuis le menu View app actions du ticket (la première fois ; Jira le garde ensuite sur le ticket). Il liste les RID qui visent ce ticket, dans tous les projets que vous pouvez consulter, avec leur état et la décision du comité. Émettre un RID sur ce ticket propose les revues en relecture où vous pouvez émettre un RID : c'est le moyen le plus rapide de relever un problème sur une exigence.

4. Journal

L'onglet Journal d'une revue, et le journal de chaque article ou modification, listent toutes les opérations (qui, quand, quels champs, avant et après). Chaque entrée est chaînée à la précédente par SHA-256 : Vérifier l'intégrité recalcule toute la chaîne du projet, la compare à la tête du journal et signale la première entrée modifiée, supprimée ou insérée, y compris une suppression des dernières entrées. Elle affiche l'empreinte de tête : reportez-la dans un procès-verbal ou un courriel, pour pouvoir prouver plus tard que le journal n'a pas été entièrement réécrit.

5. Droits

Les droits viennent de Jira et sont recalculés à chaque appel sur le serveur :

Action Qui
Consulter Toute personne qui peut parcourir le projet
Créer une revue Selon le réglage du site : toute personne du projet, ou les administrateurs du projet
Préparer, changer de phase Président, secrétaire, créateur de la revue, administrateurs du projet
Émettre un RID Toute personne du projet (ou les seuls participants si la revue est réservée), en phase de relecture
Répondre Titulaire, président, secrétaire, créateur, administrateurs du projet
Décider Président ou secrétaire, administrateurs du projet, en phase comité
Signer le PV Participants autres que relecteurs, une fois la revue clôturée
Configuration Gestionnaires de configuration et administrateurs du projet ; demandes de modification : toute personne du projet
Décisions de commission Président ou secrétaire de la commission

Si la licence de l'app n'est plus active, tout reste consultable et exportable, mais plus rien ne se modifie.

6. Agent Rovo, compétences et serveur MCP

Sur les sites où Rovo est activé, l'app ajoute un agent Rovo, Design Review Assistant. Ouvrez le chat Rovo, choisissez l'agent et posez votre question en langage courant. Il lit ce que vous avez le droit de lire, rien de plus : chaque appel d'outil vérifie vos droits Jira sur le projet, puis votre rôle dans la revue.

Ce que vous pouvez demander

Demande Ce que fait l'agent
« La PDR est-elle prête pour le comité ? Qu'est-ce qui bloque sa clôture ? » Vérifie chaque critère de sortie et nomme les RID qui le bloquent, les RID contestés, les actions en retard et les conclusions possibles à cet instant.
« Prépare le pré-brief du prochain comité de revue » Rédige le pré-brief : verdict, critères de sortie, décisions à prendre (majeurs d'abord), RID à arbitrer, actions, ordre du jour proposé.
« Qu'est-ce qui m'attend dans les revues de ce projet ? » RID auxquels répondre comme titulaire, décisions à saisir comme président ou secrétaire, procès-verbaux à signer, vos actions ouvertes, revues où vous pouvez émettre des RID.
« Explique REV-2-007 » Le RID complet, avec la réponse du titulaire, la décision du comité, l'action et l'historique.
« Quels constats de revue visent ALT-42 ? » Les RID émis sur un ticket Jira (une exigence, un composant), dans tous les projets que vous pouvez consulter.
« Aide-moi à émettre un RID sur le dossier de conception, § 4.3 : … » Cherche un RID qui couvre déjà le constat, rédige le vôtre (un constat par RID : document, emplacement, classe, constat, correction proposée), montre le brouillon et ne l'émet qu'après votre accord. Répondez « oui » dans le chat ; Rovo affiche ensuite sa propre carte « Please review » pour l'action, à valider par Confirm selected.
« Qu'est-ce qui a changé depuis le dernier référentiel, et à cause de quelle modification ? » Compare deux référentiels, ou un référentiel et la configuration en vigueur, et cite la demande de modification à l'origine de chaque changement d'indice.
« Explique ECR-3 » Motif, articles touchés, commission, décision, référence de l'accord client, mise en application.
« Le journal de ce projet est-il intact ? » Recalcule la chaîne SHA-256 et donne l'empreinte de tête.

L'agent répond dans votre langue. Depuis un ticket ou une page de projet, il travaille sur le projet de la conversation ; ailleurs, il demande la clé du projet.

Ce que l'agent ne fait jamais

Il ne saisit aucune décision du comité, ne répond pas à la place du titulaire, ne signe aucun procès-verbal, ne fige aucun référentiel et ne décide d'aucune modification. Ces actes reviennent aux personnes qui tiennent le rôle et se font dans l'app. La seule chose que l'agent écrit est un RID, en votre nom, avec les mêmes règles que dans l'app (revue en phase de relecture, revue réservée aux participants, licence en consultation seule). Un RID émis ainsi porte la marque via Rovo dans son panneau et la note « via Rovo » au journal.

Compétences

Trois compétences au format ouvert Agent Skills (un fichier SKILL.md chacune) portent la méthode que suit l'agent : review-board-prebrief (pré-brief et ordre du jour du comité), rid-drafting (ce que contient un RID bien formé, et l'étape de confirmation) et baseline-change-brief (état de configuration, comparaison de référentiels, ordre du jour d'une commission).

Serveur MCP

Les onze mêmes outils sont aussi exposés aux agents construits dans Rovo Studio par le module rovo:mcp de l'app, pour qu'ils les appellent avec vos droits. L'ouverture aux clients IA externes est décidée par l'administrateur de votre site (voir le guide d'administration).