Global

O Global é a base compartilhada do PowerP. Todo outro módulo lê dele o que precisa para funcionar: quem são as pessoas, quais unidades a organização tem, quem pode entrar no sistema e o que cada um pode fazer. Nenhum módulo mantém um cadastro próprio de pessoas ou de filiais; todos apontam para o registro do Global.

O módulo reúne:

• Pessoas: cadastro único de pessoas físicas e jurídicas, com documentos, endereços, contatos, canais de mensageria, certificados digitais e foto.
• Unidades: a estrutura da organização (matriz, regionais, filiais), com responsáveis, horário de funcionamento, calendário de feriados e grupos de unidades.
• Usuários: as contas dos colaboradores internos, com as unidades que cada um alcança, os grupos de permissão e as chaves de API.
• Grupos de Permissão e Administrador Geral: quem pode fazer o quê, em qual tela.
• Políticas de Segurança: restrições por endereço de rede e por horário.
• Configurações: os parâmetros da organização, com valor geral e valor por unidade.
• Horários e Calendários: grades de horário reutilizáveis e feriados por unidade.
• Catálogos compartilhados: tipos estratégicos de pessoa, centros de custo e unidades de medida.
• Central de notificações: tipos, categorias, modelos, canais de envio, histórico e agendamentos, além da caixa de notificações de cada usuário.

O Global guarda os dados e garante a integridade deles: documento único por organização, hierarquia sem ciclos, vínculos sempre dentro da mesma organização. As regras de negócio de cada contexto ficam no módulo que usa o dado. É por isso que o cadastro de pessoa não exige foto, por exemplo: a Gestão Educacional é quem exige foto do aluno, e a Assinatura Digital é quem exige e-mail e documento com foto.

Os setores (departamentos) são um conceito que o Global compartilha com todos os módulos, mas o cadastro deles fica em Recursos Humanos.

Pessoa

Uma pessoa é física ou jurídica e nasce com um documento principal (CPF ou CNPJ no Brasil; DNI, CUIT, CI, RUC ou passaporte em outros países). O número é validado por formato e dígito verificador, e não pode haver duas pessoas com o mesmo tipo e número na organização. O documento principal não muda depois do cadastro. Toda pessoa tem um nome oficial (nome civil ou razão social) e pode ter um nome de exibição, que na pessoa física é o apelido que ela mesma escolhe. A pessoa jurídica informa a atividade econômica principal (CNAE). Uma pessoa pode ter vários endereços (residencial, comercial, cobrança, entrega), vários contatos (celular, fixo, e-mail, site) com canais de mensageria (WhatsApp, Telegram, Signal, SMS, Discord), documentos adicionais com validade, certificados digitais A1/A3 (um ativo por vez) e uma foto de perfil.

Unidade

Unidade é uma filial, escola, regional ou matriz. Toda unidade representa uma pessoa jurídica cadastrada, recebe um número sequencial e um código único, e tem um nome operacional. A hierarquia é livre: a unidade de topo é a matriz, as subordinadas são filiais, sem limite de níveis. Cada unidade pode ter quatro responsáveis opcionais (gestor, mantenedora, financeiro e faturamento), um horário de funcionamento e um calendário de feriados próprio. Unidades podem ser reunidas em grupos de unidades para classificação.

Setor

Setor é o departamento dentro de uma unidade: um catálogo plano de nomes, ícones e cores, vinculado às unidades com hierarquia local e responsável, e com pessoas lotadas por período de vigência. O Global guarda esse registro porque vários módulos o consomem; o cadastro e a lotação ficam no módulo Recursos Humanos.

Conta de usuário

Só colaboradores internos (funcionários e professores) têm conta de usuário. Ela liga a credencial de login à pessoa e carrega as unidades alcançadas, os grupos de permissão e as chaves de API. Alunos, responsáveis, clientes e fornecedores entram com o mesmo login, mas recebem permissões automáticas pelo perfil, sem conta administrada.

Grupo de permissão

Conjunto de funcionalidades concedido a usuários. A organização cria os grupos que quiser; o sistema mantém os papéis de Administrador Geral e Administrador de Unidades.

Configuração

Parâmetro da organização com valor geral e, quando a definição permite, valor próprio por unidade.

Pessoas

Lista com busca (só dígitos procura documento; letras procuram nome) e filtros por tipo e situação. O cadastro tem abas laterais: Dados básicos (tipo, nomes, documento principal e foto), Dados pessoais (só pessoa física: nascimento, gênero, estado civil, profissão), Endereços, Contatos e Documentos. Cidade, estado e naturalidade vêm do catálogo de geografia; o CEP preenche logradouro, bairro e cidade. A foto passa por um editor de retrato com recorte e rotação. O detalhe da pessoa é somente leitura.

Unidades

A tela é o organograma da organização: um nó por unidade, ligado à unidade-pai, com física de arrasto. Há também a vista em tabela. Clicar num nó abre o perfil lateral com posição na organização, código, situação, quantidade de filiais, setores vinculados e as ações. Nova Matriz cria unidade de topo; Adicionar filial abre o cadastro com o pai já definido. Unidade fora da licença aparece esmaecida com o selo Não licenciada e sem ações.

Grupos de Unidades

Lista paginada com criar, editar e excluir, e o vínculo das unidades a cada grupo.

Usuários

Lista à esquerda (foto, nome, e-mail de login, situação, selo com a quantidade de unidades) e, à direita, o cartão da conta escolhida, com os blocos Unidades, Grupos de permissão, Permissões individuais e Permissões efetivas. O perfil mostra o último acesso (Nunca entrou quando não houve) e o selo Troca de senha pendente.

Grupos de Permissão e Administrador Geral

Grupos em mestre-detalhe, com a árvore de funcionalidades por módulo e tela. A tela do Administrador Geral mostra o papel, a árvore em somente leitura e quem o tem, com os botões de promover e despromover.

Configurações, Políticas de Segurança, Horários e Calendários

Descritas nas seções seguintes. Os calendários mostram os feriados numa grade mensal.

Gerenciar notificações

Abas Tipos, Categorias, Templates (matriz canal por idioma com prévia) e Canais; telas de histórico de envios com envio manual e reenvio de falhas, e de agendamentos. Cada usuário tem o sino na barra, a caixa de notificações agrupada por dia e as preferências de aviso.

Todos os cadastros respondem aos atalhos do produto: F2 cria, F3 leva à busca, Esc fecha e Ctrl+S salva, sempre com a mesma permissão do botão correspondente.

Cadastrar uma pessoa

1. Escolha o tipo (física ou jurídica) e o tipo do documento principal. Só aparecem os tipos ativados para a organização; CPF ou CNPJ já vêm pré-selecionados.
2. Digite o número: a máscara e a validação de formato barram o erro na hora, e o servidor confere o dígito verificador. Número já cadastrado é recusado com o caminho para localizar o cadastro existente.
3. Informe o nome oficial e, se quiser, o nome de exibição e a foto. Salve.
4. Depois do primeiro salvamento, as abas de endereços, contatos e documentos habilitam, e cada item é incluído, editado ou removido na própria aba. Ao marcar um endereço ou contato como principal, o anterior deixa de ser.

Pessoa não é apagada: é desativada e continua acessível pelo filtro de inativos.

Criar uma unidade

1. Na tela de Unidades, use Nova Matriz ou, no perfil de uma unidade, Adicionar filial.
2. O cadastro é um assistente em etapas, com rascunho guardado: Identificação (empresa, nome operacional, código, endereço operacional), Hierarquia (a árvore mostra a posição; a própria unidade e as subordinadas ficam desabilitadas como pai), Responsáveis, Funcionamento (horário e calendário), Identidade visual (ícone e cor, herdados pelas filiais) e Revisão.
3. Se a empresa ainda não existe como pessoa, cadastre-a dentro do próprio formulário, com documento, nacionalidade, endereços e contatos; tudo é gravado junto com a unidade. Quando a organização não tem nenhuma pessoa jurídica, o formulário já abre nesse modo.

Quem cria a unidade é vinculado a ela automaticamente. Mover uma unidade na hierarquia leva as subordinadas junto; trocar a mantenedora pede confirmação explícita. Desativar não apaga nada e não altera as filiais; unidade inativa só não recebe novos vínculos.

Dar acesso a um colaborador

1. Em Usuários, clique em criar: escolha uma pessoa física existente (por nome ou documento) ou cadastre uma nova no mesmo diálogo.
2. Defina o e-mail de login e, se quiser, a senha inicial. A conta nasce exigindo a troca de senha no primeiro acesso.
3. Informe as unidades que a conta alcança e os grupos de permissão. Sem unidade, a conta não vê dados ligados a unidades.

Ninguém altera os próprios vínculos de unidade nem desativa a própria conta: essas ações exigem outro administrador. Conta que nunca entrou pode ser excluída definitivamente, liberando o e-mail; conta já usada só é desativada, e reativar devolve tudo como estava.

O catálogo de funcionalidades é uma árvore por módulo e tela. O nó da tela concede entrar e consultar; os filhos concedem incluir, alterar, excluir e ações específicas. A regra das telas é uma só: ação sem permissão não é apresentada. Quem tem só o nó da tela de Configurações, por exemplo, abre a tela em consulta, com os campos desabilitados e sem Salvar.

Como o acesso é montado

• Grupos: um usuário pode ter vários grupos; as permissões se somam. Remover um grupo tira só o que era exclusivo dele.
• Grupos coletivos: aplicados automaticamente pela classificação da pessoa (tipo estratégico), a internos e externos, sem vínculo manual.
• Permissões individuais: no cartão do usuário, cada nó da árvore tem três estados, herdar (o que os grupos dão), conceder e negar, com cascata aos filhos e um resumo antes de gravar.
• Negação: vence qualquer concessão, exceto nas contas de administração, onde não tem efeito; por isso a tela nem oferece negar nelas.

Papéis mantidos pelo sistema

O Administrador Geral tem toda funcionalidade da organização e alcança todas as unidades. É concedido e retirado só na tela própria, por uma permissão própria, e a organização nunca fica sem um ativo: despromover ou desativar o último é recusado. O Administrador de Unidades tem toda funcionalidade dentro das unidades que alcança. O Administrador de Plataforma é da operadora e atua em qualquer organização, com cada ação registrada. Esses papéis têm selo na lista de grupos e não podem ser editados, excluídos ou duplicados.

Unidades não são permissão

O que um usuário enxerga de dados ligados a unidade vem do vínculo da conta (a unidade e as subordinadas) cruzado com as unidades contratadas na licença. Não existe permissão de ver tudo: quem precisa de alcance amplo é vinculado à matriz. Funcionalidade de módulo fora da licença é descartada e some do menu.

Políticas de segurança

Uma política combina faixas de endereço de rede e janelas de horário (grades cadastradas em Horários) e protege grupos. Ela não bloqueia o login: fora do contexto, a pessoa entra e simplesmente não recebe os grupos protegidos. A avaliação acontece a cada requisição; política desativada afrouxa; lista vazia não restringe; grade sem faixa nunca abre. Um simulador na tela mostra o veredito e cada condição isoladamente. Alterações de grupo levam até 15 minutos para valer em sessão já aberta.

A tela Configurações reúne os parâmetros da organização. As definições (nome, tipo, texto de ajuda e valor base) vêm do produto, semeadas por cada módulo; o que a organização faz é escolher valores. Cada configuração tem um valor geral, que todas as unidades herdam, e, quando a definição é por unidade, um valor próprio por unidade. A resolução segue a cascata: valor da unidade, senão valor geral, senão valor base. Remover o valor da unidade faz ela voltar a herdar o geral. O valor precisa respeitar o tipo (texto, inteiro, decimal, sim ou não, data, hora, data e hora, estrutura) e, quando há conjunto fechado, pertencer a ele.

A tela

• Árvore módulo, tela à esquerda, com a quantidade de configurações em cada nó e busca por nome, chave e texto de ajuda.
• Modo Por Unidades: a lista das configurações da tela escolhida, agrupadas, com Editar abrindo um diálogo que mostra o valor padrão e uma linha por unidade permitida ao usuário, cada uma com a opção Usar valor padrão.
• Modo Por Configurações: um formulário com todas as configurações da tela para a unidade ativa, com Salvar único e Descartar alterações.
• Menu Exibir para mostrar ou ocultar o código e as instruções de cada configuração.
• Campos por tipo: interruptor sim ou não, lista de opções com rótulos, número, texto, data, editor de mapa por finalidade.

Definir valor para uma unidade fora do alcance do usuário é recusado; o valor efetivo de uma unidade, porém, é dado dela e vale para qualquer módulo que o consulte.

Configurações do próprio Global

• Segurança: tamanho mínimo de senha e tempo de expiração da sessão.
• Perfil: o que o usuário pode alterar sozinho em Meu perfil (nome de usuário, contatos, endereços e foto), ligados por padrão. Nome oficial, documento e nascimento continuam do cadastro de Pessoas e do RH.
• Dias não úteis por unidade: se sábado e domingo contam como dia útil e como tratar feriado nos cálculos (avançar para o próximo dia útil, cobrar normalmente ou ratear). Mudar o horário ou o calendário de uma unidade vale a partir do próximo cálculo, sem recálculo retroativo.

Todo registro do Global guarda quem o criou, quando e de qual endereço de rede, e quem o alterou pela última vez, quando e de onde. Algumas operações têm o registro explícito do operador e do momento: mover uma unidade na hierarquia, trocar um responsável, ativar ou desativar unidade, conta ou vínculo de unidade, e cada ação de um administrador da plataforma, que inclui ainda a origem e a organização acessada. Chaves de API registram a data e a origem de cada uso; chave revogada e vínculo de unidade desativado permanecem no histórico.

O que mudou, e não só quem

Além das colunas de autoria, o PowerP mantém uma auditoria de domínio gravada na mesma transação da mudança: ou grava tudo, ou nada. Cada ação (uma requisição, um processamento em segundo plano, um evento recebido) guarda quem fez, por onde, quando, de qual endereço, em qual organização e se o Assistente de IA participou (apoiou ou executou). Debaixo da ação ficam as entradas, uma por registro afetado, com a operação (criação, alteração, exclusão, restauração, leitura sensível ou evento de negócio) e os valores antes e depois: na alteração, só os campos que mudaram; na criação e na exclusão, o registro completo. Segredos como senhas, chaves e certificados nunca entram no registro.

Consulta

O histórico é consultado por um serviço próprio de auditoria: o log de ações com filtros por autor, data, origem, situação e uso de IA; o histórico de um registro específico, do mais recente ao mais antigo; e as entradas por tipo de operação. Ver o log exige a permissão de leitura de auditoria; valores sensíveis aparecem mascarados para quem não tem a permissão de vê-los. A consulta de outra organização pelo administrador da plataforma e o desmascaramento de valores sensíveis são, eles mesmos, auditados. Os módulos podem mostrar o histórico de um registro na própria tela, uma linha por ação com os campos alterados, atrás da permissão daquele módulo. Há regras de retenção e expurgo alinhadas à LGPD.

No dia a dia

No cartão do usuário, o bloco Permissões efetivas lista cada permissão com a origem (via qual grupo, concessão individual ou administração), para responder se fulano pode fazer algo. A exclusão definitiva de uma conta fica na trilha com o e-mail e o nome da pessoa. No histórico de envios, cada notificação registra situação, tentativas e motivo de falha, para investigar reclamações de não recebimento.

A direção é sempre a mesma: os módulos apontam para o Global, nunca o contrário.

• Financeiro: o titular da fatura, a unidade emissora e a parte do contrato são pessoas e unidades do Global; o rateio usa os centros de custo compartilhados; a unidade de medida dos itens vem do catálogo do Global.
• Gestão Educacional: o aluno da matrícula é uma pessoa; a matrícula e a turma pertencem a uma unidade.
• Compras e Estoque: o fornecedor do recebimento é uma pessoa; o almoxarifado é de uma unidade; a requisição aponta para um centro de custo analítico; as conversões usam as unidades de medida.
• Projetos: fecha custo nos centros de custo.
• Recursos Humanos: é dono da tela de setores, cargos e lotações, gravando no registro compartilhado do Global; os setores aparecem como satélites no organograma de Unidades.
• Assinatura Digital (MySign): a assinatura eletrônica do usuário é responsabilidade do MySign; o Global fornece a pessoa, o e-mail e os certificados digitais.
• Assistente de IA: a participação da IA em cada ação fica registrada na auditoria, e os perfis de acesso do assistente são configurados pela árvore de permissões.

Como os módulos escrevem pessoas

Quando um módulo precisa de uma pessoa (o aluno novo, o fornecedor da nota), ele pede ao Global para localizar ou criar pelo documento, na mesma transação. Campo já preenchido nunca é sobrescrito pelo módulo: divergências voltam como conflito para quem chamou. Corrigir um nome digitado errado é tarefa do operador na tela de Pessoas. Cada módulo define o que exige da pessoa no seu contexto: a nota fiscal exige o código IBGE da cidade, CPF ou CNPJ e inscrição estadual; a assinatura eletrônica exige e-mail e documento com foto; a educação exige foto, filiação e data de nascimento.

O que todos consomem

• O alcance de unidades do usuário recorta automaticamente toda consulta de qualquer módulo que tenha unidade.
• As grades de horário servem às políticas de segurança, ao RH e ao atendimento; os feriados por unidade alimentam os cálculos de prazo.
• As configurações são resolvidas por chave e unidade para qualquer módulo.
• Qualquer módulo envia notificações pela central (e-mail, SMS, WhatsApp, push, webhook e caixa do usuário), com modelos por tipo, canal e idioma.
• Um serviço de integração permite a outras aplicações da JR importar os usuários ativos com a estrutura de unidades e setores.