Posted inUML

O Propósito e a Importância de Identificar Atores em uma Abordagem Orientada a Casos de Uso

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.

What is Use Case Diagram?

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.

🔍 1. O Propósito de Identificar Atores

Identificar atores não é apenas uma tarefa preliminar — é uma atividade estratégica que molda todo o ciclo de desenvolvimento. Os principais objetivos incluem:

✅ 1. Definir os Limites do Sistema

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.

✅ 2. Capturar Interações do Mundo Real

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.

✅ 3. Impulsionar a Descoberta de Casos de Uso

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.

✅ 4. Melhorar a Comunicação e a Colaboração

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.

✅ 5. Apoio ao Planejamento de Testes e Validação

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.

🧍‍♂️ 2. Tipos de Ator: Humano vs. Não Humano

Os atores são amplamente categorizados em dois tipos:Atores HumanoseAtores Não Humanos.

🧑‍💼 A. Atores Humanos

São indivíduos que interagem diretamente com o sistema.

Exemplos:

  • Cliente

  • Administrador

  • Funcionário

  • Gerente

  • Atendente de Suporte

  • Paciente (em sistemas de saúde)

Características:

  • 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.

🤖 B. Atores Não Humanos

São sistemas externos, dispositivos ou processos automatizados que interagem com o software.

Exemplos:

  • 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)

Características:

  • 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?”

🎯 3. Papéis e Responsabilidades do Ator

Compreender o papel do atorpapel e responsabilidades aprofunda a compreensão sobre como eles utilizam o sistema e o que esperam.

🔹 Papel: Quem é o Ator

  • 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”

🔹 Responsabilidades: O que o Ator Faz

  • As ações que o ator realiza no sistema.

  • Os objetivos que eles buscam alcançar.

  • Os dados que eles fornecem ou recebem.

Exemplo: Ator “Cliente” em um Sistema de Comércio Eletrônico

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.

🛠️ 4. Como a Identificação de Ator Apoia Áreas de Desenvolvimento

A identificação adequada de atores afeta múltiplas fases do ciclo de vida do desenvolvimento de software:

📌 1. Coleta de Requisitos

  • 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.

📌 2. Modelagem de Casos de Uso

  • 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.

📌 3. Design e Arquitetura do Sistema

  • 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).

📌 4. Testes e Validação

  • 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.

📌 5. Documentação e Treinamento do Usuário

  • Definições claras de atores ajudam a escrever manuais do usuário e materiais de treinamento.

  • Explica quem pode fazer o que no sistema.

📌 6. Desenvolvimento Ágil e Iterativo

  • 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.

🧩 5. Conceitos-Chave na Identificação de Ator

✅ 1. Ator ≠ 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”

✅ 2. O Ator É uma Entidade Externa

  • 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).

✅ 3. Um Ator, Múltiplos Casos de Uso

  • Um único ator pode estar envolvido em muitos casos de uso.

  • Exemplo: Um “Cliente” pode “Navegar”, “Adicionar ao Carrinho”, “Finalizar Compra” e “Avaliar Produto.”

✅ 4. Caso de Uso vs. Ator

  • 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”

📝 6. Diretrizes para Identificação Efetiva de Ator

Siga estas melhores práticas para garantir uma identificação precisa e significativa de atores:

✅ 1. Comece com entrevistas com partes interessadas

  • 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?”

✅ 2. Use a pergunta “Quem inicia?”

  • Para cada caso de uso potencial, pergunte: “Quem inicia esta interação?”

  • A resposta provavelmente é o ator.

✅ 3. Evite sobreabstração

  • Não use termos vagos como “Usuário”, “Sistema” ou “Pessoa”.

  • Seja específico: “Cliente Registrado”, “API de Terceiros”, “Dispositivo Móvel”.

✅ 4. Considere todos os pontos de interação

  • 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”.

✅ 5. Use o teste “É uma pessoa?”

  • Se não for uma pessoa, pergunte: “Ele envia ou recebe mensagens para o sistema?”

  • Se sim → é um ator não humano.

✅ 6. Valide com diagramas de casos de uso

  • Desenhe diagramas de casos de uso e verifique se todos os atores estão representados.

  • Garanta que nenhum caso de uso seja “sem ator”.

💡 7. Dicas e Truques para o Sucesso

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.

🎯 Exemplo do Mundo Real: Sistema Bancário Online

Atores:

  1. Cliente – visualiza conta, transfere dinheiro

  2. Caixa do Banco – processa solicitações de empréstimo

  3. Máquina de Caixa Eletrônico – envia solicitações de saque

  4. Sistema de Detecção de Fraude – monitora transações e sinaliza atividades suspeitas

  5. Gateway de Pagamento – processa pagamentos com cartão de crédito

Caso de Uso: “Sacar Dinheiro”

  • 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.

🚫 Armadilhas Comuns para Evitar

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

✅ Conclusão

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.

📚 Leitura adicional e ferramentas

  • 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.