Confiabilidade - M3: Percentual de requisitos com critérios de aceitação bem definidos

Introdução

Na presente execução da análise de confiabilidade do Agromart, foi definida, durante a Fase 2 do projeto, métricas que seriam utilizadas para avaliação do software. Logo, este documento tem como objetivo sintetizar os achados da métrica M3 de confiabilidade do Agromart: Percentual de requisitos com critérios de aceitação bem definidos.

Referencial teórico

Para executar a avaliação, é necessário possuir um definição de critérios de aceitação para requisitos. Cabe frizar que a análise foi realizada a partir dos critérios de aceitação das histórias de usuário, uma vez que, quando especificados os requisitos na documentação do Agromart, não foram colocados critérios de aceitação.

Segundo Cohn ^[1], a clareza e satisfação de histórias de usuário tem profunda ligação com adequação de uma aplicação. Dessa forma, podemos compreender também que ao satisfazer histórias de usuário, o software, consequentemente, se torna mais confiável em sua atividade, uma vez que, conclui as atividades de forma correta e satisfatória.

Sendo assim, é de extrema importância a declaração de critérios de aceitação para histórias de usuário de forma correta. Sendo assim, bons critérios de aceitação devem seguir os seguintes conceitos ^[1]^[2]:

Clareza e consisão: devem ser escritos em linguagem sinples, sem a uitlização de jargões técnicos e com ambiguidade, para que assim todos os interessados (devs, testers, PO, etc) consigam compreender o que o critério significa;
Testabilidade: cada critério de aceitação deve poder ser comprovado por um teste específico, dessa forma, é possível cerificar a funcionalidade e cumprimento dos requisitos;
Resultado: o foco deve ser no resultado esperado do requisito, ou seja, "o quê" está sendo realizado, deixando em aberto como a solução deve ser implementada;
Independência: cada critério a ser utilizado deve poder ser avaliado isoladamente. Dessa forma, os testes individuais são facilitados e a baixa coesão do software é evidenciada.

Assim, um conjunto de critérios de aceitação completo é aquele que, para cada história de usuário, define claramente as condições de sucesso de forma testável. Critérios eficazes são: clareza e brevidade, testabilidade objetiva, foco no resultado do usuário e mensuráveis, e idealmente independentes entre si.

Análise

Dessa forma, a avaliação será dada de forma qualitativa, com a análise dos critérios de aceitação disponíveis na documentação do Agromart, em histórias de usuário.

Os critérios de julgamento e níveis de pontuação da métrica serão utilizados conforme especificados na Fase 2.

Execução da análise

Na Tabela 1, está presente a análise realizada nos critérios de aceitação de histórias de usuário do Agromart.

A organização da tabela está feita de acordo com a história de usuário, seguindo das colunas que expressam os conceitos corretos para critérios de aceitação, e por fim, a pontuação para a corretude desses critérios aplicados a história de usuário correspondente.

Tabela 1 – Avaliação e pontuação dos critérios de aceitação das histórias de usuário do Agromart

História de Usuário	Clareza e Concisão	Testabilidade	Resultado	Independência	Pontuação
US01: Realizar Cadastro na CSA	Sim	Não	Sim	Sim	3/4
US02: Realizar Cadastro em outra CSA	Não	Não	Sim	Não	1/4
US03: Realizar login no Agromart	Não	Não	Não	Não	0/4
US04: Baixar o aplicativo no celular	Não	Não	Não	Não	0/4
US05: Acessar uma notificação	Não	Não	Não	Não	0/4
US06: Realizar uma busca	Não	Não	Não	Não	0/4
US07: Sair	Não	Não	Não	Não	0/4
US08: Acesssar página Meus Planos	Não	Não	Não	Não	0/4
US09: Acesssar página Meus Endereços	Não	Não	Não	Não	0/4
US10: Acessar página das lojas da CSA cadastradas	Não	Não	Não	Não	0/4
US11: Acessar histórico de compras	Não	Não	Não	Não	0/4
US12: Adicionar ao carrinho	Não	Não	Não	Não	0/4
US13: Comprar cesta	Não	Não	Não	Não	0/4
US14: Comprar produto	Não	Não	Não	Não	0/4
US15: Comprar planos	Não	Não	Não	Não	0/4
US16: Realizar login no Strapi	Não	Não	Não	Não	0/4
US17: Realizar login no Aplicativo	Não	Não	Não	Não	0/4
US18: Possuir um tutorial	Não	Não	Não	Não	0/4
US19: Interagir com Produtos	Sim	Sim	Não	Sim	3/4
US20: Interagir com Planos	Sim	Sim	Não	Sim	3/4
US21: Interagir com Cestas	Sim	Sim	Não	Sim	3/4
US22: Interagir com um Co-agricultor	Sim	Sim	Não	Sim	3/4
US23: Interagir com Lojas	Sim	Sim	Não	Sim	3/4
US24: Criar notificações	Não	Não	Não	Não	0/4
US25: Interagir com Pedidos	Não	Não	Não	Não	0/4
US26: Visualizar endereços	Não	Não	Não	Não	0/4

Autor: Júlia Fortunato

Resultados

Ao realizar a análise, observou-se que grande parte das histórias não apresentam critérios de aceitação que atendam minimamente essas qualidades. Em muitos casos, os critérios estavam ausentes, eram ambíguos ou expressavam condições que mais se aproximam de pré-requisitos para uso (como "possuir acesso à internet", "ter o código da CSA") do que de critérios de aceitação propriamente ditos.

Além disso, notou-se o uso de termos vagos ou técnicos demais, como em "deve conversar com o administrador para estabelecer a forma de pagamento" — o que pode gerar confusão: trata-se de uma interação com o sistema ou com uma pessoa real? Tal fato compromete diretamente a clareza e a testabilidade.

Também foram identificados critérios como "deve estar logado", utilizados de forma repetida e isolada para funcionalidades diversas (como acessar notificações, histórico de compras, etc.), sem detalhar o fluxo ou o comportamento esperado da funcionalidade.

Dessa forma, a Tabela 2 apresenta um panorama quantitativo das pontuações atribuídas aos critérios de aceitação das histórias de usuário avaliadas, evidenciando a necessidade de revisão e aprimoramento desses elementos para garantir maior qualidade e confiabilidade na especificação dos requisitos, uma vez que, cerca de 73% dos critérios de aceitação não pontuaram na avaliação, sendo assim o nível de pontuação da métrica marcado como insatisfatório.

Tabela 2 – Distribuição de histórias de usuário por pontuação dos critérios de aceitação

Pontuação	Quantidade	Porcentagem
0/4	19	73,08%
1/4	1	3,85%
2/4	0	0,00%
3/4	6	23,07%
4/4	0	0,00%
Total	26	100%

Autor: Júlia Fortunato

Bibliografia

- Documentação de histórias de usuário do AgroMart. Disponível em: https://agromart.github.io/docs/docs/modelagem/historiaDeUsuario/co-agricultor. Acesso em: 07 de julho de 2025.

- ALTEXSOFT. Acceptance Criteria: Purposes, Types, Examples and Best Prac. Disponível em: https://www.altexsoft.com/blog/acceptance-criteria-purposes-formats-and-best-practices/. Acesso em: 07 de julho de 2025.

‌

Referências Bibliográficas

[1] COHN, M.; BECK, K. User stories applied : for agile software development. Boston Etc.: Addison-Wesley, , Cop, 2004.

[2] ATLASSIAN. Acceptance Criteria Explained [+ Examples & Tips]. Disponível em: https://www.atlassian.com/work-management/project-management/acceptance-criteria. Acesso em: 07 de julho de 2025.

Histórico de Versões

Versão	Data	Descrição	Autor	Revisor
`1.0`	07/07/2025	Criação do documento	Júlia Fortunato	Maurício Ferreira