62 votes

Modèles de spécifications techniques et fonctionnelles

En gros, je cherche de bons modèles pour rédiger les spécifications techniques et fonctionnelles d'un projet ou d'une demande de travail.

Qu'utilisez-vous ? Jusqu'où allez-vous dans la rédaction des spécifications ? Tout autre conseil général que vous pourriez fournir serait apprécié.

Mon entreprise en a cruellement besoin. Je travaille pour un entrepreneur et pour l'instant nous n'utilisons pas du tout ces documents.

EDIT : J'ai lu le point de vue de Joel sur Spécification indolore J'ai beaucoup aimé, mais y a-t-il d'autres avis :)

32voto

Mark Nold Points 3553

Des conseils généraux ;

Nous mettons en œuvre un processus de

1) Énoncé des besoins de l'entreprise (BRS)

2) Spécification fonctionnelle

3) Spécifications techniques

Le BRS couvre les problèmes de l'entreprise et les exigences en matière de solutions, de tests, de sécurité, de fiabilité et de livraison. Cela définit ce qui ferait une solution réussie.

La spécification fonctionnelle détaille ce qui est nécessaire, l'aspect du produit, la longueur des champs, etc.

Les spécifications techniques détaillent la provenance des données, ainsi que tout code délicat à prendre en compte.

Le client possède les exigences. Les développeurs possèdent les spécifications techniques, et les spécifications fonctionnelles sont un moyen terme. Les tests sont effectués par rapport aux spécifications techniques (généralement les tests unitaires), puis par rapport aux spécifications fonctionnelles (généralement les tests système) et enfin par rapport aux exigences (UAT).

La partie importante de tout cela (et avec laquelle nous avons du mal) est que les développeurs doivent toujours respecter les spécifications fonctionnelles et les exigences commerciales initiales. En réalité, les spécifications fonctionnelles et techniques ne sont là que par souci de clarté.

En résumé, mon principal conseil est de commencer par élaborer le processus que vous souhaitez mettre en œuvre. Ensuite, recherchez l'accord de toutes les parties concernées par le processus que vous proposez, puis travaillez sur les modèles pour les adapter. Les modèles eux-mêmes ne représentent qu'une petite partie du changement que vous souhaitez apporter.

18voto

Galwegian Points 29966

Ce n'est pas un modèle, mais Joel a écrit une quelques articles sur l'écriture d'une spécification fonctionnelle. Il a également échantillon ici .

7voto

Guy Starbuck Points 14241

Vous pouvez acheter des modèles à l'ieee et dans d'autres endroits, mais j'ai toujours fini par créer les miens.

Pour une spécification technique, " Code complet " de Steve McDonnell contient une bonne liste de contrôle, vous pouvez y puiser des informations. Dans mon dernier emploi, j'ai simplement créé un modèle à partir de ses en-têtes de section, et je l'ai modifié à partir de là.

Pour ce qui est d'une spécification fonctionnelle, l'important est de définir toutes les interfaces :

  1. UI (maquettes d'écran)
  2. Interfaces logicielles (plugins, etc.)
  3. Interfaces matérielles (le cas échéant)
  4. Interfaces de communication (services, courrier électronique, messagerie, etc.)

Il devrait également y avoir une section pour les règles de gestion, les choses qui sont importantes sur le plan fonctionnel et qui ne sont pas couvertes par une définition d'interface.

6voto

Thomas Owens Points 45042

Si vous voulez acheter un livre, Besoins en logiciels par Karl Wiegers a des modèles pour quelques documents en annexe. Malheureusement, je suis au travail et ce livre est à la maison. Si quelqu'un l'a sous la main, il pourra peut-être le confirmer.

5voto

Ben Collins Points 11318

Il se trouve que j'aime bien celui-ci, parmi d'autres : ReadySet .

Il vend aussi une version pro.

Prograide.com

Prograide est une communauté de développeurs qui cherche à élargir la connaissance de la programmation au-delà de l'anglais.
Pour cela nous avons les plus grands doutes résolus en français et vous pouvez aussi poser vos propres questions ou résoudre celles des autres.

Powered by:

X