Skip to content

Commit

Permalink
Merge pull request #71 from Requisitos-de-Software/verificacaoRafael
Browse files Browse the repository at this point in the history
Verificação de 5 artefatos
  • Loading branch information
yagompassos authored Nov 26, 2023
2 parents 0bcd7a9 + d678e86 commit 6f35315
Show file tree
Hide file tree
Showing 5 changed files with 447 additions and 0 deletions.
92 changes: 92 additions & 0 deletions docs/verificacao/grupo6/especificacao_suplementar.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,92 @@
# Verificação do artefato ["Especificação Suplementar"](https://requisitos-de-software.github.io/2023.2-Skoob/modelagem/especificacao_suplementar/)

## 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 ["Especificação Suplementar"](https://requisitos-de-software.github.io/2023.2-Skoob/modelagem/especificacao_suplementar/) desenvolvido pelo [Grupo 6](https://requisitos-de-software.github.io/2023.2-Skoob/).<a id="a" href="#aa">[3]</a>. 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.<a id="a" href="#aa">[2]</a>. 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.<a id="a" href="#aa">[1]</a>.

![Inspeção Fagan](../Fagan.png)

<b>Método de Fagan</b>: 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 explique a técnica FURPS+ e apresente o resultado.

### 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. <a id="Tabela1"></a>

| ID | Conteúdo | Possui | Qualidade | Observação |
| --- | --------------------------------------------------------------------- | ------ | ------------- | ----------------------------------------- |
| 1 | Há histórico de versão padronizado? | Não | Pode melhorar | Não segue o padrão previamente estabelecido. |
| 2 | Há autor e revisor no artefato? | Sim | Ótimo | |
| 3 | Existem referências bibliográficas? | Sim | Ótimo | |
| 4 | Possui hiperlinks? | Sim | Ótimo | |
| 5 | Todas as referências foram citadas no texto? | Incompleto | Pode melhorar | Faltou citar a referência de id número 1. |
| 6 | As imagens/tabelas utilizadas possuem legendas e seguem um padrão? | Sim | Ótimo | |

<b>Tabela 1</b>: 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. <a id="Tabela2"></a>

| ID | Conteúdo | Possui | Qualidade | Observação |
| --- | ----------------------------------------------------------------------------------------------- | ------ | ------------- | ------------------------------------------------------ |
| 1 | Apresenta um texto fazendo uma introdução do artefato? | Sim | Ótimo | |
| 2 | Explica em detalhes a técnica utilizada? | Sim | Ótimo | |
| 3 | O modelo FURPS+ foi seguido corretamente(apresenta os 5 critérios)? | Sim | Ótimo | |


<b>Tabela 2</b>: Perguntas selecionadas: Conteúdo do artefato. (Fonte: Rafael Amancio, 2023)

## Correções e ajustes sugeridos

O artefato foi bem elaborado e seguiu quase todos os checklists apresentados na tabela. Os ajustes sugeridos podem ser realizados seguindo as observações:
#### Referentes a tabela 1:
- [ID1 - Há histórico de versão padronizado? ](#Tabela1)

#### Referentes a tabela 2:

- [ID4 - Apresenta uma breve descrição sobre o que cada ferramenta faz?](#Tabela2)

## 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 24 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: 24 de novembro de 2023.
> [3] Documento de ferramentas escolhidos do Grupo 6 da Disciplina de Requisitos. Disponível em: <https://requisitos-de-software.github.io/2023.2-Skoob/planejamento/ferramentas/>. Acesso em 24 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` | 25/11/2023 | 26/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) |
| :-------------: | :------------------: | :-----: | :--------------------------------------------: |
| xx/xx/xxxx | `1.0` | -- | [Yago Passos](https://github.com/yagompassos) |
91 changes: 91 additions & 0 deletions docs/verificacao/grupo6/first_things_first.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,91 @@
# Verificação do artefato ["First Things First"](https://requisitos-de-software.github.io/2023.2-Skoob/planejamento/first_things_first/)

## 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-Skoob/planejamento/first_things_first/) desenvolvido pelo [Grupo 6](https://requisitos-de-software.github.io/2023.2-Skoob/).<a id="a" href="#aa">[3]</a>. 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.<a id="a" href="#aa">[2]</a>. 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.<a id="a" href="#aa">[1]</a>.

![Inspeção Fagan](../Fagan.png)

<b>Método de Fagan</b>: 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 explique a técnica que será aplicada e que apresente seus resultados.

### 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 | Ótimo | |
| 4 | Possui hiperlinks? | Sim | Bom | Os hiperlinks da Ana Rocha no Histórico de Versão apresentam o erro de Página não encontrada. |
| 5 | Todas as referências foram citadas no texto? | Sim | Ótimo | |
| 6 | As imagens/tabelas utilizadas possuem legendas e seguem um padrão? | Sim | Ótimo | |

<b>Tabela 1</b>: 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 | Ótimo | |
| 2 | Explica em detalhes a técnica utilizada? | Sim | Ótimo | |
| 3 | Há participação do cliente e/ou persona no processo de priorização? | Sim | Ótimo | |
| 4 | Os requisitos estão ordenados em ordem de prioridade? | Sim | Ótimo | |
| 5 | A tabela possui as colunas de benefício, penalidade, valor, custo, risco e suas porcentagens? | Sim | Ótimo | |
| 6 | A fórmula para o cálculo da prioridade está correta? | Sim | Ótimo | |
| 7 | A realização da técnica foi gravada e disponibilizada? | Sim | Ótimo | |
| 8 | O artefato apresenta uma conclusão? | Sim | Ótimo | |


<b>Tabela 2</b>: Perguntas selecionadas: Conteúdo do artefato. (Fonte: Rafael Amancio, 2023)

## Correções e ajustes sugeridos

O artefato foi muito bem elaborado e seguiu todos os checklists apresentados na tabela. Um pequeno ajuste deve ser realizado nos hiperlinks do Histórico de Versão.

## 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 24 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: 24 de novembro de 2023.
> [3] Documento de ferramentas escolhidos do Grupo 6 da Disciplina de Requisitos. Disponível em: <https://requisitos-de-software.github.io/2023.2-Skoob/planejamento/ferramentas/>. Acesso em 24 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` | 24/11/2023 | 25/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) |
| :-------------: | :------------------: | :-----: | :--------------------------------------------: |
| xx/xx/xxxx | `1.0` | -- | [Ana Rocha](https://github.com/anaaroch) |
Loading

0 comments on commit 6f35315

Please sign in to comment.