🎭 Atores e Papéis de API (Actors)
Um Ator representa quem ou o quê está chamando o seu sistema para iniciar um fluxo. O Ator jamais participa passivamente; ele age ou sofre a ação de retorno do Banco de Dados.
🏗️ Categorias Autenticáveis
Dependendo da sua Arquitetura, você lidará com diferentes Atores. Abaixo está a visão em três frentes:
| Origem da Chamada (Ator) | Descrição Arquitetural |
|---|---|
| 👤 Humano (Browser/App) | Perfis autenticados via Token JWT (Ex: MédicoPlantonista, Paciente, Administrador). Use substantivos simples e não "CPF 123.456". |
| ⚙️ Hardware (Edge/IoT) | O Hardware também envia metadados para seu Banco. (Ex: Leitor de Catraca Biométrica, Sensor de Temperatura, Relógio de Ponto). |
| 🔗 APIs de Terceiros (Webhooks) | O sistema de Cobrança do Banco Itaú (Muitas vezes, a API do Governo manda uma notificação dizendo que a Nota Fiscal foi aceita. Nesse cenário, o Governo agiu como um Ator contra o seu sistema). |
🎨 O que o Arquiteto Nunca Deve Fazer:
- 🚫 Nunca liste CPF/Nomes Próprios: Crie "Cargos" ou "Grupos Lógicos" (
Admin,User_Premium). - 🚫 Nunca liste o seu Banco de Dados como Ator: "Ah, quem checa a senha é o PostgreSQL, logo ele é o Ator!". Falso. O Banco de Dados não está FORA das fronteiras da sua API, ele faz parte orgânica do que você vai codar. O Ator sempre está FORA do Backend e do Frontend, pressionando o seu serviço.