Skip to content

Commit

Permalink
Merge pull request #49 from Requisitos-de-Software/work
Browse files Browse the repository at this point in the history
Work
  • Loading branch information
anaaroch authored Nov 10, 2023
2 parents da732ee + 2192cca commit cad8f99
Show file tree
Hide file tree
Showing 2 changed files with 108 additions and 0 deletions.
107 changes: 107 additions & 0 deletions docs/verificacao/grupo7/requisitos_elicitados.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,107 @@
# Verificação do artefato "[Requisitos Elicitados](https://requisitos-de-software.github.io/2023.2-DETRAN/Entrega_2/requisitos_elicitados/)"

## Introdução

A verificação de artefatos desempenha um papel crucial na avaliação de documentos, projetos ou produtos em diversas áreas, incluindo os Requisitos de Software. Essa técnica visa a análise minuciosa do conteúdo, estrutura e características específicas de um artefato, com o propósito de avaliar sua qualidade, conformidade com requisitos e adequação aos objetivos estabelecidos.
Neste contexto, este documento tem como objetivo executar esse procedimento no artefato [Requisitos Elicitados](https://requisitos-de-software.github.io/2023.2-DETRAN/Entrega_2/requisitos_elicitados/) <a id="c" href="#cc">[3]</a> , desenvolvido pelo [Grupo 7](https://requisitos-de-software.github.io/2023.2-DETRAN/).

Em termos práticos, 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 desvios em relação aos requisitos. Essa etapa é fundamental para assegurar a qualidade e precisão do artefato, garantindo que este esteja alinhado com os objetivos do projeto ou documento em questão.

## Metodologia

A metodologia adotada para a verificação dos artefatos é composta por duas abordagens distintas, cada uma contribuindo para assegurar a qualidade e integridade do material analisado.

A primeira é fundamentada nos critérios de avaliação presentes no [plano de ensino](https://aprender3.unb.br/pluginfile.php/2692699/mod_resource/content/34/Plano_de_Ensino%20RE%20022023%20Turma%202.pdf) <a id="a" href="#aa">[1]</a> e [Software Requirements, Third Edition](https://aprender3.unb.br/pluginfile.php/2692775/mod_resource/content/1/Elicitacao%20de%20Req.pdf) <a id="d" href="#dd">[4]</a>, fornecendo um direcionamento preciso para a avaliação do conteúdo esperado nos artefatos. Essa etapa se baseia em um checklist elaborado a partir da leitura do plano e do livro, abrangendo questionamentos específicos sobre a construção de [Requisitos Elicitados](https://requisitos-de-software.github.io/2023.2-DETRAN/cronograma/cronograma_de_atividades/) <a id="c" href="#cc">[3]</a>.

A segunda abordagem se apoia na técnica formal de inspeção de Fagan, um processo estruturado que visa identificar e corrigir possíveis erros, falhas e problemas nos artefatos analisados, abrangendo documentos, código-fonte, especificações, entre outros itens relacionados a projetos de desenvolvimento de software. Essa técnica proporciona uma revisão criteriosa e sistemática, contribuindo para a melhoria da qualidade e precisão dos artefatos <a id="b" href="#bb">[2]</a>. A inspeção de Fagan é ilustrada na Figura 1 apresentada abaixo, demonstrando as etapas envolvidas no processo.

<div style="text-align: center;">
<img src="../../Fagan.png" alt="image" width="900"/>
</div>

<div style="text-align: center;">
Figura 1: Método de Fagan: Inspeção. (Fonte: Slide “Requisitos – Aula 23” <a id="b" href="#bb">[2]</a>, 2023)
</div>

## Conteúdo esperado

É esperado que o artefato inclua a lista de requisitos elicitados com suas devidas identificações e descrições, além de seguir a estrutura padrão básica exigida para todos os artefatos.

## Verificação

Com base nisso, foram criadas as Tabela 1 e 2 a seguir, que relaciona as especificações ideais do artefato, indica se o requisito é atendido ou não e avalia a qualidade de acordo com a classificação a seguir:

**Possui**

- Sim
- Não
- Incompleto

**Qualidade**

- Ótimo (Atende todos os requisitos do conteúdo esperado)
- Bom (Atende parcialmente os requisitos do conteúdo esperado)
- Pode melhorar (Não atende os requisitos do conteúdo esperado)

A Tabela 1 contém perguntas no que diz respeito à formatação do artefato. <a id="Tabela1"></a>

| ID | Descrição do Critério | Possui | Qualidade | Observação |
|----|----------------------|---------------------------------|------------------------|----------|
| 1 | O artefato possui introdução? | Sim | Ótimo | |
| 2 | Todas as tabelas e imagens do artefato possuem legendas, fontes e são introduzidas no texto? | Sim | Ótimo | |
| 3 | Possui links para os outros artefatos, caso necessário? | Não | Pode melhorar | Os artefatos "Questionário", "Entrevista", "Storytelling" e "Análise de documentos" são mencionados, porém não possuem links de acesso para referência. |
| 4 | O artefato possui bibliografia/referências bibliográficas? | Não | Ótimo | Não foi necessário. |
| 5 | O artefato possui um histórico de versões? | Sim | Ótimo | |
| 6 | O artefato possui autor? | Sim | Ótimo | |
| 7 | O artefato possui revisor? | Incompleto | Bom | Não possui revisor em todas as versões do histórico. |

<div style="text-align: center;">
Tabela 1: Perguntas selecionadas: Formatação do artefato. (Fonte: Plano de ensino da disciplina <a id="a" href="#aa">[1]</a>, 2023)
</div>

A Tabela 2 contém perguntas no que diz respeito ao conteúdo do artefato. <a id="Tabela2"></a>

| ID | Descrição do Critério | Possui | Qualidade | Observação |
|----|----------------------|--------|----------|------------|
| 1 | Todos os requisitos elicitados foram devidamente listados? | Incompleto | Bom | Os requisitos ST15 e ST17 do artefato 'Storytelling' não foram localizados na lista de requisitos elicitados. Adicionalmente, foi observado que os requisitos ADD24 e ADD32 se referem à mesma funcionalidade. |
| 2 | Rastreabilidade dos requisitos está presente? | Não | Pode melhorar | A rastreabilidade específica para os requisitos não foi identificada. |
| 3 | Requisitos funcionais e não funcionais estão identificados? | Sim | Ótimo | |
| 4 | Existe uma legenda explicando as siglas de identificação, se necessário? | Sim | Ótimo | |

<div style="text-align: center;">
Tabela 2: Perguntas selecionadas: Conteúdo do artefato. (Fonte: Plano de ensino da disciplina <a id="a" href="#aa">[1]</a>, Software Requirements - Third Edition <a id="d" href="#dd">[4]</a> e Ana Rocha, 2023)
</div>

## Correções e ajustes sugeridos

O artefato foi analisado com atenção aos checklists apresentados, atendendo a maioria dos critérios. No entanto, recomenda-se realizar ajustes de acordo com as observações detalhadas nas tabelas específicas de cada ID abaixo.

Referentes à [Tabela 1](#Tabela1):

- ID3: Possui links para os outros artefatos, caso necessário?
- ID7: O artefato possui revisor?

Referentes à [Tabela 2](#Tabela2):

- ID1: Todos os requisitos elicitados foram devidamente listados?
- ID2: Rastreabilidade dos requisitos está presente?

## Bibliografia

<a id="aa" href="#a">[1]</a> SALES, André Barros. Plano de ensino da disciplina. Disponível em: [Aprender 3](https://aprender3.unb.br/pluginfile.php/2692699/mod_resource/content/34/Plano_de_Ensino%20RE%20022023%20Turma%202.pdf). Acesso em 09 de novembro de 2023.</br>
<a id="bb" href="#b">[2]</a> SERRANO, Milena e Mauricio. Slide “Requisitos – Aula 23”. Disponível em: [Aprender 3](https://aprender3.unb.br/pluginfile.php/2692856/mod_resource/content/2/Requisitos%20-%20Aula%20023.pdf). Acesso 09 de novembro de 2023. </br>
<a id="cc" href="#c">[3]</a> GRUPO 7. Documento de Requisitos Elicitados do Grupo 7 da Disciplina de Requisitos de Software. Disponível em: [Git Page](https://requisitos-de-software.github.io/2023.2-DETRAN/Entrega_2/requisitos_elicitados/). Acesso em 09 novembro de 2023.</br>
<a id="dd" href="#d">[4]</a> Requirements Elicitation. Software Requirements, Third Edition. Disponível em: [Aprender 3](https://aprender3.unb.br/pluginfile.php/2692775/mod_resource/content/1/Elicitacao%20de%20Req.pdf). Acesso em 09 de novembro de 2023.</br>

## Histórico de Versão

| Versão | Data de execução | Data prevista de revisão | Descrição | Autor(es) | Revisado |
| :----: | :--------------: | :-------------: | :-------------------------------: | :--------------------------------------------------: | :--------------------------------------------------: |
| `1.0` | 09/11/2023 | 11/11/2023 | Criação do artefato | [Ana Rocha](https://github.com/anaaroch_) | |


### Revisão (V&V)

| Data de Revisão | Cobertura de Versões | Técnica | Revisor(es) |
| :------------: | :-------------: | :--------------------------: | :----------------------------------------: |
| xx/xx/xxxx | `1.0` | - | [Rafael Amancio](https://github.com/Rafael-gc) |
1 change: 1 addition & 0 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -72,6 +72,7 @@ nav:
- Análise de documentos: verificacao/grupo7/analise-documentos.md
- Personas: verificacao/grupo7/personas.md
- Questionário: verificacao/grupo7/questionario.md
- Requisitos Elicitados: verificacao/grupo7/requisitos_elicitados.md
- Entrega 3:
- Especificação Suplementar: verificacao/grupo7/especificacao-suplementar.md
- Entregas: planejamento/entregas.md
Expand Down

0 comments on commit cad8f99

Please sign in to comment.