Introdução

Gerencie contas de administrador com funções, permissões e controle de acesso.

🎯 O que este módulo faz?

O módulo Admins permite que você recupere quem tem acesso ao seu painel de administração do OneEntry e o que eles podem fazer.

📖 Explicação Simples

Imagine que você está gerenciando um site com uma equipe:

• 👑 Super Admin - Pode fazer tudo (você, o proprietário)
• 👨‍💼 Gerente de Conteúdo - Pode editar páginas e produtos
• 📝 Editor - Pode escrever postagens de blog
• 🎨 Designer - Pode gerenciar imagens e blocos
• 👀 Visualizador - Pode apenas visualizar dados, sem edição

Em vez de dar acesso total a todos, você:

• ✅ Cria contas de administrador para os membros da equipe
• ✅ Atribui funções e permissões específicas
• ✅ Controla o que cada pessoa pode ver e editar
• ✅ Rastreia quem fez alterações (trilha de auditoria)
• ✅ Revoga o acesso quando alguém sai da equipe

Exemplo do mundo real:

Sem Gerenciamento de Admin:
- Todos compartilham uma conta → Não é possível rastrear quem fez o quê ❌
- Todos têm acesso total → Arriscado! ❌
- Sem controle sobre permissões ❌

Com Gerenciamento de Admin:
- Cada membro da equipe tem sua própria conta ✅
- Permissões específicas por função ✅
- Trilha de auditoria completa de alterações ✅
- Fácil adicionar/remover membros da equipe ✅

✨ Conceitos Chave

O que é um Administrador?

Um administrador (admin) é um usuário com acesso elevado para gerenciar seu projeto OneEntry:

• Direitos de acesso - Quais partes do sistema eles podem acessar
• Permissões - Quais ações eles podem realizar (criar, editar, excluir)
• Função - Sua posição/responsabilidade (por exemplo, "Gerente de Conteúdo")
• Informações da conta - Nome, e-mail, status

Administrador vs Usuário Regular

Tipo	Propósito	Exemplo
Administrador	Gerencia o sistema (backend)	Você, seus membros de equipe
Usuário Regular	Usa seu aplicativo/site (frontend)	Seus clientes, visitantes do site

Diferença chave: Admins gerenciam conteúdo, Usuários consomem conteúdo.

📋 O que você precisa saber

Atributos do Admin

Todo admin possui estes campos principais:

{
  id: 123,                          // ID único do admin
  attributeSetId: 27,               // ID único do conjunto de atributos
  identifier: "admin",              // Identificador único
  attributeSetIdentifier: "admins", // Identificador único do conjunto de atributos
  position: 1,                      // Posição
  isSync: true,                     // Se deve sincronizar com o backend
  attributeValues: {}               // Valores dos atributos
}

Filtrando Admins

Use filtros para encontrar admins específicos:

Marcadores de condição (mesmos do módulo Products):

Marcador	Significado	Exemplo
eq	Igual	statusId = 1 (apenas ativos)
neq	Não igual	role ≠ "Viewer"
in	Contém (um dos)	role in ["Editor", "Manager"]
nin	Não contém	email not in ["@temp.com"]
exs	Existe (tem valor)	Tem lastLogin
nexs	Não existe	Nunca fez login

Considerações de Segurança

Importante:

• 🔒 Nunca exponha credenciais de admin no código frontend
• 🔐 Use tokens seguros para chamadas de API
• 👤 Implemente o menor privilégio - dê as permissões mínimas necessárias
• 📝 Audite alterações - rastreie quem fez o quê
• 🚪 Revogue o acesso imediatamente quando alguém sair

---

❓ Perguntas Comuns (FAQ)

Qual é a diferença entre os módulos Admins e Users?

• Admins - Gerenciam sua equipe (usuários do backend que gerenciam o sistema)
• Users - Gerenciam clientes (usuários do frontend que usam seu aplicativo/site)

---

Como posso restringir o que um admin pode fazer?

Use funções e permissões.

---

O que acontece com o conteúdo quando eu excluo um admin?

O conteúdo permanece, mas a referência do criador é quebrada.

Melhor prática: Desative em vez de excluir

---

💡 Notas Importantes

Melhores Práticas de Segurança

Sempre valide as permissões do admin

---

🎓 Melhores Práticas

• Use funções para agrupar permissões
• Implemente o menor privilégio (permissões mínimas necessárias)
• Desative em vez de excluir (preserve a trilha de auditoria)
• Rastreie ações de admin (quem fez o quê, quando)
• Revise permissões regularmente
• Use políticas de senha fortes
• Habilite autenticação de dois fatores (2FA)
• Configure notificações por e-mail para ações críticas

---

Para mais informações sobre a interface do usuário do módulo, visite https://doc.oneentry.cloud/docs/category/administrators

---

Definição do módulo 'Admins'

const { Admins } = defineOneEntry(
  "your-project-url", {
    "token": "your-app-token"
  }
);

---

const body = [
  {
    "attributeMarker": "num",
    "conditionMarker": "mth",
    "conditionValue": 1
  }
];

Esquema de parâmetros

Esquema: (body)

attributeMarker: string
Identificador de texto do atributo
exemplo: price

conditionMarker: string
Identificador de texto da condição, valores possíveis: 'in' - contém, 'nin' - não contém, 'eq' - igual, 'neq' - não igual, 'mth' - maior que, 'lth' - menor que, 'exs' - existe, 'nexs' - não existe, 'pat' - padrão, por exemplo -, onde '' representa qualquer caractere, 'same' - mesmo valor que o atributo selecionado*
exemplo: in
Enum: [ in, nin, eq, neq, mth, lth, exs, nexs, pat, same ]

conditionValue: number
Valor da condição
exemplo: 1

---

🔗 Documentação Relacionada

• Módulo Users - Gerencie contas de clientes (usuários do frontend)
• Módulo AuthProvider - Sistema de autenticação
• Módulo Forms - Crie formulários de registro de admin

---