Upload
elmahdi1982
View
226
Download
0
Embed Size (px)
Citation preview
8/3/2019 Conduite de Projet - Gestion Documentation Des Projets Informatiques
1/21
Centre national de la recherche scientifiqueDirection des systmes d'information
REFERENTIEL QUALITEGuide mthodologique
Gestion de la documentationdes projets informatiques
Rfrence : CNRS/DSI/BQSD/conduite-projet/developpement/guide-gestion-doc
Date de dernire mise jour : 19 fvrier 2001
Version : 01
Etat : termin
Auteurs : F.Villeneuve
Diffusion : DSI
Objet :Ce document est un guide pour grer la documentation au sein d'une quipe projet la DSI : mettre enoeuvre des moyens pour rfrencer de manire homogne lensemble de la documentation relative chaque projet, en organiser la production, le classement et laccs.
8/3/2019 Conduite de Projet - Gestion Documentation Des Projets Informatiques
2/21
Guide mthodologique - Gestion de la documentation
CNRS/DSI/BQSD/conduite-projet/developpement/guide-gestion-doc 19 fvrier 2001 2 / 21
Table des mises jour du document
Version dudocument
Date Objet de la mise jour
V1.0 17 fvrier 1995 Cration du document
v1.1 07 mars 1996 Diverses mises jour (noms de documents rfrencs...)Remplacement de la fiche de synthse par la fiche derelectureAjout du classement de la documentation papier (armoire etfeuille d'emprunt)Ajout de la gestion des versionsComplments sur la gestion physique des fichiersAjout du plan et dossier de tests de validation, mise jourdes dfinitions des niveaux de test
v1.2 01 septembre 99 Changement de dnomination de la DSI : Dlgation auxsystmes d'information devient "Direction des systmesd'information".
v1.3 19 fvrier 2001 Mise en forme et ajustements
8/3/2019 Conduite de Projet - Gestion Documentation Des Projets Informatiques
3/21
Guide mthodologique - Gestion de la documentation
CNRS/DSI/BQSD/conduite-projet/developpement/guide-gestion-doc 19 fvrier 2001 3 / 21
Sommaire
1- OBJET ET DOMAINE DAPPLICATION........................................................................ 4
2 - DOCUMENTS DE RFRENCE..................................................................................... 4
3 - ABRVIATIONS ET TERMINOLOGIE......................................................................... 4
4- GESTION DE LA DOCUMENTATION............................................................................ 4
4.1- LES ACTEURS ET LEURS RESPONSABILITS............................................................................. 44.2 CYCLE DE VIE DUN DOCUMENT.............................................................................................. 5
4.2.1 Production du document................................................................................................ 6
4.2.2 Vrification/validation du document ............................................................................. 6
4.2.3 Archivage du document ................................................................................................. 7
4.3 IDENTIFICATION ET STRUCTURE DE LA DOCUMENTATION ....................................................... 74.3.1 Identification.................................................................................................................. 7
4.3.2 Structure ........................................................................................................................ 8
4.4 GESTION DES VERSIONS - RVISIONS....................................................................................... 94.5 OUTILS DE PRODUCTION DE LA DOCUMENTATION .................................................................. 94.6 CLASSEMENT ........................................................................................................................ 94.7 GESTION PHYSIQUE DES FICHIERS CONTENANT LES DOCUMENTS ........................................... 10
4.7.1 Rpertoires................................................................................................................... 10
4.7.2 Noms des fichiers......................................................................................................... 10
4.7.3 Procdures de sauvegarde et archivage...................................................................... 10
5. ORGANISATION DE LA DOCUMENTATION ............................................................ 105.1 DOCUMENTS DE GESTION DE PROJET..................................................................................... 115.2 DOCUMENTS DTUDE ET DVELOPPEMENT .......................................................................... 125.3 DOCUMENTS RELATIFS LA MISE EN OEUVRE ...................................................................... 135.4 DOCUMENTS RELATIFS LA QUALIT.................................................................................. 14
6. ANNEXE :GLOSSAIRE DES DIFFRENTS TYPES DE DOCUMENTS................... 15
8/3/2019 Conduite de Projet - Gestion Documentation Des Projets Informatiques
4/21
Guide mthodologique - Gestion de la documentation
CNRS/DSI/BQSD/conduite-projet/developpement/guide-gestion-doc 19 fvrier 2001 4 / 21
1- OBJET ET DOMAINE DAPPLICATION
Rappel : documentation : ensemble de documents relatifs un projet - notice - mode demploi -
action de slectionner, classer, utiliser ou diffuser des documents. (Source : Le Petit Larousse -1994)
La documentation dun projet a une importance primordiale : cest loutil de communication et de dialogueentre les membres de lquipe projet et les intervenants extrieurs (membre des instances de pilotage, chefde projet, utilisateurs, etc...). Elle assure aussi la prennit des informations au sein du projet.Afin dorganiser la gestion de la documentation produite par projet, il convient au pralable didentifiertous les types de documents relatifs aux diverses tapes dun projet, de les rfrencer de manirehomogne pour ensuite dfinir un mode de gestion commun tous les projets.
2 - DOCUMENTS DE REFERENCE
AFNOR Z 67 - 100-1 "Systme dinformation documentaire en ingnierie informatique" :positionnement de la documentation dans le droulement des projets et dans la relation Client-Fournisseur.
AFNOR Z 67 - 100-2 "Management de la documentation dans un contexte dassurance qualit" AFNOR Z 67 - 100-3 "Contenus type de la documentation courante des projets
informatiques"
Plan type Document de projet Plan type Fiche de relecture Plan type Journal de la documentation Plan type Fiche d'emprunt
3 - ABREVIATIONS ET TERMINOLOGIE
cf Glossaire Conduite de projet Systmes dinformation Les dfinitions des diffrents types de documents sont donnes en annexe du prsent guide.
4- GESTION DE LA DOCUMENTATION
Ce chapitre prcise les rgles de gestion de la documentation mettre en oeuvre dans tout projet.Pour mieux comprendre la ncessit dune gestion rigoureuse de la documentation, il convient en premierlieu de dtailler les tats par lesquels passe un document avant dtre diffus ainsi que le rle des diffrentsacteurs.
4.1- Les acteurs et leurs responsabilits
Les diffrents acteurs sont : le charg de la gestion documentaire (gnralement le responsable qualit du projet), le(s) auteur(s) du document, les responsables de la vrification (membres de lquipe projet ou intervenants extrieurs), les responsables de la validation (une ou plusieurs personnes dsignes).
ACTEUR RESPONSABILITES
8/3/2019 Conduite de Projet - Gestion Documentation Des Projets Informatiques
5/21
Guide mthodologique - Gestion de la documentation
CNRS/DSI/BQSD/conduite-projet/developpement/guide-gestion-doc 19 fvrier 2001 5 / 21
Charg de la gestion de ladocumentation du projet
. diffusion homogne des outils de production de documents,
. supervision du fonctionnement courant,
. dfinition et respect des rgles didentification, de structurationet de classement,
. contrle de la cohrence et de lhomognit dans la gestion etles extensions de la documentation du projet,
. dcisions darchivage ou de suppression de documents.Auteur
(un document peut tre produit parplusieurs auteurs : un auteur princi- pal
doit tre dsign et rfrenc sur le
document en tte de liste des auteurs)
. objectifs et contenu du document
. diffusion vers les destinataires identifis (cycle de vie prvu pourle document)
. gestion des mises jour et des versions-rvisions successives dudocument
. mise jour du journal de la documentation (liste de tous lesdocuments produits par le projet)
. sauvegarde du document.Responsable de la
vrification
. relecture pour commentaires et enrichissements ventuels
. contrle de la conformit par rapport aux standardsmthodologiques (contenu attendu du document) et aux rglesde prsentation et structuration des documents.
Responsable de la validation . valuation de la pertinence, la correction et la compltude ducontenu, par rapport aux objectifs du document.
4.2 Cycle de vie dun document
Un document passe par un certain nombre d'tats :
Etat Significationtravail le document est en cours d'laboration par l'auteurtermin le document satisfait l'auteur; il est prt tre diffusvrifi (optionnel) le document est approuv par d'autres membres de l'quipe, des
intervenants extrieurs et/ou le contrle qualitvalid le document est approuv par les personnes habilites et prend valeur de
rfrence au sein du projetprim le document nest plus adapt et est donc retir tous ses dtenteurs
(retrait d'usage)archivage le document n'est plus consult rgulirement, mais une trace de son
existence demeure (pour une dure dfinie par le charg de gestion de ladocumentation du projet)destruction - le document n'est pas archiv ou
- le dlai d'archivage est coul
8/3/2019 Conduite de Projet - Gestion Documentation Des Projets Informatiques
6/21
Guide mthodologique - Gestion de la documentation
CNRS/DSI/BQSD/conduite-projet/developpement/guide-gestion-doc 19 fvrier 2001 6 / 21
Cycle de vie d'un document
travail
termin
vrifi
valid
vrification
production
validation
archivage
Auteur
Vrificateur
Validateur
La conclusion de la vrification/validation doit tre crite dans un document, de sorte que l'auteur puissegarder une trace formelle de l'application du cycle de vie prvu pour le document.
4.2.1 Production du document
Un document en cours de production est dans l'tat "travail".Lorsque l'auteur obtient une rdaction qui le satisfait et ne souhaite plus apporter de modifications, ill'indique en le faisant passer l'tat "termin".Avant de faire passer un document en l'tat "termin", l'auteur peut le soumettre des lectures croises ausein de son quipe.
4.2.2 Vrification/validation du document
L'auteur diffuse alors le document aux vrificateurs puis aux validateurs , ou directement aux validateurs(la vrification est optionnelle selon le type de document). La diffusion se fait sous format papier oulectronique (choisir le plus pratique).Il joint son document une fiche derelecture o les remarques ventuelles des vrificateurs ou validateurs
sont formalises (modifications souhaites).Toutes les remarques de fond sur le contenu du document (imprcision, ambiguts, incohrences...)doivent tre consignes dans cette fiche sauf les remarques relatives la forme du document (fautes defrappe, d'orthographe, problmes de mise en page...) qui peuvent tre signales directement sur la copiepapier du document.Si les modifications du texte sont importantes, elles sont juste rfrences dans la fiche de relecture puis
dcrites directement sur une copie papier du document.
La fiche de relecture comporte les lments suivants : Une partie renseigne par l'auteur (avant transmission au vrificateur/validateur)
nom du demandeur date de la demande nom et rfrence du document
8/3/2019 Conduite de Projet - Gestion Documentation Des Projets Informatiques
7/21
Guide mthodologique - Gestion de la documentation
CNRS/DSI/BQSD/conduite-projet/developpement/guide-gestion-doc 19 fvrier 2001 7 / 21
date de retour pour les remarques aspects examiner (contenu, forme, totalit, partie...)
Une partie renseigne par le vrificateur/validateur
nom du vrificateur ou validateur date de vrification ou validation conclusion de la vrification ou validation :
document valid , document valid aprs intgration des modifications par l'auteur, document revalider (ncessite un nouveau passage en vrification/validation
aprs intgration des modifications par l'auteur), liste des points modifier dans le document (numro de , page, description de la modification
ou rfrence une annotation dans la copie papier du document jointe).
Cette fiche (ainsi qu'ventuellement le document annot joint) est transmise l'auteur.L'auteur rpond aux remarques mises par les relecteurs dans la colonne "justification rponses" de la ficheprvue cet effet.
L'auteur conserve une copie papier de la fiche.
Si la vrification/validation est accepte, le document passe l'tat "vrifi"/"valid", sinon il revient en tatde "travail".L'auteur du document est charg d'indiquer en page de garde du document l'tat dans lequel le documentse trouve, ainsi que les noms des vrificateurs/validateurs et les dates de vrification/validation.
NB : Pour chaque document valider, une date de retour des remarques est convenue. Si aucun retourn'est parvenu l'auteur la date prvue, le document est considr comme valid.
4.2.3 Archivage du document
Lorsqu'un document est prim, le responsable charg de la gestion de la documentation l'archive et veille informer tous les dtenteurs du document de sa cessation d'applicabilit.
4.3 Identification et structure de la documentation
4.3.1 Identification
Afin dassurer lefficacit de la gestion de la documentation, il faut prvoir un mcanisme normalisdidentification des documents (homognit).Ainsi, chaque document reoit une rfrence unique au sein du projet, constitue de plusieurs champs(cette rfrence apparat en page de garde et sur chacune des pages du document) :nom_du_projet / nature_de_document / identification_du_document
a) nom du projet : CNRS/DSI/#PROJET#
b) nature de document (sur 2 caractres) :. documents de gestion : GE. documents de dveloppement : en fonction de l'tape dans laquelle est produit ou utilis le
document technique :
* tape d'tude pralable :EP* tape d'tude dtaille (ou fonctionnelle) :ED
* tape d'tude technique :ET
8/3/2019 Conduite de Projet - Gestion Documentation Des Projets Informatiques
8/21
Guide mthodologique - Gestion de la documentation
CNRS/DSI/BQSD/conduite-projet/developpement/guide-gestion-doc 19 fvrier 2001 8 / 21
* tape de ralisation :RE
* tape de rception :RC
. documents de mise en oeuvre : MO, et plus spcifiquement :* documents lis la documentation utilisateur :DO
* documents lis la formation des utilisateurs :FO
* documents lis au laboratoire d'valuation :LE
. documents qualit : QU
c) identification du document. pour les documents techniques, de tests, ou lis la qualit : nom du module ou de la
procdure* exemples : FACT(document d'tude dtaille/Module Factures)
PTUTI(document d'tude technique/Plan de Tests Unitaires et d'Intgration)
PACQ (document qualit/Plan d'Assurance et Contrle Qualit)
. pour les documents de type courrier, utiliser l'outil NUMELEC.
4.3.2 Structure
Il est convenu que tout document doit comporter les lments suivants sur la page de garde : le titre du document, la rfrence du document, la date de dernire mise jour, le numro de version de l'application concerne par le document (VX.x), l'indice de rvision du document (numro chronologique : 00, 01...) par rapport la version de
l'application, ltat du document (ex : travail), le nom de lauteur (ou des auteurs), lobjet du document (prsentation rapide du contenu) pour les documents faisant l'objet d'une vrification et/ou d'une validation, le cartouche de visa (noms
des destinataires, objet de la diffusion - validation, vrification, information- , dates de visa).
Dautre part, sur chaque page du document prciser : le titre du document, la rfrence, la date de dernire mise jour, le numro de page / nombre de pages total.
Une table des mises jour des documents (aprs la page de garde) permet de retracer les diffrentestapes qua suivies le document et se dcompose de la faon suivante : le numro de version de l'application concerne par le document (VX.x), l'indice de rvision du document (00, 01...), la date de dernire mise jour de cette rvision, lobjet de la mise jour du document par rapport la rvision prcdente.
Chaque document comprend un sommaire, qui reprend les titres des chapitres et des diffrentsparagraphes et prcise les numros de pages correspondants.
NB : GESTION DE LA DATE
8/3/2019 Conduite de Projet - Gestion Documentation Des Projets Informatiques
9/21
Guide mthodologique - Gestion de la documentation
CNRS/DSI/BQSD/conduite-projet/developpement/guide-gestion-doc 19 fvrier 2001 9 / 21
Tant que le document est en cours de production, et non diffus pour vrification ou validation, la dateutilise peut tre la date systme de lordinateur (celle du jour). Ds que le document fait lobjet dunediffusion, la date (en page de garde et sur chaque page est fige la date de dernire mise jour.
4.4 Gestion des versions - rvisions
Chaque modification de version dun document doit tre soumise aux mmes dispositions dapprobationque les documents initiaux (voir chapitre 2.2 : "cycle de vie dun document").Lauteur de la modification est responsable : du respect du cycle de vrification et validation, de la modification de l'indice de rvision, de la diffusion de la nouvelle version, de la sauvegarde des modifications.
Le numro de version qui apparat sur un document correspond la version de l'application logicielleconcerne.
L'indice de rvision est propre au document : il est remis 00 lors chaque nouvelle version de l'application il est incrment chaque modification du contenu du document devant faire l'objet d'une diffusion (il
n'est pas incrment pour des corrections portant sur la forme du document - fautes de frappe,d'orthographe, ...).
Pour certains documents, il est important de faire apparatre clairement les volutions d'une rvision l'autre du document. A cet effet, l'option Outils/Suivi des modifications de Word est utilise.Les corrections de fautes d'orthographe, de frappe ou de mise en page ne doivent pas apparatre avec desmarques de rvision. Pour cela, effectuer ce type de modifications sur le document initial (exemple : dans
ED_ASTTO2.doc) avant de le dupliquer.Attention :Le document original choisi pour effectuer la rvision, est fonction du destinataire auquel s'adresse cettervision : soit le destinataire aura en main toutes les rvisions successives du document ; soit le document transmis fera la somme de toutes les relectures successives.
4.5 Outils de production de la documentation
Tout nouveau document est produit sur PC, avec les logiciels WORD, EXCEL ou Powerpoint.
4.6 Classement
Tous les documents mis dans le projet sont rfrencs dans un journal de la documentation quicomporte les lments suivants : rfrence du document, date de cration, auteur(s), titre,
outil de production du document (word, excel... - PC)
8/3/2019 Conduite de Projet - Gestion Documentation Des Projets Informatiques
10/21
Guide mthodologique - Gestion de la documentation
CNRS/DSI/BQSD/conduite-projet/developpement/guide-gestion-doc 19 fvrier 2001 10 / 21
NB : Chaque auteur de document est responsable de la mise jour du journal de la documentation duprojet.
Un exemplaire papier de chaque document du projet est disponible dans l'armoire de la documentation duprojet. Une feuille d'emprunt permet de connatre la localisation des documents sortis de l'armoire.
4.7 Gestion physique des fichiers contenant les documents
4.7.1 Rpertoires
Les documents du projet sont accessibles en consultation tous les membres de l'quipe projet surserveur, dans un rpertoire clairement identifi par le nom du projet.Un sous-rpertoire est cr par nature de document grer. Les noms de ces rpertoires reprennent lescodes de la nature du document : GE, EP, ED, ET, RE, RC, MO, QU.
4.7.2 Noms des fichiers
Le nom de chaque fichier rappelle la rfrence du document :nature-de-document "_" identification-du-document
La nature du document est rappele dans le nom de fichier afin qu'il n'y ait pas de confusion entre desdocuments ayant la mme identification mais pas la mme nature (exemple : identification STRUC maisnature ED ou ET).Drogation : la nature du document peut ne pas tre inclue dans le nom du fichier si aucune confusionn'est possible entre 2 documents.Remarque : lorsqu'il est ncessaire de sauvegarder plusieurs rvisions de documents, l'indice de rvisionest ajout en fin du nom de fichier.
4.7.3 Procdures de sauvegarde et archivage
Le rpertoire du projet est sauvegard chaque soir par la procdure automatique du serveur.Lorsque le dveloppement d'une version de l'application est termine, la documentation est archive.Les dernires rvisions des documents applicables sont transfres dans un nouveau rpertoire identifi parle numro de la prochaine version.Lorsque l'accs immdiat un document n'est plus indispensable, le document est archiv par scurit. Sile document est prim, le responsable de la documentation veille informer tous les dtenteurs dudocument de sa cessation d'applicabilit.
5. ORGANISATION DE LA DOCUMENTATION
Le tableau des principaux documents produits par le projet est donn ci-aprs. nom : titre du document (que l'on retrouvera en page de garde du document et dans le journal de la
documentation) auteur : personne(s) charge(s) dans le projet de produire le document, de le transmettre aux
destinataires donns et de le mettre jour suite aux retours ventuels des destinataires priodicit : frquence de production du document et tape du projet concerne destinataires : liste des personnes auxquelles le document est destin pour action missions : exploitation du document faire par les destinataires :
8/3/2019 Conduite de Projet - Gestion Documentation Des Projets Informatiques
11/21
Guide mthodologique - Gestion de la documentation
CNRS/DSI/BQSD/conduite-projet/developpement/guide-gestion-doc 19 fvrier 2001 11 / 21
vrification : action de contrle de la forme et du contenu pour commentaires ouenrichissements ventuels, et pour s'assurer de la conformit aux standards dfinis surle projet (principalement dans le plan d'assurance et contrle qualit)
validation : action de donner un avis par rapport au contenu (fond) du document,permet d'tablir le document comme une rfrence au sein du projet et de passer l'tape suivante
information : diffusion pour consultation, sans retour attendu de la part du destinataire action : diffusion pour application des recommandations/dcisions donnes dans le
documentN = Nature de document (GEstion - Etude Dtaille - Etude Technique - REalisation - RCeption -FOrmation - DOcumentation - Laboratoire d'Evaluation - Mise en Oeuvre - QUalit)
5.1 Documents de gestion de projet
Nom Auteur Priodicit Destinataires Missions N
1. Gestion de projet
Planning - resp. quipe
ou
- chef de projet
runions
de
l'quipe
- quipe projet
- chef de projet
- action
- validation
GE
Journal de bord
(JBORD)
- chef de projet runions del'quipe
- quipe projet -information,action
GE
Suivi des risques
(RISQ)
- chef de projet
- resp. qualit
identification d'unrisque
- direction DSI -information,action(dcision)
GE
Dossier instancesde pilotage duprojet - comits(comptes-rendus,convocations, docde travail, listedes membres)
- chef de projet tout au long duprojet
- prsidents descomits
- membres descomits
- quipe projet
- validation
- information
- information
GE
Bilan de projet(interne DSI)
(BILAN)
- chef de projet fin du projet - resp. qualit
- quipe projet
- direction DSI
- vrification
- information
- information
GE
2. Gestion des moyens financiers
Suivi du budget(consomm etprvisionnel)
- chef de projet runion de suivide projet
- responsablegestion la DSI
- information GE
Factures - chef de projet arrive defactures
- secrtariat - action (saisieXLAB)
GE
3. Gestion de la documentation et configuration logicielle
8/3/2019 Conduite de Projet - Gestion Documentation Des Projets Informatiques
12/21
Guide mthodologique - Gestion de la documentation
CNRS/DSI/BQSD/conduite-projet/developpement/guide-gestion-doc 19 fvrier 2001 12 / 21
Journal de ladocumentation(JDOC)
- quipe projet production dedoc
- chef de projet
- responsablequalit
- information
- vrification
GE
Etat de la configu-ration logiciel
- resp. ralisation modification,livraison
- chef de projet
- quipe ralisation- resp. qualit
- information
- information- vrification
GE
4. Secrtariat / Logistique
Chrono courrier - assistante arrive/dpart decourrier
- quipe projet - information GE
5.2 Documents dtude et dveloppement
Nom Auteur Priodicit Destinataires Missions N
Dossier d'tudepralable
- quipespcification
tape d'tudepralable
- resp. qualit
- chef de projet
- comits
- vrification
- validation
- validation
EP
Dossier d'tudedtaille(spcificationsfonctionnelles)
- quipespcification
tape d'tudedtaille
- resp. qualit
- chef de projet
- comits
- quipe
ralisation- resp. mise enoeuvre
- vrification
- validation
- validation
- action
- information
ED
Dossier d'tudetechnique(spcificationstechniques)
- quiperalisation
tape d'tudetechnique
- resp. qualit
- chef de projet
- quiperalisation
- vrification
- validation
- action(code)
ET
Dossier de
programmes
- quipe
ralisation
tape de
ralisation
- resp. qualit
- quiperalisation
- vrification
- action (tests)
RE
Plan de testsunitaires etd'intgration(PTUTI)
- quiperalisation
tape d'tudetechnique
- resp. qualit
- chef de projet
- quiperalisation
- vrification
- validation
- action (tests)
RE
Plan de tests devalidation (PTV)
- quiperalisation
tape d'tudetechnique
- resp. qualit
- chef de projet
- quiperalisation
- vrification
- validation
- action (tests)
RE
8/3/2019 Conduite de Projet - Gestion Documentation Des Projets Informatiques
13/21
Guide mthodologique - Gestion de la documentation
CNRS/DSI/BQSD/conduite-projet/developpement/guide-gestion-doc 19 fvrier 2001 13 / 21
Plan de tests denon rgression(PTNR)
- quiperalisation
tape d'tudetechnique
- resp. qualit
- chef de projet
- quiperalisation
- vrification
- validation
- action (tests)
RE
Protocole derception interne(recette)
(PRCI)
- quipe rception tape d'tudedtaille - resp. qualit- chef de projet
- quipeconception
- vrification- validation
- action (tests)
RC
Dossier derception interne(cahier de recette)
(DRCI)
- quipe rception tape d'tudedtaille
(prparation de tests)
puis tape deralisation (phase de
rception)
- resp. qualit
- chef de projet
- quipeconception
- vrification
- validation
- information,action
RC
5.3 Documents relatifs la mise en oeuvre
Nom Auteur Priodicit Destinataires Missions N
1. Communication
Prsentationgnrale de projet
- charg de lacommunication
tape deprparation de lamise en oeuvre
- chef de projet
- utilisateurs
- comits
- validation
- information
- information
MO
2. Documentation d'utilisation
Manueld'utilisation
Manueld'installation
Manueld'exploitation
Manuel de
rfrence
- charg de ladocumentation
tape deprparation mise
en oeuvre
- resp. qualit
- chef de projet
- comits
- laboratoired'valuation
- sites pilotes
- utilisateurs
- vrification
- validation
- information
- action :utilisation/retours
- action :utilisation/retours
- action :utilisation
DO
3. Formation des utilisateurs
Plan de formation - charg de laformation
tape deprparation mise
en oeuvre
- chef de projet
- comits
- interlocuteursDS, DR
- validation
- validation
- information
FO
Calendrier des
formations
- charg de la
formation
tape de
prparation miseen oeuvre
- chef de projet
- interlocuteursDS, DR
- validation
- information
FO
8/3/2019 Conduite de Projet - Gestion Documentation Des Projets Informatiques
14/21
Guide mthodologique - Gestion de la documentation
CNRS/DSI/BQSD/conduite-projet/developpement/guide-gestion-doc 19 fvrier 2001 14 / 21
Support deformation(transparents +cahier d'exercice)
- charg de laformation
tape deprparation mise
en oeuvre
- quipe ralisation
- resp. mise enoeuvre- utilisateurs
- vrification
- validation
- action
FO
Fiche d'valuation
de formation
- utilisateurs
- formateurs
fin d'une session
de formation
- charg de la
formation
- information FO
Bilan de formation - charg de laformation
fin d'un ensemblede sessions de
mme type
- reponsable miseen oeuvre
- chef de projet
- comits
- information
- information
- information
FO
4. Laboratoire d'valuation
Prparation dulaboratoire
d'valuation
- ergonome DSI avant le passageen laboratoire
- quipe projet
- participants aupassage enlaboratoire
- validation
- action(tches,scnarios)
LE
Synthse desrsultats
- ergonome DSI aprs le passageen laboratoire
- chef de projet- quipe projet
- validation- action
LE
5. Rception externe (passage en site pilote)
Protocole derception externe(PRCE)
- charg des sitespilotes
avant la diffusionen sites pilote
- quipe rception
- chef de projet
- sites pilotes
- vrification
- validation
- action
MO
Dossier de rception externe(DRCE)
- charg des sitespilotes
tape de sitespilotes
- sites pilotes- chef de projet
- action(tests)- validation
MO
5.4 Documents relatifs la qualit
Nom Auteur Priodicit Destinataires Missions N
Plan d'assurance
et contrle qualit(PACQ)
- resp. qualit dbut de projet - chef de projet
- quipe projet
- validation
- action(application)
QU
Dossier de suiviqualit
(bilans,CRrevues, mesures)
- resp. qualit tout au long duprojet
- chef de projet
- quipe projet
- information
- information,action
QU
8/3/2019 Conduite de Projet - Gestion Documentation Des Projets Informatiques
15/21
Guide mthodologique - Gestion de la documentation
CNRS/DSI/BQSD/conduite-projet/developpement/guide-gestion-doc 19 fvrier 2001 15 / 21
6. ANNEXE : GLOSSAIRE DES DIFFERENTS TYPES DE DOCUMENTS
Ce glossaire est issu de la norme AFNOR Z 67-100-3 et adapt au contexte des projets DSI (le termeAFNOR correspondant est donn entre parenthses).
AA--------------------------------------------------------------------------------------------------
AIDE-MEMOIRE OU "MEMO" (AIDE-MEMOIRE)
Dfinition :
Document prsentant l'application informatique sur un support rduit (en gnral cartonn et/ou plastifi)contenant les modes d'accs aux diffrentes fonctions et les commandes disponibles.
Domaine d'application :
Documentation de mise en oeuvre - manuel d'utilisation
AIDE EN LIGNE (AIDE EN LIGNE)
Dfinition :
Support documentaire fournissant l'utilisateur les informations ncessaires l'utilisation directe del'application, par rponse interactive toute question qu'il peut se poser lors de la manipulation desprocdures mises sa disposition. Cette information s'obtient en frappant sur une touche "aide" (ou "?")et apparat dans une zone particulire de l'cran (lignes spcifiques ou fentre).
Domaine d'application :
Documentation de mise en oeuvre - manuel d'utilisation
AVENANT (DOCUMENT D'ENGAGEMENT COMPLEMENTAIRE)
Dfinition :Document contenant les lments qui modifient les conditions initiales de la convention.
Domaine d'application :
Documentation de relation contractuelle
BB--------------------------------------------------------------------------------------------------
BILAN DE PROJET (BILAN DE PROJET)
Dfinition :
Document analysant objectivement les succs ou les difficults rencontres et faisant part de toutedisposition susceptible d'tre retenue dans le futur pour l'amlioration de la qualit des produits et du
droulement des projets.Domaine d'application :
Documentation de gestion de projet.
BILAN QUALITE INTERNE (RAPPORTS D'AUDIT INTERNE)
Dfinition :
Document visant vrifier la mise en oeuvre et l'efficacit du systme qualit pour le projet. L'audit estmen indpendamment de l'avancement du projet.
Domaine d'application :
Documentation qualit
CC --------------------------------------------------------------------------------------------------
8/3/2019 Conduite de Projet - Gestion Documentation Des Projets Informatiques
16/21
Guide mthodologique - Gestion de la documentation
CNRS/DSI/BQSD/conduite-projet/developpement/guide-gestion-doc 19 fvrier 2001 16 / 21
CAHIER DES CHARGES (CAHIER DES CHARGES)
Dfinition :
Document fourni par le demandeur (client) au dveloppeur (fournisseur), dcrivant le plus explicitementpossible le contenu de la prestation et de la fourniture attendue et des ventuelles contraintes concernantles conditions techniques de dveloppement, d'exploitation et de qualit.En cas de sous-traitance avec engagement forfaitaire, doit tre suffisamment prcis, explicite et non volutifpour que le fournisseur puisse s'engager sur un budget et un dlai.
Domaine d'application :
Documentation de relation contractuelle
DD--------------------------------------------------------------------------------------------------
DOSSIER D'ETUDE PREALABLE (RAPPORTS DE L'ETUDE PREALABLE)
Dfinition :
Dossier regroupant lexpression des besoins et les exigences de ltablissement puis dcrivant de manireglobale pour lensemble du domaine dtude, les fonctions, lorganisation, larchitecture technique, les
contraintes majeures de scurit et de performance, les interfaces avec dautres systmes... Une tude delexistant approfondie peut tre mene si ncessaire. Diffrentes solutions dorganisation ou techniquespeuvent tre approfondies par les experts systmes dinformation.
Domaine d'application :
Documentation d'tude et de dveloppement
DOSSIER D'ETUDE DETAILLEE / SPECIFICATIONS DETAILLEES (FONCTIONNELLES) (RAPPORTS DE
L'ETUDE DETAILLEE)
Dfinition :
Si l'tude dtaille fait suite une tude pralable, document consistant dcrire et complter de
manire exhaustive l'avant-projet qui en est issu. Si l'tude dtaille n'est pas conscutive une tude pralable (cas des petits-projets), document
consistant prsenter la solution au plan fonctionnel avant d'en dtailler les parties sous forme despcifications de ralisation.
Document dcrivant, sous l'angle utilisateur, chacune des units d'ouvrage (cran, tat, tche...) identifie etdnombre par le projet dtaill, soumise en outre un dveloppement ultrieur.
Domaine d'application :
Documentation d'tude et de dveloppement
DOSSIER D'ETUDE TECHNIQUE / SPECIFICATIONS TECHNIQUES (DOSSIER D'ANALYSE TECHNIQUE)
Dfinition :Document prolongeant les dossiers de spcifications dtailles (fonctionnelles) et constituant la traductioninformatique des fonctionnalits raliser.
Domaine d'application :
Documentation d'tude et de dveloppement
DOSSIER DE PROGRAMMES (DOSSIER DE PROGRAMMES)
Dfinition :
Dossier visant donner une description technique de chaque programme partir des spcificationstechniques.
Ceci constituera une rfrence pour la maintenance ou pour l'volution ultrieure du systme.Domaine d'application :
Documentation d'tude et de dveloppement
8/3/2019 Conduite de Projet - Gestion Documentation Des Projets Informatiques
17/21
Guide mthodologique - Gestion de la documentation
CNRS/DSI/BQSD/conduite-projet/developpement/guide-gestion-doc 19 fvrier 2001 17 / 21
DOSSIER DE RECEPTION (DOCUMENTS DE QUALIFICATION)
Dfinition :
La rception consiste s'assurer de la conformit du logiciel aux spcifications externes, en fonction desmodalits des tests.
Selon les logiciels, elle peut porter sur : le fonctionnement de modules particuliers l'intgration la qualification fonctionnelle.On retrouve dans ce document la trace des sessions effectues par l'quipe de rception : les observations qui ont t faites la trace des dfaillances dont la description a t transmise pour correction l'quipe de
dveloppement les retours d'information sur les modifications apportes par l'quipe de dveloppement le travail de rception fait et faire.
Domaine d'application :Documentation d'tude et de dveloppement
DOSSIER DE SUIVI DE PROJET (DOCUMENTS DE SUIVI DE PROJET)
Dfinition :
Tout document permettant de matriser pas pas le bon droulement du projet et de prendre les dcisionsou les mesures correctives locales qui s'imposent. Les documents contenus dans ce dossier sont lessuivants : planning ; journal de bord ; documents relatifs aux instances de pilotage - comits ; suivi dubudget ; comptes-rendus de runion ; relev de dcisions ...
Domaine d'application :
Documentation de gestion de projet
MM -------------------------------------------------------------------------------------------------
MANUEL D'EXPLOITATION (MANUEL D'EXPLOITATION)
Dfinition :
Support permettant aux utilisateurs informaticiens (exploitants, oprateurs et pupitreurs) d'exploiterl'application informatique sur les systmes (ordinateurs, rseaux, etc.) dont ils peuvent utiliser lesressources.Ce document comprend cinq modules : un sous-dossier gnral qui sert prsenter l'application un sous-dossier spcifique de mise en exploitation : complment du manuel d'installation pour
toutes les procdures particulires de migration et de transition un sous-dossier relatif aux traitements d'exploitation courante : un sous-dossier par traitement,
qu'il s'agisse de batch, de TP (transactionnnel) ou mixte (ex. tltraitement, considr comme untraitement se droulant entre deux sauvegardes)
un sous-dossier scurit, dcrivant l'ensemble des procdures mettre en oeuvre en cas d'incident un sous-dossier archivage, dcrivant les procdures d'archivage (en matire d'indicateur
volumtrique, de date de validit ou de premption, etc.) sur un support particulier tel que bandemagntique (ou "streamer") ainsi que les procdures de restauration pour retraitements ventuels.
Domaine d'application :
Documentation de mise en oeuvre
MANUEL D'INSTALLATION (MANUEL D'INSTALLATION)
8/3/2019 Conduite de Projet - Gestion Documentation Des Projets Informatiques
18/21
Guide mthodologique - Gestion de la documentation
CNRS/DSI/BQSD/conduite-projet/developpement/guide-gestion-doc 19 fvrier 2001 18 / 21
Dfinition
Document dcrivant les tapes suivre lors de la mise en oeuvre d'une application de taille moyenne ouimportante sur un ou plusieurs gros systmes (unit centrale ou serveur). Il peut tre compos d'un ouplusieurs supports documentaires, par exemple : le guide d'installation, le guide d'installation en rseau, paramtrage, ...L'installation pour un petit logiciel sur micro-ordinateur peut tre traite dans le "manuel utilisateur".
Domaine d'application :
Documentation de mise en oeuvre
MANUEL DE REFERENCE (pas d'quivalent AFNOR)
Dfinition :
Compilation des lments contenus dans les documents d'tude et de dveloppement du logiciel (i.e.description technique de chaque cas d'erreur possible, chaque cran, chaque commande de l'application).Il peut tre compos de plusieurs supports documentaires : guide de rfrence glossaire ...
Domaine d'application :
Documentation de mise en oeuvre
MANUEL D'UTILISATION (MANUEL UTILISATEUR)
Dfinition :
Document dcrivant de faon exhaustive les procdures prvues dans l'application (descriptionfonctionnelle). Est prsent sous une forme permettant l'utilisateur final d'accder la dmarche suivredans une procdure donne, en fonction de chaque vnement. Il peut tre compos de plusieurs supportsdocumentaires, par exemple : aide mmoire guide de l'utilisateur : dcrit de faon exhaustive les procdures prvues dans l'application, le langage de requte, ... aide en ligne ...
Domaine d'application :
Documentation de mise en oeuvre
MARCHE / COMMANDE (CONVENTIONS)
Dfinition :
Engagement rciproque explicite de deux types liant contractuellement les acteurs : soit accord interneentre entits d'un mme organisme, soit contrat entre entits diffrentes ou marchs publics.
Domaine d'application :
Documentation de relation contractuelle.
PP --------------------------------------------------------------------------------------------------
PLAN D'ASSURANCE ET CONTROLE QUALITE (PLAN D'ASSURANCE QUALITE)
Dfinition :
8/3/2019 Conduite de Projet - Gestion Documentation Des Projets Informatiques
19/21
Guide mthodologique - Gestion de la documentation
CNRS/DSI/BQSD/conduite-projet/developpement/guide-gestion-doc 19 fvrier 2001 19 / 21
Document prcisant les lments qui permettent de s'assurer de la mise en oeuvre et de l'efficacit desactivits prvues pour obtenir la qualit requise.Ce document dtaille notamment les tches et relations mutuelles entre les cellules impliques dans laqualit telles que : direction de projet, quipe de production, support logistique, cellule assurance qualit,etc.Les lignes directrices du plan assurance qualit se retrouvent au niveau des documents de suivi de projet.
En cas de projet complexe ou de grande dimension, il peut tre prvu que le chef de projet enrichisse ceplan d'assurance qualit initial lors d'une premire tape d'excution du contrat.
Domaine d'application :
Documentation qualit.
PLANNING (PLAN DE DEVELOPPEMENT)
Dfinition :
Document permettant de prparer de manire dtaille l'excution du projet, notamment en terme dedmarche, de rpartition de tches et de suivi d'avancement.
Domaine d'appplication :
Documentation de gestion du projet
PLAN DE TESTS UNITAIRES ET D'INTEGRATION (PLAN DE TEST, RAPPORT DE TESTS UNITAIRES)
Dfinition :
Document dfinissant l'organisation des tests unitaires et des tests d'intgration : responsabilit, tapes,environnement de test, enchanement, planning...Le document contient galement la description des tests unitaires et d'intgration (scnario, cas de test,rsultat attendu) puis la trace des sessions de test (rsultat obtenu, fiches d'anomalie...)Les tests unitaires ont pour objectif de vrifier le fonctionnement de chaque composant logiciel unitairemodifi ou nouveau dans des cas de fonctionnement normal, aux limites ou dgrad. Ils s'appuient sur lastructure interne du composant (tests "bote blanche").Les tests d'intgration ont pour objectif de vrifier progressivement que l'ensemble constitu par lescomposants logiciels assembls rpond aux spcifications fonctionnelles et techniques. Ils doivent, s'il y alieu, activer les interfaces avec les applications connexes (progiciels et spcifiques).
Domaine d'application :
Documentation d'tude et de dveloppement
PLAN DE TESTS DE VALIDATION (PLAN DE TEST, DOCUMENTS DE QUALIFICATION)
Dfinition :
Document dfinissant l'organisation des tests de validation : responsabilit, tapes, environnement de test,enchanement, planning...Le document contient galement la description des tests de validation (scnario, cas de test, rsultatattendu) puis la trace des sessions de test (rsultat obtenu, fiches d'anomalie...)Les tests de validation ont pour objectif de vrifier que les exigences du cahier des charges sontrespectes. Ils s'effectuent sans connaissance de la structure interne (tests "bote noire").
Domaine d'application :
Documentation d'tude et de dveloppement
PLAN DE TESTS DE NON REGRESSION (PLAN DE TEST)
Dfinition :Document dfinissant l'organisation des tests de non rgression : responsabilit, tapes, environnement detest, enchanement, planning...
8/3/2019 Conduite de Projet - Gestion Documentation Des Projets Informatiques
20/21
Guide mthodologique - Gestion de la documentation
CNRS/DSI/BQSD/conduite-projet/developpement/guide-gestion-doc 19 fvrier 2001 20 / 21
Le document contient galement la description des tests non rgression (scnario, cas de test, rsultatattendu) puis la trace des sessions de test (rsultat obtenu, fiches d'anomalie...)Les tests de non rgression ont pour objectif de vrifier dans le cas d'volutions, que les modificationsapportes n'ont pas entran d'effets de bord non prvus qui pourraient dgrader le comportement dulogiciel antrieurement valid. Les vrifications peuvent porter sur les fonctionnalits disponibles, lesperformances, l'ergonomie...
Domaine d'application :Documentation d'tude et de dveloppement
PRESENTATION GENERALE DE PROJET (DOCUMENTS DE PRESENTATION GENERALE)
Dfinition :
Document usage externe ou interne apportant aux diffrents partenaires les lments minimumd'information afin qu'ils aient une vision d'ensemble de l'application et de son intgration dans l'organisation.L'information peut tre sous support papier et/ou audiovisuel, en fonction de la politique de communicationde l'entreprise.
Domaine d'application :
Documentation de mise en oeuvre.
PROCES VERBAL DE RECEPTION (DOCUMENTS DE RECEPTION)
Dfinition :Document constatant l'excution du contrat et librant les parties de leurs obligations rciproques, saufcelles dont la dure est suprieure celle de l'excution de la fourniture (ex. : rglement des sommes dues,clause de garantie, de confidentialit, etc.).
Domaine d'application :
Documentation de relation contractuelle
PROPOSITION (PROPOSITION)
Dfinition :Document par lequel un fournisseur explicite sa mthodologie de ralisation de la fourniture dcrite dans lecahier des charges soumis par son client.
Domaine d'application :
Documentation de relation contractuelle
PROTOCOLE DE RECEPTION (PLAN DE TEST)
Dfinition :Document dfinissant les principes d'organisation de la rception des produits et travaux raliss dans lecadre d'un projet : les acteurs et responsabilits, le droulement des diffrentes phases et tapes de larception, l'environnement mis en oeuvre, ...
Domaine d'application :
Documentation d'tude et dveloppement - rception interneDocumentation de mise en oeuvre - rception externe
RR--------------------------------------------------------------------------------------------------
REVUE QUALITE PROCESSUS FOURNISSEUR (pas d'quivalent AFNOR)
Dfinition :
8/3/2019 Conduite de Projet - Gestion Documentation Des Projets Informatiques
21/21
Guide mthodologique - Gestion de la documentation
Document visant vrifier l'organisation du processus de dveloppement ou de maintenance mis en uvrepar un fournisseur dans le cadre d'un march. La revue est mene indpendamment de l'avancement duprojet.
Domaine d'application :
Documentation qualit
SS --------------------------------------------------------------------------------------------------
SUPPORT POUR LES FORMATEURS (SUPPORTS POUR LES FORMATEURS)
Dfinition
Documents pdagogiques destins aux formateurs : supports de cours, tudes de cas. Ont pour objet defixer les messages transmettre, d'viter une distorsion d'information et d'assurer la cohrence del'enseignement en cas de formateurs multiples.Ils sont matrialiss par : le manuel du formateur structurant le cours dans l'espace et le temps et dcrivant les outils utiliser les outils appropris chaque module qui peuvent revtir des formes diverses :
documents crits, visuels, audiovisuels postes de travail, base de formation et cas traiter Enseignement Assist par Ordinateur (EAO) didacticiels.
Domaine d'application :
Documentation de mise en oeuvre
SUPPORT DE FORMATION (MODULES POUR LES UTILISATEURS)
Dfinition :
Ces documents, gnralement sur support papier ou dont le contenu est parfois accessible en ligne, doivent
permettre de rpondre un double objectif : former les utilisateurs la pratique de l'application leur permettre de traiter des cas complexes ou inhabituellement rencontrs.
Domaine d'application :
Documentation de mise en oeuvre