Hierarquia de Entidades

A plataforma HorusBI é organizada em uma estrutura hierárquica projetada para garantir governança, segurança e escalabilidade. Antes de configurar seu ambiente, é fundamental entender como as peças se encaixam.

TIP

Para uma visão rápida de Cliente, Tenant e Usuário, consulte a Visão Geral do HEC. Esta página aprofunda os conceitos de Mesas, Aplicações e Tabelas, que são a base da organização interna de cada Tenant.

🏢 1. Cliente (Parceiro)

No topo da hierarquia está o Cliente (também chamado de Parceiro). Esta entidade representa a sua organização — por exemplo, uma empresa revendedora, consultoria de dados ou holding.

• Função: Gerenciamento global de múltiplos ambientes (Tenants)
• Administradores: Usuários neste nível são chamados de "Admins do Cliente". Eles podem criar novos Tenants e gerenciar configurações globais como SMTP, domínio e identidade visual (branding)

🏠 2. Tenant (Ambiente)

O Tenant é a unidade de isolamento da plataforma. Cada Tenant representa um cliente final, um projeto ou um ambiente segregado ("Empresa X — Produção", "Empresa X — Homologação").

• Isolamento total: Dados, usuários e configurações de um Tenant são completamente invisíveis para os demais
• Governança: Recomenda-se criar um Tenant para cada cliente final. Isso facilita atualizações via Templates e garante que um cliente não impacte o outro
• Administradores: O "Admin do Tenant" possui controle total apenas sobre o seu ambiente específico

📂 3. Mesas (Workspaces)

Dentro de cada Tenant, a organização dos ativos é feita por Mesas. Pense nelas como pastas de trabalho que separam o conteúdo por finalidade. Existem dois tipos:

🗄️ Mesa de Dados (Data Workspace)

Voltada para a organização técnica e lógica dos dados.

• Exemplos de nomes: RAW (dados brutos), Refined (dados tratados), Sandbox (área de testes)
• Conteúdo: Armazena as Tabelas e os Dataflows (fluxos de integração)
• Na prática: É a camada onde a engenharia de dados organiza os diferentes estágios de qualidade do dado

📊 Mesa de Aplicação (Business Workspace)

Voltada para a organização de negócio e entregas ao usuário final.

• Exemplos de nomes: Comercial, Financeiro, Logística, Estoque, Suprimentos
• Conteúdo: Armazena os Dashboards, Aplicações e Visualizações
• Reuso de dados: Uma tabela técnica (Produtos da mesa Refined) pode ser consumida por múltiplas mesas de aplicação. Por exemplo, a mesma tabela Produtos serve simultaneamente para Comercial, Estoque e Suprimentos

IMPORTANT

Mesas e Templates: As mesas são a unidade levada quando você publica um template. Isso significa que a estrutura organizacional definida pelas mesas é o que será replicado para outros tenants.

📦 4. Aplicações e Tabelas

• Tabelas: Representam a estrutura física/lógica dos dados (colunas, tipos, relacionamentos). São criadas e mantidas nas Mesas de Dados
• Aplicações: São o agrupamento visual de Dashboards que consomem as tabelas. Residem nas Mesas de Aplicação e são o produto final entregue ao usuário de negócio

---

🔐 Níveis de Acesso

A hierarquia de entidades define também os perfis de usuário na plataforma:

Nível	Escopo	O que pode fazer
Admin do Cliente	Todos os Tenants do parceiro	Criar ambientes, configurar branding, gerenciar a plataforma globalmente
Admin do Tenant	Um ambiente específico	Controle total sobre usuários, mesas, permissões e configurações daquele Tenant
Usuário	Conforme permissões	Acesso restrito via Grupos e Permissões dentro de um ou mais Tenants

TIP

Para detalhes sobre como configurar cada nível de acesso, consulte a documentação de Permissões e Segurança.