Neste módulo
User Story vs. Caso de Uso
| User Story | Caso de Uso | |
|---|---|---|
| Foco | Valor para o usuário | Interação detalhada com o sistema |
| Tom | Informal, conversacional | Formal, técnico |
| Nível de detalhe | Médio — o suficiente para o DEV entender | Alto — cobre todos os fluxos e variações |
| Quando usar | Planejamento de sprint, backlog | Documentação, contratos, compliance |
| Quem lê | DEV, PO, analista | DEV, arquiteto, QA, cliente |
Regra prática: User Story = "O quê e Por quê" (orientada ao negócio). Caso de Uso = "Como exatamente" (orientado ao sistema).
Por que casos de uso importam
Cobrem todos os caminhos
Não só o caminho feliz — todos os alternativos e de exceção ficam explícitos.
Base para testes
Cada fluxo alternativo vira um caso de teste para o QA.
Protegem o analista
Documentam o que foi combinado antes da implementação.
Facilitam manutenção
Quando o sistema muda, o UC mostra o impacto em cada fluxo.
Estrutura de um Caso de Uso
| Campo | O que registrar |
|---|---|
| ID | UC-[número] — ex: UC-014 |
| Nome | Verbo no infinitivo + objeto — ex: "Autenticar Usuário" |
| Ator principal | Quem inicia a interação |
| Atores secundários | Outros sistemas ou pessoas envolvidos |
| Pré-condições | O que precisa ser verdade antes de começar |
| Pós-condições (sucesso) | Estado do sistema quando termina bem |
| Pós-condições (falha) | Estado do sistema quando termina mal |
| Fluxo principal | Passo a passo do caminho feliz — sem condicionais |
| Fluxos alternativos | Variações que ainda concluem com sucesso |
| Fluxos de exceção | Erros, falhas, casos extremos |
Modelo completo — copie e use
## UC-[NÚMERO]: [NOME DO CASO DE USO] Versão: 1.0 | Data: DD/MM/AAAA | Status: Rascunho | Campo | Valor | |---|---| | Ator principal | [Quem inicia] | | Atores secundários | [Outros sistemas/pessoas] | ### Pré-condições 1. [Estado necessário antes de iniciar] ### Pós-condições — sucesso 1. [Estado após conclusão bem-sucedida] ### Pós-condições — falha 1. [Estado após falha — o que ficou inalterado] ### Fluxo principal | Passo | Ator | Ação | |---|---|---| | 1 | [Ator] | [O que faz] | | 2 | Sistema | [Como responde] | | N | Sistema | [Conclusão] | ### FA-01: [Nome do fluxo alternativo] Ponto de extensão: após passo [N] Condição: [quando este fluxo ocorre] | Passo | Ator | Ação | | [N]a | ... | ... | Retorno: passo [X] do fluxo principal ### FE-01: [Nome da exceção] Ponto de extensão: após passo [N] Condição: [quando o erro ocorre] | Passo | Ator | Ação | | [N]a | Sistema | [Mensagem de erro] | ### Regras de negócio - RN-01: [Regra] ### Requisitos não funcionais - [Ex: Resposta em até 2 segundos]
Prompts para gerar Casos de Uso com IA
Quando usar: Você tem uma US aprovada e quer expandir para Caso de Uso formal.
Você é analista de negócio sênior. Vou fornecer uma User Story aprovada.
Expanda para um Caso de Uso formal completo.
Contexto do sistema: [DESCREVA]
User Story: [COLE A US]
Gere o Caso de Uso com:
- ID, nome, versão e status
- Ator principal e secundários
- Pré e pós-condições (sucesso e falha)
- Fluxo principal: mínimo 6 passos (alternando ator/sistema)
- Mínimo 2 fluxos alternativos com ponto de extensão
- Mínimo 3 fluxos de exceção com tratamento detalhado
- Regras de negócio numeradas
- Requisitos não funcionais
Para cada FA e FE: identifique em qual passo do principal o desvio ocorre.
Se faltar info, marque [A DEFINIR]. Formato: Markdown com tabelas.
Quando usar: Antes de começar a especificação de um módulo novo.
Você é analista de negócio. Preciso mapear todos os casos de uso
de um módulo antes de começar a especificação.
Módulo: [NOME]
Descrição: [O QUE O MÓDULO FAZ]
Atores conhecidos: [LISTE OS PERFIS]
Gere:
1. Lista completa de UCs numerados (UC-001, UC-002...)
2. Para cada UC: nome, ator e uma linha de descrição
3. Relacionamentos entre UCs (inclui, estende, antecede)
4. Prioridade de especificação: quais são mais críticos
Exemplo: UC expandido da US-047
O mesmo pedido de venda do Módulo 02, agora expandido para Caso de Uso formal — veja a diferença de profundidade.
## UC-023: Registrar Pedido de Venda Manual Versão: 1.0 | Status: Em revisão | Campo | Valor | |---|---| | Ator principal | Vendedor interno | | Atores secundários | API de Estoque, Serviço de E-mail, Módulo de Aprovação | | Módulo | Gestão de Vendas | ### Pré-condições 1. Vendedor autenticado com perfil "Vendas Interno" 2. Pelo menos um cliente ativo cadastrado 3. Integração com Sistema de Estoque disponível ### Pós-condições — sucesso 1. Pedido salvo com número único PED-AAAA-NNNNNN 2. Status definido conforme regras de aprovação 3. Notificações enviadas 4. Log de auditoria registrado ### Pós-condições — falha 1. Nenhum pedido criado na base 2. Dados preenchidos mantidos na tela ### Fluxo principal | Passo | Ator | Ação | |---|---|---| | 1 | Vendedor | Acessa "Vendas > Novo Pedido" | | 2 | Sistema | Exibe formulário com busca de cliente | | 3 | Vendedor | Busca e seleciona o cliente | | 4 | Sistema | Valida status; exibe dados e crédito | | 5 | Vendedor | Adiciona itens (código + quantidade) | | 6 | Sistema | Consulta estoque; calcula subtotal | | 7 | Vendedor | Aplica desconto e observações | | 8 | Sistema | Valida percentual conforme perfil | | 9 | Vendedor | Revisa resumo e confirma | | 10 | Sistema | Aplica regras, gera número | | 11 | Sistema | Salva, registra log, dispara notificações | | 12 | Sistema | Exibe confirmação com número e próximos passos | ### FA-01: Desconto acima do limite Ponto de extensão: após passo 8 Condição: desconto > 15% para perfil Vendedor | 8a | Sistema | Detecta desconto acima do limite | | 8b | Sistema | Exibe aviso e opções | | 8c | Vendedor | Reduz desconto OU solicita aprovação gerencial | Retorno: passo 9 ### FE-01: Sistema de Estoque indisponível Ponto de extensão: passo 6 | 6a | Sistema | Exibe "Verificação de estoque indisponível" | | 6b | Sistema | Oferece: aguardar OU prosseguir sem verificação | | 6c | Vendedor | Escolhe a opção | ### FE-02: Cliente inativo Ponto de extensão: passo 4 | 4a | Sistema | Bloqueia formulário | | 4b | Sistema | Exibe "Cliente inativo. Contate o Cadastro." | ### Regras de negócio - RN-01: Desconto máximo sem aprovação: 15% - RN-02: Pedidos ≥ R$ 10.000 requerem aprovação gerencial - RN-03: Número: PED-AAAA-NNNNNN (sequencial por ano) ### Requisitos não funcionais - Consulta de estoque em até 3s; timeout aciona FE-01 - Toda operação registrada em log de auditoria imutável