From 6dec71383e00629de110638b03659d503fec33f3 Mon Sep 17 00:00:00 2001 From: Rafael-gc Date: Sun, 12 Nov 2023 11:05:59 -0300 Subject: [PATCH] =?UTF-8?q?Realizada=20verifica=C3=A7=C3=A3o=20do=20artefa?= =?UTF-8?q?to=20FTF=20do=20grupo=207?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/verificacao/grupo7/FTF.md | 95 ++++++++++++++++++++++++++ docs/verificacao/grupo7/ferramentas.md | 2 +- 2 files changed, 96 insertions(+), 1 deletion(-) create mode 100644 docs/verificacao/grupo7/FTF.md diff --git a/docs/verificacao/grupo7/FTF.md b/docs/verificacao/grupo7/FTF.md new file mode 100644 index 00000000..5d9d53dc --- /dev/null +++ b/docs/verificacao/grupo7/FTF.md @@ -0,0 +1,95 @@ +# Verificação do artefato ["First Things First"](https://requisitos-de-software.github.io/2023.2-DETRAN/Entrega_2/FTF/) + +## Introdução + +A técnica de verificação de artefatos é uma etapa crítica no processo de avaliação de documentos, projetos ou produtos em várias áreas, incluindo Requisitos de Software. Essa abordagem visa examinar detalhadamente o conteúdo, a estrutura e as características específicas de um artefato para avaliar sua qualidade, conformidade com requisitos e adequação aos objetivos definidos. + +Neste contexto, pretendemos aplicar essa técnica ao artefato ["First Things First"](https://requisitos-de-software.github.io/2023.2-DETRAN/Entrega_2/FTF/) desenvolvido pelo [Grupo 7](https://requisitos-de-software.github.io/2023.2-DETRAN/).[3]. A verificação é baseada no plano de ensino e nas datas estabelecidas nele. + +Para esclarecer, a técnica de verificação, inspirada no processo de Fagan, implica na análise rigorosa e sistemática do artefato em busca de erros, inconsistências, lacunas e não conformidades com os requisitos. É uma etapa essencial para garantir a qualidade e a precisão do artefato, assegurando que ele atenda aos objetivos estabelecidos no contexto do projeto ou documento em questão. + +## Metodologia + +A verificação por inspeção de Fagan é uma técnica formal e estruturada de revisão de documentos que visa identificar erros, falhas e problemas em artefatos como documentos, código-fonte, especificações e outros itens relacionados a projetos de desenvolvimento de software. O processo envolve etapas que incluem planejamento, visão geral, preparação, inspeção, correção e acompanhamento.[2]. Além disso, para verificar o artefato em questão será baseado também nos critérios de avaliação do artefato, disponível como prévia no [plano de ensino](https://aprender3.unb.br/pluginfile.php/2692699/mod_resource/content/34/Plano_de_Ensino%20RE%20022023%20Turma%202.pdf). +O processo será composto pelo "conteúdo esperado" onde foi realizado um checklist baseado nas perguntas do plano de ensino.[1]. + +![Inspeção Fagan](../Fagan.png) + +Método de Fagan: Inspeção. (Fonte: Slides da aula “Requisitos – Aula 23” dos professores Milene Serrano e Maurício Serrano, 2023) + +## Conteúdo esperado + +Espera-se que o artefato contenha introdução, metodologia e resultado da técnica de priorização First Things First. + +### Verificação + +Sendo assim, foram elaboradas as tabelas 1 e 2 abaixo relacionando as especificações ideais do artefato, se ele possui ou não o requisito apresentado nas perguntas e quanto a qualidade, baseada na seguinte classificação: + +**Possui** + +- Sim +- Não +- Incompleto + +**Qualidade** + +- Ótimo (Apresenta todos os requisitos do conteúdo esperado) +- Bom (Apresenta parcialmente os requisitos do conteúdo esperado) +- Pode melhorar (Não apresenta os requisitos do conteúdo esperado) + +A Tabela 1 contém perguntas no que diz respeito à formatação do artefato. + +| ID | Conteúdo | Possui | Qualidade | Observação | +| --- | ----------------------------------------------------------------- | ------ | ------------- | ----------------------------------------------------------------------------------------------- | +| 1 | Há histórico de versão padronizado? | Sim | Ótimo | | +| 2 | Há autor e revisor no artefato? | Sim | Ótimo | | +| 3 | Existem referências bibliográficas? | Sim | Bom | | +| 4 | Possui hiperlinks? | Não | Pode melhorar | É recomendado ligar os requisitos que foram priorizados com seus artefatos de origem (elicitação). Para realizar isso basta colocar hiperlinks nos ID's de cada requisito. | + +Tabela 1: Perguntas selecionadas: Formatação do artefato. (Fonte: Rafael Amancio, 2023) + +A Tabela 2 contém perguntas no que diz respeito ao conteúdo do artefato. + +| ID | Conteúdo | Possui | Qualidade | Observação | +| --- | ----------------------------------------------------------------- | ------ | ------------- | ----------------------------------------------------------------------------------------------- | +| 1 | Apresenta um texto fazendo uma introdução do artefato? | Sim | Bom | A introdução ficou muito extensa | +| 2 | Apresenta um texto explicando a metodologia da técnica? | Sim | Bom | Seria interessante criar um tópico chamado Metodologia, separando-a da introdução | +| 3 | Há participação do cliente e/ou persona na priorização de requisitos? | Não | Pode melhorar | É de extrema importância realizar a priorização utilizando personas ou com contato direto do cliente | +| 4 | A técnica foi executada de maneira correta? | Sim | Ótimo | | + + +Tabela 2: Perguntas selecionadas: Conteúdo do artefato. (Fonte: Rafael Amancio, 2023) + +## Correções e ajustes sugeridos + +O artefato apresenta algumas falhas que poderiam ser corrigidas seguindo as observações: +#### Referentes a tabela 1: +- ID4 - Possui hiperlinks? + +#### Referentes a tabela 2: +- ID1 - Apresenta um texto fazendo uma introdução do artefato? +- ID2 - Apresenta um texto explicando a metodologia da técnica? +- ID3 - Há participação do cliente e/ou persona na priorização de requisitos? + +## Bibliografia + +> [1] SALES, André Barros. Plano de ensino da disciplina. Disponível em: https://aprender3.unb.br/pluginfile.php/2692699/mod_resource/content/34/Plano_de_Ensino%20RE%20022023%20Turma%202.pdf. Acesso em 11 de novembro de 2023. + +> [2] Slides da aula “Requisitos – Aula 23” dos professores Milene Serrano e Maurício Serrano. Disponível em: https://aprender3.unb.br/pluginfile.php/2692856/mod_resource/content/2/Requisitos%20-%20Aula%20023.pdf. Acessado em: 11 de novembro de 2023. + +> [3] Documento de First Things First escolhido do Grupo 7 da Disciplina de Requisitos. Disponível em: . Acesso em 11 novembro de 2023. + + +## Histórico de Versão + +| Versão | Data de execução | Data prevista de revisão | Descrição | Autor(es) | Revisado | +| :----: | :--------------: | :-------------: | :-------------------------------: | :--------------------------------------------------: | :--------------------------------------------------: | +| `1.0` | 11/11/2023 | 12/11/2023 | Criação do artefato | [Rafael Amancio](https://github.com/Rafael-gc) | | + + + +### Revisão (V&V) + +| Data de Revisão | Cobertura de Versões | Técnica | Revisor(es) | +| :------------: | :-------------: | :--------------------------: | :----------------------------------------: | +| -- | 1.0 | Revisão por inspeção | [Ana Caroline](https://github.com/anaaroch) | \ No newline at end of file diff --git a/docs/verificacao/grupo7/ferramentas.md b/docs/verificacao/grupo7/ferramentas.md index e27c5a58..8f841b53 100644 --- a/docs/verificacao/grupo7/ferramentas.md +++ b/docs/verificacao/grupo7/ferramentas.md @@ -46,7 +46,7 @@ A Tabela 1 contém perguntas no que diz respeito à formatação do artefato. | 3 | Existem referências bibliográficas? | Sim | Ótimo | | | 4 | Possui hiperlinks? | Sim | Ótimo | | -Tabela 1: Perguntas selecionadas: Formatação do artefato. (Fonte: Shaíne Oliveira, 2023) +Tabela 1: Perguntas selecionadas: Formatação do artefato. (Fonte: Rafael Amancio, 2023) A Tabela 2 contém perguntas no que diz respeito ao conteúdo do artefato.