Cahier des charges informatique

Check-lists de formulation et de structuration

A l'étape de spécification

Surtout utile à l'étape de spécification, la check-list suivante regroupe les critères que doit remplir une exigence pour être intégrée au cahier des charges.

Check-list de bonne formulation d'une exigence

Élémentaire (atomic). Ne comporte qu'un élément insécable.

Nécessaire. Utile à au moins un utilisateur ou une partie prenante.

Mesurable. Ou du moins vérifiable.

Concise. Ne contient pas de mots inutiles.

Traçable. Se rapporte à une exigence de plus haut niveau.

Réalisable et modifiable. Peut faire l'objet d'un développement.

Autosuffisante. Compréhensible indépendamment des autres.

Indépendante de la solution. Décrit un besoin ou une contrainte.

Avant le passage en validation

À toute étape de l'élaboration, cette check-list générale peut être appliquée à une exigence pour en vérifier la qualité. En fin de spécification, tous les points doivent être vérifiés.

Spécification des exigences

L'exigence est alignée sur un objectif ou un besoin validé.

L'exigence décrit un besoin ou une contrainte, et non une solution.

L'exigence satisfait au moins un besoin d'au moins un utilisateur.

L'exigence émane d'une source reconnue et légitime.

Les termes ambigus sont définis dans le glossaire.

L'exigence est traçable vers les exigences qui lui sont liées.

L'exigence est traçable quant à son origine et sa source.

L'exigence n'entre pas en conflit avec une autre exigence.

L'exigence est complète. Elle représente une fonction élémentaire.

L'exigence est non ambiguë. Elle a une seule interprétation possible.

L'exigence est concise, écrite simplement et sans mots inutiles.

Toute exigence élémentaire est « atomique » (fonction insécable).

L'exigence est formulée selon le modèle en vigueur.

L'exigence est spécifiée avec le niveau de détail adéquat.

L'exigence est spécifiée avec le formalisme adéquat.

L'exigence textuelle est grammaticalement correcte.

L'exigence est rédigée sous la forme sujet, verbe, complément.

L'exigence est vérifiable sans équivoque par un utilisateur.

L'exigence est utile. Elle a été validée par au moins un utilisateur.

L'exigence est réalisable. Elle a été validée par un expert technique.

La check-list suivante permet de vérifier le document dans sa globalité. Elle peut être utilisée préalablement à une revue formelle.

Check-list du cahier des charges

Complétude. Le document couvre la totalité du problème.

Cohérence. Il n'y a ni conflit ni redondance entre deux exigences.

Traçabilité. Toute exigence se rapporte à une exigence de plus haut niveau.

Maintenabilité. La réécriture est possible sans perte de cohérence.

Priorisation. Entre deux exigences, on peut déterminer celle qui est prioritaire.

Monosémie. Tout terme a toujours le même sens pour tous.

Fonctions de persistance (CRUD). Toute entité peut être créée (C = create), consultée (R = read), mise à jour (U = update) et supprimée (D = delete). Sinon, l'absence de cette fonction doit être justifiée.

La règle des 5 C

Votre document est-il... ?

Correct (grammaire, lois, règlements...)

Complet (ni omissions ni sous-entendus)

Clair (pas de flou ni d'ambiguïtés)

Concis (pas de mots inutiles)

Cohérent (pas de conflits entre exigences)