Guide pour la rédaction d’une Spécification …

1 Manuel SP2_MA Guide pour la r daction d une Sp cification Technique de Besoin Date cr ation : 23/09/08 Page 1 sur 8 Ce document est la copropri t du CEA/CNRS. Il ne peut tre reproduit ou diffus sans l autorisation de l quipe direction de projet SPIRAL2. Guide pour la r daction d une Sp cification Technique de Besoin (STB) R dacteurs : St phanie Perret-Gatel Philippe Laborie Ce document est un Guide pour vous aider r diger une Sp cification Technique de Besoin (STB). Il doit tre adapt en fonction de l quipement/ produit consid r . Guide pour la r daction d une STB Page 2 sur 8 Ce document est la copropri t du CEA/CNRS. Il ne peut tre reproduit ou diffus sans l autorisation de l quipe direction de projet SPIRAL2. La Sp cification Technique de Besoin est un document qui traduit le besoin d un demandeur en termes d exigences et contraintes techniques (sp cifications).

2 Ce document est approuv par le demandeur, il est en g n ral crit conjointement par le demandeur et le concepteur/r alisateur et plus rarement par le demandeur seul. La STB doit tre suffisante pour qu'un concepteur puisse laborer une d finition du produit qui y r ponde sans ambigu t . Avec le Dossier de D finition (DD) (cf. SP2_MA_8111_I012776) et le Dossier Justificatif de la D finition (DJD) (cf. SP2_MA_8111_I012779), elle forme un ensemble de documents destin s fournir la base du syst me documentaire relatif tout produit mat riel ou logiciel. Pour tablir la STB, on peut s appuyer, s il existe, sur le Cahier des Charges Fonctionnel. La STB est initi e d s le d but de l tude de faisabilit (on parle alors de STB pr liminaire en fin de phase de faisabilit ), elle est progressivement enrichie pendant les tudes de conception.

3 Cette STB doit tre fig e et approuv e avant le d but de la phase de r alisation. Si celle-ci doit malgr tout tre modifi e en cours de r alisation, ces modifications devront au pr alable tre approuv es par toutes les parties concern es et trac es dans un document (cf. SP2_MD_8111_014676). Sommaire type d une Sp cification Technique de Besoin 1. OBJET DU DOCUMENT .. 3 2. DOCUMENTATION DE REFERENCE .. 3 3. GLOSSAIRE .. 3 4. PRESENTATION GENERALE DU PRODUIT .. 3 Le produit et son concept .. 3 Profil de vie .. 4 Exigences principales .. 4 Fonctions .. 4 Cha ne fonctionnelle .. 4 Description fonctionnelle .. 5 Constituants principaux .. 5 5. EXIGENCES .. 5 Exigences et contraintes techniques .. 5 Exigences op rationnelles .. 6 Exigences de S ret nucl aire applicables au produit .. 7 Exigences d'interfaces.

4 7 Exigences relatives aux conditions d'acceptation du produit .. 8 6. CONTRAINTES .. 8 Exigences d' tudes et solutions impos es .. 8 Exigences d'environnement .. 8 Guide pour la r daction d une STB Page 3 sur 8 Ce document est la copropri t du CEA/CNRS. Il ne peut tre reproduit ou diffus sans l autorisation de l quipe direction de projet SPIRAL2. 1. OBJET DU DOCUMENT Dans ce chapitre doivent figurer les informations g n rales qui d finissent le but et le domaine d'application de la sp cification. Exemple Cette sp cification d finit les exigences relatives aux performances d un dispositif de mesure d intensit faisceau ainsi que son domaine de fonctionnement (type de faisceau mesur , dynamique de mesure). 2. DOCUMENTATION DE REFERENCE Il s'agit de l'ensemble des documents qui doivent imp rativement tre appliqu s pour la d finition du produit (exemple : documents d'interface) mais aussi les documents qui constituent la bibliographie n cessaire l' laboration de la STB.

5 : Calculs, r sultats de simulations, articles, comptes-rendus de r unions, Cahier des Charges Fonctionnel s il Exemples [DR1] Dossier de contr le des interfaces [DR2] Arborescence produit / PBS du projet [DR3] Cahier des Charges Fonctionnel [DR4] Document de synth se de l tude de faisabilit .. 3. GLOSSAIRE La terminologie et les sigles utilis s dans le document seront explicit s dans ce paragraphe. On pourra ventuellement faire r f rence au glossaire du projet SP2_MA_8111_I008775 (le lister alors dans les documents de r f rence). 4. PRESENTATION GENERALE DU PRODUIT Il s agit dans les diff rentes rubriques de ce paragraphe de donner une description simple du produit d velopper. Pour cela, on suivra une logique partant de la formulation du besoin et aboutissant au produit r aliser. Dans les sous-paragraphes , on num rera : - les besoins fondamentaux qui n cessitent la cr ation du produit, - les fonctions attendues, dans les grandes lignes, sans pr sager dans un premier temps de la solution retenue.

6 Nota : dans le cas o un CdCF (Cahier des Charges Fonctionnel) a t r dig , il comporte d j ces informations. Le CdCF sera ajout dans la documentation de r f rence et on pourra se dispenser de r diger les rubriques La cha ne fonctionnelle ainsi que l arborescence produit correspondant la solution propos e ( ) est d duite de ces informations. Le produit et son concept Ce paragraphe synth tise le besoin fonctionnel du produit et d crit le concept retenu. Guide pour la r daction d une STB Page 4 sur 8 Ce document est la copropri t du CEA/CNRS. Il ne peut tre reproduit ou diffus sans l autorisation de l quipe direction de projet SPIRAL2. Exemple Le dispositif devra tre capable de mesurer des doses moyennes sur un champ d exposition pr d fini et d exprimer la mesure en valeur num rique qui pourra tre lue et m moris e p riodiquement.

7 En outre, le dispositif donnera la position du faisceau d irradiation avec une fr quence de r p tabilit lev e permettant de suivre le d placement du faisceau sur le champ d exposition. Pour cela, nous associerons un ensemble de d tecteurs et capteurs une acquisition rapide. Profil de vie Ce paragraphe doit d crire les phases successives de l utilisation du produit jusqu son retrait de service (arr t). Exigences principales Essayer de r pondre aux questions suivantes : Dans quel but le produit est-il cr ? Quels sont les enjeux (scientifiques, technologiques, ou en terme de ) ? Sur quoi le produit agit-il (param tres, environnement, ) ? Qu est-ce qui pourrait le faire voluer, le modifier ? Fonctions On d crit dans ce sous-paragraphe les diff rentes fonctions que le produit doit remplir. On trouve deux types de fonctions : les fonctions essentielles (auxquelles on pense toujours !)

8 Et les fonctions secondaires (qui peuvent d couler des fonctions principales ou bien de l environnement du produit, ou encore de ses interfaces). Ces fonctions sont ind pendantes de la solution retenue. Exemples Exemple de fonction essentielle Le dispositif de mesure de dose devra tre capable de mesurer des doses moyennes sur les champs d exposition dans la gamme comprise entre Gy et Gy avec une pr cision relative de +-5%. Cette dose s entend dans l eau et l entr e de la cible. Exemple de fonction secondaire L utilisateur devra pouvoir disposer d un fichier lui indiquant la dose finale re ue par chaque chantillon et des valeurs interm diaires avec un pas de temps qui sera typiquement de 1/5 du temps d irradiation pour les dur es les plus courtes et 1/10 pour les plus longues. Cha ne fonctionnelle Il s agit de r pondre ici la question comment le produit fonctionne ?

9 Pour cela, on donnera un sch ma. Les explications associ es au sch ma sont donn es dans le sous-paragraphe suivant (voir exemple). Guide pour la r daction d une STB Page 5 sur 8 Ce document est la copropri t du CEA/CNRS. Il ne peut tre reproduit ou diffus sans l autorisation de l quipe direction de projet SPIRAL2. Exemple La cha ne fonctionnelle peut tre r sum e ainsi : FaisceauLocalisation+EnergieGestiondesEn tr es/SortiesVisualisationD tecteursAcquisition&synchronisationContr les Description fonctionnelle Exemple Le faisceau en passant au travers des d tecteurs (ou en s y arr tant), d pose une nergie. Cette nergie est r cup r e par les d tecteurs qui d livrent galement une information de localisation ( monitoring ). Ces informations ( nergie d pos e + localisation) sont envoy es vers le module de gestion des entr es sorties.

10 Ce m me module assure la synchronisation des diff rents d Constituants principaux Ce paragraphe d crit la d composition arborescente du produit en ses principaux constituants. Exemple Le dispositif peut se subdiviser en 3 constituants principaux : - un module mesure et localisation donnant l information nombre d ions et la localisation faisceau. Ce module est compos d une chambre d ionisation (appel e aussi moniteur ionisation) et de deux capteurs effet Hall, - un module talonnage qui permet d talonner les d tecteurs (conversion perte d nergie / nombre d ions) et les capteurs effet Hall (conversion amplitudes des champs magn tiques / position absolue), - un module acquisition et synchronisation qui g re les entr es / sorties, synchronise les d tecteurs et g re le stockage des donn es acquises.