Documents produits

L'étendue et les détails de la documentation sur les produits dépendent beaucoup du contexte du travail. Plutôt que de prescrire des documents séparés, Praxis fournit une liste des champs à partir desquels des documents appropriés doivent être élaborés en fonction des besoins du projet ou du programme.

Cela peut aboutir à une approche simple avec un document par produit ou une approche plus étendue avec des documents séparés pour les descriptions de réalisations, les éléments de configuration et les enregistrements de qualité.

Pour plus de commodité, les champs ont été répertoriés en trois sections. Lorsqu'ils sont agrandis dans des documents distincts, les champs doivent souvent être dupliqués dans les documents séparés.

 

Informations descriptives

• Identifiant
  

• Un identifiant unique qui peut être constitué de composants tels qu'un code de projet ou de programme, un code de produit, un numéro de version, etc.
  

• Titre
  

• Le nom par lequel le produit est connu.
  

• Description
  

• Une description du produit comprenant éventuellement son objet et la façon dont il s'insère dans la production globale.
  

• Composition
  

• Pour un produit simple, cette section peut suffire à décrire les composants et la nature du produit. Les produits plus complexes nécessitent des références croisées aux spécifications techniques.
  

• Propriétaire
  

• Si le produit est un livrable, alors le propriétaire est l'intervenant à qui le produit est remis. Sinon, il est un membre de l'équipe de gestion qui est responsable de l'acceptation du produit avant qu'il soit intégré dans le résultat comme un tout.
  

• Références
  

• Liens vers d'autres documents qui fournissent des informations supplémentaires sur le produit, par ex., registre de risques, représentation des intervenants, leçons, etc.

 

Informations sur le développement

• Développeur
  

• La personne, l'équipe, le service ou l'entrepreneur qui sont responsables du développement du produit.
  

• Dates prévues
  

• Quand le produit est prévu être développé.
  

• Dates réelles
  

• Lorsque le produit a été réellement développé.
  

• Critères de qualité
  

• Ce sont les critères de qualité qui seront testés dans le contrôle de la qualité. Il peut s'agir de références à des normes de qualité externes, à des critères propres au produit ou à une combinaison des deux.
  

• Tolérances de qualité
  

• Pour chaque critère de qualité, il convient de dresser la liste des mesures dans lesquelles le produit est acceptable.
  

• Méthodes de contrôle de qualité
  

• Les méthodes de contrôle à utiliser sont définies ici. Celles-ci peuvent aller des examens qualitatifs des utilisateurs à l'inspection mécanique et à l'analyse statistique.
  

• Responsabilité de contrôle de qualité
  

• Les personnes ou groupes chargés de mettre en œuvre les méthodes de contrôle de la qualité.
  

• Dates d'essai
  

• Les dates planifiées et prévues pour la plupart des activités d'essai ou d'examen dépendent entièrement d'un échéancier de réalisation qui est mis à jour régulièrement. Pour éviter les doubles emplois, les dates planifiées et prévues peuvent simplement être couvertes par un renvoi au plan de réalisation approprié. Ces renvois peuvent être complétés par des informations telles que « le produit doit être testé dans la semaine qui suit l'achèvement ».
  

• Résultats d'essais
  

• Les résultats du contrôle de qualité peuvent être aussi simples qu'une conformité ou non-conformité ou des données de test approfondi. Quoi qu'il en soit, la conséquence des résultats des tests doit être documentée. Si la qualité est acceptable, le produit peut être transmis pour intégration avec d'autres produits ou il peut être remis au propriétaire.

• Si la qualité est inacceptable, le produit peut être retravaillé ou mis au rebut. Dans certaines circonstances, il peut être possible ou nécessaire d'accepter un produit qui n'a pas satisfait aux critères, mais c'est une décision qui devra être prise par le parrain.
  

• Références
  

• Généralement, ces renvois sont des plans de réalisation qui montrent le contexte des dates prévues et réelles.
  

 

Informations de configuration

• Version actuelle
  

• Un identifiant qui indique la version la plus récente du produit. La section de gestion de la configuration du plan de gestion de la portée définit le système permettant l’étiquetage progressif des versions d'un produit.
  

• État
  

• Une classification de l'état actuel tel que défini dans un plan de gestion de configuration, par ex., en développement, en cours d'examen, approuvés, remis, etc.

• Date du dernier changement
  

• Lorsque la dernière version du produit a été émise pour test ou transfert.
  

• Versions précédentes
  

• Lorsque la date de la dernière version est enregistrée, elle ne remplace pas les dates précédentes. Chaque identifiant de la version actuelle et la date de la dernière modification restent dans le document pour afficher l’échéancier de développement du produit.
  

• Localisation
  

• L’emplacement où est situé ou stocké le produit. Cela s'applique à un « produit logiciel » tel qu'un fichier électronique ou un composant physique qui peut être déplacé avant l'installation. Il n'est pas pertinent pour les produits qui sont intégrés à la production globale, comme les fondations d'un bâtiment ou la quille d'un navire.
  

• Titulaire actuel
  

• La version actuelle d'un produit peut être avec les producteurs originaux ou une équipe d'essai. Lorsque le produit est un physique et non copiable, ce sont simplement des informations utiles.
  

• Dans le cas de fichiers électroniques (par ex., documents ou code informatique) où un téléchargement ou une pièce jointe de courrier électronique crée une copie, il est essentiel de comprendre qui a le pouvoir exclusif de travailler sur le produit. Cela est essentiel pour s'assurer qu'il n'y a pas plusieurs personnes faisant des changements simultanés à un produit.
  

• Relations
  

• Cette section explique comment le produit fonctionne avec d'autres produits. Il s'agit de l’élément clé lors de l'évaluation d'une demande de modification, car elle identifie comment un changement à ce produit peut affecter d'autres produits.

   

Documents typiques

De nombreux types de documents peuvent être assemblés à partir du menu d'informations de produit. Ceux décrits ci-dessous sont choisis sur la base qu'ils se retrouvent couramment dans les guides et les méthodes de la gestion P3. Il ne s'agit pas d'une liste définitive ou prescriptive.

Le contenu typique de chaque document est résumé dans le tableau à la fin de cette section.

• Description du produit

• Ce document est une mini spécification pour une composante particulière des objectifs du projet, du programme ou du portefeuille. Il permet aux individus de comprendre la nature détaillée, le but, la fonction, l'apparence et les critères d'acceptation du produit. Il doit contenir suffisamment d'informations pour identifier : quelles activités sont nécessaires pour développer, tester et approuver le produit; les ressources nécessaires pour le développer; les coûts du produit; où d'autres informations peuvent être trouvées.
  

• Registre du produit
  

• Ce registre résume les informations contenues dans les descriptions de produits pour fournir un index des produits et un aperçu de leur état. Parfois appelé liste de contrôle des produits.
  

• Registre de qualité
  

• Le registre de qualité résume les activités de contrôle de la qualité pour tous les produits et constitue une référence centrale pour un éventail varié de documents de contrôle de la qualité.
  

• Élément de configuration
  

• Ce document fournit un enregistrement d'un élément qui a été placé sous la responsabilité de la gestion de la configuration. Il couvre des informations telles que l'historique, l'état actuel, les versions et les corrélations avec d'autres éléments.
  

• Rapport d'état
  

• Le rapport d'état résume les informations relatives à l'état actuel d'un ensemble défini d'éléments de configuration, par ex., « Tous les produits devant être achevés au cours du mois prochain » ou « tous les produits développés par XYZ Contractors Ltd. » La portée du rapport d’état doit être décrite avant d'énumérer les informations indiquées dans le tableau.

   

  Champ	Registre du produit	Description du produit	Registre de qualité	Élément de configuration	Compte d'état
  Identifiant	X	X	X	X	X
  Titre	X	X	X
  Description		X		X
  Composition		X
  Propriétaire				X	X
  Description des renvois	X	X	X	X	X
  Développeur				X	X
  Dates prévues	X		X		X
  Dates actuelles	X		X		X
  Critères de qualité		X
  Tolérance de qualité		X
  Méthode de contrôle de la qualité		X	X
  Responsabilité de qualité		X	X
  Résultats d'essai				X	X
  Références de développement	X	X	X	X	X
  Version courante	X			X	X
  État				X	X
  Date du dernier changement				X	X
  Versions précédentes				X
  Localisation				X
  Titulaire actuel				X
  Relations				X

   

 

Merci à la SMaP pour la traduction.