Na engenharia de software, especialmente dentro da metodologia de desenvolvimento orientada a casos de uso, identificaratoresé um passo fundamental e crítico. Os atores atuam como ponte entre o sistema em desenvolvimento e as entidades externas que interagem com ele. Identificar e compreender adequadamente os atores permite que as equipes projetem sistemas centrados no usuário, funcionalmente completos e alinhados às necessidades do mundo real.

Este artigo abrangente explora opropósito de identificar atores, ostipos de atores (humanos e não humanos), seuspapéis e responsabilidades, como esse processo apoia diversas áreas do desenvolvimento de software, e fornececonceitos-chave, diretrizes e dicas práticaspara o sucesso.
Identificar atores não é apenas uma tarefa preliminar — é uma atividade estratégica que molda todo o ciclo de desenvolvimento. Os principais objetivos incluem:
Os atores ajudam a estabelecer o que está dentro do sistema (o software) e o que está fora. Essa clareza evita o crescimento excessivo do escopo e garante que a equipe se concentre no domínio correto.
Exemplo:Em um sistema bancário, o cliente é um ator fora do sistema, enquanto o módulo de processamento de transações faz parte do sistema.
Os atores representam usuários reais ou sistemas que interagem com o software. Ao identificá-los, as equipes modelam casos de uso reais que refletem como o sistema será usado na prática.
Cada caso de uso geralmente envolve um ou mais atores. Conhecer os atores ajuda a descobrir o conjunto completo de requisitos funcionais. Se você não souber quem está usando o sistema, não poderá definir o que eles precisam fazer.
Os atores fornecem uma linguagem comum para stakeholders, desenvolvedores, testadores e analistas de negócios. Eles facilitam a discussão sobre funcionalidades, a validação de requisitos e a alinhamento de expectativas.
Os testadores podem usar papéis de atores para projetar cenários de teste. Por exemplo, um ator “Cliente” pode precisar realizar “Login”, “Transferir Fundos” e “Visualizar Extrato” — cada um se tornando um caso de teste.
Os atores são amplamente categorizados em dois tipos:Atores HumanoseAtores Não Humanos.
São indivíduos que interagem diretamente com o sistema.
Cliente
Administrador
Funcionário
Gerente
Atendente de Suporte
Paciente (em sistemas de saúde)
Têm objetivos e intenções.
Interagem por meio de interfaces gráficas, formulários ou comandos de voz.
Podem ter papéis com permissões diferentes (por exemplo, administrador vs. usuário comum).
✅ Dica:Use nomes baseados em papéis (por exemplo, “Cliente Registrado” em vez de “Usuário”) para evitar ambiguidades.
São sistemas externos, dispositivos ou processos automatizados que interagem com o software.
Máquina de Caixa Eletrônico
Gateway de Pagamento (por exemplo, Stripe, PayPal)
Servidor de E-mail
API do Serviço de Clima
Sensor IoT
Sistema Legado (por exemplo, banco de dados antigo)
Não são pessoas, mas iniciam ou respondem a ações do sistema.
Muitas vezes representam pontos de integração ou serviços externos.
Pode disparar casos de uso automaticamente.
✅ Exemplo: Em um sistema de comércio eletrônico, o “Gateway de Pagamento” é um ator que processa pagamentos e envia confirmação de volta ao sistema.
⚠️ Erro Comum: Tratar um componente do sistema como parte do sistema em vez de um ator externo. Sempre pergunte: “Essa entidade inicia um caso de uso?”
Compreender o papel do atorpapel e responsabilidades aprofunda a compreensão sobre como eles utilizam o sistema e o que esperam.
Descreve a pessoa ou sistema no contexto.
Muitas vezes ligado a uma função de trabalho ou tipo de sistema.
Exemplo: “Funcionário de Empréstimo” vs. “Cliente”
As ações que o ator realiza no sistema.
Os objetivos que eles buscam alcançar.
Os dados que eles fornecem ou recebem.
| Responsabilidade | Descrição |
|---|---|
| Navegar por Produtos | Visualizar listagens e detalhes dos produtos |
| Adicionar ao Carrinho | Selecione itens e adicione-os a um carrinho de compras |
| Finalizar Compra | Insira informações de envio e pagamento |
| Rastrear Pedido | Visualizar o status do pedido e atualizações de entrega |
✅ Melhor Prática:Documente as responsabilidades dos atores em uma tabela ou legenda do diagrama de casos de uso para melhorar a clareza.
A identificação adequada de atores afeta múltiplas fases do ciclo de vida do desenvolvimento de software:
Ajuda a identificar todos os grupos de usuários e sistemas externos.
Evita a perda de necessidades críticas dos usuários.
Incentiva a participação dos interessados desde cedo.
Cada caso de uso é acionado por um ator.
Permite a descoberta sistemática de requisitos funcionais.
Ajuda a evitar casos de uso redundantes ou sobrepostos.
Orienta o design da interface (UI/UX).
Influencia segurança e controle de acesso (por exemplo, administrador vs. convidado).
Determina pontos de integração (por exemplo, APIs de terceiros).
Os testadores usam papéis de atores para criar cenários de teste.
Garante que todas as trajetórias do usuário sejam cobertas.
Apoia a criação de scripts de teste automatizados.
Definições claras de atores ajudam a escrever manuais do usuário e materiais de treinamento.
Explica quem pode fazer o que no sistema.
No Agile, os atores ajudam a definir histórias de usuário (por exemplo, “Como cliente, quero redefinir minha senha”).
Facilita a priorização da lista de tarefas com base nas necessidades do usuário.
Um usuário é uma pessoa que utiliza o sistema.
Um ator é qualquer entidade que interage com o sistema.
Um usuário pode desempenhar múltiplos papéis (por exemplo, um gerente que também é cliente).
❌ Errado: “Usuário” como o único ator.
✅ Correto: “Cliente,” “Gerente,” “Administrador do Sistema”
Os atores estão fora da fronteira do sistema.
Não inclua componentes internos (por exemplo, “Banco de Dados” não é um ator—a menos que seja um sistema externo).
Um único ator pode estar envolvido em muitos casos de uso.
Exemplo: Um “Cliente” pode “Navegar”, “Adicionar ao Carrinho”, “Finalizar Compra” e “Avaliar Produto.”
O caso de uso descreve uma ação ou objetivo.
O ator dispara ou participa do caso de uso.
✅ Caso de uso: “Processar Pagamento”
✅ Ator: “Cliente” e “Gateway de Pagamento”
Siga estas melhores práticas para garantir uma identificação precisa e significativa de atores:
Converse com analistas de negócios, usuários finais e proprietários do sistema.
Pergunte: “Quem usa este sistema? Quem envia dados para ele? Quem recebe saídas?”
Para cada caso de uso potencial, pergunte: “Quem inicia esta interação?”
A resposta provavelmente é o ator.
Não use termos vagos como “Usuário”, “Sistema” ou “Pessoa”.
Seja específico: “Cliente Registrado”, “API de Terceiros”, “Dispositivo Móvel”.
Pense além dos usuários diretos: sensores, tarefas agendadas, serviços externos.
Exemplo: Um sensor de clima pode disparar um caso de uso “Enviar Alerta”.
Se não for uma pessoa, pergunte: “Ele envia ou recebe mensagens para o sistema?”
Se sim → é um ator não humano.
Desenhe diagramas de casos de uso e verifique se todos os atores estão representados.
Garanta que nenhum caso de uso seja “sem ator”.
| Dica | Explicação |
|---|---|
| Use nomes baseados em papéis | Em vez de “Usuário”, use “Cliente”, “Administrador”, “Fornecedor” — mais claro e mais ação. |
| Agrupe atores por papel | Crie uma “Lista de Atores” com descrições, responsabilidades e permissões. |
| Aproveite as personas | Crie personas para os atores principais para se empatizar com seus objetivos e pontos de dor. |
| Verifique a existência de atores ausentes | Pergunte: “O que acontece se o sistema falhar? Quem é notificado?” → Muitas vezes revela atores ocultos. |
| Use a regra “Fora do Sistema” | Se algo está dentro do sistema, não é um ator. |
| Itere e refine | Revise os atores em cada fase de desenvolvimento. Novas funcionalidades podem introduzir novos atores. |
| Documente os atores em uma tabela de referência | Mantenha um documento vivo com detalhes dos atores para referência futura. |
Cliente – visualiza conta, transfere dinheiro
Caixa do Banco – processa solicitações de empréstimo
Máquina de Caixa Eletrônico – envia solicitações de saque
Sistema de Detecção de Fraude – monitora transações e sinaliza atividades suspeitas
Gateway de Pagamento – processa pagamentos com cartão de crédito
Ator: Cliente e máquina ATM
Interação: Cliente insere o cartão → ATM envia solicitação → Sistema verifica → Fundos liberados
✅ A ATM é um ator porque inicia a interação.
| Armadilha | Por que é ruim | Como corrigir |
|---|---|---|
| Tratar módulos internos como atores | Violenta o conceito de fronteira do sistema | Pergunte: “Isso está dentro ou fora do sistema?” |
| Usar termos vagos como “Usuário” | Leva a ambiguidade e requisitos ausentes | Use papéis específicos: “Cliente”, “Fornecedor” |
| Esquecer atores não humanos | Perde integrações e automações | Pense em APIs, sensores, jobs de cron |
| Assumir um ator por caso de uso | Ignora interações complexas | Permita múltiplos atores por caso de uso |
| Não revisitar atores durante o desenvolvimento | Atores podem evoluir com novos recursos | Revise os atores na planejamento de sprint e retrospectivas |
Identificar atores em uma abordagem orientada a casos de uso vai muito além de uma formalidade — é umpilar estratégico do desenvolvimento de software bem-sucedido. Ao definir claramente quem interage com o sistema (tanto humanos quanto não humanos), as equipes obtêm:
Compreensão mais profunda das necessidades dos usuários
Requisitos mais completos e precisos
Melhor design e arquitetura do sistema
Testes e documentação aprimorados
Alinhamento mais forte com os interessados
Quando feito corretamente, a identificação de atores transforma ideias abstratas em insights concretos e passíveis de ação. Garante que o software não funcione apenas — mas simresolve problemas reais para pessoas e sistemas reais.
Livros:
Modelagem de Casos de Uso por Alistair Cockburn
Escrevendo Casos de Uso Efetivos por Alistair Cockburn
Ferramentas:
Visual Paradigm (para diagramas de casos de uso)
Lucidchart / Draw.io (diagramação)
Jira + Confluence (para documentação de atores e casos de uso)
Metodologias:
Ágil (histórias de usuário derivadas de atores)
Design Orientado a Domínio (DDD) – atores como parte do modelo de domínio
🌟 Pensamento final:
“Você não constrói software para sistemas — você o constrói para pessoas e para os sistemas que as servem. Os atores são o primeiro passo para entender quem são essas pessoas e sistemas.”
Ao dominar a identificação de atores, você estabelece a base para um sistema que não é apenas funcional — mas verdadeiramente valioso.