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.
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
Casos de uso facilitam a compreensão e comunicação, garantem a aderência aos requisitos, ajudam a identificar problemas cedo e economizam tempo e recursos no desenvolvimento.
-
Facilitam a compreensão do sistema:
Casos de uso fornecem uma visão clara e detalhada do funcionamento do sistema. -
Aprimoram a comunicação com stakeholders:
São fáceis de entender e podem ser usados para alinhar expectativas entre a equipe e os envolvidos no projeto. -
Garantem que os requisitos sejam atendidos:
Ajudam a assegurar que o sistema atenda às necessidades e expectativas dos usuários. -
Identificação precoce de problemas:
Facilitam a detecção de lacunas e inconsistências nos requisitos nas fases iniciais do projeto. -
Economia de tempo e recursos:
Ajudam a evitar retrabalho, reduzindo custos e tempo de desenvolvimento.
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.
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.
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.
Desde 2011, você tem acesso a conteúdos valiosos e gratuitos aqui. Mas a realidade é dura: sem sua ajuda imediata, não conseguiremos manter o site no ar. Estamos no limite. Precisamos da sua contribuição agora para continuar funcionando. Um pequeno gesto seu pode fazer toda a diferença. Sem sua doação, o fim pode ser hoje. Por favor, não deixe este projeto morrer. chico@antiheroi.com
URGENTE: SEM SUA DOAÇÃO, SAIREMOS DO AR
Chaves PIX 🔑
pix@analisederequisitos.com.br
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.
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.
LIVRO: Gatilhos Mentais
Modelo de Prompt: Criando Atas em Segundos com IA
Rapid Prototyping: Como Construir Protótipos Rapidamente