Uma narrativa de caso de uso bem elaborada transforma objetivos abstratos do sistema em especifica\u00e7\u00f5es passo a passo e acion\u00e1veis. Documentando intera\u00e7\u00f5es precisas, pontos de decis\u00e3o e caminhos de tratamento de erros, as equipes estabelecem uma \u00fanica fonte de verdade que alinha propriet\u00e1rios de produtos, desenvolvedores, testadores e analistas de neg\u00f3cios. Este estudo de caso explora a anatomia de uma documenta\u00e7\u00e3o de casos de uso eficaz, demonstrando como narrativas estruturadas, modelos padronizados e modelos visuais complementares convergem para produzir especifica\u00e7\u00f5es funcionais inequ\u00edvocas. Atrav\u00e9s de um cen\u00e1rio pr\u00e1tico de saque em caixa eletr\u00f4nico, examinaremos como capturar a l\u00f3gica de neg\u00f3cios, gerenciar desvios e manter a rastreabilidade desde o conceito at\u00e9 a implementa\u00e7\u00e3o.<\/p>\n
![\"Mastering](\"https:\/\/blog.visual-paradigm.com\/wp-content\/uploads\/2026\/05\/img_6a0ff6c455a21.png\")
<\/p>\n
\n
1. Conceitos Fundamentais<\/h2>\n
Antes de elaborar especifica\u00e7\u00f5es detalhadas, \u00e9 essencial compreender os componentes principais que conferem integridade estrutural a um caso de uso:<\/p>\n
- \n
- \n
Ator:<\/strong>\u00a0Qualquer entidade (humana, sistema externo ou hardware) que interaja com o sistema para alcan\u00e7ar um objetivo.<\/p>\n
- \n
- \n
Ator Prim\u00e1rio:<\/em>\u00a0Inicia a intera\u00e7\u00e3o para cumprir um objetivo espec\u00edfico (por exemplo, um Cliente Banc\u00e1rio).<\/p>\n<\/li>\n
- \n
Ator Secund\u00e1rio\/Apoio:<\/em>\u00a0Fornece servi\u00e7os ou dados necess\u00e1rios ao sistema durante a execu\u00e7\u00e3o (por exemplo, uma API de Banco Central ou Gateway de Pagamento).<\/p>\n<\/li>\n<\/ul>\n<\/li>\n
- \n
Pr\u00e9-condi\u00e7\u00f5es:<\/strong>\u00a0O estado do sistema ou do ambiente que j\u00e1 deve existir antes que o caso de uso possa come\u00e7ar. S\u00e3o assumidos como verdadeiros e n\u00e3o s\u00e3o validados dentro do fluxo.<\/p>\n<\/li>\n
- \n
Disparador:<\/strong>\u00a0O evento espec\u00edfico ou a a\u00e7\u00e3o do usu\u00e1rio que inicia o caso de uso.<\/p>\n<\/li>\n
- \n
Cen\u00e1rio de Sucesso Principal (Fluxo B\u00e1sico):<\/strong>\u00a0A sequ\u00eancia ideal e livre de erros de passos que leva \u00e0 conclus\u00e3o bem-sucedida do objetivo do ator. Muitas vezes referido como o \u201ccaminho feliz\u201d.<\/p>\n<\/li>\n
- \n
Extens\u00f5es \/ Fluxos Alternativos e de Exce\u00e7\u00e3o:<\/strong>\u00a0Desvios documentados em rela\u00e7\u00e3o ao fluxo principal.<\/p>\n
- \n
- \n
Fluxos Alternativos:<\/em>\u00a0Diferentes caminhos v\u00e1lidos para alcan\u00e7ar o mesmo objetivo (por exemplo, usando um m\u00e9todo de pagamento diferente).<\/p>\n<\/li>\n
- \n
Fluxos de Exce\u00e7\u00e3o:<\/em>\u00a0Condi\u00e7\u00f5es de erro, falhas de valida\u00e7\u00e3o ou restri\u00e7\u00f5es do sistema que interrompem o objetivo e exigem tratamento espec\u00edfico.<\/p>\n<\/li>\n<\/ul>\n<\/li>\n
- \n
P\u00f3s-condi\u00e7\u00f5es:<\/strong>\u00a0O estado garantido do sistema, dos dados ou do ambiente ap\u00f3s a conclus\u00e3o bem-sucedida do caso de uso.<\/p>\n<\/li>\n<\/ul>\n
\n2. O Modelo Padr\u00e3o de Especifica\u00e7\u00e3o<\/h2>\n
A consist\u00eancia \u00e9 cr\u00edtica para a manutenibilidade. O seguinte modelo fornece uma estrutura amplamente adotada que garante a completude sem verbosity desnecess\u00e1ria:<\/p>\n
\n\n
\n \nCampo<\/th>\n Descri\u00e7\u00e3o<\/th>\n<\/tr>\n<\/thead>\n \n ID e Nome do Caso de Uso<\/strong><\/td>\n Um identificador \u00fanico e um t\u00edtulo com verbo-substantivo (por exemplo,\u00a0 UC-201: Sacar Dinheiro<\/code>).<\/td>\n<\/tr>\n\n Ator(es)<\/strong><\/td>\n Lista todos os participantes principais e secund\u00e1rios.<\/td>\n<\/tr>\n \n Descri\u00e7\u00e3o<\/strong><\/td>\n Um resumo conciso do prop\u00f3sito do caso de uso e do seu valor para o neg\u00f3cio.<\/td>\n<\/tr>\n \n Pr\u00e9-condi\u00e7\u00f5es<\/strong><\/td>\n Estados do sistema ou ambientais necess\u00e1rios antes da inicia\u00e7\u00e3o.<\/td>\n<\/tr>\n \n Disparador<\/strong><\/td>\n O evento exato que inicia a intera\u00e7\u00e3o.<\/td>\n<\/tr>\n \n Cen\u00e1rio Principal de Sucesso<\/strong><\/td>\n Passos numerados e sequenciais que detalham o caminho padr\u00e3o de sucesso.<\/td>\n<\/tr>\n \n Extens\u00f5es \/ Exce\u00e7\u00f5es<\/strong><\/td>\n Fluxos alternativos mapeados para etapas espec\u00edficas do cen\u00e1rio principal (por exemplo,\u00a0 3a<\/code>,\u00a08b<\/code>).<\/td>\n<\/tr>\n\n P\u00f3s-condi\u00e7\u00f5es<\/strong><\/td>\n O estado final do sistema ap\u00f3s a conclus\u00e3o bem-sucedida.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
\n3. Narrativa do Estudo de Caso: UC-201 Sacar Dinheiro<\/h2>\n
A especifica\u00e7\u00e3o a seguir demonstra como o modelo e os conceitos fundamentais s\u00e3o aplicados a um cen\u00e1rio real de banco.<\/p>\n
ID e Nome do Caso de Uso:<\/strong>\u00a0
UC-201 - Sacar Dinheiro<\/code>
\nAtor Principal:<\/strong>\u00a0Cliente do Banco
\nAtor Secund\u00e1rio:<\/strong>\u00a0Sistema Banc\u00e1rio Central \/ Rede de Caixas Eletr\u00f4nicos
\nDescri\u00e7\u00e3o:<\/strong>\u00a0Descreve como um cliente banc\u00e1rio autenticado retira dinheiro de sua conta corrente ou poupan\u00e7a usando uma m\u00e1quina de caixa eletr\u00f4nico (ATM).
\nPr\u00e9-condi\u00e7\u00f5es:<\/strong>\u00a0O caixa eletr\u00f4nico mant\u00e9m uma conex\u00e3o de rede ativa e cont\u00e9m uma quantidade suficiente de dinheiro f\u00edsico.
\nDisparador:<\/strong>\u00a0O Cliente insere seu cart\u00e3o banc\u00e1rio no leitor de cart\u00f5es do ATM.<\/p>\nCen\u00e1rio de Sucesso Principal (Fluxo B\u00e1sico)<\/h3>\n
- \n
- \n
O sistema l\u00ea o cart\u00e3o banc\u00e1rio e solicita o n\u00famero de identifica\u00e7\u00e3o pessoal (PIN).<\/p>\n<\/li>\n
- \n
O Cliente digita seu PIN.<\/p>\n<\/li>\n
- \n
O sistema valida o PIN com o Sistema Banc\u00e1rio Central.<\/p>\n<\/li>\n
- \n
O sistema exibe as op\u00e7\u00f5es de transa\u00e7\u00e3o dispon\u00edveis.<\/p>\n<\/li>\n
- \n
O Cliente seleciona \u201cRetirar Dinheiro\u201d.<\/p>\n<\/li>\n
- \n
O sistema solicita o tipo de conta (Corrente\/Poupan\u00e7a) e o valor da retirada.<\/p>\n<\/li>\n
- \n
O Cliente seleciona a conta-alvo e digita uma quantia dispon\u00edvel.<\/p>\n<\/li>\n
- \n
O sistema verifica fundos suficientes com o Sistema Banc\u00e1rio Central.<\/p>\n<\/li>\n
- \n
O sistema debita a conta e comanda o dispensador de dinheiro para liberar a quantia especificada.<\/p>\n<\/li>\n
- \n
O sistema dispensa o dinheiro, ejecta o cart\u00e3o e imprime um comprovante da transa\u00e7\u00e3o.<\/p>\n<\/li>\n
- \n
O Cliente retira o dinheiro, o cart\u00e3o e o comprovante.<\/p>\n<\/li>\n<\/ol>\n
Extens\u00f5es (Fluxos Alternativos e de Exce\u00e7\u00e3o)<\/h3>\n
- \n
- \n
3a. PIN Inv\u00e1lido:<\/strong><\/p>\n
- \n
- \n
O sistema informa ao Cliente que o PIN est\u00e1 incorreto e solicita uma nova tentativa.<\/p>\n<\/li>\n
- \n
O Cliente digita um novo PIN.<\/p>\n<\/li>\n
- \n
Retomar no passo 3.<\/em><\/p>\n<\/li>\n
- \n
Exce\u00e7\u00e3o:<\/em>\u00a0Se o cliente digitar um PIN inv\u00e1lido tr\u00eas vezes consecutivas, o sistema ret\u00e9m o cart\u00e3o e encerra a sess\u00e3o.<\/p>\n<\/li>\n<\/ol>\n<\/li>\n
- \n
8a. Fundos Insuficientes:<\/strong><\/p>\n
- \n
- \n
O sistema exibe uma mensagem de erro \u201cFundos Insuficientes\u201d e solicita ao Cliente que digite uma quantia menor ou cancele.<\/p>\n<\/li>\n
- \n
O Cliente seleciona \u201cCancelar\u201d.<\/p>\n<\/li>\n
- \n
O sistema ejetar\u00e1 o cart\u00e3o e encerrar\u00e1 a sess\u00e3o.<\/p>\n<\/li>\n<\/ol>\n<\/li>\n<\/ul>\n
P\u00f3s-condi\u00e7\u00f5es<\/h3>\n
A transa\u00e7\u00e3o \u00e9 registrada com seguran\u00e7a, o saldo da conta \u00e9 atualizado com precis\u00e3o, o estoque f\u00edsico de dinheiro do caixa eletr\u00f4nico \u00e9 reduzido conforme necess\u00e1rio e o terminal volta para a tela de boas-vindas ociosa.<\/p>\n
\n4. Melhores Pr\u00e1ticas de Elabora\u00e7\u00e3o<\/h2>\n
Para garantir que as descri\u00e7\u00f5es de casos de uso permane\u00e7am acion\u00e1veis, escal\u00e1veis e amig\u00e1veis aos desenvolvedores, siga estas diretrizes estabelecidas:<\/p>\n
- \n
- \n
Mantenha uma Perspectiva de Caixa Preta:<\/strong>\u00a0Documente\u00a0o que<\/em>\u00a0o sistema faz do ponto de vista do usu\u00e1rio, e n\u00e3o\u00a0como<\/em>\u00a0ele o realiza internamente. Evite refer\u00eancias a esquemas de banco de dados, pontos de extremidade de API ou posicionamentos de pixels na interface do usu\u00e1rio.<\/p>\n<\/li>\n
- \n
Utilize voz ativa e sintaxe clara:<\/strong>\u00a0Use constru\u00e7\u00f5es diretas sujeito-verbos para eliminar ambiguidades.<\/p>\n
- \n
- \n
Evite:<\/em>\u00a0\u201cA senha \u00e9 avaliada pelo sistema.\u201d<\/p>\n<\/li>\n
- \n
Recomendado:<\/em>\u00a0\u201cO sistema valida a senha.\u201d<\/p>\n<\/li>\n<\/ul>\n<\/li>\n
- \n
Mapeie Extens\u00f5es Explicitamente:<\/strong>\u00a0Ligue sempre os fluxos alternativos e de exce\u00e7\u00e3o diretamente ao n\u00famero da etapa de onde eles se desviam (por exemplo,\u00a0
5a<\/code>\u00a0ramifica da etapa 5). Isso preserva a rastreabilidade e simplifica a gera\u00e7\u00e3o de casos de teste.<\/p>\n<\/li>\n- \n
Objetive Processos Elementares de Neg\u00f3cio (EBP):<\/strong>\u00a0Cada caso de uso deve representar uma tarefa completa e valiosa realizada por um ator em resposta a um \u00fanico evento de neg\u00f3cios. Evite documentar cliques granulares na interface do usu\u00e1rio ou microintera\u00e7\u00f5es do sistema.<\/p>\n<\/li>\n
- \n
Separe Pr\u00e9-condi\u00e7\u00f5es de Gatilhos:<\/strong>\u00a0Uma pr\u00e9-condi\u00e7\u00e3o \u00e9 um estado est\u00e1tico (por exemplo, \u201cO usu\u00e1rio tem uma sess\u00e3o ativa\u201d), enquanto um gatilho \u00e9 uma a\u00e7\u00e3o din\u00e2mica (por exemplo, \u201cO usu\u00e1rio clica em \u2018Enviar Pedido\u2019\u201d). Manter esses elementos distintos evita sobreposi\u00e7\u00e3o l\u00f3gica e confus\u00e3o de escopo.<\/p>\n<\/li>\n<\/ol>\n
\n5. Visualiza\u00e7\u00e3o de Intera\u00e7\u00f5es do Sistema<\/h2>\n
Embora narrativas textuais forne\u00e7am profundidade, modelos visuais oferecem clareza estrutural imediata. Integrar Diagramas de Casos de Uso e Diagramas de Sequ\u00eancia junto com as especifica\u00e7\u00f5es garante que os interessados compartilhem uma compreens\u00e3o unificada sobre os limites do sistema e a execu\u00e7\u00e3o temporal.<\/p>\n
A. Diagrama de Relacionamento de Casos de Uso<\/h3>\n
Este diagrama mapeia as intera\u00e7\u00f5es dos atores, define os limites do sistema e ilustra rela\u00e7\u00f5es de inclus\u00e3o entre comportamentos reutiliz\u00e1veis.<\/p>\n
![\"\"](\"https:\/\/blog.visual-paradigm.com\/wp-content\/uploads\/2026\/05\/img_6a0ff6731cd78.png\")
<\/p>\n\n\nPlantUML<\/span>
\n
\n - \n
- \n
- \n
- \n
- \n
- \n
- \n
- \n
- \n