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.
ACESSO LIBERADO • CONTRIBUICAO OPCIONAL
Sem sua doacao, este site pode sair do ar hoje
Seu apoio mantem servidor, manutencao e novos conteudos.
Projeto independente desde 2011.
Aqui voce encontra livros, guias, modelos e artigos tecnicos sobre requisitos, projetos, agile e IA, com foco pratico e aplicacao real. Sua contribuicao mantem esse acervo aberto, sem paywall e com qualidade editorial para milhares de profissionais e estudantes evoluirem todos os dias.
Novos materiais com frequencia
Apoio direto ao projeto
Nao pode doar agora? Sem problema. O download esta disponivel abaixo.
Entrar e liberar download
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.
