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 das 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 da 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 - conceda as permissões mínimas necessárias.
• 📝 Audite as 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.
• Ative a 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(
  "sua-url-do-projeto", {
    "token": "seu-token-de-aplicativo"
  }
);

---

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.

---