🎭 CAPÍTULO 10: DIAGRAMA DE CASOS DE USO (CONCEITOS)
O Diagrama de Casos de Uso é a "foto panorâmica" do sistema sob a perspectiva do usuário final. Ele é o ponto de partida essencial para definir o escopo funcional e os limites do software. 🛡️🧩
🎯 Objetivo do Capítulo
Dominar os três elementos estruturantes da UML: Atores, Casos de Uso e Fronteira do Sistema, aplicando nomenclaturas profissionais alinhadas ao padrão RESTful de mercado.
🏢 O Cenário Corporativo (TecProExpress)
Na TecProExpress, os diretores querem ver uma lista de funcionalidades do novo Módulo de Compras. Eles não querem saber de Java ou SQL, eles querem saber o que o Comprador, o Gerente e o Fornecedor poderão fazer na plataforma.
"Seu desafio é desenhar esse 'Cardápio de Funcionalidades'. Você deve estabelecer o que está dentro do nosso desenvolvimento (Fronteira) e quem são as entidades externas (Atores) que vão pressionar nossos botões."
🧠 Os 3 Elementos Estruturantes
| Elemento Gráfico | Aplicação no Software |
|---|---|
| Atores (Boneco) | Papéis externos (Usuários, Sensores IoT ou APIs de Terceiros). |
| Casos de Uso (Elipse) | A funcionalidade real (Ex: "Efetuar Login", "Gerar Fatura"). |
| Fronteira (Retângulo) | O limite do seu projeto. O que está dentro será desenvolvido por você. |
📊 Visualizando a Lógica de Fronteira
graph LR
A["Usuário Padrão"] --- UC(["Efetuar Login Seguro"])
subgraph "Fronteira da sua API (TecProExpress)"
UC
end
style UC fill:#e3f2fd,stroke:#1e88e5
👥 Atores e Papéis de API
Um Ator representa quem ou o quê está chamando o seu sistema.
- Humano: Perfis como
Admin,Motorista,Cliente_Premium. (Dica: Nunca use nomes próprios ou CPFs). - Hardware: Sensores de temperatura, leitores biométricos.
- Sistemas Externos: API do Governo, Sistema de Pagamentos (Stripe/PayPal).
[!CAUTION] O Erro Comum: Nunca liste o seu Banco de Dados como um Ator. O banco faz parte interna do seu sistema (está dentro da fronteira). O Ator é sempre algo que está FORA, enviando ou recebendo dados da sua aplicação. 🧠🛡️
🏷️ Nomenclatura RESTful Profissional
Para que seus diagramas falem a língua dos programadores modernos, os Casos de Uso devem usar Verbos no Infinitivo acoplados ao recurso:
| Verbo | Mapeamento Técnico | Exemplo |
|---|---|---|
| Cadastrar / Criar | Futura Rota POST. | Cadastrar Veículo |
| Consultar / Listar | Futura Rota GET. | Consultar Rastreio |
| Efetuar / Executar | Processos Complexos. | Efetuar Pagamento |
| Emitir / Gerar | Geração de Arquivos. | Gerar PDF de Relatório |
💡 Checkpoint de Lógica
[!IMPORTANT] Reflexão Profissional: O Diagrama de Casos de Uso mostra O QUE o sistema faz, mas não mostra COMO ele faz. O passo a passo (a lógica do código) será detalhado em outro diagrama. Você sabe qual é? (Resposta: Diagrama de Sequência). 🧠🛡️