Comprendre les exigences et la documentation système

Qu'est-ce qu'une exigence ?

Un besoin peut être défini comme un attribut indispensable dans un système, représentant une capacité, une caractéristique ou un facteur de qualité utile aux clients ou aux utilisateurs finaux.

Une exigence est la description d'un état ou d'une capacité qu'un système doit satisfaire, qu'elle soit dérivée d'un besoin précis des utilisateurs, d'un contrat, d'une norme, d'une spécification ou de tout autre document formellement imposé au début du processus.

Exigences types

Les prescriptions concernant les logiciels peuvent être divisées en deux catégories : les exigences fonctionnelles et non fonctionnelles.

• Les exigences fonctionnelles : elles définissent les fonctions que le système sera capable d'exécuter, décrivant les transformations appliquées aux intrants pour produire les extrants.
• Les exigences non fonctionnelles : elles sont liées aux caractéristiques qui limitent le système, par exemple : les performances (temps et espace), les interfaces utilisateur, la fiabilité (robustesse, disponibilité), l'entretien, la sécurité, la portabilité, les normes et l'auditabilité.

Caractéristiques d'une exigence

Il est important de garder à l'esprit que l'exigence doit être :

• Indiquée par écrit : comme dans tout contrat ou accord entre deux parties.
• Vérifiable : si une demande ne peut être prouvée, comment savoir si elle a été satisfaite ?
• Concise : facile à lire et à comprendre. L'écriture doit être simple et claire pour toute référence future.
• Complète : sans avoir besoin de détails supplémentaires, fournissant assez d'informations pour être comprise.
• Conforme : elle ne doit pas contredire d'autres exigences.
• Sans ambiguïté : elle ne doit avoir qu'une seule interprétation possible pour éviter toute confusion.

Normalisation

La normalisation signifie que des symboles standardisés sont utilisés dans tous les diagrammes de flux et la documentation. Bien que les normes varient, il est essentiel au sein d'une organisation d'utiliser une seule méthode. L'utilisation de procédures standardisées est la base d'une communication claire, réduisant les coûts et facilitant la formation du personnel.

Avantages de la normalisation

• Aide à la formation du personnel.
• Utile pour la responsabilité de l'entretien des systèmes.
• Permet aux analystes et concepteurs de travailler sur l'intégration des systèmes.
• Assure le bon fonctionnement du système et l'utilisation efficace des ressources.

Normes de documentation de base

Toute documentation, qu'elle soit manuelle ou informatique, doit être clairement étiquetée, organisée, complète et à jour.

Normes de documentation technique

Une bonne documentation est indispensable pour la conception et l'entretien des systèmes. Elle doit contenir au moins les six éléments suivants :

1. Une spécification : décrit ce que le circuit ou le système doit faire (entrées/sorties).
2. Un schéma fonctionnel : description picturale des modules principaux.
3. Un schéma électrique : spécification formelle incluant les détails de construction (types de CI, broches).
4. Un chronogramme : montre les valeurs logiques des signaux en fonction du temps.
5. Une description du dispositif : indique la fonction interne (ex: VHDL, FPGA, ASIC).
6. Une description du circuit : document narratif expliquant le fonctionnement interne, les hypothèses et les risques.

Schémas et diagrammes

Schéma logique : les portes sont dessinées avec les entrées à gauche et les sorties à droite.

Chronogrammes : ils montrent le comportement d'un signal numérique en fonction du temps et définissent les exigences temporelles.

Fig. 3.5.c : Mémoire morte délai de 80486