Documente Academic
Documente Profesional
Documente Cultură
ConfigurationInterfaceforMEssageROuting
Date:05/04/07
Version:1.1
Statut:diffusable
Auteurs:
1/19
BAGNARDNatacha
FOROTJulien
Date
Modifications
0.1
17/01/07
Crationdudocument
0.2
01/02/07
ModificationdudocumentsuiteunelecturedeJrmeCamilleri
1.0
20/03/07
ValidationdudocumentparJrmeCamilleri
1.1
05/04/07
ModificationsuiteaupremierauditavecMartineTasset(fiche
audit1_040407.odt)
Tabledesmatires
1.But,porte,responsabilit.........................................................................5
1.1.Objectifdudocument......................................................................................................
............5
1.2.Portedudocument....................................................................................................................5
1.3.Responsabilitsassocies.............................................................................................................5
1.4.Procdured'volutionduPAQL...................................................................................................5
2.Documentationutilise..............................................................................5
2.1.Documentsderfrence..............................................................................................................
.5
3.Terminologie..............................................................................................6
4.Organisation..............................................................................................6
4.1.Matrised'ouvrage......................................................................................................................6
4.2.Matrised'oeuvre........................................................................................................................6
4.3.Chefdeprojet..................................................................................................
...........................7
4.4.Responsablequalit..................................................................................................................
...7
5.Cycledevie................................................................................................7
5.1.Motivationduchoix.............................................................................................................
.......7
5.2.Descriptiondestapesducycledevie..........................................................................................8
5.3.Phaseducycledevie.......................................................................................................
............8
6.Documentationproduite..........................................................................11
7.Gestiondelaconfiguration......................................................................11
7.1.Outilsdetravailcollaboratif.....................................................................................................11
2/19
7.2.Environnementtechnique.........................................................................................................12
8.Gestiondesmodifications........................................................................12
8.1.Procduredemodification........................................................................................................12
8.2.Rglesdvolutiondesnumrosdeversion.................................................................................12
8.3.Rglesd'volutiondustatut......................................................................................................12
9.Mthodes,outils,rgles,normes.............................................................13
9.1.Mthodes.............................................................................................................
.....................13
9.2.Outils.......................................................................................................................................
.13
9.3.Rglesetnormesrespecter.................................................................................................
.....13
10.Exigencesetvaluationdelaqualit.....................................................15
10.1.Facteurs....................................................................................................................
..............15
10.2.Critres..........................................................................................................................
.........16
10.3.valuation.............................................................................................................
.................16
11.Reproduction,protection,livraison.......................................................18
11.1.Procduredereproduction......................................................................................................18
11.2.Protectiondulogiciel..............................................................................................................18
11.3.Livraisonetinstallation..........................................................................................................18
12.Suividel'applicationduPAQL...............................................................18
12.1.Validationdesdocuments.....................................................................................................
...18
12.2.Relecture..........................................................................................................................
.......19
3/19
1.2.Porte du document
Cedocumentestdestin:
auresponsabledustage:JrmeCamilleri
laconsultante:MartineTasset
aujuryduMasterProGIpourl'valuationdustage
l'quipeduprojet:NatachaBagnardetJulienForot
1.3.Responsabilits associes
LeresponsablequalitestchargdelardactionduprsentPAQLainsiquedeveillerson
applicationetsonvolution,encollaborationaveclechefdeprojet.Cestluidedciderdes
actionsentreprendresilePAQLnestpasappliqu.
2.Documentation utilise
2.1.Documents de rfrence
Letableausuivantrcapitulelesprincipalessourcesdocumentairesquiserontutilisesdans
lecadredeceprojet.
But
Source
Rdactiondesdocuments
CoursdeY.Ledru
DveloppementEclipse
DocumentationEclipse
ServiceMix
DocumentationServiceMix
Petals
DocumentationPetals
4/19
But
Source
JBI
SpcificationJBI1.0JSR208
Dveloppementdelanouvelleversion
Documentationproduitepourlaversion
prcdente
3.Terminologie
LestermessuivantsontlestermesspcifiquesutilissdanslePAQL.
CdC:CahierdesCharges
CdB:CahierdeBord
DCG:Dossierdeconceptionglobale
DCD:DocumentdeConceptionDtaille
DSE:DossierdeSpcificationsExternes
PAQL:PlandAssuranceQualitLogiciel
PDL:PlandeDveloppementLogiciel
MOA:Matrised'ouvrage
MOAd:Matrised'ouvragedlgue
MOE:Matrised'oeuvre
MOEd:Matrised'oeuvredlgue
CV:Cycledevie
4.Organisation
4.1.Matrise d'ouvrage
4.1.1.MOA
Lamatrised'ouvrageestl'quipeBSOAdelasectionRechercheetDveloppementdeBull.
4.1.2.MOAd
Lamatrised'ouvragedlgueestreprsenteparJrmeCamilleri,del'quipeBSOA.Son
rleestdedonnerlesobjectifsdetravailetdevaliderlesrsultatsobtenus.
5/19
4.2.Matrise d'oeuvre
4.2.1.MOE
Lamatrised'oeuvreestleMaster2ProGnieInformatiquedel'UJFetsontreprsentant:
PhilippeLalanda.
4.2.2.MOEd
Lamatrised'oeuvredlgueestl'quipededveloppement:NatachaBagnardetJulien
Forot.LeurrleestdeproposerunesolutionlogiciellepermettantaulogicielCimerod'voluerpour
satisfairelesnouveauxbesoinsduMOAetpalierauxproblmesdelaversionprcdente,ainsique
desassurerdelabonneconduiteduprojet.
Pourcela,ilsdoiventfaireensorteque:
Touslesdocumentsdemandssoientfournis
Leplanningsoitobservetrajustduncommunaccordsibesoin
Lesnormesdequalitsoientdfiniesetrespectes
LavalidationdesdocumentssoitconformeauPAQL
LavalidationducodeproduitsoitconformeauPAQL
4.3.Chef de projet
Le chef de projet sera Julien Forot pour la priode de janvier mijuin, puis Natacha
Bagnardpourlapriodedemijuinmiseptembre.
Lechefdeprojetestresponsable:
delaplanificationduprojet
ducontrledel'avancementduprojet
delamobilisationdesmoyensncessairesdelacoordinationdestravauxdechacun
4.4.Responsable qualit
LeresponsablequalitseraNatachaBagnardpourlapriodedejanviermijuin,puisJulien
Forotpourlapriodedemijuinmiseptembre.
Leresponsablequalitapourmissionde:
dfinirlesrglesderetourarrireetlesprocduresdemodification
veillerladiffusionetaurespectdesrglesparticuliresauprojet
grerl'volutionduPAQL
6/19
superviserlesactionsdevrificationetdevalidation
5.Cycle de vie
5.1.Motivation du choix
Chaqueattenteduclientpeuttreatteinteindpendammentdesautres.L'utilisationd'un
cycledeviepermettantdedvelopperchacundesmodulesdeboutenboutsparmentestdonc
approprie.Leproduitfinalseradonclivrparlotssuccessifs.Lecycledeviechoisiestuncycle
incrmental.
Analyse des
besoins
Spcifications
externes
Conception
Codage
Test
Livraison
Illustration1
:Cycledevieincrmental
Analysedesbesoins:Cettetapepermetdeprendreencomptelesbesoinsduclient,
choisirlecycledevieadopter,dfinirleplanningetprparerl'acquisitiondesoutils
deprogrammation.
Spcificationsexternes :Cettetapepermetdedfinirprcismentl'ensembledes
fonctionnalits,d'tudierl'interfacehommemachinedusystme,deseformeraux
outilsutilissetdeprparerlestestssystme.
Conception : Cette tape permet de dfinir l'architecture interne du logiciel,
d'acqurir et d'installer les outils de programmation et de prparer les tests
d'intgration.
7/19
Codage :Cettetaperegroupelaphasedeconceptiondtailleetdecodage.Elle
permetdedtaillerprcismentlaconceptionglobaleparmoduleafindepouvoirles
dvelopperetprparerlestestsunitaires.Lecodagepermetdetraduirelaconception
dtailleenunprogramme.
Tests:Cettetapepermet,l'aidedesplansdetests,detesterlelogicieldvelopp
dans l'ordre suivant : tests d'intgration, tests systme, tests d'acceptation.
L'observationetlacomparaisonaveclesrsultatsattenduspermettrontdemodifiersi
ncessairelelogiciel.
Livraison:Livraisond'uneversionlogicieloudulogicielfinal.
Documents
Requis
Analysedes tudedel'existant,
besoins
dfinitiondes
besoins,analysedes
risquesetdela
faisabilit,
prparationdestests
d'acceptation,
tablissementdes
procduresetplans
qualit,choixdu
CV,planification,
estimationdes
ressources
Spcifications tudedtailledu
externe
logicielraliser,
prparationdestests
systme,misejour
desdocuments
tablisdansl'tape
prcdente
Produits
CdC
PDL
PAQL
CdC
8/19
Condition
Validationdu
CdcparleMOAd
Plandetests
d'acceptation
DSE
Manuel
utilisateur
Plandetests
systme
Validationdes
documentsparle
MOAd
Activits
Documents
Requis
Conception
Codage
Dfinitionde
larchitectureinterne
dulogiciel,
dfinitiondes
composants,
prparationdestests
d'intgrationetdes
testsunitaires,mise
jourdes
documentstablis
dansl'tape
prcdente
Codage,
documentationdes
composants,mise
jourdesdocuments
tablisdansl'tape
prcdente
Tests
Ralisationdesjeuxde
tests,correctiondu
codesibesoin,mise
jourdesdocuments
tablisdansl'tape
prcdente
Livraison
Ralisationdestests
d'acceptationparle
client
DSE
Produits
DCG
DCD
DCG
DCD
Ensemble
desplansde
tests
Jeuxdetests
d'acceptation
9/19
Condition
Plandetests
d'intgration
etdetests
systme
Rapportsde
tests
Validationdes
documentsparle
MOAd
Jeuxde
tests
concluant
6.Documentation produite
Al'issuedeceprojet,plusieursdocumentsauronttproduits.Certainsdevronttrelivrs
avecleproduitfini,certainsserontdisponiblessileclientlessouhaiteetcertainsneservirontqu'
l'quipededveloppement.Letableausuivantprcisepourchaquedocumentsontstatut.
Document
Statut
Cahierdescharges
Livrable
Pland'assurancequalitlogicielle
Livrable
Plandedveloppementlogiciel
Priv
Dossierdespcificationsexternes
Livrable
Dossierdeconceptionglobale
Consultable
Dossierdeconceptiondtaille
Consultable
Plansdetests
Livrable
Jeudetests
Livrable
Manuelutilisateur
Livrable
Livrable:Doittrefournitauclient
Consultable:Peuttreconsultparleclient
Priv:Destinl'quipeduprojetuniquement
7.Gestion de la configuration
Laconfigurationestl'ensembledeslmentssuivants:codesourceexcutable,outilsde
dveloppementetdetestutiliss,documentsetdonnes.
CVS(ConcurrentVersionsSystem)
Cet outil permet de partager le code source d'un logiciel et d'intgrer facilement les
modificationsdefichiersd'undveloppeuravantdelesmettredispositiondesautresutilisateurs.
Ilpermetgalementdedisposerd'unhistoriquedetouteslesmodificationsetdesdiffrentes
versionsduprojet.Leretouruneversionprcdenteencasdeproblmeestfacilit.
10/19
BullForge
Bullpossdeunsitequipermetauxquipesdedveloppementdecollaborerefficacement
grceadesoutilscommelesforumsetlesmailingslist.Bullforgefournitaussidesoutilsdetravail
collaboratifcommeCVSouSubversion.
Mailinglist
L'inscriptionauxmailinglistdesprojetsassocisestessentielpourprendreenmainles
outilsettreaucourantdesnouvellesversionsetdescorrectionsd'erreurs.
7.2.Environnement technique
LedveloppementseraeffectusousenvironnementLinux(Debian).LepluginpourEclipse
seradveloppsurlaversion3.3del'IDE.LaJDK1.5serautilisepourledveloppementJAVA.
Dtectiond'uneanomalie
Demanded'volution
Danslecasd'unedtectiond'anomalie,ilfautentrouverlasourcepuislacorrigerdansles
plusbrefdlais.
Danslecasd'unedemanded'volutiondulogicielparleclient,ilfautdansunpremiertemps
raliserunetudedefaisabilit,pourensuitemodifierlelogicielenconsquencesicelas'avre
ralisabledanslesdlaisimpartis.
LesmembresduMOEdsontresponsablesdelamiseenoeuvredecesmodifications.
Onincrmentelenumrodecorrection
Initial :Ledocumentestencoursderdaction,iln'estpasdiffusable,mmeen
interne.
Diffusable :Ledocumentestrdig,ilpeuttrediffuseninternemaisiln'apas
encoretvalid.
Final:Ledocumenttvalid.Ilpeuttreconsulteroulivrer.
Analysedesbesoins:Prparationdestestsd'acceptation
Spcificationsexternes:Prparationdestestssystmes
Conceptionglobale:Prparationdestestsd'intgration
Conceptiondtaille:Prparationdestestsunitaires
Cestestsdevronttreprparsaufuretmesuredel'avancementduprojet.Ainsi,chaque
tape,ilsdevronttrerpertorisdansledocumentPlanDeTests*.odt.
9.2.Outils
Letableausuivantrcapitulelesoutilsquiserontutilissdanslecadredeceprojet.
Fonctions
Outils
Editeurdetexte
OpenOfficeWriter
EditeurUML
Dia/OMONDO
Environnementdedveloppement
Eclipse
Dveloppementcollaboratif
CVS,BullForge,Mailinglist
Gestiondeprojets
Planner
ESB
ServiceMix,Petals
12/19
pagedegarde
Nomduprojet
Nomdudocument
Datedederniremodification
Numrodeversion
Auteur(s)
Cartouched'entte:LogoBull,nomdudocument,logoduprojet
pagesuivantes
Cartouched'entte:LogoBull,nomdudocument,logoduprojet
Numrodepage
Nombredepages
9.3.2.Rgles de programmation
Le systme sera dvelopp en langage Java. Nous adopterons donc les rgles qui s'y
appliquent,notamment:
Enenttedeclasse
Datedecrationdelaclasse
Auteur
Historiquedesmodifications
Pourchaquemthode
Descriptionsuccinctedelamthode
Descriptiondesparamtresutiliss
Descriptiondelavaleurderetour
Conventiondenommage
Le nom d'une classe commence par une majuscule. Si ce nom est luimme
13/19
composdeplusieursnoms,chacund'entreeuxcommenceparunemajuscule.Les
autreslettressontenminuscules.
publicclassComposant{}
publicclassTypeComposant{}
Lenomd'unemthodeoud'unevariablecommenceparuneminuscule.Sicenom
estluimmecomposdeplusieursnoms,chacund'entreeuxcommenceparune
majuscule.Lesautreslettressontenminuscules.
Exemple:
Exemple:
publicvoidinit(){}
publicvoiddoPost{}
Lenomdesvariablesdoittresignificatifpourunemeilleurecomprhensiondu
code.
Lerespectdecesrglesdeprogrammationdevratrevrifil'aidedeCheckStyle(plugin
Eclipse). Un minimum d'avertissements devra tre prsent. Aucun seuil n'est fix carcertaines
erreursdeCheckStylen'ontpasungrandimpactsurlestyledeprogrammationmaisncessitepar
contreungrandinvestissemententemps.
Ils'agiradoncderduireaumaximumlenombred'avertissementsenperdantunminimum
detemps.
9.3.3.Normes sur les comptes-rendus de runions
Chaque audit donneralieulardactiond'uncompterendu.Celuicisecompose de la
maniresuivante:nom_date.
nom:nomdelarunion(audit1,audit2ouaudit3)
jj:lenumrodujoursur2chiffres
mois:lenumrodumoissur2chiffres
aa:lenumrodel'annesur2chiffre
Parexemple,lecompterendudel'auditdu15mars2007seraitnomm:audit1_150307.
9.3.4.Normes sur les documents livrables
Chaquedocumentpossdeunnumrodeversiondelaformex.y.
Toutincrmentdupremierindice(x)impliqueunchangementnotoiredudocument.Tout
14/19
incrmentdusecondindice(y)impliqueunemodificationminimedudocument.
9.3.5.Normes sur les fiches de relecture
Chaquediffusiond'undocumentdonnelieuunerelectureetauremplissaged'unfichede
relecture.Cellecisecomposedelamaniresuivante:nomDocAssoci_Relecteur_Date.
nomDocAssoci:Lenomdudocumentabrgassocilafichederelecture
Relecteur:Lenomdurelecteur
Date:Ladatedecrationdelafiche
Parexemple,lafichederelectureassocieauPland'AssuranceQualit(PAQL)crerpar
JrmeCamillerile7fvrier2007seranomme:PAQL_Camilleri_06022007.Unmodlede
ficheestfourni:Modele_fiche_relectureainsiqu'uneficheexplicativeannexe:
PAQL_Fiche_relecture.
Maintenabilit:Aptitudedulogicielpouvoirtrecorrigfacilement.
Portabilit : Aptitude du logiciel tre transfr d'un matriel et/ou d'un
environnementlogicielunautre.
15/19
10.2.Critres
Chaquefacteurestlidescritresprcis.Parmiceuxci,unminimumde4 critrespar
facteurdevratreassur.
Maintenabilit
Portabilit
Tracabilit
Simplicit
Instrumentation
Modularit
Consistance
AutoDescription
Simplicit
Indpendancelogicielle
Modularit
Indpendancemachine
Autodescription
Concision
Communicabilit
Principauxcritresretenus
Autrescritres
10.3.valuation
Lapartiesuivanteprsentelesmesuresquiseronteffectuespourquantifierlerespectde
chaque critre slectionn. Les conditions de validation de chaque critre seront galement
prcises.
10.3.1.Modularit
Lamodularitestl'aptituded'unlogicieltrecomposdemodulesindpendants.Comme
lelangagedeprogrammationutilisdansceprojetestJAVA,lamodularitseracalculeenfonction
dunombredelignesdecode(LOC)composantchaqueclasse.
Lataillemaximalerecommanded'uneclasseJAVAestde500lignesdecode.Audel,le
codedevienttropcomplexe.
Uneclasseseraconsidrevalidesiellerespectel'expressionsuivante:
16/19
ClasseValide=NombreDeLignesDeCode<500
Lecritremodularitseradoncmesurparl'expressionsuivante:
Modularit=10*(NombreDeClassesValides/NombreTotalDeClasses)
Conditiondevalidationdececritre:
Lanotesur10obtenuedevratresuprieure8.5.
10.3.2.Auto-description
L'autodescription est l'aptitude d'un logiciel fournir la description de chacune de ses
fonctions.CommelelangagedeprogrammationutilisdansceprojetestJAVA,ilserapossiblede
rdigerdelajavadocainsiquedescommentairesavantchaquefonctionpourspcifiersonrle,ses
attributs,savaleurderetour,...Delammefaon,lecorpsdesfonctionsdevratrecommentafin
derestercomprhensible.
Uneclasseseraconsidrevalidesiellerespectel'expressionsuivante:
ClasseValide=NombreDeLignesDeCommentaires/NombreDeLignesDeCode>30%
Lecritreautodescriptionseradoncmesurparl'expressionsuivante:
AutoDescription=10*(NombreDeClassesValides/NombreTotalDeClasses)
Conditiondevalidationdececritre:
Lanotesur10obtenuedevratresuprieure8.5.
10.3.3.Indpendance logicielle
L'indpendance logicielle est l'aptitude d'un logiciel ne pas tre li, de par son
fonctionnement,unenvironnementlogicielparticulier.Pourrespectercecritre,lelogicielissude
ceprojetdevrafonctionnerpareillementsousWindowsXP2000etsousLinux(Debian).
Lecritreindpendancelogicielleseradoncmesurparl'expressionsuivante:
Indpendancelogicielle=10*(FonctionneIndependamentDeL'OS)
Conditiondevalidationdececritre:
Lanotesur10obtenuedevratregale10.
17/19
10.3.4.Indpendance matrielle
L'indpendance matrielle est l'aptitude d'un logiciel ne pas tre li, de par son
fonctionnement,unenvironnementmatrielparticulier.Pourrespectercecritre,lelogicielissude
ceprojetdevrafonctionnerpareillement(sansprendreencomptelaperformance)surdiffrentes
configurationsdemachines.
Lecritreindpendancematrielleseradoncmesurparl'expressionsuivante:
Indpendancematrielle=10*(FonctionneSurPlusieursConfigurationsDeMachines)
Conditiondevalidationdececritre:
Lanotesur10obtenuedevratregale10.
10.3.5.
10.3.6.Simplicit
Lasimplicitestl'aptituded'unlogicielavoirunfonctionnementinternecomprhensible
facilement.Pourcela,desrglesdeprogrammationonttprises(voirchapitreIX.3.B).
Unefonctionseraconsidrevalidesiellerespectel'expressionsuivante:
FonctionValide=NormesDeProgrammationRespectes(vraioufaux)
Lecritresimplicitseradoncmesurparl'expressionsuivante:
Simplicit=10*(NombreDeFonctionsValides/NombreTotalDeFonctions)
Conditiondevalidationdececritre:
Lanotesur10obtenuedevratresuprieure8.5.
11.2.Protection du logiciel
Aucuneprotectiondulogicieln'estprvu.
11.3.Livraison et installation
Lelogicielfinalseraremisl'quipeBSOA.Ilcontiendralecodesourcedel'application,
ainsiqueleplugindvelopps.
18/19
LesdocumentslivrablesserontfournisdansunrpertoireCimerov2Doc.Lesrglesde
nommagedecesfichierssontexplicitesdanslechapitre9.4.
Cepluginserainstalldansl'IDEeclipsesurunemachinedel'entrepriseBull.Unautre
exemplaireserautilispourlasoutenancedestagedel'quipededveloppement(septembre2007).
LorsdelalivraisonduproduitBull,uneprocdurecomplted'installationserafournie
(dans le manuel utilisateur) afin de permettre des personnes trangres l'quipe de
dveloppementd'installeretd'utiliserleproduitsansdifficults.
12.2.Relecture
La lecture croise sera effectue au minimum par les 2 membres de l'quipe de
dveloppement(l'unrdige,l'autrerelit)etparleMOEd.
L'auteurd'undocumentassurelaralisationdescorrectionspropossparlesrelecteurset
grelechangementdesnumrosdeversions.
L'enchanementdestchesestlesuivant:
Crationdudocument
1
Diffusionauxrelecteurspotentielsaveclafichederelecture associe
Intgrationdesmodificationsparl'auteuretmodificationventuelledunumrode
versionenfonctiondesmodificationseffectues
Validation finale, aprs plusieurs cycles de diffusioncorrection, effectue par le
MOEdJrmeCamilleri
1 Voirdocumentannexe:PAQL_Fiche_relecture.odt,pourplusdeprcision
19/19