Qual é a diferença entre especificações técnicas e documentos de design?

O que são especificações técnicas? Eles são iguais aos documentos de design. Caso contrário, qual é a diferença e alguns exemplos?

Um documento de design de software pode estar no nível de um sistema ou componente e geralmente inclui:

• objetivos ou requisitos relevantes (funcionais e não funcionais);
• estrutura estática (por exemplo, componentes, interfaces, dependências);
• comportamento dinâmico (como os componentes interagem);
• modelos de dados ou interfaces externas (externas ao sistema / componente descrito no documento); e
• considerações de implantação (por exemplo, requisitos de tempo de execução, componentes de terceiros).

Observe que todas essas descrições estão em um nível abstrato. O objetivo é fornecer ao leitor uma ampla compreensão geral do sistema ou componente. Pode haver muitos níveis de documentos de design (por exemplo, em nível de sistema ou componente).

Uma especificação técnica descreve os mínimos detalhes de todas ou partes específicas de um projeto, como:

• a assinatura de uma interface, incluindo todos os tipos / estruturas de dados necessários (tipos de dados de entrada, tipos de dados de saída, exceções);
• modelos de classe detalhados, incluindo todos os métodos, atributos, dependências e associações;
• os algoritmos específicos que um componente emprega e como eles funcionam; e
• modelos de dados físicos, incluindo atributos e tipos de cada entidade / tipo de dados.

As especificações técnicas, pelo menos na forma de um projeto técnico, fazem parte dos documentos de projeto, juntamente com, por exemplo, listas de requisitos, projetos funcionais, histórias de usuários, maquetes de design gráfico, estudos de usabilidade, diagramas UML, diagramas de processos de negócios, dados especificações do modelo, etc.

As especificações técnicas do tipo que você escreve após o fato, para documentar o produto acabado, geralmente não fazem parte dos documentos de design, mas podem ser incluídas no conjunto de documentos de design de uma versão posterior (para referência) ou outro produto que confia neles.