🎭 Atividade 05: Casos de Uso (UML)

🎯 Objetivo da Aula

Ao final desta atividade, você será capaz de:

• Identificar Atores (pessoas ou sistemas externos que interagem com o seu software).
• Mapear Casos de Uso (funcionalidades entregues ao ator).
• Aplicar os relacionamentos de dependência <<include>> e <<extend>> corretamente, segundo as normas UML.
• Descrever textualmente o "Caminho Feliz" de um Caso de Uso.

🏢 O Cenário Prático (Seu Desafio)

Na TecProExpress, você escreveu um Backlog incrível (Atividade 04). Mas quando levou os Post-its para a diretoria, o CEO disse: "Não consigo ler isso, são muitos textos soltos. Quero um desenho que me mostre de forma macro o que o Motorista pode fazer e o que o Administrador pode fazer".

"Seu desafio é desenhar o primeiro diagrama oficial da Engenharia de Software: O Diagrama de Casos de Uso. Ele será a 'Planta Baixa' do seu aplicativo, estabelecendo a Fronteira do Sistema (o que está dentro e o que está fora)."

🧠 Fundamentos: A Teoria Traduzida

A UML (Linguagem de Modelagem Unificada) é o idioma mundial da engenharia. Um desenvolvedor japonês que não fala português consegue entender seu projeto se você desenhar em UML.

Elementos Chaves

• Ator (Boneco de Palito): É quem provoca o sistema. (Ex: O Cliente, O Motorista, ou até a API do Banco Central).
• Caso de Uso (Oval): Sempre no infinitivo (Ex: Atualizar Rastreio, Realizar Login).
• Fronteira (Retângulo): A caixa do seu software. Atores ficam de fora, Casos de Uso ficam dentro.

📊 Visualizando a Lógica

📖 Exemplo Guiado

Abaixo, veja como estruturar o cenário do aplicativo de logística da TecProExpress.

📊 Relações de Include e Extend da TecProExpress

🛠️ Especificação Textual do Caso de Uso

Todo oval desenhado precisa de um "Manual de Instruções" por trás dele. Exemplo do Caso "Reportar Atraso":

• Ator Principal: Motorista.
• Pré-condição: O motorista deve estar logado no aplicativo.
• Fluxo Principal (Caminho Feliz):
  1. O motorista seleciona a entrega em andamento.
  2. Clica no botão "Reportar Atraso".
  3. O sistema pede o motivo (Trânsito, Veículo Quebrado, etc).
  4. O motorista seleciona o motivo e confirma.
  5. O sistema atualiza o status e notifica o SAC.
• Pós-condição: O status da entrega muda para "Atrasado".

🔍 Detalhamento da Documentação:

• O Caminho Feliz é a rota perfeita, sem erros. É essencial escrever isso para que o testador de software saiba o que esperar quando tudo dá certo.

🛠️ Prática Obrigatória 1: O Diagrama

Cenário: O projeto semestral da sua equipe.

1. Acesse o draw.io (ou Lucidchart, Astah) e crie um Diagrama de Casos de Uso.
2. Desenhe a Fronteira do Sistema (O retângulo com o nome do App no topo).
3. Insira pelo menos 2 Atores diferentes (do lado de fora).
4. Insira pelo menos 6 Casos de Uso (dentro da fronteira), derivados das suas User Stories.
5. Crie pelo menos uma relação de <<include>> e uma de <<extend>>.

🏁 Resultado Esperado (Para sua Referência)

Um arquivo de imagem (PNG/JPG) com o diagrama organizado, onde as linhas não se cruzam loucamente, provando que você sabe abstrair o macro do sistema.

🛠️ Prática Obrigatória 2: O Caminho Feliz

Cenário: O detalhamento da regra de negócio.

1. Escolha o Caso de Uso principal do seu diagrama (A funcionalidade core do sistema).
2. Escreva a Especificação Textual contendo: Ator, Pré-condição, Fluxo Principal (Passo a passo numerado) e Pós-condição.

🏁 Resultado Esperado (Para sua Referência)

Um arquivo Markdown documentando o texto do caso de uso escolhido.

📤 Instruções de Entrega (Microsoft Teams)

Após validar suas documentações técnicas:

1. Salve o arquivo de documentação com o nome Atividade_05.md e a imagem do seu diagrama com o nome Atividade_05.png na pasta es-atv-05-casos-uso/ do seu repositório GitHub.
2. Certifique-se de fazer o commit e push para o repositório público.
3. Submeta o link do seu repositório no Microsoft Teams para avaliação do professor.

💡 Checkpoint de Lógica

📊 Rubrica Formativa de Avaliação