1

Documenter

Ou comment partager la connaissance

2

Plan

• Cycle de dévt logiciel

• Typologie des documents

• Technique pour rédiger des documents

• Qu’est-ce qu’une représentation?

3

Cycle de vie du logiciel

Source [LINFORMATICIEN’03j]

4

O3

NOEUD: A0 TITRE: Réaliser un projet logiciel PAGE : 1/1

Codage

Conception

Analyse

Déf pb,Etude besoins

A1

A2

A3

A4

CahierDes charges ;

Entrevue décideur

Documentconception

DocumentD‘analyse

Doc Specs ExterneCode source,Executable

Cycle de développement logiciel

5

Règle de transformation

• Seule la dernière étape est réalisée systématiquement dans le langage adapté (C++, Visual Basic, PHP, SQL, …) ;

• Pourtant– Chaque activités (étapes) du développement a

ses techniques ;– Il existe des langages, des notations adaptés à

chacune de ces transformations.

6

Le jeu des questions

• Définition du problème– Pourquoi

• Analyse– Quoi

• Conception– Comment

7

Typologie des documents

• Définition du problème, capture des besoins– Dossier de Spécifications Générales (externes)

• Analyse– Dossier de Spécifications Détaillées (internes)

• Conception– Dossier de Conception Générale

• Architecture

– Dossier de Conception Détaillée• Détail chaque module

8

DSG : plan-type

• Contexte– Audience, Glossaire

• Description Générale– Objectif du système– Fonctions principales– Contraintes générales– Caractéristiques des acteurs

• Besoins détaillés– Spécifications fonctionnelles– Spécifications opérationnelles

9

Qu’est-ce qu’un objectif ?

10

Qu’est-ce qu’une contrainte ?

Système

Décision de conception

Contraintes d’exploitation

11

Contraintes : exemple

• Contraintes architecturales– Caractéristiques des machines cibles, OS, …

• Environnementale, – Nombre de sites,

• Contrainte de déploiement– Reprise de l’existant

12

Qu’est-ce qu’un acteur ?

• Voir le support « Modèle d’usage »

13

Spécifications fonctionnelles

• Voir le support « Notation IDEF0 »

14

Spécifications opérationnelles

• Typologie– Performances

• L’ADS doit être renvoyé en moins de 10s

– Volumétrie• Traiter 500 000 TDs / an

– Maintenance• Le système est surveillé 24h/24, les jours ouvrables

– Sureté de fonctionnement• Intégrité, disponibilité du système, fiabilité, …

– Confidentialité• Lister les profils et leur prérogatives