Organizações e Funções - Documentação do Entity Enricher

Organizações e Funções

O Entity Enricher usa multi-tenancy baseada em organizações. Cada utilizador pertence a uma organização e todos os dados — registos, esquemas, chaves de API — estão isolados por organização.

Multi-inquilino

As organizações são a fronteira de nível superior para o isolamento de dados. Ao registar-se, cria uma nova organização ou integra uma já existente. Todos os records de enriquecimento, schemas e chaves de API pertencem à sua organização e ficam acessíveis aos membros da equipa consoante a respetiva função.

O Que Pertence a uma Organização

Registos de EnriquecimentoTodos os resultados de enriquecimento, prompts e dados de custo
Esquemas guardadosSchemas JSON criados ou gerados por membros da equipa
Chaves de APIChaves de acesso da organization para integração programática
Chaves de FornecedorChaves de API de fornecedores de LLM para faturação por organização
UtilizadoresMembros da equipa com permissões baseadas em funções
DefiniçõesPreferências da organização e limites de utilização

Hierarquia de funções

O Entity Enricher usa uma hierarquia de 4 níveis de funções. Cada função inclui todas as permissões das funções abaixo dela:

Administrador do sistemaNível 5 · Em todo o sistema
  • Faça a gestão de todas as organizações e utilizadores em todo o sistema
  • Acesso a dados e relatórios entre organizações
  • Aceda à documentação interativa da API (Swagger UI, ReDoc)
  • Controlo total da configuração do sistema
ProprietárioNível 4 · Organization
  • Controlo total sobre a organização
  • Faça a gestão dos membros da equipa: convidar, aprovar, alterar funções, desativar
  • Criar e gerir chaves de API (incluindo chaves de acesso de organização)
  • Configure as definições da organização e as chaves de API dos fornecedores
  • Eliminar a organização (como último proprietário)
EditorNível 2 · Organization
  • Executar enriquecimentos (individuais e em lote)
  • Criar, editar e eliminar esquemas
  • Utilizar a geração e edição de schemas por IA
  • Ver todos os records e custos da organization
OperadorNível 1 · Organization
  • Executar enriquecimentos usando schemas existentes (acesso de leitura ao schema)
  • Ver o painel de records e custos
  • Selecione os modelos e configure as opções de enriquecimento

Registo

Registe-se com o Google, o GitHub ou e-mail através da autenticação Firebase. Durante o registo, opta por criar uma nova organização ou juntar-se a uma existente.

Criar organização

  1. Registe-se com o seu fornecedor de identidade
  2. Escolha um nome de organização e um slug seguro para URL
  3. Você torna-se o proprietário da nova organization
  4. Se ainda não existir um administrador de sistema, você torna-se o administrador de sistema

Juntar-se à Organization

  1. Pesquise a organização por nome ou slug
  2. Enviar um pedido de adesão
  3. Se a organization não tiver um proprietário ativo, é automaticamente aprovado como proprietário
  4. Caso contrário, o seu pedido fica pendente até que um proprietário o aprove

Estados do utilizador

Os utilizadores passam por um fluxo de aprovação ao aderir a uma organização:

EstadoSignificadoPode Iniciar Sessão?
AtivoAcesso total ao sistema com base na função atribuídaSim
PendentePedido de adesão enviado, a aguardar aprovação do proprietárioNão
RejeitadoO pedido de adesão foi recusado por um proprietárioNão
DesativadoA conta foi desativada (eliminação lógica, preserva o registo de auditoria)Não

Sair de uma organização

Qualquer utilizador pode sair da sua organização. O comportamento depende da propriedade:

Membros regulares

A sua conta foi desativada e a sua sessão foi terminada. Os seus registos de enriquecimento permanecem na organização para fins de auditoria.

Último proprietário

Se você for o único proprietário restante, terá de confirmar a eliminação da organização. Os records de enrichment e os schemas são desassociados (não eliminados), enquanto os utilizadores, as chaves de API e as chaves de provider são removidos com a organização.

Gestão de utilizadores

Os proprietários acedem à página de Gestão de Utilizadores para gerir a sua equipa:

Utilizadores ativosVer todos os membros ativos da equipa, alterar funções ou desativar contas
Pedidos pendentesAnalise e aprove ou rejeite pedidos de adesão de novos utilizadores

Regras de segurança:

  • Os utilizadores não podem desativar-se a si próprios
  • Os utilizadores não podem despromover-se abaixo da sua função atual
  • Apenas os proprietários podem promover ou despromover outros membros

Autenticação

O Entity Enricher suporta múltiplos métodos de autenticação:

Início de sessão social

Inicie sessão com o Google ou o GitHub através do Firebase. Não é necessária palavra-passe.

E-mail + palavra-passe

Autenticação tradicional por email e palavra-passe através do Firebase.

Chaves de API

Chaves de acesso programático para CI/CD e integrações de serviços.

Após a autenticação, o backend emite tokens de acesso JWT de curta duração (15 minutos) e tokens de atualização de longa duração (7 dias). Saiba mais sobre o acesso programático no guia de API Keys.

Próximos Passos