Skip to content

Commit

Permalink
Merge pull request #48 from Requisitos-de-Software/work
Browse files Browse the repository at this point in the history
correções e verificação do questionario grupo 7
  • Loading branch information
anaaroch authored Nov 8, 2023
2 parents 1b2abd0 + d265b02 commit da732ee
Show file tree
Hide file tree
Showing 3 changed files with 121 additions and 4 deletions.
8 changes: 4 additions & 4 deletions docs/verificacao/grupo7/cronogramas.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
## 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 [Cronograma do Projeto](https://requisitos-de-software.github.io/2023.2-DETRAN/cronograma/cronograma_de_atividades/) <a id="c" href="#cc">[3]</a> , desenvolvido pelo [Grupo 7](https://requisitos-de-software.github.io/2023.2-DETRAN/), com base no plano de ensino e suas respectivas datas.
Neste contexto, este documento tem como objetivo executar esse procedimento no artefato [Cronograma do Projeto](https://requisitos-de-software.github.io/2023.2-DETRAN/cronograma/cronograma_de_atividades/) <a id="c" href="#cc">[3]</a> , desenvolvido pelo [Grupo 7](https://requisitos-de-software.github.io/2023.2-DETRAN/), com base no plano de ensino e suas respectivas datas.

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.

Expand All @@ -29,7 +29,7 @@ Espera-se que o artefato apresente tabelas com os cronogramas planejados e execu

## Verificação

Com base nisso, foi criada a Tabela 1 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:
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**

Expand All @@ -45,7 +45,7 @@ Com base nisso, foi criada a Tabela 1 a seguir, que relaciona as especificaçõe

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 |
| ID | Descrição do Critério | Possui | Qualidade | Observação |
|----|----------------------|---------------------------------|------------------------|----------|
| 1 | O artefato possui introdução? | Sim | Bom | O texto de introdução possui erros ortográficos e gramaticais. |
| 2 | Todas as tabelas e imagens do artefato possuem legendas, fontes e são introduzidas no texto? | Incompleto | Pode melhorar | O artefato apresenta tabelas sem legenda e sem chamadas no texto, além disso, algumas das tabelas que atendem aos requisitos estão com o número de identificação incorreto. |
Expand All @@ -61,7 +61,7 @@ A Tabela 1 contém perguntas no que diz respeito à formatação do artefato. <a

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 |
| ID | Descrição do Critério | Possui | Qualidade | Observação |
|----|----------------------|---------------------------------|------------------------|----------|
| 1 | O cronograma do planejamento apresenta todas as atividades de todas as etapas para cada integrante com as datas de início e fim das entregas dos artefatos, assim como o período da revisão deles? | Incompleto | Bom | Alguns dos cronogramas detalhados não incluem um período de revisão. |
| 2 | O cronograma do planejamento apresenta um período de gravação da apresentação de cada etapa? | Sim | Ótimo | |
Expand Down
116 changes: 116 additions & 0 deletions docs/verificacao/grupo7/questionario.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,116 @@
# Verificação do artefato "[Questionário](https://requisitos-de-software.github.io/2023.2-DETRAN/Entrega_2/questionario/)"

## 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 [Questionário](https://requisitos-de-software.github.io/2023.2-DETRAN/Entrega_2/questionario/) <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 da seção "Questionnaires", encontrada na página 127 do livro <a id="d" href="#dd">[4]</a>, abrangendo questionamentos específicos sobre a construção do [Questionário](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

Espera-se que o artefato apresente, a metodologia em questão, um registro referente à formulação das perguntas do questionário e os resultados obtidos, 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 | Bom | Falta a referência que comprova que é uma das técnicas mais utilizadas atualmente. De onde foi obtida essa informação? |
| 2 | Todas as tabelas e imagens do artefato possuem legendas, fontes e são introduzidas no texto? | Incompleto | Pode melhorar | O artefato não apresenta legendas, fontes e introduções no texto referente às imagens do questionário. |
| 3 | Possui links para os outros artefatos, caso necessário? | Não | Ótimo | Não foi necessário. |
| 4 | O artefato possui bibliografia/referências bibliográficas? | Sim | Bom | A referência não inclui um link funcional de acesso. |
| 5 | O artefato possui um histórico de versões? | Sim | Ótimo | |
| 6 | O artefato possui autor? | Sim | Ótimo | |
| 7 | O artefato possui revisor? | Sim | Ótimo | |

<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 | Um cronograma para realização da elicitação dos requisitos? | Não | Pode melhorar | Seria recomendável incluir um cronograma que abrange o período de elaboração do questionário, a duração em que permaneceu disponível e o cronograma de execução da elicitação em si. |
| 2 | A gravação e os registros da atividade de elicitação dos requisitos? | Não | Pode melhorar | Seria interessante ter uma gravação da elicitação dos requisitos com base nas respostas do questionário. |
| 3 | Os requisitos elicitados estão identificados? | Sim | Ótimo | |
| 4 | Os requisitos foram qualificados em funcionais e não funcionais? | Sim | Ótimo | |
| 5 | O artefato possui uma explicação desse método de elicitação? | Sim | Ótimo | |
| 6 | O questionário faz suas perguntas baseadas no perfil de usuário traçado pelo grupo? | Não | Pode melhorar | O questionário tem como propósito, além da elicitação de requisitos, a definição do perfil do usuário, o que não é recomendável. |
| 7 | As perguntas são claras e concisas? | Sim | Ótimo | |
| 8 | As perguntas possuem uma ordem coerente com o objetivo do artefato? | Sim | Ótimo | |
| 9 | O questionário possui quantidade de perguntas adequadas, sem excessos que causem perda na qualidade da pesquisa? | Sim | Ótimo | |
| 10 | A quantidade de respostas ao questionário foi alta? | Sim | Bom | |

<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):

- ID1: O artefato possui introdução?
- ID2: Todas as tabelas e imagens do artefato possuem legendas, fontes e são introduzidas no texto?
- ID4: O artefato possui bibliografia/referências bibliográficas?

Referentes à [Tabela 2](#Tabela2):

- ID1: Um cronograma para realização da elicitação dos requisitos?
- ID2: A gravação e os registros da atividade de elicitação dos requisitos?
- ID6: O questionário faz suas perguntas baseadas no perfil de usuário traçado pelo grupo?


## 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 08 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 08 de novembro de 2023. </br>
<a id="cc" href="#c">[3]</a> GRUPO 7. Documento do Questionário 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/questionario/). Acesso em 08 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 08 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` | 08/11/2023 | 10/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` | - | [Jefferson](https://github.com/Frans6) |
1 change: 1 addition & 0 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -71,6 +71,7 @@ nav:
- Entrega 2:
- Análise de documentos: verificacao/grupo7/analise-documentos.md
- Personas: verificacao/grupo7/personas.md
- Questionário: verificacao/grupo7/questionario.md
- Entrega 3:
- Especificação Suplementar: verificacao/grupo7/especificacao-suplementar.md
- Entregas: planejamento/entregas.md
Expand Down

0 comments on commit da732ee

Please sign in to comment.