Please enable JavaScript.
Coggle requires JavaScript to display documents.
UE 4 Documentação de Requisitos (N2) (Critérios de qualidade para…
UE 4 Documentação de Requisitos (N2)
Design do documento
Todas as formas de representação de requisitos são denominadas técnicas de documentação
A documentação tem papel de respaldo na comunicação e no estabelecimento de metas
Uma técnica de documentação é qualquer tipo de representação mais ou menos formal que facilita a comunicação entre stakeholders e aprimora a qualidade dos requisitos documentados
Requisitos formam a base para o desenvolvimento do sistema
Requisitos têm relevância legal. Documentar os requisitos pode ajudar a rapidamente resolver conflitos legais.
Documentos de requisitos são complexos. Sem uma documentação adequada, manter a situação sob controle pode se tornar bastante difícil para os envolvidos
Requisitos devem ser acessíveis para todas as partes envolvidas. Quando os requisitos podem ser acessados de forma permanente, evitam-se incertezas e desconhecimentos, e novos membros da equipe podem rapidamente colocar-se a par do projeto
Tipos de documentação
3 perspectivas dos requisitos
Perspectiva estrutural
Adota-se uma perspectiva estático-estrutural dos requisitos do sistema
Exemplo: a estrutura dos dados de entrada e saída, os aspectos estático-estruturais de uso, bem como as relações de dependência entre o sistema e o contexto do sistema
Perspectiva comportamental
Documenta informações sobre o sistema e sobre como o sistema está integrado ao contexto do sistema a partir dos estados do sistema
Perspectiva funcional
Documenta quais informações são recebidas do contexto do sistema e processadas pelo sistema ou por uma de suas funções.
Formas eficazes de documentação
A documentação de requisitos em linguagem natural
É apropriada para documentar requisitos em qualquer das 3 perspectivas
Desvantagem: pode resultar em requisitos ambíguos e os requisitos de diferentes tipos e perspectivas correm o risco de serem misturados
Vantagem: Nenhum stakeholder precisa aprender uma nova notação
Modelos de requisitos usando modelos conceituais
Retrata os requisitos documentados de forma muito mais compacta, sendo assim de compreensão mais fácil para um leitor treinado
Oferecem um menor grau de ambiguidade devido ao seu maior grau de formalidade
Tipos:
Diagrama de caso de uso:
Permite obter uma rápida visão geral das funcionalidades do sistema especificado
Um caso de uso descreve quais funções são oferecidas ao usuário pelo sistema e como essas funções se relacionam na interação com outras entidades externas
Diagrama de classe
Serve para documentar requisitos com respeito à estrutura estática dos dados
Dependências estático-estruturais entre o sistema e o contexto do sistema
Diagrama de atividade
Torna possível documentar processos de negócio
São apropriados para modelar o caráter sequencial dos casos de uso
Modelar uma especificação detalhada de interação das funções que processam dados
Diagrama de estados
Usado para documentar comportamentos de um sistema desencadeados por determinados eventos (event-driven behavior)
Exige conhecimentos específicos de modelagem
Formas combinadas de documentação de requisitos
Tipicamente os documentos contêm uma combinação de linguagem natural e modelos conceituais.
A combinação permite diminuir eventuais desvantagens de um dos dois tipos de documentação através dos pontos fortes do outro tipo
Estrutura dos documentos
Para assegurar a capacidade do documento de ser gerenciado, o conteúdo de tais documentos deve ser estruturado da maneira mais apropriada
A prática mostra que o uso dessas estruturas de referência para documentos de requisitos traz muitos efeitos positivos
As estruturas de referência para documentos de requisitos propõem um conteúdo estruturado conforme modelos testados na prática
Todavia, essas estruturas de referência geralmente não podem ser adotadas diretamente para um documento de requisitos, pois a estruturação de seu conteúdo precisa muitas vezes ser adaptada para circunstâncias específicas do domínio, da empresa ou do projeto
Estruturas padronizadas de documentos
Com o uso de modelos padronizados, uma estrutura aproximada e uma curta descrição do conteúdo das principais seções são previamente determinadas
Vantagens
Simplificam a inclusão de novos membros da equipe
Permitem a rápida localização de conteúdos desejados
Permitem uma leitura e validação seletiva dos documentos de requisitos
Permitem a verificação automática dos documentos de requisitos
Permitem a reutilização simplificada dos conteúdos dos documentos de requisitos
Essas estruturas devem ser ajustadas para as propriedades específicas do projeto para atender às suas respectivas restrições
3 estruturas padronizadas de documentos mais amplamente utilizadas
RUP (Rational Unified Process) - 2001
Usa as estruturas da especificação de requisitos de sistema para documentar todos os requisitos de software
Modelo-V - 2004
Do Ministério do Interior da Alemanha, define diferentes estruturas, dependendo de quem é o autor dos documentos de requisitos
Norma IEEE standart 830-1998
Contém um estruturação que foi especialmente projetada para o documento de requisitos de software
Conteúdos Padrão Customizados
Questões abordadas por qualquer estrutura selecionada
Introdução
Finalidade
Cobertura do sistema
Stakeholder
Definições, acrônimos e abreviações
Referências
Visão Geral
Contém informações sobre o documento como um todo
Perspectiva geral
Documenta-se informações adicionais que aumentam a compreensibilidade dos requisitos, essas informações são meramente operacionais
Ambiente do sistema
Descrição da arquitetura
Funcionalidade do sistema
Usuários e público-alvo
Restrições
Pressupostos
Requisitos
Contém requisitos funcionais e requisitos de qualidade
Apêndices
Podem ser documentadas informações adicionais que completam o documento
Índice
Contém um sumário, isto é, a estrutura dos capítulos e um índice remissivo
Uso dos documentos de requisitos
Ao longo do ciclo do projeto, os documentos de requisitos servem de base para diferentes atividades
Planejamento
Projeto de arquitetura
Implementação
Testes
Gerenciamento de mudanças
Utilização do sistema e manutenção do sistema
Gerenciamento de contratos
Critérios de Qualidade para documento de requisitos sugeridos pela norma ISO/IEC/IEEE 29148:2011
Consistente e sem ambiguidade
Claramente estruturado
Modificável e extensível
Completo
Rastreável
Critérios de qualidade para requisitos
Acordado
Não ambíguo
Somente são considerados não ambíguos os documentos onde todos os requisitos individualmente são não ambíguos
Uma das características da não ambiguidade é a possibilidade de identificação única
Válido e atualizado
Consistente
Um documento de requisitos pode ser considerado inconsistente, mesmo quando cada requisito individualmente seja consistente
Verificável
Rastreável
Completo
Compreensível
Princípios fundamentais de compreensibilidade
Para facilitar a compreensão dos requisitos, duas regras fundamentais para sua redação em linguagem natural devem ser acrescentadas aos critérios de qualidade, promovendo a facilidade de leitura
Formular um único requisito por frase
Usar sentenças curtas e parágrafos curtos
Priorizado
Correto
Realizável
Glossário
Divergências na interpretação de termos são frequentes causas de conflitos entre as pessoas envolvidas na Engenharia de requisitos
Para evitar esse problema, é necessário definir todos os termos relevantes em um glossário
Um glossário é uma coleção de definições reunindo
Termos técnicos específicos para um determinado contexto
Abreviações e acrônimos
Conceitos do dia-a-dia com sentido específico em determinado contexto
Sinônimos
Homônimos
As seguintes regras devem ser seguidas
O glossário deve ser gerenciado de forma centralizada
As responsabilidades pela manutenção do glossário devem estar definidas
O glossário deve ser mantido ao longo do projeto
O glossário deve ser acessível por todos os participantes do projeto
A utilização do glossário deve ser obrigatória
A origem dos termos deve ser mencionada no glossário
O glossário deve ser aprovado pelos stakeholders
Os registros no glossário devem ter uma estrutura consistente
É recomendável iniciar a elaboração do glossário o mais cedo possível, para reduzir o trabalho posterior de atualização
Documento de requisitos/Especificação de requisitos
Uma especificação de requisitos é uma coleção de requisitos representada de forma sistemática, tipicamente para um sistema ou componente, atendendo a determinados critérios
Resumo
É muito importante estruturar os requisitos de forma clara, para que o pessoal envolvido no projeto também compreenda os requisitos
Dessa maneira a localização e a modificação de requisitos é simplificada e acelerada
A utilização de estruturas customizadas de documentação demonstrou ser apropriada para esse propósito