Edmundo Sérgio Spoto. Revisões Técnicas. Edmundo S. Spoto. 26/8/2009 Revisão de Software 1

Transcrição

1 Revisões Técnicas Edmundo S. Spoto 26/8/2009 Revisão de Software 1

2 Histórico A atividade de revisão começou como uma ferramenta de controle gerencial Revisão de progresso O progresso não pode ser avaliado simplesmente contando-se o número de tarefas finalizadas Era preciso estabelecer um meio de avaliar também a qualidade do trabalho executado 26/8/2009 Revisão de Software 2

3 Revisões Técnicas Surgiram então as revisões que avaliam aspectos técnicos do produto Qualquer produto pode ser submetido a uma revisão técnica A técnica pode ser aplicada desde as primeiras fases do ciclo de vida Formais ou informais 26/8/2009 Revisão de Software 3

4 Planejamento Cabe ao engenheiro de software planejar o que deve ser revisado quais os resultados esperados quem deve fazer a revisão Determinar checkpoints dentro do ciclo de vida onde a revisão deve ser aplicada Determinar resultados esperados 26/8/2009 Revisão de Software 4

5 Checkpoints Revisão Requisitos de sistema Requisitos do software Plano de teste Projeto preliminar Projeto detalhado Revisão de módulos Teste de validação (sistema) Aceitação Resultado esperado Entendimento do que o sistema deve fazer Aprovar a especificação de requisitos e iniciar projeto preliminar Aprovar a estratégia de teste Estabelecer uma linha base para o projeto; determinar uma abordagem básica para o projeto e teste do software Aprovar projeto detalhado; autorizar o início da codificação e teste Aprovar a finalização da implementação e teste das unidades; liberar para demais fases de teste Determinar o final dos testes de validação (sistema) Aceitar o produto; aprovar implementação operacional 26/8/2009 Revisão de Software 5

6 Exercício Defina Checkpoints de revisão para sua proposta de um Ambiente de trabalho seguindo as partes: Planejamento do projeto Laboratório ou escritório de desenvolvimento. Controle de Materiais de Uso Viabilidades de execução (técnica e financeira) 26/8/2009 Revisão de Software 6

7 Planejamento... quem participa? qual informação é revisão? requerida antes da pré-condições que devem ser satisfeitas antes que a revisão possa ser conduzida? Como Organizar? 26/8/2009 Revisão de Software 7

8 Planejamento... Gerar checklists ou outra indicação do que deve ser coberto na revisão; Determinar as condições de término ou critérios que devem ser satisfeitos para que a revisão termine; Gerar registros e documentos que devem ser produzidos. 26/8/2009 Revisão de Software 8

9 Resultados obtidos revisões são o principal mecanismo para avaliar o progresso do desenvolvimento de maneira confiável; revisões trazem à luz as capacidades de cada indivíduo envolvido no desenvolvimento; revisões são capazes de revelar lotes ou classes de erros de uma só vez; 26/8/2009 Revisão de Software 9

10 Resultados obtidos revisões proporcionam retorno já nas primeiras fases, prevenindo que erros mais sérios surjam; revisões treinam e educam os participantes e têm significante efeito positivo na competência dos desenvolvedores. 26/8/2009 Revisão de Software 10

11 Custo da remoção de erros Atividades de projeto são responsáveis por 50 a 65% dos erros Revisão pode revelar até 75% desses erros Revelar erros cedo diminui o custo de validação e correção Fase de projeto: custo 1 Fase anterior ao teste: custo 6.5 Fase de teste: custo 15 Fase de manutenção: custo 60 a /8/2009 Revisão de Software 11

12 Amplificação de defeitos cada caixa representa um passo erros podem ser criados, passados a frente, amplificados ou ainda revelados Defeitos Detecção Erros vindos do passo anterior Erros passados a diante Erros amplificados 1:x Erros novos gerados Percentagem de erros detectados Erros para o próximo passo 26/8/2009 Revisão de Software 12

13 Amplificação sem revisões 94 projeto preliminar Teste integr % x % 47 Projeto detalhado 25 Teste validação 0 0 0% x 3 50% 24 Codigo/test unidade 25 Teste sistema % 50% /8/2009 Revisão de Software 13

14 Amplificação com revisões 24 projeto preliminar 0 Projeto detalhado % 2 Codigo/test unidade 10 1 x % x % Teste integr. Teste validação % Teste sistema % % /8/2009 Revisão de Software 14

15 Custo final Fase Erros revelados Com revisões Custo unitário Total Projeto Antes do teste Durante teste Após liberação Sem revisões Antes do teste Durante teste Após liberação /8/2009 Revisão de Software

16 Regras (Walkthrough) Tipicamente 3 a 5 pessoas autor, líder de revisões e 2 ou 3 revisores Preparação antecipada 1 a 2 horas Duração de no máximo 2 horas Uma parte pequena do software deve ser selecionada para revisão 26/8/2009 Revisão de Software 16

17 Walkthrough Um dos revisores fica como secretário da revisão Inicia-se com uma discussão sobre a pauta e uma breve introdução sobre o produto Autor descreve o produto caminha sobre ele Revisores colocam suas dúvidas, baseados no estudo prévio do produto 26/8/2009 Revisão de Software 17

18 Walkthrough Erros identificados devem ser anotados lista de problemas Revisores preenchem também um relatório sumário de revisão o que foi revisado quem fez a revisão conclusão 26/8/2009 Revisão de Software 18

19 Lista de problemas - EX Número da revisão: 0013 Data: Líder da revisão: Plínio Vilela Secretário: Márcio Delamaro Lista de problemas: Introduções aos módulos YMOTION e ZMOTION não estão consistentes com os padrões de projeto. O propósito do módulo deveria estar explicitamente declarado (referência não é aceita) e uma especificação de itens de dados deveria ser declarada. Contador de laço para interpolação em X, Y e Z é incrementado uma vez a mais para controle de passo do motor. Equipe de revisão recomenda uma verificação na especificação do controle de passo e se necessário a correção do contador. Equipe de revisão recomenda a alteração do algoritmo comparador de posição para melhorar a performance. As alterações necessárias estão 26/8/2009 anotadas em PDL. O autor tem restrições quanto à modificação e deverá Revisão de Software analisar potenciais impactos antes de efetuar a alteração. 19

20 Sumário de revisão R e la t ó r io S u m á r io d e r e v is ã o té c n ic a I d e n tific a ç ã o d a r e v is ã o P r o je t o : C o n t r o la d o r d e te m p o r e a l N C N ú m e r o d a r e v is ã o : D a t a : L o c a l: S a la H o r á r io : 1 0 :0 0 I d e n tific a ç ã o d o p r o d u to M a te r ia l r e v is a d o : P r o je t o d e ta lh a d o - m ó d u lo s p a r a c o n t r o le d e m o v im e n t o A u to r : G e r a ld o S e te M e io B r e v e d e s c r iç ã o : 3 m ó d u lo s p a r a c o n t r o le d e m o v im e n to n o s e ix o s X Y e Z M a te r ia l r e v is a d o 1. D e s c r iç õ e s d o s m ó d u lo s X M O T IO N, Y M O T IO N e Z M O T IO N 2. P D L p a r a o s m ó d u lo s R e v is o r e s : N O M E A s s in a tu r a 1 - P lín io V ile la ( líd e r ) _ 2 - M á r c io D e la m a r o (s e c r e tá r io ) _ 3 - D o r o té ia B a n z o _ 4 - B o b D u m o n t _ A v a lia ç ã o d o p r o d u to A c e ito c o m o e s tá ( ) c / p e q u e n a m o d ific a ç õ e s (X ) N ã o a c e it o r e v is ã o ( ) r e v is ã o s e c u n d á r io ( ) R e v is ã o n ã o fo i c o m p le ta d a ( e x p lic a r m o t iv o s ) 26/8/2009 M a te r ia l s u p le m e n t a r a n e xrevisão a d o : de Software 20 L is ta d e p r o b le m a s (X ) M a te r ia is d e p r o d u ç ã o (X )

21 Guidelines ou Uma má revisão pode ser pior que nenhuma revisão Determine uma agenda (e mantenha-a) Limite os debates Levante as áreas problemáticas não tente resolver todos os problemas Tome notas Revise o produto, não o produtor 26/8/2009 Revisão de Software 21

22 Guidelines Limite o número de participantes e insista na preparação; Prepare um checklist, de acordo com o produto a ser revisado; Reserve recursos do projeto para revisões; Promova treinamento para os revisores; Revise suas antigas revisões. 26/8/2009 Revisão de Software 22

23 Checklists Quase qualquer produto pode ser revisado. Dependendo do produto, os revisores devem focalizar sua atenção em determinados pontos. Para cada checkpoint deve ser gerada uma lista de pontos importantes, um checklist! 26/8/2009 Revisão de Software 23

24 Especificação de requisitos... A análise do domínio da informação está completa, consistente e correta? O particionamento do problema está completo? As interfaces internas e externas estão definidas corretamente? Os modelos de dados refletem os objetos, seus atributos e relacionamentos corretamente? Todos os requisitos podem ser mapeados para o nível de sistema? 26/8/2009 Revisão de Software 24

25 Especificação de requisitos Prototipagem foi conduzida com o usuário? Os requisitos de performance podem ser alcançados, dadas as restrições impostas por outros elementos do sistema? Os requisitos são consistentes com cronograma, recursos e orçamento? Os critérios de validação estão completamente especificados? 26/8/2009 Revisão de Software 25

26 Projeto preliminar... Os requisitos do software estão refletidos na arquitetura? Modularidade foi alcançada de maneira eficaz? Os módulos são funcionalmente independentes? Foram definidas as interfaces dos módulos e dos elementos externos do sistema? 26/8/2009 Revisão de Software 26

27 Projeto preliminar As estruturas de dados são consistentes com o domínio da informação? As estruturas de dados são consistentes com os requisitos do software? O item manutenibilidade foi considerado? Outros fatores de qualidade foram explicitamente considerados? 26/8/2009 Revisão de Software 27

28 Projeto detalhado O algoritmo realiza a função desejada? O algoritmo está logicamente correto? A interface está consistente com o projeto da arquitetura? A complexidade lógica é razoável? Manipulação de defeitos e abordagens anti-defeito foram especificadas? 26/8/2009 Revisão de Software 28

29 Projeto detalhado Estruturas de dados locais estão propriamente definidas? As construções de programação estrutura são utilizadas em todos módulos? Os detalhes de implementação são adaptáveis para linguagens de programação? Lógica composta ou negativa é utilizada? O item manutenibilidade foi considerado? 26/8/2009 Revisão de Software 29

30 Código... A tradução do projeto procedimental para código foi feita de maneira correta? Existem erros de digitação? As convenções de utilização da linguagem foram seguidas? O código está de acordo com padrões de estilo, comentários e introdução do módulo? 26/8/2009 Revisão de Software 30

31 Código Existem comentários incorretos ou ambíguos? Tipos e declarações de dados estão corretos? Constantes físicas estão corretas? Todos os itens do walkthrough de projeto reexaminados? (quando necessário) 26/8/2009 Revisão de Software 31

32 Plano de teste... As principais fases de teste estão bem identificadas e seqüenciadas? Foram estabelecidos critérios e requisitos de validação nos requisitos do software? O plano de teste é consistente com o plano de desenvolvimento geral? O cronograma de teste foi explicitamente determinado? 26/8/2009 Revisão de Software 32

33 Plano de teste Os recursos e ferramentas de teste estão disponíveis? Foi estabelecido um mecanismo para manter os registros do teste? Drivers e stubs foram identificados? Foi estabelecido tempo no cronograma para seu desenvolvimento? Teste de estresse foi especificado? 26/8/2009 Revisão de Software 33

34 Procedimentos de teste... Foram especificadas diversas técnicas de teste? Critérios para avaliação de casos de teste foram utilizados? Casos de teste foram identificados e guardados? 26/8/2009 Revisão de Software 34

35 Procedimento de teste Tratamento de erros foram testados? Valores limites foram testados? Performance e sincronismo devem ser testados? Foi especificada uma variação aceitável para os resultados esperados? 26/8/2009 Revisão de Software 35

36 Exercício Elabore um planejamento de revisão para um dos checkpoints estabelecidos no exercício anterior. Quem participa? Qual informação é requerida antes da revisão? Pré-condições que devem ser satisfeitas antes que a revisão possa ser conduzida; Checklist ou outra indicação do que deve ser coberto na revisão. Condições de término ou critérios que devem ser satisfeitos para que a revisão termine; Registros e documentos que devem ser produzidos. 26/8/2009 Revisão de Software 36

37 Exercício Considere que o produto a ser revisado sendo a documentação de Projeto de Escritório Especificação de Requisitos e Descrições funcionais: Defina um planejamento para a revisão. Elabore um checklist para esse tipo de material. Forme um grupo de 4 pessoas e faça a revisão do Material. 26/8/2009 Revisão de Software 37

38 Ex: Checklist Erros de sintaxe Erros de concordância Uso de terminologia padrão Seqüência de descrição fora de ordem A descrição das Funcionalidades não são explicativas As dependências (pré e pós condições) em cada funcionalidade não estão claras. Pouca clareza nas descrições do fluxo de informação das Funcionalidades. Apresenta pouca Figura ilustrativa. A escrita atende um entendimento técnico e de fácil interpretação? 26/8/2009 Revisão de Software 38

39 Ex:: Checklist Os termos utilizados são pertinentes ao tipo de aplicação? O texto é fluente e didático? (Especificação) As não funcionalidades foram citadas? As características técnicas possuem uma tabela de sinônimos? A qualidade de impressão é boa? 26/8/2009 Revisão de Software 39

40 Como implementar Muitas vezes encontram-se resistências à implementação de técnicas novas 26/8/2009 Revisão de Software 40

41 Treinamento Investimento inicial para treinar os revisores treinar algumas poucas pessoas que vão se encarregar de treinar os outros Duplas de lideres 26/8/2009 Revisão de Software 41

42 Cronograma A fatia do cronograma que deve ser alocada 2 a 10% (dependendo do ambiente) Inicialmente, deve-se fazer uma projeção pessimista pois não se dispõem de dados anteriores Inicialmente o tamanho do produto revisado tende a ser pequeno 26/8/2009 Revisão de Software 42

43 Outras dicas Inicie a revisão com partes não críticas do software revisores necessitam de tempo para aprender a revisar Tente revisar, por exemplo, o seu guia para conduzir revisões isso pode aprimorar a aplicação na sua organização 26/8/2009 Revisão de Software 43

44 Problemas e Pontos a Ponderar Um programa pode estar correto e ainda assim não exibir boa qualidade? Explique. Foi lhe dada a responsabilidade de melhorar a qualidade de software em sua empresa. Qual é a primeira coisa que você deve fazer? E depois? Como você reconheceria um bom candidato a participar da revisão? E o não preparado? Quais as providências, se você fosse o lider? 26/8/2009 Revisão de Software 44

45 Duvidas? Perguntas? 26/8/2009 Revisão de Software 45