Conduite de Projet - Gestion Documentation Des Projets Informatiques

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.


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


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


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


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


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


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/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


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)


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 :


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


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


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


- resp. qualit

- chef de projet

- quiperalisation

- vrification

- validation

- action (tests)

RE

Plan de tests devalidation (PTV)

- quiperalisation


- resp. qualit

- chef de projet

- quiperalisation

- vrification

- validation

- action (tests)

RE


13/21



Plan de tests denon rgression(PTNR)

- quiperalisation


- 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


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


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


14/21



Support deformation(transparents +cahier d'exercice)

- charg de laformation


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


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


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).


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.


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.


Documentation qualit

CC --------------------------------------------------------------------------------------------------


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.



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.


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.



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.



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 :



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 ...


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.


Documentation de mise en oeuvre

MANUEL D'INSTALLATION (MANUEL D'INSTALLATION)


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".



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 ...



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 ...



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.


Documentation de relation contractuelle.

PP --------------------------------------------------------------------------------------------------

PLAN D'ASSURANCE ET CONTROLE QUALITE (PLAN D'ASSURANCE QUALITE)

Dfinition :


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.


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).



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").



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...


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.


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.).



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.



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, ...


Documentation d'tude et dveloppement - rception interneDocumentation de mise en oeuvre - rception externe

RR--------------------------------------------------------------------------------------------------

REVUE QUALITE PROCESSUS FOURNISSEUR (pas d'quivalent AFNOR)

Dfinition :


21/21


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.


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.



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.

