UE 4 Documentação de Requisitos (N2)

UE 4 Documentação de Requisitos (N2)

1. 4.1 Design do Documento

   • Documentar os requisitos para o sistema de forma apropriada é a principal e mais importante tarefa de documentação na engenharia de requisitos
   • 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 qualidades dos requsiitos documentados
   • A princípio qualquer tipo de técnica de documentação pode ser utilizada para documentar os requisitos: Documentação baseada na linguagem natural e redigida, Textos , Diagramas de estados
   • Principais razões para documentar requisitos:
     • Formam a base para o desenvolvimento do sistema (papel central)
     • Tem relevância legal (vinculo legal entre contratante e contratado)
     • Documentos de requisitos são complexos (complexibilidade)
     • Requisitos devem ser acessíveis para todas as partes envolvidas (acessibilidade)

2. 4.2 Tipos de Documentação

   • Existem 3 perspectivas diferentes para se documentar requisitos. tanto a linguagem natural quanto a modelagem conceitual são utilizadas para esse fim
     • Perspectiva estrutural
     • Perspectiva funcional
     • Perspectiva comportamental
   • Documentação de Requisitos usando Linguagem Natural: Conversa livre (prosa livre) é a forma de documentação de requisito mais aplicada na prática
   • Documentação de Requisitos usando Modelos Conceituais: Ao contrário da linguagem natural os diferentes tipos de modelos conceituais não podem ser utilizados universalmente.Ao documentar requisitos por meio de modelos, linguagens especiais de modelagem relacionadas com a perspectiva apropriada deve ser utilizada. O modelo retrata os requisitos documentados de forma muito mais compacta, sendo assim de compreensão mais fácil para um leitor treinado do que a linguagem natural
     • Diagrama de caso de uso
     • Diagrama de Classe
     • Diagrama de atividades
     • Diagrama de Estado
   • Documentos de Requisitos Híbridos: Tipicamente os documentos contêm uma combinação de linguagem natural e modelos conceituais. A combinação permite dominuir eventuais desvantagens de um dos dois tipos de documentação através dos pontos fortes do outro tipo. Essa combinação explora vantagem de ambos

3. 4.3 Estrutura dos Documentos

   • Estruturas Padronizadas de Documentos oferecem uma estrutura previamente definida
     • * Simplificam a inclusão de novos membros na equipe; * Permitem rápida localização de conteúdos desejados; * Leitura e validação seletiva dos documentos de requisitos; * Verificação automática dos documentos de requisitos (verificar se o documento está completo); * Reutilização simplificada dos conteúdos dos documentos de requisitos
     • Estruturas mais utilizadas: RUP, Norma IEEE standard 830-1998 e Modelo V
   • Conteúdos Padrão Customizados (conteúdo mínimo de uma especificação de Requisitos):
     • Introdução: visão geral do sistema
     • Perspectiva geral
     • Requisitos
     • Apendeices
     • Índice

4. 4.4 Uso dos Documentos de Requisitos

   • Ao longo do projeto, os documentos de requisitos servem de base para diferentes tarefas:
     • * Planejamento; * Projeto arquitetônico; * Implementação; * Teste; * Gerenciamento de mudanças; * Uso do sistema e manutenção do sistema; *Gerenciamento do contrato

5. 4.5 Critérios de Qualidade para Documento de Requisitos

   • Para se tornar base para os processos subsequentes de desenvolvimento, o documento deve atender certos critérios de qualidade
     • Não-ambiguidade e consistência
     • Estrutura clara
     • Modificabilidade e extensibilidade
     • Completude
     • Rastreabilidade

6. 4.6 Critérios de Qualidade para Requisitos

   • Critérios de qualidade para aumentar a aceitação do leitor
     • Frases curtas e parágrafos curtos
     • Formular apenas um requisito por frase

7. 4.7 Glossário

   • Todos os termos relevantes devem ser definidos em um glossário comum
   • Elementos de um Glossário:
     • * Termos técnicos especificos do contexto; * Abreviações e acrônimos * Conceitos do dia-a-dia que possuem um sentido específico no dado contexto; * Sinônimos * Homônimos
   • Regras básicas de um glossário:
     • * Deve ser gerenciado de forma centralizada (não pode haver multiplos glossários); * Responsabilidade deve ser atribuida (uma pessoa especifica deve manter atualizado); * Deve ser mantido ao longo do projeto; * Deve ser de acesso comum; * Deve ser obrigatório o uso; * Deve incluir fonte dos termos; * Deve ser aprovado pelos stakeholders; * Os verbete no glossário devem possuir uma estrutura consistente.
   • Recomenda-se iniciar a copilação do glossário no inicio do projeto