Rejoin BI

Validação Inicial Obrigatória

Ao iniciar o RejoinBI.exe, o Launcher valida automaticamente os componentes embutidos da instalação. Esta checagem confirma:

• Integridade do pacote instalado para operação estável da plataforma
• Disponibilidade dos módulos internos para uso dos recursos essenciais

Confirmação de Prontidão

Concluída a validação inicial, o sistema libera automaticamente a tela de login e a jornada de configuração da plataforma:

• Ambiente validado: prossiga normalmente com autenticação e parametrização inicial.
• Inconsistência detectada: execute o reparo ou a reinstalação pelo instalador oficial para restabelecer a integridade.

Pasta de Dados

Escolha uma pasta segura para armazenar o banco de dados e arquivos carregados. Dica: Use um local com backup regular.

Configure o servidor de saída de e-mail. Este passo é vital para o envio de e-mails de recuperação, notificações e PIN de autenticação (2FA). Se você utiliza uma conta compartilhada, preencha também o campo Apelido (Alias) conforme orientado pelo seu gestor.

Use o link abaixo para abrir direto a página de segurança do Gmail e gerar/configurar a senha de aplicativo usada pelo SMTP da plataforma.

Túnel, Rede e Domínio

Valide o acesso local e, quando o plano permitir, habilite o túnel para publicar o domínio externo da organização.

Controle do Servidor

O controle do servidor só libera a operação depois da validação das configurações obrigatórias, especialmente do SMTP. Após iniciar, os controles abaixo permitem pausar e reiniciar o sistema. O painel também exibe o tempo de duração da assinatura ativa; quando a assinatura expira, o programa é encerrado automaticamente.

Backup Automático

Configure um destino de backup, escolha a frequência e mantenha uma rotina de cópia dos dados locais. A rotina mantém somente dois pontos de restauração: D-0 como backup mais recente e D-1 como backup anterior. Também é possível executar um backup manual a qualquer momento.

SQLite (JDBC)

Após iniciar o servidor, o painel de Banco de Dados aparecerá no Launcher. Utilize as URLs geradas para conectar ferramentas como DBeaver ou outras soluções de análise diretamente à base local.

Visão Geral do Workspace

Ao abrir o Workspace, a parte superior apresenta os ambientes virtuais disponíveis, o botão Novo ambiente virtual e o acesso à Ajuda. Quando um ambiente é selecionado, a tela expande automaticamente os painéis de Upload, Conteúdo Atual, Notificações e os blocos operacionais da parte inferior.

Essa organização permite alternar entre ambientes já existentes sem sair da mesma área, mantendo o fluxo de publicação, acompanhamento e manutenção centralizado.

Criar Ambiente Virtual e Proteger o Acesso

Clique em Novo ambiente virtual, informe um nome técnico para identificação do projeto e, se necessário, defina uma senha de proteção. Esse nome passa a representar o ambiente dentro do Workspace e das áreas vinculadas da plataforma.

Após o salvamento, o card do ambiente exibe o status de execução e o ícone de cadeado quando houver proteção ativa. O gerenciamento de senha permite validar a senha atual, definir uma nova senha ou remover a proteção de acesso.

• Nome técnico: utilize letras, números, sublinhado ou hífen para manter o ambiente facilmente identificável.
• Proteção por senha: a senha restringe a seleção do ambiente, o uso do terminal e novas publicações.
• Status visual: o card indica se o ambiente está online, em inicialização ou desconectado.

Cadastro do ambiente virtual

Ambiente virtual com senha (cadeado)

Validação da senha atual

Definição ou remoção de senha

Enviar Projeto e Definir a Inicialização

Com o ambiente virtual selecionado, envie a pasta raiz do projeto para o Workspace. Em seguida, confirme o envio e selecione o arquivo Python principal que deve ser utilizado na inicialização da aplicação.

Nessa etapa, também é possível definir a versão do Python e manter o início automático habilitado para concluir a publicação com a aplicação já em execução.

• ● Pasta raiz: envie a estrutura completa do projeto para manter arquivos, pastas e subpastas organizados.
• ● Arquivo principal: selecione o script que será usado como ponto de entrada da aplicação.
• ● Versão do Python: escolha o interpretador desejado ou mantenha a seleção automática.
• ● Inicialização automática: publique o projeto já com o ambiente em execução.

Upload e Conteúdo Atual

Com o ambiente virtual já selecionado, a faixa central do módulo apresenta dois painéis lado a lado: Upload para o ambiente e Conteúdo Atual. Esse conjunto concentra a publicação do projeto e a leitura imediata da estrutura já existente no ambiente virtual.

• ● Upload por pasta: envia a raiz completa do projeto para manter a estrutura organizada.
• ● Conteúdo Atual: lista arquivos e pastas já disponíveis no ambiente virtual selecionado.
• ● Ações laterais: os ícones do painel permitem atualizar a leitura, exportar uma versão e limpar o conteúdo quando necessário.

Notificações Locais do Ambiente Virtual

Após a seleção do ambiente, o bloco Notificações do ambiente virtual habilita configurações próprias para e-mail e WhatsApp. Essas configurações ficam vinculadas apenas ao ambiente selecionado no Workspace, sem misturar grupos de outros ambientes.

• ● Canais independentes: o ambiente mantém configurações próprias de e-mail e WhatsApp, sem compartilhar grupos com outros ambientes virtuais.
• ● Listas locais: cada canal permite criar ou editar a lista de e-mail e o grupo de WhatsApp diretamente na área do ambiente.
• ● Atualização periódica: é possível definir intervalo em minutos ou horas para envio automático do status.
• ● Mensagem automática: o conteúdo padrão informa ambiente virtual, status, motivo, data, hora e último log quando existir.
• ● Histórico de notificações: registra as ocorrências emitidas para o ambiente selecionado.

Criar Lista de E-mail do Ambiente

O botão + do canal de e-mail abre o modal Nova Lista de E-mail. Nele, a lista local pode combinar usuários internos e contatos externos, sempre vinculados ao ambiente virtual selecionado.

• ● Nome da lista: identifica o grupo local que será usado nas notificações por e-mail.
• ● Conexão: usa uma conexão cadastrada no módulo Gestão de E-mails.
• ● Usuários internos: permite adicionar usuários do sistema com e-mail cadastrado.
• ● Contatos externos: permite complementar a lista com destinatários informados manualmente.
• ● Selecionados: resume os destinatários que serão considerados quando a lista for salva.

Se a conexão ainda não estiver disponível, o preenchimento do modal pode ser preparado normalmente, mas o salvamento final depende da seleção da conexão de envio.

Criar Grupo de WhatsApp do Ambiente

O botão + do canal de WhatsApp abre o modal Novo Grupo de WhatsApp. Essa configuração permite reunir usuários internos, contatos externos e, quando houver sessão ativa, grupos disponíveis na própria sessão conectada.

• ● Nome do grupo: identifica o grupo local do ambiente para as notificações por WhatsApp.
• ● Sessão: usa uma sessão cadastrada no módulo Configuração WhatsApp.
• ● Destinatários: podem ser usuários internos, contatos externos ou grupos oriundos da sessão selecionada.
• ● Selecionados: resume todos os destinos que receberão o alerta automático.
• ● Grupos da sessão: quando a sessão estiver ativa, a busca lateral permite anexar grupos já existentes no WhatsApp.
• ● Contato externo: o telefone é preenchido em duas partes visuais, com DDI / DDD separados do número principal, facilitando a conferência antes do salvamento.

Se não houver sessão disponível, o modal pode ser configurado com os dados do grupo, mas a gravação final depende da seleção da sessão de WhatsApp.

Terminal Integrado e Comandos Operacionais

Na parte inferior do módulo, o terminal integrado centraliza os logs de inicialização, o resultado da execução da aplicação e os comandos de operação do ambiente virtual.

• ● Parar: encerra a execução atual do ambiente virtual.
• ● Reiniciar: reinicia o ambiente e reabre a sequência de inicialização.
• ● Atualizar: recarrega os logs recentes sem precisar sair da tela.
• ● Campo de comando: aceita comandos operacionais digitados manualmente, com envio pelo botão lateral ou pela tecla Enter.

Versionamento e Histórico

Cada nova publicação arquiva a versão anterior do projeto, permitindo consultar o histórico de execução, exportar um backup ou restaurar uma versão anterior quando necessário.

• ● Versão atual: identifica o ambiente que está em execução no momento.
• ● Backups automáticos: cada novo envio preserva o estado anterior do projeto.
• ● Restauração: o retorno a uma versão anterior pode ser feito diretamente pelo modal de histórico.

Ajuda Operacional e Boas Práticas

O botão Ajuda reúne orientações visuais para preparar a pasta do projeto, revisar arquivos obrigatórios, evitar conflitos de rotas e entender o comportamento do terminal integrado.

• ● Rotas de API: prefira o prefixo /api/ para evitar conflitos com páginas HTML.
• ● Persistência: mantenha arquivos de dados em pastas dedicadas do projeto, como data/.
• ● Portas e execução: deixe o Workspace controlar a inicialização e a publicação do ambiente.

Tela Inicial da Estrutura

Ao acessar o módulo, a parte superior apresenta os ambientes virtuais disponíveis e o botão Ordem. Quando o ambiente ainda não possui páginas cadastradas, a área central exibe um estado inicial com as ações Nova Página e Criar Primeira Página.

Acesso ao Ambiente Virtual Protegido

Ao selecionar um ambiente virtual protegido por senha, o sistema abre um modal de autenticação antes de liberar a manutenção das páginas. Esse controle garante que apenas usuários autorizados possam alterar a estrutura vinculada ao ambiente.

Cadastro da Página, Campos e Regras do Formulário

Ao clicar em Nova Página, o formulário reúne os campos que definem a função da página na navegação: Tipo de Página, Nome da Página, Ícone da Página, Descrição, Menu Principal, Arquivo HTML, Rota Personalizada e o status Ativo. O campo Menu Principal define a página principal de referência da estrutura; quando ele permanece vazio, a nova página passa a ser tratada como item raiz do menu lateral.

• ● Tipo de Página: define se o cadastro será uma página HTML comum ou a página especial Gerenciador do Ambiente Virtual.
• ● Nome da Página: texto exibido na estrutura administrativa e, quando a página estiver ativa, também no menu lateral da página inicial.
• ● Ícone da Página: símbolo visual que acompanhará o item no módulo e na navegação do usuário.
• ● Descrição: apoio administrativo para identificar a finalidade da página no cadastro.
• ● Menu Principal: define a página principal de referência e, consequentemente, o nível hierárquico em que a nova página será posicionada.
• ● Arquivo HTML: vincula a página a um arquivo existente no ambiente virtual selecionado. O item passa a abrir esse conteúdo quando o usuário navegar pelo menu.
• ● Rota Personalizada: cria um endereço lógico próprio para a navegação, quando necessário.
• ● Página Ativa: controla se a página ficará disponível para uso na navegação publicada.

Validação do Bloco RLS

Quando a página é vinculada a um Arquivo HTML, o rodapé do formulário passa a exibir o bloco de Row Level Security (RLS). Nesse ponto, o controle ainda permanece bloqueado até que o usuário valide o template e confirme que a estrutura do arquivo atende ao padrão esperado pela plataforma.

• ● Estado inicial: o checkbox Ativar RLS para esta página permanece desabilitado, e o botão Validar Template conduz a análise do arquivo selecionado.
• ● Validação aprovada: o formulário libera o checkbox, informa que a página está apta para RLS e, quando houver rls.json detectado, apresenta a página mapeada para continuidade do vínculo.
• ● Validação não aprovada: o sistema mantém o RLS bloqueado e exibe a mensagem de incompatibilidade, orientando o ajuste necessário no projeto cliente.

O botão Tutorial, disponível no bloco RLS, abre a documentação detalhada da funcionalidade com arquitetura 1:N, pré-requisitos, localização do arquivo e exemplos de implementação.

Resumo prático para configurar o rls.json:

• ● Publicação do arquivo: o projeto cliente deve expor o arquivo em /plataformarj/rls.json. Em algumas estruturas de código-fonte, isso corresponde fisicamente à pasta app/plataformarj/rls.json, mas a URL final validada pela plataforma continua sendo /plataformarj/rls.json.
• ● Estrutura recomendada: utilize um objeto raiz com a chave paginas, declarando uma entrada separada para cada página que participará do controle por linha.
• ● Campo pagina: informe o identificador da página no cadastro. Quando houver vínculo com HTML, mantenha esse identificador alinhado ao nome-base do arquivo ou ao ID utilizado no cadastro da página.
• ● Campo usuario: liste as colunas que identificam o usuário dentro do dataset, normalmente email ou outra chave funcional equivalente.
• ● Campo rls: liste as colunas dimensionais que serão filtradas por permissão, como matricula, setor ou cliente_id.
• ● Compatibilidade dos nomes: os nomes declarados em usuario e rls devem corresponder exatamente aos nomes das colunas realmente existentes no HTML, no dataset e na estrutura reconhecida pela plataforma.
• ● Gravação do arquivo: salve o JSON em UTF-8 sem BOM para evitar falhas de leitura durante a validação.
• ● Continuidade do processo: depois que o template for validado e o rls.json for reconhecido, a definição de regras, usuários, grupos e valores continua no módulo Gerenciar RLS.

Escolha do Ícone da Página

O botão de pesquisa do campo Ícone da Página abre a biblioteca visual de ícones. Nessa tela, o usuário pode pesquisar por palavras-chave, visualizar a prévia e selecionar o símbolo que será exibido na listagem interna do módulo e no menu lateral da página inicial.

Ao confirmar a escolha, a classe do ícone é preenchida automaticamente no campo do formulário e a pré-visualização é atualizada de forma imediata. Isso facilita a padronização visual da navegação sem exigir que o usuário memorize nomes técnicos de ícones.

Estrutura Criada, Arquivos e Níveis do Menu

Depois dos cadastros, a árvore passa a exibir a estrutura organizada por níveis. O comportamento segue a lógica abaixo:

• ● Página principal: criada sem Menu Principal; aparece como primeiro nível do menu lateral.
• ● Subpágina: criada com uma página principal selecionada no campo Menu Principal.
• ● Subpágina de nível seguinte: ocorre quando uma subpágina também passa a receber novas páginas abaixo dela.
• ● Entrada operacional: a página é aberta pelo usuário quando possui Arquivo HTML ou Rota Personalizada válidos.
• ● Agrupador: a página pode permanecer sem arquivo vinculado e continuar aparecendo no menu quando sua função é apenas organizar subpáginas.

No exemplo operacional do manual, a estrutura foi montada com diferentes cenários de hierarquia: Diretoria como página principal única, Receitas > Pedidos > Pedidos Detalhados, Clientes > Carteira Ativa, Operacoes > Estoque / Fornecedores / Margem e a página especial Gerenciar Ambiente.

Consulta da Ordem Hierárquica

O botão Ordem abre o quadro hierárquico para conferência e reorganização das páginas. Nessa visão é possível expandir grupos, validar o encadeamento entre página principal, subpáginas e níveis seguintes, além de ajustar a sequência de exibição do menu lateral sem alterar o vínculo funcional da página.

Resultado no Menu Lateral

Com a estrutura publicada, o menu lateral da página inicial passa a apresentar as páginas cadastradas do ambiente virtual com a mesma hierarquia definida no gerenciador. O recuo visual identifica os subníveis, e o ícone escolhido no cadastro acompanha cada item da navegação.

Página Especial de Gerenciamento

Ao cadastrar uma página do tipo Gerenciador do Ambiente Virtual, o sistema abre um painel operacional próprio, com status de execução, ações de iniciar, reiniciar e parar, criação de agendamentos recorrentes e terminal para acompanhamento de logs e comandos.

Tela Inicial da Operação

Ao acessar o módulo pela primeira vez, a página apresenta a grade de monitoramento vazia e já deixa disponíveis os filtros e as ações principais da rotina. Esse estado indica que ainda não existem regras cadastradas para as páginas validadas.

Monitoramento, Filtros e Auditoria

Com regras já cadastradas, a grade passa a exibir o histórico operacional por registro. Nessa mesma área ficam concentrados os recursos de busca, exportação e importação em lote.

• ● Filtros rápidos: permitem localizar regras por e-mail, nome, página ou status.
• ● Extrair: exporta a visão atual para apoio de auditoria e conferência.
• ● Exemplo: baixa o modelo de planilha usado no carregamento em lote.
• ● Upload: envia múltiplas regras em um único arquivo Excel.
• ● Novo RLS: abre o formulário de cadastro manual de uma nova regra.

Cadastro Manual da Regra

Ao clicar em Novo RLS, a plataforma abre o formulário de criação manual. A lista de páginas exibida nesse modal depende da validação realizada em Gerenciar Páginas, porque apenas páginas já preparadas para RLS podem receber novas regras.

• ● E-mail: identifica o usuário que receberá o filtro.
• ● Nome do Usuário: é preenchido automaticamente após a seleção do e-mail.
• ● Página de Destino: define em qual página o filtro será aplicado.
• ● Valor RLS / Dimensão: informa o valor que será permitido ao usuário.
• ● Coluna Usuário (Filtro 1): representa a chave que identifica o usuário, normalmente email.
• ● Coluna Dimensão (Filtro N): representa a coluna que receberá o filtro, como setor, cliente_id ou centro_custo.

Exemplo de Preenchimento e Salvamento

Depois que os campos são completados, o sistema já deixa a regra pronta para gravação. Esse é o momento de revisar se a relação entre Filtro 1 e Filtro N está coerente com a estrutura do rls.json e com a página selecionada.

Importação em Lote e Resultado

Quando a operação exigir várias regras de uma só vez, utilize primeiro o botão Exemplo para baixar o modelo de planilha e, em seguida, o botão Upload para enviar o arquivo preenchido. Após a importação, a plataforma apresenta um resumo com itens gravados e inconsistências encontradas.

Edição de Regras Existentes

O botão de edição reabre o mesmo formulário com os dados da regra já carregados. Esse fluxo é usado para corrigir valores dimensionais, trocar colunas, alterar a página de destino ou revisar o status operacional da regra.

Regra de Visibilidade Final

Visão Geral do Módulo

Ao abrir a tela, a interface apresenta os blocos Motores de IA e Página para treinamento. Quando ainda não existem IAs registradas, o primeiro bloco exibe o estado vazio com a mensagem "Nenhuma IA cadastrada".

Cadastrar uma Nova IA

Ao clicar em Nova IA, o sistema abre o formulário de cadastro da conexão. Nele você informa nome, senha opcional da conexão, modelo Rejoin BI, raciocínio, velocidade, ordem de prioridade e uma descrição operacional.

O salvamento pode ser concluído por OAuth Rejoin BI ou por Chave de IA Rejoin BI. A senha da conexão é opcional e serve para proteger o uso manual daquela IA específica.

Ler os Cards, Status e Prioridade

Depois do cadastro, cada IA passa a aparecer em um card com modelo, raciocínio, velocidade, status da conexão Rejoin BI, prioridade e volume de requisições. Os botões laterais permitem editar e excluir.

Selecionar a Página para Treinamento

Use os campos Menu Principal, Submenu e Página Final para localizar a tela que receberá o treinamento. Quando a hierarquia é confirmada, o bloco inferior passa a mostrar o caminho completo da página.

Se a estrutura da página tiver menos níveis, os campos seguintes só aparecem quando forem necessários. O vínculo sempre considera a página escolhida dentro do respectivo ambiente virtual.

Preencher o Treinamento Analítico da Página

Com a página definida, preencha o formulário para orientar a IA sobre objetivo, indicadores prioritários, glossário interno, identificação do relatório, regras estratégicas, benchmarks e configurações do agente.

O campo Objetivo da Página é obrigatório. Já o campo Agente Rejoin BI vinculado permite fixar uma IA específica ou manter a rotação automática com base na prioridade dos agentes ativos.

Consultar Ajuda, Limpar Dados e Salvar

O botão Ajuda abre um material de apoio com exemplos de preenchimento, explicações sobre os blocos do formulário e orientação sobre o uso de agente vinculado, prioridade e detalhe.

Ao finalizar a revisão, use Salvar Treinamento para gravar a configuração da página. Quando necessário, o botão Limpar Dados remove o conteúdo do treinamento selecionado.

Visão Inicial do Módulo

Ao abrir a página, o usuário encontra os indicadores superiores, a área de filtros, a tabela Histórico de Eventos e os controles de paginação. Quando ainda não há resultado aplicado, a grade permanece vazia e pronta para consulta.

Aplicar Filtros e Ler o Resultado

Depois de preencher os campos de pesquisa, o botão Aplicar Filtros atualiza os indicadores e a tabela de registros. O módulo aceita a combinação de:

• Período: intervalo de datas da consulta.
• Usuário: e-mail ou login vinculado ao evento.
• Ação: tipo de atividade, como Login, Acesso à Página, Concessão de Permissão, Upload de Arquivo, Gerenciamento de Página e outros eventos operacionais.
• Nível: severidade do registro em Info, Warning ou Error.

Na tabela, cada linha apresenta Data/Hora, Usuário, Ação, Detalhes, Nível e o botão Detalhes para consulta individual.

Abrir o Detalhamento de um Registro

Ao clicar em Detalhes, a plataforma abre o modal do evento selecionado na aba Resumo. Nessa visão ficam disponíveis os principais campos de conferência: Data/Hora, Nível, Usuário, Sessão, Ação, Página, Sucesso, Usuário Alvo e o bloco Resumo da Atividade.

Consultar o JSON Técnico do Evento

No mesmo modal, a aba JSON exibe a estrutura técnica do registro. Os botões Copiar Resumo e Copiar JSON ajudam na documentação de evidências, abertura de chamados e análise técnica.

Saúde do Sistema

O botão Saúde do Sistema abre um painel de verificação do serviço. Nessa consulta são apresentados o Status, a condição do Banco, o tempo de Performance, o Total de Logs e a Última Verificação.

Atualização, Exportação e Paginação

O botão Atualizar recarrega os indicadores e a tabela. Já o botão Extrair gera o arquivo XLSX da consulta atual, respeitando os filtros aplicados.

No rodapé da tabela, use Anterior, Próxima, os números de página e o campo Página com o botão Ir para navegar diretamente até o trecho desejado do histórico.

Visão Geral do Painel

Ao acessar a página, você encontra o botão Nova programação, os indicadores de Total de programações, Ativas, Inativas e Situação atual, além dos blocos Status operacional e Programações de horário. Quando ainda não existem cadastros, o sistema apresenta o estado vazio e o atalho Criar programação.

Nova Programação de Horário

Clique em Nova programação, informe o nome, defina os horários de Início e Fim, selecione os dias da semana e registre Observações quando necessário. Depois disso, conclua em Salvar programação.

Função de cada campo: Nome da programação identifica a agenda no painel; Início determina o horário previsto para o retorno do sistema; Fim define o horário de encerramento da janela operacional; Dias da semana estabelece em quais dias a agenda será considerada; e Observações registra orientações internas, exceções ou contexto de uso da programação.

Regras do cadastro: o horário de fim precisa ser posterior ao horário de início, ao menos um dia da semana deve ser selecionado e cada dia aceita somente uma programação. Se algum dia já estiver vinculado a outra agenda, o sistema bloqueia o salvamento para evitar conflito operacional.

Fluxo operacional: novas programações entram na lista para conferência e podem ser ativadas depois pelo card correspondente.

Status Operacional e Controle das Programações

Depois do cadastro, o painel atualiza os indicadores e passa a exibir a situação corrente da plataforma, com Último status, Próximo retorno, Próximo desligamento e Monitoramento. A área inferior lista as programações criadas com janela, dias ativos, data de atualização e modo aplicado.

Use os botões de cada card para Editar, Ativar, Desativar ou Excluir a programação conforme a rotina da operação. O controle continua respeitando a regra de uma programação por dia da semana.