# Revue de conception et gestion de configuration dans Jira : une méthode traçable

Source : https://consignestudio.fr/guides/revue-conception-gestion-configuration-jira/ · publié le 2026-10-27 · Antoine Despres, Consigne

Jira suffit pour tenir une revue de conception traçable si chaque remarque devient un ticket RID avec sa classe, le document et l'édition relus, la réponse du titulaire et la décision du comité. La revue se pilote ensuite par quelques filtres JQL et un tableau de bord. Ce que Jira ne fait pas seul, c'est figer : le paquet relu, le procès-verbal et la ligne de base de configuration doivent être gelés et archivés par une règle que vous écrivez.

## Ce qui rend une revue traçable

Une revue de conception (SRR, PDR, CDR, revue de qualification ou simple revue de document) se juge sur ses **RID** (*review item discrepancy*) : chaque remarque d'un relecteur sur le dossier relu. Six semaines après la séance, quelqu'un doit pouvoir répondre sans hésiter à ces questions :

* quels documents ont été relus, et dans quelle édition ?
* qui a émis chaque remarque, sur quel paragraphe ?
* qu'a répondu le titulaire, et qu'a décidé le comité ?
* chaque action a-t-elle un responsable, une échéance et une preuve de solde ?
* le procès-verbal signé correspond-il à ce qui a été décidé ?

Le tableur envoyé par courriel puis recopié à la main échoue presque toujours sur la deuxième et la cinquième question. Un ticket par RID dans Jira règle la plupart des autres.

## Le cycle d'un RID

Le même chemin vaut quelle que soit la norme du programme :

| État | Qui agit | Ce qui se passe |
|---|---|---|
| Ouvert | Relecteur | Émet le RID sur un document et un emplacement précis, avec une classe et une correction proposée |
| Répondu | Titulaire | Donne sa position (accord, accord partiel, désaccord, clarification) et sa réponse |
| Action en cours | Comité | Accepte le RID avec une action : description, responsable, échéance |
| Clos | Comité ou titulaire | Décision sans action (acceptée, rejetée, transférée), ou action soldée avec sa preuve |
| Retiré | Relecteur | Retire le RID avant décision, avec un motif |

Trois classes suffisent dans la plupart des programmes : **majeur** (remet en cause la conception, une exigence ou la sécurité, et bloque la sortie de revue), **mineur** (erreur sans effet sur la conception), **éditorial** (forme). Si votre programme impose une autre échelle, gardez-la : seuls les libellés changent.

## Mettre en place le RID dans Jira

Dans un projet géré par l'entreprise, un administrateur Jira crée un type de ticket **RID** et lui associe des champs personnalisés :

| Champ | Type Jira | Rôle |
|---|---|---|
| Classe | liste à choix unique | majeur, mineur, éditorial |
| Document | texte court | référence du document relu |
| Édition | texte court | édition relue, par exemple 1.2 |
| Emplacement | texte court | paragraphe, page, tableau ou identifiant d'exigence |
| Correction proposée | paragraphe | ce que propose le relecteur |
| Position du titulaire | liste à choix unique | accord, accord partiel, désaccord, clarification |
| Réponse du titulaire | paragraphe | réponse argumentée |
| Décision du comité | liste à choix unique | accepté avec action, accepté sans action, rejeté, transféré |
| Motif de la décision | paragraphe | obligatoire sauf pour « accepté sans action » |

Le résumé, la description, l'échéance et les étiquettes sont des champs standards. **L'étiquette identifie la revue** (revue-pdr, revue-cdr) : c'est elle qui permet de filtrer une revue et de comparer les revues entre elles. L'exigence visée se relie par un lien de ticket.

### Le workflow

Affectez au type RID un workflow à cinq états, avec des écrans de transition qui demandent la bonne information au bon moment : la position et la réponse pour « Répondre », la décision, le motif, le responsable et l'échéance pour « Accepter avec action ». Réservez les transitions de décision à un rôle de projet « Comité ». Deux réglages évitent bien des erreurs :

* un validateur qui rend le motif obligatoire pour rejeter ou transférer ;
* une fonction post-transition qui renseigne la **résolution** vers Clos et Retiré, sans quoi les filtres « non résolus » deviennent faux.

## Recueillir les RID des relecteurs extérieurs

Le client, l'agence ou un sous-traitant n'ont souvent pas de compte Jira. Envoyez-leur un formulaire tableur, une ligne par RID, avec la liste des classes. Au retour, enregistrez-le en CSV UTF-8 et importez-le par l'importateur CSV de Jira (droit d'administrateur requis). Répétez l'import une fois sur un projet de test pour régler la correspondance des colonnes, puis enregistrez cette configuration.

## Piloter la revue par JQL

Quelques filtres partagés avec le groupe de la revue suffisent. Remplacez ALT par la clé de votre projet :

```
project = ALT AND issuetype = RID AND labels = revue-pdr AND Classe = Majeur AND status in (Ouvert, Répondu)
project = ALT AND issuetype = RID AND labels = revue-pdr AND status = Répondu
project = ALT AND issuetype = RID AND status = "Action en cours" AND duedate < startOfDay()
```

Le premier liste les majeurs sans décision, le deuxième ce qui attend le comité, le troisième les actions en retard. Si le nom du champ Classe est ambigu sur votre site, utilisez son identifiant, de la forme `cf[10042]`.

Un tableau de bord par revue, avec des statistiques à deux dimensions (état × classe), les majeurs sans décision et les actions en retard, répond aux questions du président en séance.

## Le déroulé type

| Jalon | À faire |
|---|---|
| Lancement, trois à quatre semaines avant | Figer la liste des documents et leurs éditions, publier l'étiquette, envoyer le formulaire aux relecteurs extérieurs |
| Date limite des RID | Importer les formulaires reçus, repérer les RID tardifs |
| Réponses, la semaine précédente | Le titulaire répond à chaque RID ; le secrétaire bâtit l'ordre du jour autour des désaccords et des majeurs |
| Comité | Décision RID par RID, majeurs d'abord ; une action, un responsable, une échéance |
| Clôture | Vérifier les critères de sortie, rédiger et faire signer le procès-verbal |

Critères de sortie usuels : aucun RID majeur sans décision, tous les RID décidés, chaque action avec un responsable et une échéance. La conclusion est l'une de : prononcée, prononcée avec réserves, non prononcée.

## Ce que Jira ne fige pas

Trois points restent à tenir par une règle écrite, et ce sont ceux qu'un auditeur qualité regarde en premier :

1. **Le paquet relu.** Les éditions sont saisies à la main ; une édition changée pendant la revue passe inaperçue. Archivez les documents relus, à l'édition annoncée, dans votre gestion documentaire au lancement.
2. **Le procès-verbal.** Un champ modifié après la séance change l'export. Exportez le filtre de la revue en CSV à la clôture, joignez-le au PV et archivez l'ensemble avant signature.
3. **Le lien avec la configuration.** Une action décidée en revue devient souvent une demande de modification. Sans lien, on perd sa trace entre la revue et la ligne de base suivante.

> Une revue est aussi un jalon de configuration : son paquet relu doit correspondre à une ligne de base identifiée. Une revue dont on ne sait pas dire sur quelle ligne de base elle a porté est difficile à défendre.

## Lignes de base et demandes de modification

La gestion de configuration repose sur quelques notions qu'on retrouve dans la plupart des référentiels, dont ECSS-M-ST-40 dans le spatial :

| Notion | Ce que c'est |
|---|---|
| Article de configuration | un élément géré : matériel, logiciel, document, interface, avec un identifiant et un indice |
| Ligne de base (référentiel) | l'état figé d'un ensemble d'articles et de leurs indices à une date : fonctionnelle, allouée, produit |
| Demande de modification (ECR) | change la définition : chaque article touché passe d'un indice à un autre, après décision |
| 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 |
| Commission de configuration | instance qui approuve, rejette ou ajourne les demandes |

Dans Jira, la démarche la plus simple consiste à créer un type de ticket pour la demande de modification, avec son propre workflow (brouillon, soumise, approuvée, rejetée ou ajournée, appliquée, close), et à la relier par un lien de ticket au RID dont elle découle. Pour la ligne de base, Jira n'offre pas d'instantané figé : la pratique courante est d'exporter la liste des articles et de leurs indices à la date du jalon, de la référencer et de l'archiver, comme le procès-verbal.

## Le modèle gratuit

Le modèle [Revue de conception dans Jira](https://consignestudio.fr/revue-de-conception-jira/) reprend la partie revue de cette méthode : un guide qui décrit le type RID, ses champs, le workflow, l'import CSV, six filtres JQL et le tableau de bord, un formulaire Excel pour les relecteurs sans compte, et un exemple de 13 RID sur une PDR fictive avec son CSV d'import. Il est gratuit, sous licence CC BY 4.0, et fonctionne avec Jira Cloud seul, dans un projet géré par l'entreprise. Il ne fige ni le paquet relu ni le procès-verbal, et ne couvre pas la gestion de configuration : ces points restent à tenir par les règles décrites plus haut.

## Sources

- ECSS-M-ST-10-01, Space project management · Organization and conduct of reviews (cité par numéro, texte non reproduit)
- ECSS-M-ST-40, Space project management · Configuration and information management (cité par numéro, texte non reproduit)
- Modèle gratuit « Revue de conception dans Jira » 1.0.0, Consigne, 2026 (guide, formulaire RID, exemple)