Casos de Uso
Introdução
O diagrama de casos de uso, também conhecido como diagrama comportamental na notação UML, tem como objetivo registrar como o sistema deve funcionar sob a perspectiva de um usuário externo. Para isso, utiliza os léxicos identificados durante a definição dos casos de uso, descrevendo, assim, um conjunto de ações realizadas pelo sistema.
No contexto do diagrama de casos de uso, cada caso deve fornecer um resultado prático para o usuário que interage com ele. Quando determinados casos exigem maior detalhamento, recomenda-se adotar uma abordagem mais descritiva e próxima da linguagem natural. Essa prática, amplamente aceita pela comunidade de desenvolvedores, é conhecida como previsão de casos de uso.
Metodologia
Para a criação dos artistas, foi adotada uma abordagem tradicional, consistindo na elaboração de um diagrama de casos de uso UML. Utilizou-se a ferramenta LucidChart, um software especializado em criação
Componentes e Símbolos
Um diagrama de casos de uso é composto pelos seguintes elementos, os quais serão explicados a seguir para oferecer uma compreensão mais detalhada do diagrama.
Atores
Representamos os usuários e sistemas, ou categorias desses elementos, sendo geralmente ilustrados por ícones que lembram figuras humanas.
Cenário
Neste elemento, são descritos os eventos que ocorrem quando um usuário interage com o sistema. Normalmente, é representado por uma caixa.
Todos os casos de uso que o sistema descrito devem ser incluídos neste cenário; caso contrário, serão considerados fora do escopo do sistema.
Casos de uso
O caso de uso é uma ação ou funcionalidade realizada pelo usuário, o ator. Normalmente, é representado por um objeto oval horizontal, sendo que cada representação corresponde a uma interação distinta que o usuário pode ter com o sistema. Para se referir às ações realizadas, é comum usar verbos no infinitivo para descrevê-las.
Comunicação (ou ação)
Consiste em uma ação que o usuário realizará sobre o caso de uso, conforme ilustrado na imagem 4. A ação pode ser de dois tipos:
Inclusão: Quando a funcionalidade de um caso de uso precisa ser realizada por meio de outro caso de uso. Em outras palavras, um caso de uso A inclui o caso de uso B, de forma que, ao executar o caso de uso A, o caso de uso B será automaticamente executado junto.
- Notação no diagrama : <>
Extensão: O caso de uso atual será executado normalmente, mas alguns casos de uso podem adicionar etapas extras no caso de uso estendido. Ou seja, se o caso de uso A estende o caso de uso B, ao executar o caso de uso A, o caso de uso B poderá ou não ser executado também.
- Notação no diagrama : <<>>
Casos de Uso
Os principais casos de uso, mais relevantes e frequentemente utilizados no aplicativo, estão ilustrados na imagem 5. Para uma visualização mais detalhada da imagem, consulte os casos de uso na Caesb Autoatendimento.
Autor(a): Natan Almeida.jpeg?raw=true)
Autor(a): Leandro de AlmeidaRequisitos Utilizados
Tabela 1: Informa os Requisitos utilizados no diagrama de caso de uso 1.
| Id | Descrição | Implementado |
|---|---|---|
| OBS3 | Visualizar Segunda Via de Conta | Sim |
| INT06 | Informar Falta d'Água | Sim |
| ADD03 | Realizar Auto Leitura do Hidrômetro | Sim |
| INT01 | Informar Vazamento | Sim |
| INT03 | Consultor Histórico de Consumo | Sim |
| ADD02 | Alterar Titularidade e Vencimento | Sim |
| INT15 | Agenda Atendimento Presencial | Não |
| ADD09 | Suporte de Chat ou Atendimento | Não |
| ADD08 | Notificações de Vencimento | Não |
| ENT07 | Filtro de Atendimentos | Não |
| ENT09 | Simulação de Tarifas | Não |
| B08 | Formas de Pagamento | Não |
Tabela 2: Informa os Requisitos utilizados no diagrama de caso de uso 2.
| Id | Descrição | Implementado |
|---|---|---|
| B10 | O sistema deve permitir a configuração de um pagamento mensal recorrente | |
| INT14 | O usuário deve poder consultar o mapa de interrupções de fornecimento. | |
| INT18 | O aplicativo deve disponibilizar alertas sobre manutenção programada. |
Especialização dos casos de uso
As tabelas de 3 a 10 mostram a especialização dos casos de uso.
Tabela 3: Visualizar Segunda Via de Conta
| UC01 | Informações |
|---|---|
| Descrição | O usuário pode acessar e visualizar a segunda via de sua conta para pagamento |
| Ator | Usuário |
| Pré-condições | Acesso à internet, conta ativa no sistema |
| Ação | O usuário acessou o aplicativo e obteve a segunda via da conta |
| Fluxo principal | 1. O usuário acessa o aplicativo. 2. O usuário seleciona "Segunda Via de Conta" 3. O sistema exibe a segunda via em formato PDF para download ou impressão |
| Fluxo alternativo | O usuário não encontra a segunda via no app e acessa o suporte |
| Fluxo de exceção | O sistema é indisponível, e o usuário tenta novamente mais tarde |
| Pós-condições | A segunda via da conta é gerada e enviada ao usuário |
| Data de Criação | 05/12/2024 |
| Rastreabilidade | OBS3 |
Tabela 11: Informar Falta d'Água
| UC02 | Informações |
|---|---|
| Descrição | O usuário pode relatar falta de água em sua localidade para a entrega |
| Ator | Usuário |
| Pré-condições | Acesso à internet, localização conhecida |
| Ação | O usuário relatou falta de água com detalhes de endereço |
| Fluxo principal | 1. O usuário acessa o aplicativo 2. O usuário seleciona "Informar Falta d'Água" 3. O sistema solicita o endereço ou usa localização automaticamente 4. O usuário confirma as informações e envia o relatório |
| Fluxo alternativo | O sistema não registra a localização automaticamente e o usuário insere manualmente o endereço |
| Fluxo de exceção | O sistema é indisponível, e o usuário tenta novamente mais tarde |
| Pós-condições | A falta d'água é registrada para análise e resposta |
| Data de Criação | 05/12/2024 |
| Rastreabilidade | INT06 |
Tabela 11: Realizar Auto Leitura do Hidrômetro
| UC03 | Informações |
|---|---|
| Descrição | O usuário pode informar a leitura do hidrômetro manualmente para atualizar o consumo |
| Ator | Usuário |
| Pré-condições | Acesso ao hidrômetro, acesso ao aplicativo |
| Ação | O usuário registra a leitura no sistema |
| Fluxo principal | 1. O usuário acessa o aplicativo 2. O usuário seleciona "Auto Leitura do Hidrômetro" 3. O sistema solicita os dados da leitura atual 4. O usuário insira os dados e confirme o envio |
| Fluxo alternativo | O usuário insere um valor incorreto e o sistema solicita uma nova leitura |
| Fluxo de exceção | O hidrômetro está inacessível, e o usuário registra o problema no sistema |
| Pós-condições | A leitura do hidrômetro é atualizada no sistema |
| Data de Criação | 05/12/2024 |
| Rastreabilidade | ADD03 |
Tabela 11: Informar Vazamento
| UC04 | Informações |
|---|---|
| Descrição | O usuário pode relatar vazamentos de água observados em residência ou área externa |
| Ator | Usuário |
| Pré-condições | Acesso à internet, informações do local do vazamento |
| Ação | O usuário registra os detalhes do vazamento no sistema |
| Fluxo principal | 1. O usuário acessa o aplicativo 2. O usuário seleciona "Informar Vazamento" 3. O sistema solicita informações como localização e descrição do problema 4. O usuário confirma as informações e envia |
| Fluxo alternativo | O sistema sugere campos adicionais para complementação caso as informações estejam incompletas |
| Fluxo de exceção | O sistema é indisponível, e o usuário tenta novamente mais tarde |
| Pós-condições | O vazamento é registrado no sistema para ação da equipe técnica |
| Data de Criação | 05/12/2024 |
| Rastreabilidade | INT01 |
Tabela 11: Consultor Histórico de Consumo
| UC05 | Informações |
|---|---|
| Descrição | O usuário pode consultar o histórico de consumo de água ao longo do tempo |
| Ator | Usuário |
| Pré-condições | Acesso à internet, dados disponíveis no sistema |
| Ação | O usuário visualiza os dados históricos no aplicativo |
| Fluxo principal | 1. O usuário acessa o aplicativo 2. O usuário seleciona "Histórico de Consumo" 3. O sistema exibe os dados de consumo por períodos (mensal, anual) |
| Fluxo alternativo | Não há dados disponíveis para o período selecionado e o sistema de informação ao usuário |
| Fluxo de exceção | O sistema é indisponível, e o usuário tenta novamente mais tarde |
| Pós-condições | O histórico de consumo é mostrado com sucesso |
| Data de Criação | 05/12/2024 |
| Rastreabilidade | INT03 |
Tabela 11: Alterar Titularidade e Vencimento
| UC06 | Informações |
|---|---|
| Descrição | O usuário pode alterar o titular da conta ou os dados de vencimento da fatura |
| Ator | Usuário |
| Pré-condições | Acesso ao sistema, conta ativa |
| Ação | O usuário realiza a alteração solicitada |
| Fluxo principal | 1. O usuário acessa o aplicativo 2. O usuário seleciona "Alterar Titularidade e Vencimento" 3. O sistema solicita novos dados 4. O usuário confirma e salva as alterações |
| Fluxo alternativo | Dados incompletos, e o sistema solicita complementação antes de salvar |
| Fluxo de exceção | O sistema é indisponível, e o usuário tenta novamente mais tarde |
| Pós-condições | Os dados são atualizados no sistema |
| Data de Criação | 05/12/2024 |
| Rastreabilidade | ADD02 |
Tabela 11: Agenda Atendimento Presencial
| UC07 | Informações |
|---|---|
| Descrição | O usuário pode agendar um horário para atendimento presencial |
| Ator | Usuário |
| Pré-condições | Acesso ao sistema e horários |
| Ação | A agenda do usuário ou atendimento no sistema |
| Fluxo principal | 1. O usuário acessa o aplicativo 2. O usuário seleciona "Agenda de Atendimento" 3. O sistema exibe os horários disponíveis 4. O usuário escolhe um dado e local e confirma |
| Fluxo alternativo | Horários indisponíveis, e o sistema sugere outros dias |
| Fluxo de exceção | O sistema é indisponível, e o usuário tenta novamente mais tarde |
| Pós-condições | O atendimento é agendado com sucesso |
| Data de Criação | 05/12/2024 |
| Rastreabilidade | INT15 |
Tabela 11: Suporte de Chat ou Atendimento
| UC08 | Informações |
|---|---|
| Descrição | O usuário pode acessar o suporte via chat ou atendimento telefônico para resolver problemas ou tirar dúvidas |
| Ator | Usuário |
| Pré-condições | Acesso à internet e conta ativa no sistema |
| Ação | O usuário escolhe a forma de suporte desejada e inicia a comunicação |
| Fluxo principal | 1. O usuário acessa o aplicativo 2. O usuário seleciona "Suporte" 3. O sistema exibe as opções de atendimento: chat ou telefone 4. O usuário escolhe o método e inicia a comunicação |
| Fluxo alternativo | O sistema não oferece suporte por chat, e o usuário opta por atendimento telefônico |
| Fluxo de exceção | O suporte é indisponível, e o sistema informa o horário de funcionamento |
| Pós-condições | Uma dúvida ou problema do usuário é resolvido por meio do suporte |
| Data de Criação | 05/12/2024 |
| Rastreabilidade | ADD09 |
Tabela 11: Notificações de Vencimento
| UC09 | Informações |
|---|---|
| Descrição | O usuário pode receber notificações sobre o vencimento de contas via e-mail, SMS ou aplicativo |
| Ator | Usuário |
| Pré-condições | Conta ativa no sistema e canais de comunicação configurados |
| Ação | O sistema envia notificações automáticas antes do vencimento da fatura |
| Fluxo principal | 1. O sistema identifica os dados de vencimento próximo 2.O sistema verifica os canais ativados pelo usuário (e-mail, SMS ou aplicativo) 3. O sistema envia uma notificação ao usuário com antecedência definida |
| Fluxo alternativo | O usuário não configurou os canais de notificação e o sistema alerta sobre a necessidade de configuração |
| Fluxo de exceção | O envio da notificação falhou, e o sistema tenta novamente em outro momento |
| Pós-condições | O usuário recebe uma notificação e é informado sobre os dados de vencimento da conta |
| Data de Criação | 05/12/2024 |
| Rastreabilidade | ADD08 |
Tabela 11: Configurar Pagamento Mensal Recorrente
| UC10 | Informações |
|---|---|
| Descrição | O sistema deve permitir a configuração de um pagamento mensal recorrente |
| Ator | Usuário |
| Pré-condições | O usuário deve estar autenticado no sistema; Uma forma de pagamento válida deve estar cadastrada no sistema. |
| Ação | O sistema permite configurar o pagamento recorrente, incluindo frequência, valor e forma de pagamento. |
| Fluxo principal | 1. O usuário seleciona a opção de configurar pagamento recorrente 2.O sistema solicita as informações necessárias 3. O sistema valida as informações e salva a configuração. 4. Uma confirmação é exibida. |
| Fluxo alternativo | Caso o usuário já tenha um pagamento recorrente configurado, o sistema pode exibir a opção de editar ou cancelar a configuração existente. |
| Fluxo de exceção | Caso a forma de pagamento seja inválida, o sistema exibe uma mensagem de erro e solicita a correção. |
| Pós-condições | A configuração do pagamento recorrente é salva no sistema. |
| Data de Criação | 11/12/2024 |
| Rastreabilidade | B10 |
Tabela 12: Consultar o Mapa de Interrupções
| UC11 | Informações |
|---|---|
| Descrição | Permitir que o usuário visualize áreas afetadas por interrupções no fornecimento. |
| Ator | Usuário |
| Pré-condições | O sistema deve ter acesso às informações de interrupções de fornecimento. |
| Ação | O sistema exibe um mapa com as áreas afetadas. |
| Fluxo principal | 1. O usuário seleciona a opção de consultar o mapa de interrupções. 2. O sistema recupera os dados atualizados sobre interrupções. 3. O mapa é exibido com áreas destacadas por cores. |
| Fluxo alternativo | O usuário pode selecionar uma área específica no mapa para mais detalhes, como horário estimado de retorno. |
| Fluxo de exceção | Caso os dados de interrupções estejam indisponíveis, o sistema exibe uma mensagem de erro e oferece tentar novamente mais tarde. |
| Pós-condições | O usuário obtém informações sobre as interrupções no fornecimento. |
| Data de Criação | 11/12/2024 |
| Rastreabilidade | INT14 |
Tabela 13: Receber Alertas de Manutenção Programada
| UC12 | Informações |
|---|---|
| Descrição | Permitir que o usuário receba notificações sobre manutenções programadas. |
| Ator | Usuário |
| Pré-condições | O usuário deve estar registrado no sistema. |
| Ação | O sistema envia alertas por canais configurados. |
| Fluxo principal | 1. O sistema verifica se há manutenções programadas. 2. Para cada manutenção programada, o sistema verifica os usuários impactados. 3. Os alertas são enviados conforme as preferências do usuário (horário e canal de envio). |
| Fluxo alternativo | Caso o usuário não tenha configurado preferências, o sistema solicita a configuração antes de enviar alertas. |
| Fluxo de exceção | Caso o envio de alerta falhe (ex.: e-mail inválido), o sistema registra o erro e tenta enviar novamente. |
| Pós-condições | O usuário é notificado sobre manutenções programadas. |
| Data de Criação | 11/12/2024 |
| Rastreabilidade | INT18 |
Tabela 14: Filtro de Atendimentos
| UC13 | Informações |
|---|---|
| Descrição | O sistema permite que o usuário filtre os atendimentos cadastrados por ano, mês e status (finalizado ou em andamento). |
| Ator | Usuário |
| Pré-condições | O usuário deve estar autenticado no sistema. Devem existir atendimentos cadastrados para consulta. |
| Ação | O sistema exibe os atendimentos de acordo com os filtros aplicados pelo usuário. |
| Fluxo principal | 1. O usuário acessa a funcionalidade de Atendimentos. 2.O sistema exibe os filtros disponíveis: ano, mês e status. 3. O usuário seleciona um ou mais filtros. 4. O sistema aplica os filtros e exibe os atendimentos correspondentes. |
| Fluxo alternativo | O usuário não seleciona nenhum filtro: o sistema exibe todos os atendimentos disponíveis. |
| Fluxo de exceção | Não há atendimentos que correspondam aos filtros aplicados: o sistema exibe uma mensagem informando que não há resultados. |
| Pós-condições | O usuário visualiza os atendimentos filtrados conforme os critérios selecionados. |
| Data de Criação | 11/12/2024 |
| Rastreabilidade | ENT07 |
Tabela 15: Simulação de Tarifas
| UC14 | Informações |
|---|---|
| Descrição | O sistema permite que o usuário realize a simulação de tarifas diretamente no aplicativo, sem redirecionamento para o site da Caesb. |
| Ator | Usuário |
| Pré-condições | O usuário deve estar autenticado no aplicativo. O aplicativo deve estar atualizado e com acesso à funcionalidade de simulação de tarifas. |
| Ação | O sistema realiza a simulação de tarifas com base nos dados fornecidos pelo usuário. |
| Fluxo principal | 1. O usuário acessa a funcionalidade Simulação de Tarifa no aplicativo. 2.O sistema exibe os campos para entrada de dados, como consumo estimado, tipo de usuário (residencial, comercial, etc.), e outros parâmetros necessários. 3. O usuário preenche os campos e confirma a simulação. 4. O sistema processa as informações e apresenta o resultado da simulação ao usuário. |
| Fluxo alternativo | O usuário não preenche todos os campos obrigatórios: o sistema exibe uma mensagem solicitando o preenchimento dos dados faltantes. |
| Fluxo de exceção | O sistema encontra problemas ao processar a simulação (por exemplo, erro no servidor): o sistema exibe uma mensagem informando a falha e sugere que o usuário tente novamente mais tarde. |
| Pós-condições | O usuário recebe o resultado da simulação de tarifa diretamente no aplicativo, sem necessidade de redirecionamento. |
| Data de Criação | 11/12/2024 |
| Rastreabilidade | ENT09 |
Tabela 16: Formas de Pagamento
| UC15 | Informações |
|---|---|
| Descrição | O sistema permite que o usuário escolha entre diferentes formas de pagamento ao realizar uma transação. |
| Ator | Usuário |
| Pré-condições | O usuário deve estar autenticado no aplicativo. Deve haver uma conta disponível para pagamento. |
| Ação | O sistema exibe as opções de pagamento disponíveis e processa a escolha do usuário. |
| Fluxo principal | 1. O usuário acessa a funcionalidade de pagamento no sistema. 2.O sistema exibe as formas de pagamento disponíveis, como: cartão de crédito, cartão de débito e pix. 3. O usuário seleciona a forma de pagamento desejada e fornece as informações necessárias (se aplicável). 4. O sistema processa o pagamento e confirma a transação. |
| Fluxo alternativo | O usuário não seleciona nenhuma forma de pagamento: o sistema exibe uma mensagem informando que a seleção é obrigatória para concluir a transação. |
| Fluxo de exceção | O pagamento falha (ex.: cartão recusado, erro de rede): o sistema exibe uma mensagem de erro e orienta o usuário a tentar novamente ou escolher outra forma de pagamento. |
| Pós-condições | A transação é concluída com sucesso e o usuário recebe uma confirmação do pagamento. |
| Data de Criação | 11/12/2024 |
| Rastreabilidade | B08 |
Referências Bibliográficas
Especificacao de Caso de Uso. Disponível em: https://aprender3.unb.br/pluginfile.php/2972484/mod_resource/content/3/SiglaProjeto_EspecificacaoCasoUso.pdf. Acesso em: 0 dec. 2024.
Casos de Uso. Disponível em: https://aprender3.unb.br/pluginfile.php/2972470/mod_resource/content/1/Aula%2010.pdf. Acesso em: 05 dec. 2024.
Projeto como exemplo. Disponível em: https://requisitos-de-software.github.io/2023.1-BilheteriaDigital/modelagem/useCase/. Acesso em: 05 dec. 2024.
Ferramenta utilizada para o diagrama de caso de uso: Lucidchart . Disponível em: https://www.lucidchart.com/pages/pt/diagrama-de-caso-de-uso-uml. Acesso em: 05 dec. 2024.
Histórico de versão
| Versão | Data | Descrição | Autor(es) | Revisor(es) |
|---|---|---|---|---|
| 1.0 | 02/12/2024 | Criação do artefato | Letícia Resende | Natan Almeida |
| 1.1 | 05/12/2024 | Inclusão da especificação do caso de uso | Letícia Resende | Leandro de Almeida |
| 1.2 | 10/12/2024 | Ajustes pós apresentação | Letícia Resende | Leandro de Almeida |
| 1.3 | 11/12/2024 | Adição de novos requisitos | Natan Almeida | Letícia Resende |
| 1.4 | 11/12/2024 | Inclusão de casos de uso | Leandro de Almeida | Letícia Resende |
| 1.5 | 08/02/2025 | Correção da numeração dos casos de uso | Leandro de Almeida | Letícia Resende |