Este material complementa o conteúdo do artigo Diagrama de Casos de Uso (use case diagram), explicando como especificar textualmente um caso de uso, através de 5 passos e 3 exemplos simples e claros.
Você vai ler nesse artigo:
O que é um caso de uso
Os casos de uso são uma técnica utilizada no processo de desenvolvimento de software para descrever como o sistema será utilizado pelos usuários. É importante lembrar que um caso de uso, não é a mesma coisa que uma história de usuário. Entenda melhor a diferença lendo os artigos: Como escrever uma user story fantástica e Product Management com ChatGPT: 6 ideias para começar.
É uma espécie de narrativa que descreve as interações entre o usuário e o sistema, mostrando como o sistema irá atender às necessidades do usuário em um cenário específico.
Principais funções e vantagens dos casos de uso
- Fornecem uma visão clara do sistema e ajudam a garantir que os requisitos do usuário sejam atendidos.
- Casos de uso são fáceis de entender e podem ser usados para comunicação com stakeholders do projeto.
- Ajudam a identificar e resolver problemas de requisitos precocemente, economizando tempo e dinheiro.
- Em resumo, os casos de uso são uma técnica importante e amplamente utilizada no processo de desenvolvimento de software.
Importância da especificação de casos de uso
A importância dos casos de uso está em sua capacidade de fornecer uma visão clara e concisa do que o sistema fará e como ele será utilizado. Isso ajuda a garantir que os requisitos do sistema estejam claramente definidos e que as expectativas do usuário sejam atendidas. Além disso, os casos de uso podem ser usados como base para o planejamento de testes de aceitação, garantindo que o sistema esteja em conformidade com os requisitos do usuário.
Outra vantagem dos casos de uso é que eles podem ser facilmente compreendidos por pessoas sem conhecimento técnico. Isso significa que eles podem ser usados para comunicação com stakeholders do projeto, incluindo gerentes de projeto, usuários finais e desenvolvedores. Isso pode ajudar a garantir que todos tenham uma compreensão clara do que está sendo desenvolvido e do que é esperado do sistema.
Por fim, os casos de uso podem ajudar a identificar e resolver problemas de requisitos precocemente no processo de desenvolvimento. Isso pode economizar tempo e dinheiro, pois problemas identificados tardiamente podem exigir retrabalho significativo
Como especificar um caso de uso em 5 passos
A especificação de casos de uso pode ser documentada facilmente utilizando um documento de texto como o Microsoft Word ou Google} Docs, ou então através sistemas específicos como Atlassian Jira e Freshworks.
Para facilitar a compreensão, dividimos a documentação dos casos de uso em 5 passos e etapas fundamentais:
- Identificar os atores
- Determinar as pré-condições
- Identificar e detalhar o fluxo principal
- Especificar os fluxos alternativos ou de exceção
- Especificar as pós-condições ou resultados esperados
Identificar os atores envolvidos
Identificar os atores envolvidos: quem são os usuários ou sistemas que interagem com o caso de uso? É importante definir seus papéis e responsabilidades no processo.
Determinar pré-condições necessárias
Descrever as pré-condições: quais são as condições que devem ser atendidas para que o caso de uso ocorra?
Por exemplo, se o caso de uso envolve uma compra online, é preciso que o usuário esteja logado e tenha selecionado os itens que deseja comprar.
Detalhar o fluxo principal
Identificar as etapas do fluxo principal: quais são as ações que o usuário ou sistema devem realizar para completar o caso de uso? É importante detalhar cada etapa e as condições de sucesso ou falha.
Detalhar os fluxos alternativos ou de exceções
Descrever as alternativas de fluxo: quais são as ações alternativas que o usuário pode tomar durante o caso de uso? Por exemplo, se o usuário não encontra o produto desejado, ele pode buscar por outros produtos ou abandonar a compra.
Definir o resultado esperado
Definir as pós-condições: o que acontece após a conclusão do caso de uso? É importante definir as condições que devem ser atendidas para que o caso de uso seja considerado concluído com sucesso.
Exemplos de especificação de casos de uso
Desenvolvemos três diferentes cenários de interações para exemplificar como deve ser realizada a documentação e especificação de um casos de uso de software.
Os casos de uso que apresentaremos descrevem as interações e comportamentos esperados em um sistema de Agenda com cadastro e manutenção de eventos.
Caso de Uso: “Adicionar Evento na agenda”
Atores
- Usuário
- Sistema
Pré-condições
- O usuário deve estar autenticado no sistema de agenda.
- O usuário deve estar na visualização da agenda.
Fluxo Principal
- O usuário seleciona “Adicionar evento”.
- O sistema exibe um formulário de criação de evento.
- O usuário preenche os campos do formulário com as informações do evento (título, data, hora e local).
- O usuário clica em “Salvar”.
- O sistema adiciona o novo evento à agenda.
- O sistema exibe a visualização atualizada da agenda, com o novo evento adicionado.
Pós-condições
- O novo evento é adicionado à agenda do usuário.
- O usuário pode visualizar o novo evento na sua agenda.
Caso de Uso: “Adicionar Lembrete a um Evento”
Atores
- Usuário
- Sistema
Pré-condições
- O usuário deve estar autenticado no sistema de agenda.
- O usuário deve estar na visualização da agenda.
Fluxo Principal
- O usuário seleciona um evento na agenda.
- O sistema exibe as informações do evento.
- O usuário seleciona “Adicionar lembrete”.
- O sistema exibe um formulário de criação de lembrete.
- O usuário preenche os campos do formulário com as informações do lembrete (data e hora do lembrete).
- O usuário clica em “Salvar”.
- O sistema adiciona o novo lembrete ao evento selecionado.
- O sistema exibe a visualização atualizada da agenda, com o lembrete adicionado ao evento.
Pós-condições
- O novo lembrete é adicionado ao evento selecionado na agenda do usuário.
- O usuário pode visualizar o novo lembrete no evento correspondente na sua agenda.
Caso de Uso: “Editar Evento na Agenda”
Atores
- Usuário
- Sistema
Pré-condições:
- O usuário deve estar autenticado no sistema de agenda.
- O usuário deve estar na visualização da agenda.
- Deve haver pelo menos um evento na agenda do usuário.
Fluxo Principal:
- O usuário seleciona um evento na agenda.
- O sistema exibe as informações do evento.
- O usuário seleciona “Editar evento”.
- O sistema exibe um formulário de edição do evento com as informações atuais preenchidas.
- O usuário faz as alterações desejadas no evento (data, hora, local, etc.).
- O usuário clica em “Salvar”.
- O sistema atualiza as informações do evento na agenda do usuário.
- O sistema exibe a visualização atualizada da agenda, com as alterações no evento.
Pós-condições:
- As informações do evento selecionado na agenda do usuário são atualizadas com as alterações feitas pelo usuário.
- O usuário pode visualizar as informações atualizadas do evento na sua agenda.
Modelo de exemplo de casos de uso
Criamos e disponibilizados nesse link um modelo de documento de casos de uso, você pode adaptá-lo conforme a necessidade de seu projeto, o fundamental que seja gerado um artefato final contendo o detalhamento dos casos de uso.
Caro usuário, desde 2011 disponibilizamos acesso a conteúdos excepcionais, tudo isso sem anúncios irritantes. Sua contribuição é essencial para que possamos continuar oferecendo conteúdo de qualidade e gratuito.🚀 AJUDE O SITE PATROCINANDO COM UMA DOAÇÃO DE QUALQUER OUTRO VALOR
CONTEÚDO EXCLUSIVO
FAÇA LOGIN OU CADASTRE-SE GRATUITAMENTE
Tenha acesso COMPLETO à todo o conteúdo do site! Entre 🔓gratuitamente com sua conta Google ou LinkedIn nos botões abaixo para ter acesso ao arquivo.
Lembre-se: cada doação conta. Obrigado por fazer parte da nossa comunidade e por apoiar o site! 🙌🌟
Patrocinando o site você garante o acesso a este material exclusivo e a muitos outros conteúdos valiosos sobre análise de requisitos, como:
- Livros e cursos para download
- Modelos e guias práticos
- Ferramentas e checklists
- Artigos originais e de qualidade
- Grupo exclusivo no WhatsApp
Recomendamos os seguintes artigos relacionados
Publicamos aqui no Análise de Requisitos e Negócio, Scrum e Gerenciamento de Projetos, uma série de artigos originais sobre as disciplinas da engenharia de software, etapas do desenvolvimento de software, e explicações detalhadas dos artefatos e entrada e saída de cada fase, sempre acompanhado de exemplos e modelos prontos para uso.