Visão geral da plataforma

O portal de BI da ZaaZ Telecom entrega os relatórios do Power BI da empresa, com gestão de usuários e configuração próprias. A base é multi-tenant (a mesma arquitetura de origem, com organização isolando dados por linha), mas esta instância atende exclusivamente a ZaaZ — não há nem haverá uma segunda organização cadastrada aqui.

Conceitos fundamentais

Quatro conceitos aparecem em quase toda tela do sistema. Entender a diferença entre eles evita a maior parte da confusão inicial.

Organização — a empresa dentro da plataforma. Todo registro relevante carrega um vínculo com ela, e o banco de dados aplica isolamento por linha (RLS) para garantir que uma organização jamais leia dados de outra.

Domínio — o endereço pelo qual as pessoas acessam a plataforma. Uma organização pode ter vários domínios. É o domínio que determina qual logo, cor e nome aparecem na tela de login, antes mesmo de alguém digitar a senha.

Papel base (role) — um campo simples no cadastro da pessoa, com valor admin, manager ou user. Quem tem admin recebe acesso total à sua organização, sem passar por nenhuma checagem de permissão.

Perfil de acesso — o controle fino, configurado em Perfis. Define, por módulo, se a pessoa pode ver, criar, editar e excluir; quais dashboards enxerga; e se pode exportar dados. Só vale para quem não é admin.

A confusão mais comum: dar a alguém um perfil de acesso restrito e mesmo assim a pessoa enxergar tudo. Quase sempre o motivo é que o campo Perfil do cadastro está como admin, o que ignora o perfil de acesso.

Módulos

Módulo	Para que serve	Onde fica
Dashboards	Consumo dos relatórios do Power BI publicados pela empresa	/dashboard
Usuários	Cadastro de pessoas, convites, movimentações e organograma	/users
Administração	Configuração da empresa, perfis, dashboards, menus, e-mails e integrações	/admin

CRM, Indicadores e Processos existem no código mas estão fora de uso — decisão de negócio de 2026-08-31, sem data para reativar. Não aparecem no menu nem respondem por URL direta (redirecionam para /dashboard). Se um dia voltarem a ser usados, esta wiki precisa ser atualizada — o que está escrito aqui embaixo sobre eles descreve o comportamento de quando estavam ativos, não o estado atual.

O que aparece no menu superior

O menu do topo não é igual para todo mundo. Cada item só aparece se a pessoa tiver a permissão correspondente:

• Dashboards — sempre visível para quem está autenticado
• Usuários — exige permissão de visualização em Usuários
• Configuração — exige a permissão Gerenciar configurações da organização

Além de esconder o item do menu, o sistema bloqueia o acesso direto pela URL: quem tentar abrir /admin sem a permissão de configurações é redirecionado para /dashboard.

Por onde começar

Se você acabou de assumir a administração de uma organização, siga o roteiro de primeiros passos. Ele percorre a configuração na ordem em que as dependências exigem.