Quelle est la différence entre les spécifications techniques et les documents de conception?
Quelles sont les spécifications techniques? Sont-ils les mêmes que les documents de conception. Sinon, quelle est la différence et quelques exemples?
Un document de conception de logiciel peut être au niveau d'un système ou d'un composant, et comprend généralement:
- objectifs ou exigences pertinents (fonctionnels et non fonctionnels);
- structure statique (par exemple, composants, interfaces, dépendances);
- comportement dynamique (comment les composants interagissent);
- modèles de données ou interfaces externes (externes au système/composant décrit dans le document); et
- considérations de déploiement (par exemple, exigences d'exécution, composants tiers).
Notez que toutes ces descriptions sont à un niveau abstrait. Le but est de donner au lecteur une large compréhension générale du système ou du composant. Il peut y avoir plusieurs niveaux de documents de conception (par exemple, au niveau du système ou des composants).
A spécification technique décrit les moindres détails de toutes ou de parties spécifiques d'une conception, telles que:
- la signature d'une interface, y compris tous les types/structures de données requis (types de données d'entrée, types de données de sortie, exceptions);
- des modèles de classe détaillés comprenant toutes les méthodes, attributs, dépendances et associations;
- les algorithmes spécifiques qu'un composant utilise et comment ils fonctionnent; et
- modèles de données physiques, y compris les attributs et les types de chaque entité/type de données.
Les spécifications techniques, au moins sous la forme d'une conception technique, sont en partie des documents de conception, avec, par exemple, des listes d'exigences, des conceptions fonctionnelles, des histoires d'utilisateurs, des maquettes de conception graphique, des études d'utilisabilité, UML diagrammes, diagrammes de processus métier, spécifications de modèle de données, etc.
Les spécifications techniques du type que vous écrivez après coup, pour documenter le produit fini, font pas généralement partie des documents de conception, mais elles peuvent être incluses dans l'ensemble des documents de conception d'une version ultérieure ( pour référence) ou un autre produit qui en dépend.