Pular para conteúdo

Aula 05 - Especificação de Casos de Uso 📝

Módulo

MÓDULO 2 – ESPECIFICAÇÃO E ESTRUTURA


1. Documentação Detalhada 📚

Enquanto o diagrama de casos de uso mostra a visão geral, a especificação detalha o diálogo entre o ator e o sistema. É o documento que o desenvolvedor usará para codificar a lógica de negócio.

🧠 Componentes da Especificação

Fluxo Principal (Caminho Feliz)

Sequência de passos onde tudo ocorre conforme o esperado, sem erros ou desvios inesperados.

Fluxos Alternativos

Variações que ainda levam ao objetivo final, mas por caminhos diferentes (ex: pagar com cartão vs pagar com boleto).

Fluxos de Exceção

Tratamento de erros que impedem a conclusão da tarefa (ex: saldo insuficiente ou queda de conexão).


2. Dinâmica da Especificação 📊

A estrutura lógica de uma especificação segue uma ordem rigorosa de pré e pós condições.

graph TD
    A[Início] --> B{Pré-condições ok?}
    B -- Não --> C[Erro de Autenticação/Dados]
    B -- Sim --> D[Fluxo Principal]
    D --> E{Desvio?}
    E -- Alternativo --> F[Lógica Adicional]
    E -- Exceção --> G[Tratar Erro]
    F --> H[Pós-condições]
    G --> I[Log de Erro]
    H --> J[Fim - Sucesso]

3. Template de Especificação Pro 💻

Um analista sênior organiza as especificações de forma que sejam testáveis.

# Gerando template via CLI fictíciaspecification-tool create --id UC001 --title "Realizar_Venda"[SUCCESS] Template UC001 criado em docs/specs/cat docs/specs/UC001.md# UC001: Realizar Venda**Atores**: Vendedor (Primário), Gateway de Pagamento (Secundário)
**Resumo**: Registra a venda de produtos e valida o pagamento.

4. Estrutura de Fluxos e Regras 📑

Elemento Propósito Exemplo
Passo do Ator Ação externa "O Cliente insere o cartão"
Passo do Sistema Reação interna "O Sistema valida o PIN"
Regra de Negócio (RN) Condição lógica "Desconto de 10% para compras > R$ 500"

Dica de Redação

Use frases curtas e objetivas. Evite termos técnicos da implementação como "clicar no botão salvar" (use "solicitar gravação").


5. Mini-Projeto Prático 🚀

Cenário: Sistema de Check-in de Aeroporto (Totem).

Desafio: 1. Escreva o fluxo principal (4 passos) para "Realizar Check-in". 2. Crie um fluxo de exceção para "Documento Inválido". 3. Identifique uma pré-condição obrigatória.

Importante

Regras de Negócio (RN) devem ser citadas na especificação, mas detalhadas em um documento separado de regras, para facilitar a manutenção.


🎯 Materiais e Prática

  • Slides Interativos --- Acesse a apresentação visual da aula. Ver Slides

  • Testar Conhecimento --- Responda ao Quiz da aula para fixar os conceitos. Responder Quiz

  • Exercícios Progressivos --- Pratique com 5 exercícios de fixação e desafio. Praticar

  • Mini-Projeto --- Aplique a análise no seu projeto de referência. Ver Projeto


Próxima Aula: Diagrama de Classes (Parte 1) ➡️