Casos de Uso

Introdução

Segundo Barbosa e Silva no livro Interação Humano-Computador, o diagrama de casos de uso é uma representação visual que descreve as interações entre um sistema e seus usuários externos, destacando as principais funcionalidades do sistema e como os usuários as utilizam.

Objetivos

Este artefato tem como objetivos:

• Documentar as interações principais: Fornecer uma visão clara das principais interações entre os usuários e o sistema, facilitando a compreensão das funcionalidades e do escopo do sistema.
• Apoiar a comunicação: Servir como uma ferramenta de comunicação eficaz entre os diferentes stakeholders do projeto, garantindo que todos tenham um entendimento comum sobre como o sistema deve se comportar.
• Orientar o desenvolvimento: Auxiliar a equipe de desenvolvimento na implementação das funcionalidades descritas, garantindo que todas as interações necessárias sejam consideradas.
• Facilitar a validação: Permitir que os usuários e outros stakeholders validem se as necessidades e expectativas estão sendo atendidas, identificando lacunas ou ambiguidades nas especificações.
• Manter a rastreabilidade: Prover um meio de rastrear as funcionalidades desde os requisitos até a implementação e os testes, assegurando que todas as funcionalidades necessárias sejam implementadas e verificadas.

Metodologia

Para criar este artefato, seguimos a abordagem tradicional de representação dos casos de uso por meio de diagramas UML. Utilizamos o LucidChart, uma ferramenta online para criação de diagramas, como nossa plataforma de escolha.

Componentes e Símbolos

Um diagrama de casos de uso é composto pelos seguintes elementos:

Atores

Os atores representam os usuários e sistemas envolvidos nas interações com o sistema. Eles são comumente representados por ícones de bonecos de palitos como é possivel ver na figura 1.

Figura 1: Ator

Fonte: Douglas Marinho.

Cenário

O cenário é a sequência de eventos que ocorre quando um usuário interage com o sistema. É representado por uma caixa que delimita as atividades dentro do escopo do sistema, visto na figura 2.

Figura 2: Cenário

Fonte: Douglas Marinho.

Caso de Uso

Um caso de uso descreve uma funcionalidade ou atividade realizada pelo usuário. É representado por uma forma oval horizontal e deve ser descrito com verbos no infinitivo, representado na figura 3.

Figura 3: Caso de uso

Fonte: Douglas Marinho.

Comunicação (ou Ação)

As comunicações representam as ações que conectam os usuários aos casos de uso ligadas por linha como na figura 4. Elas podem ser de dois tipos:

• Inclusão: Indica que um caso de uso depende da execução de outro caso de uso.

• Notação no diagrama: <<incluir>>

• Extensão: Indica que um caso de uso pode ser estendido por outro, adicionando novos passos ou funcionalidades.

• Notação no diagrama: <<estender>>

Figura 4: Comunicação

Fonte: Douglas Marinho

Diagrama de Casos de Uso

Na figura 5 temos o diagrama UML com os principais casos de uso da aplicação

Figura 5: Diagrama de casos de uso.

Fonte: Douglas Marinho

Especificação de Caso de Uso

Para especificar os casos de uso, foi utilizado um documento exemplificativo do Ministério da Ciência, Tecnologia, Inovações e Comunicações¹, aplicando os conceitos detalhados na Tabela abaixo.

Tabela 1: Especificação do caso de uso

Elemento	Descrição
Atores	Entidades que interagem com o sistema para realizar um caso de uso.
Frequência de uso	Frequência com que o caso de uso é executado, como diária, semanal, ou sob demanda.
Requisitos	Conjunto de condições ou capacidades necessárias para a realização do caso de uso.
Condição de entrada	Pré-condições que devem ser satisfeitas antes que o caso de uso possa iniciar.
Fluxo principal	Sequência padrão de passos executados para realizar o caso de uso com sucesso.
Fluxos alternativos	Variações no fluxo principal que podem ocorrer para atingir o mesmo objetivo de maneira diferente.
Fluxos de exceção	Situações anômalas ou erros que desviam do fluxo principal e como são tratadas.
Pós-condições	Estado do sistema após a execução bem-sucedida do caso de uso.
Rastreabilidade	Relacionamento do caso de uso com outros artefatos de desenvolvimento, como requisitos ou testes.

Fonte: Ministério da Ciência, Tecnologia, Inovações e Comunicações¹

A seguir, apresenta-se a especificação dos casos de uso identificados.

UC01. Consultar Documentos Legislativos

O caso de uso "Consultar Documentos Legislativos" detalhado na tabela 2 descreve a interação do usuário com o sistema para buscar e visualizar documentos legislativos. Este processo envolve a inserção de critérios de busca e a exibição dos resultados correspondentes.

Tabela 2: Caso de uso 1 - Consultar Documentos Legislativos.

UC01	Consultar Documentos Legislativos
Atores	Usuário
Frequência de uso	Alta
Requisitos	Conexão com a internet
Condição de entrada	O usuário acessa a aplicação e seleciona a opção de consulta de documentos legislativos
Fluxo principal	O sistema apresenta a interface de busca de documentos legislativos O usuário insere os critérios de busca O sistema busca e exibe os documentos legislativos que correspondem aos critérios inseridos
Fluxos alternativos	Não há
Fluxos de exceção	Conexão com a internet perdida O sistema detecta a perda de conexão O sistema apresenta uma mensagem de erro "Falha na conexão. Tentar novamente?" e opções "Sim" e "Retornar à tela inicial" O usuário seleciona "Sim" e o sistema tenta reconectar O usuário seleciona "Retornar à tela inicial" e a operação é cancelada
Pós-condições	O usuário visualiza os documentos legislativos de acordo com os critérios de busca inseridos
Rastreabilidade	IS01 IS04 OBS03

Fonte: Eric Silveira e Henrique Torres

A seguir na figura 06 temos representado o diagrama do caso de uso 1, referente a consultas de documentos legislativos públicos do Diário Oficial da União.

Figura 6: Caso de uso 1 - Consultar Documentos Legislativos

Fonte: Eric Silveira

UC02. Salvar Documentos para Consulta Offline

O caso de uso "Salvar Documentos para Consulta Offline" detalhado na tabela 3 descreve como o usuário pode salvar documentos legislativos no dispositivo para acesso posterior sem conexão com a internet.

Tabela 3: Caso de uso 2 - Salvar Documentos para Consulta Offline.

UC02	Salvar Documentos para Consulta Offline
Atores	Usuário
Frequência de uso	Média
Requisitos	Conexão com a internet (para salvar)
Condição de entrada	O usuário acessa a aplicação e seleciona um documento legislativo para salvar
Fluxo principal	O sistema exibe o documento legislativo selecionado O usuário seleciona a opção de salvar o documento para consulta offline O sistema salva o documento no dispositivo do usuário
Fluxos alternativos	Não há
Fluxos de exceção	Conexão com a internet perdida durante o salvamento O sistema detecta a perda de conexão O sistema apresenta uma mensagem de erro "Falha na conexão. Tentar novamente?" e opções "Sim" e "Retornar à tela inicial" O usuário seleciona "Sim" e o sistema tenta reconectar e salvar novamente O usuário seleciona "Retornar à tela inicial" e a operação é cancelada
Pós-condições	O documento legislativo está disponível para consulta offline no dispositivo do usuário
Rastreabilidade	IS02 OBS05

Fonte: Arthur Alves e Henrique Torres

A seguir na figura 7 temos representado o diagrama do caso de uso 2, referente a salvar documentos para consulta offline do Diário Oficial da União.

Figura 7: Caso de uso 2 - Salvar Documentos para Consulta Offline

Fonte: Arthur Alves

UC03. Receber Notificações Personalizadas

O caso de uso "Receber Notificações Personalizadas" descrito na tabela 4 detalha como o usuário pode configurar e receber notificações baseadas em critérios específicos, mantendo-o atualizado sobre novas publicações legislativas relevantes.

Tabela 4: Caso de uso 3 - Receber Notificações Personalizadas.

UC03	Receber Notificações Personalizadas
Atores	Usuário
Frequência de uso	Alta
Requisitos	Conexão com a internet
Condição de entrada	O usuário ativa a opção de notificações personalizadas nas configurações da aplicação
Fluxo principal	O sistema apresenta opções de configuração de notificações O usuário seleciona os critérios para notificações personalizadas O sistema salva as configurações de notificações O sistema envia notificações de acordo com os critérios selecionados pelo usuário
Fluxos alternativos	Não há
Fluxos de exceção	Falha na entrega da notificação O sistema detecta a falha na entrega O sistema registra a falha e tenta reenviar a notificação quando a conexão for restabelecida
Pós-condições	O usuário recebe notificações personalizadas sobre novas publicações relevantes
Rastreabilidade	IS03 OBS06

Fonte: Diego Sousa e Henrique Torres

A seguir na figura 8 temos representado o diagrama do caso de uso 3, referente a receber Notificações Personalizadas.

Figura 8: Caso de uso 3 - Receber Notificações Personalizadas

Fonte: Diego Sousa

UC04. Acessar Histórico de Publicações Legislativas

O caso de uso "Acessar Histórico de Publicações Legislativas" apresentado na tabela 5 descreve como o usuário pode buscar e visualizar o histórico de publicações legislativas, permitindo uma análise das publicações anteriores.

Tabela 5: Caso de uso 4 - Acessar Histórico de Publicações Legislativas.

UC04	Acessar Histórico de Publicações Legislativas
Atores	Usuário
Frequência de uso	Alta
Requisitos	Conexão com a internet
Condição de entrada	O usuário acessa a aplicação e seleciona a opção de histórico de publicações
Fluxo principal	O sistema apresenta a interface de histórico de publicações O usuário insere os critérios de busca no histórico O sistema busca e exibe as publicações legislativas que correspondem aos critérios inseridos
Fluxos alternativos	Não há
Fluxos de exceção	Conexão com a internet perdida O sistema detecta a perda de conexão O sistema apresenta uma mensagem de erro "Falha na conexão. Tentar novamente?" e opções "Sim" e "Retornar à tela inicial" O usuário seleciona "Sim" e o sistema tenta reconectar O usuário seleciona "Retornar à tela inicial" e a operação é cancelada
Pós-condições	O usuário visualiza o histórico de publicações legislativas conforme os critérios inseridos
Rastreabilidade	IS04 OBS07

Fonte: Henrique Torres e Luiz Gustavo

A seguir na figura 09 temos representado o diagrama do caso de uso 4, referente ao acesso do histórico de publicações legislativas do Diário Oficial da União.

Figura 9: Caso de uso 4 - Acessar Histórico de Publicações Legislativas

Fonte: Luiz Gustavo

UC05. Filtrar Documentos por Data, Categoria ou Órgão Emissor

O caso de uso "Filtrar Documentos por Data, Categoria ou Órgão Emissor" descrito na tabela 6 detalha como o usuário pode aplicar filtros específicos para encontrar documentos legislativos de acordo com critérios como data, categoria ou órgão emissor.

Tabela 6: Caso de uso 5 - Filtrar Documentos por Data, Categoria ou Órgão Emissor

UC05	Filtrar Documentos por Data, Categoria ou Órgão Emissor
Atores	Usuário
Frequência de uso	Alta
Requisitos	Conexão com a internet
Condição de entrada	O usuário acessa a aplicação e seleciona a opção de filtragem de documentos
Fluxo principal	O sistema apresenta a interface de filtragem de documentos O usuário seleciona os critérios de filtragem desejados (data, categoria, órgão emissor) O sistema busca e exibe os documentos que correspondem aos critérios de filtragem inseridos
Fluxos alternativos	Não há
Fluxos de exceção	Conexão com a internet perdida O sistema detecta a perda de conexão O sistema apresenta uma mensagem de erro "Falha na conexão. Tentar novamente?" e opções "Sim" e "Retornar à tela inicial" O usuário seleciona "Sim" e o sistema tenta reconectar O usuário seleciona "Retornar à tela inicial" e a operação é cancelada
Pós-condições	O usuário visualiza os documentos filtrados conforme os critérios inseridos
Rastreabilidade	OBS04

Fonte: Henrique Torres

A seguir na figura 10 temos representado o diagrama do caso de uso 5, referente ao filtro por data, categoria ou órgão emissor na pesquisa do Diário Oficial da União

Figura 10: Caso de uso 5 - Filtrar Documentos por Data, Categoria ou Órgão Emissor

Fonte: João Artur

Referência Bibliográfica

1. MINISTÉRIO DA CIÊNCIA, TECNOLOGIA, INOVAÇÕES E COMUNICAÇÕES. Especificação de Caso de Uso. Aula 12. Disponível na plataforma Aprender3. Acesso em: 15/05/2024.

Bibliografia

Macedo, Lucas. "Caso de uso". Repositório da disciplina de Requisitos de Software da Universidade de Brasília, 2022. Disponível em: <https://requisitos-de-software.github.io/2022.2-Lichess/modelagem/casos_de_uso/>. Acesso em: 15/05/2024.

Lucidchart. "Diagrama de Caso de Uso UML". Disponível em: <https://www.lucidchart.com/pages/pt/diagrama-de-caso-de-uso-uml>. Acesso em: 15/05/2024.

Barbosa, S. D. J.; Silva, B. S. "Interação Humano-Computador". Rio de Janeiro: Elsevier, 2011.

SERRANO M., SERRANO M. Requisitos - Aula 13. Disponível na plataforma Aprender3. Acesso em: 15/05/2024.

Histórico de Versão

Versão	Data	Data Prevista de Revisão	Descrição	Autor	Revisor
1.0	15/05/2024	15/05/2024	Criação do documento sobre Casos de uso	Douglas Marinho	Arthur Alves e Eric Silveira
1.1	16/05/2024	16/05/2024	Adicionando as tabelas dos casos de uso especificados	Henrique Torres	Arthur Alves e Eric Silveira
1.2	17/05/2024	18/05/2024	Adição do Diagrama UML	Douglas Marinho	Eric Silveira
1.3	18/05/2024	19/05/2024	Adição do diagrama do caso de uso 4	Luiz Gustavo	Eric Silveira
2.0	05/07/2024	07/07/2024	Adição do Diagrama UC01 e Padronização do documento	Eric Silveira	Douglas Marinho e Henrique Torres
2.1	07/07/2024	08/07/2024	Adição dos objetivos do artefato	Douglas Marinho	Eric Silveira e Henrique Torres
2.2	08/07/2024	08/07/2024	Adição do Diagrama UC02 e alterações do documento	Arthur Alves	Douglas Marinho e Henrique Torres
2.3	08/07/2024	08/07/2024	Adição do Diagrama UC03	Diego Sousa	Douglas Marinho e Henrique Torres
2.4	08/07/2024	08/07/2024	Adicção do Diagrama UC05	João Artur	Diego Sousa