Especificação de casos de uso: 5 passos

Aprenda em 5 passos como descrever e especificar casos de uso de forma correta e funcional

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 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.

Documentação de especificação de casos de uso em diferentes plataformas.
A especificação de casos de uso pode ser documentada facilmente usando um documento de texto como Microsoft Word ou Google Docs, ou ainda através de 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:

  1. Identificar os atores
  2. Determinar as pré-condições
  3. Identificar e detalhar o fluxo principal
  4. Especificar os fluxos alternativos ou de exceção
  5. 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.

Documentação de especificação de casos de uso em diferentes plataformas.
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.

Descrição das pré-condições necessárias para execução de um caso de uso.
Descrever as pré-condições é essencial para garantir que o caso de uso ocorra corretamente. Por exemplo, em uma compra online, é necessário que o usuário esteja logado e tenha selecionado os itens desejados antes de prosseguir

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.

Identificação das etapas do fluxo principal em um caso de uso
Identificar as etapas do fluxo principal: quais ações o usuário ou sistema devem realizar para completar o caso de uso? Cada etapa deve ser detalhada, incluindo 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.

Descrição das alternativas de fluxo em um caso de uso.
Descrever as alternativas de fluxo: quais ações alternativas 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.

Definição das pós-condições em um caso de uso.
Definir as pós-condições: o que acontece após a conclusão do caso de uso? É crucial estabelecer 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

  1. O usuário seleciona “Adicionar evento”.
  2. O sistema exibe um formulário de criação de evento.
  3. O usuário preenche os campos do formulário com as informações do evento (título, data, hora e local).
  4. O usuário clica em “Salvar”.
  5. O sistema adiciona o novo evento à agenda.
  6. 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

  1. O usuário seleciona um evento na agenda.
  2. O sistema exibe as informações do evento.
  3. O usuário seleciona “Adicionar lembrete”.
  4. O sistema exibe um formulário de criação de lembrete.
  5. O usuário preenche os campos do formulário com as informações do lembrete (data e hora do lembrete).
  6. O usuário clica em “Salvar”.
  7. O sistema adiciona o novo lembrete ao evento selecionado.
  8. 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:

  1. O usuário seleciona um evento na agenda.
  2. O sistema exibe as informações do evento.
  3. O usuário seleciona “Editar evento”.
  4. O sistema exibe um formulário de edição do evento com as informações atuais preenchidas.
  5. O usuário faz as alterações desejadas no evento (data, hora, local, etc.).
  6. O usuário clica em “Salvar”.
  7. O sistema atualiza as informações do evento na agenda do usuário.
  8. 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.

URGENTE: SEM SUA DOAÇÃO, SAIREMOS DO AR

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.

PATROCINE O SITE COM UM PIX DE QUALQUER VALOR!   Chaves PIX 🔑

[email protected]
[email protected]

 

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.

Francilvio Roberto Alff

Olá! Eu sou Francilvio Alff, mas você pode me chamar de Chico Alff. Vou fazer o m3u jabá rapidinho, eu prometo! :D Minha formação acadêmica é diversificada, com raízes em Engenharia de Software e Análise e Desenvolvimento de Sistemas para a Internet. Também mergulhei na História e na Língua Italiana em minha jornada acadêmica, embora essa aventura ainda não tenha sido concluída. Meu primeiro contato profissional e real com o incrível mundo dos sistemas foi em 2007, enquanto fazia a minha primeira graduação na Itália. Trabalhei na implantação da solução Orange Salsa para a gestão dos "informatori scientifici del farmaco" na colossal multinacional farmacêutica GlaxoSmithKline (GSK). Com o passar dos anos, me vi cada vez mais envolvido pela tecnologia, e ao longo dessas quase duas décadas, me especializei em Engenharia de Software, mais precisamente nas disciplinas de Análise de Requisitos, Análise de Negócios e Gerenciamento de Projetos. Nesse percurso, trabalhei em projetos desafiadores para a administração pública, soluções de ERP para o varejo e indústria, inteligência artificial aplicada em soluções IOT e linguagem neural.. Em 2011 fundei juntamente com um velho amigo e tutor o site https://AnalisedeRequisitos.com.br que mantenho até hoje como uma prova viva do meu comprometimento com a engenharia de software. Minha determinação e meu desejo constante de aprender continuam me impulsionando em direção ao futuro, onde pretendo continuar unindo minha paixão pela tecnologia com meu amor pela aprendizagem e minha curiosidade insaciável. Junte-se a mim nessa jornada!

Artigos relacionados

Apoie nosso projeto com R$ 5,00 e faça a diferença!


Sua contribuição é opcional 💔, mas a ameaça é real. Investimos horas do nosso dia para criar materiais de  qualidade.


PATROCINAR O SITE COM R$ 5,00

Doe R$5,00

Sua contribuição, por menor que seja, é essencial para que possamos continuar oferecendo conteúdo de qualidade, downloads de livros, cursos, templates, tudo isso gratuitamente para você e toda a comunidade, e sem anúncios chatos!

Isso vai fechar em 0 segundos

Apoie nosso projeto com R$ 10,00 e faça a diferença!


Sua contribuição é opcional 💔, mas a ameaça é real. Investimos horas do nosso dia para criar materiais de  qualidade.


PATROCINAR O SITE COM R$ 10,00

Doe R$ 10,00

Sua contribuição de R$10,00 faz toda a diferença, ela é essencial para que possamos continuar oferecendo conteúdo de qualidade, downloads de livros, cursos, templates, tudo isso gratuitamente para você e toda a comunidade, e sem anúncios chatos!

Isso vai fechar em 0 segundos

Apoie nosso projeto com R$ 20,00 e seja um grande apoiador!


Ao contribuir com R$ 20,00, você se torna um grande apoiador do nosso projeto e recebe todos os benefícios dos planos anteriores.


PATROCINAR O SITE COM R$ 20,00

Doe R$20,00 Acesso vitalício a todo o conteúdo premium

  • E-books e cursos online com desconto vitalício.
  • Fórum privado para troca de ideias e experiências.
  • Tenha sua dúvida respondida por um especialista em até 24hs.
  • Acesso a uma sessão de consultoria online exclusiva.

Isso vai fechar em 0 segundos

⚠️ URGENTE: O SITE PODE SAIR DO AR A QUALQUER MOMENTO!

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.

PATROCINE O SITE COM UM PIX DE QUALQUER VALOR! Chaves PIX 🔑
E-mail: [email protected]
E-mail: [email protected]

 

Isso vai fechar em 0 segundos