Painéis da plataforma — Gerenciador, construtor e Painel de Processos

Antes, cada painel vivia num canto diferente da plataforma — e era fácil perder de vista o que já existia, ou montar um painel que sumia ao sair da tela. Hoje existe um único lugar para ver todos os painéis — o Gerenciador de Painéis — e um único construtor de painéis de canvas, com persistência garantida e pré-visualização com dados reais. Você encontra, abre, cria e edita qualquer painel da plataforma sem procurar em menus diferentes.

O que você encontra

1. Um único construtor — todo painel de canvas é criado, editado e visualizado no mesmo construtor: canvas de 12 colunas com arrastar e redimensionar e widgets de métrica, tabela, filtro e busca. Cada widget lê um dado do contexto — você escolhe o contexto e, dentro dele, o dado pelo nome (ex.: "Contrato", "Parte", "Trechos de documentos"), sem precisar saber em que banco ele mora nem como se chama no esquema. O painel montado é interativo: filtros e busca aplicam nos widgets do mesmo dado, tabelas ordenam por clique no cabeçalho e paginam, e ações de linha podem abrir um processo BPM com a chave de negócio interpolada dos dados da própria linha.
2. Gerenciador de Painéis — em Sistema›Contextos›Painéis, uma lista única com os painéis nativos da plataforma (selo Plataforma), os painéis de canvas de cada workspace e os dashboards do DATTABI (selo Dashboard BI), com busca e ações.
3. Visualizador somente leitura — qualquer painel de canvas abre em modo de visualização, com dados reais e sem ferramentas de edição.
4. Painel nativo ligado pelo gerenciador — os painéis nativos da plataforma (Painel de Processos, Painel de Onboarding PJ, Pendências de Compliance e o painel de triagem de cada contexto personalizado com âncora) aparecem num workspace só quando alguém os liga no gerenciador de workspaces, aba Painéis. O tipo do contexto de dados diz qual painel lê qual contexto; ligar um painel a um workspace sem esse contexto é permitido, com um aviso do que ele vai mostrar ali. A galeria Painéis e o atalho de painéis da tela inicial só mostram o painel nativo ligado.

Ver todos os painéis da plataforma

1. Acesse Sistema›Contextos›Painéis. A trilha de navegação mostra DATTA > Sistema > Contextos > Paineis.
2. O Gerenciador de Painéis carrega o catálogo de painéis e a lista de workspaces em paralelo, então a tela abre inteira de uma vez. Use a busca para filtrar por nome ou workspace.
3. Cada linha mostra o título, o workspace de origem e o selo do tipo: Plataforma para os painéis nativos, gerenciados pelo sistema, e Dashboard BI para dashboards do DATTABI.

Enquanto carrega, a tela mostra o indicador de progresso; sem nenhum painel, mostra o estado vazio; e qualquer falha aparece como aviso amigável em português, nunca como erro técnico.

Abrir um painel (somente leitura)

1. Clique em Abrir na linha do painel.
2. Painéis de canvas abrem no visualizador, com dados reais e barra reduzida: título do painel, Atualizar (reroda a pré-visualização) e Abrir no construtor. A paleta de widgets, o painel de propriedades e os botões de edição não aparecem, e a pré-visualização roda sozinha assim que o painel termina de carregar.
3. Painéis nativos navegam para a tela correspondente dentro da própria aplicação; dashboards de BI abrem no DATTABI.

Esse mesmo visualizador é usado pelo atalho de painéis da tela inicial. Há ainda um modo sem moldura (embed=1), criado para os cartões da galeria "Painéis" do workspace (ver Workspaces: dashboards do DATTABI e filtro por contexto): ele esconde a barra inteira e já implica somente leitura.

Criar um painel novo

1. Clique em Novo Painel, escolha o workspace de destino, informe o título (ex.: "Visão Geral dos Processos") e uma descrição opcional.
2. Confirme — o painel é criado e abre direto no construtor.
3. Adicione os widgets (métrica, tabela, filtro, busca) pela paleta — cada um nasce abaixo do último, sem cobrir o que já está no canvas.
4. No painel lateral, em Dados, escolha o contexto (a lista traz os contextos do workspace) e o dado do contexto. A lista mostra o que o contexto tem, com nome legível e quantidade:
   • Registros — as entidades do contexto (ex.: Contrato, Parte, Cláusula). A entidade principal do contexto aparece primeiro, com a marca principal.
   • Documentos — os trechos de texto dos documentos enviados ao contexto.
   • Bases externas — as tabelas das bases externas ligadas ao contexto. Uma base que não responde aparece como aviso, e o resto da lista continua. Quando alguém escreveu a descrição do dado na Ficha do Ativo do Knowledge Catalog, ela aparece como segunda linha do item.
5. Escolha os campos (pelo nome legível — "Data assinatura", "Valor total") e a agregação: contagem (COUNT), contagem distinta (COUNT_DISTINCT), soma (SUM), média (AVG), mínimo (MIN) e máximo (MAX). Na tabela, Incluir todos os campos monta as colunas de uma vez. A descrição da coluna escrita na Ficha do Ativo aparece embaixo do campo escolhido e como dica ao passar o mouse na lista.
6. Use Pré-visualizar para ver os números com dados reais e Salvar para gravar.

Painéis montados antes da escolha por contexto continuam funcionando sem mudança. Ao abrir um widget desses, o painel lateral avisa qual dado ele lê e permite trocá-lo pelo dado do contexto.

Filtros e busca vivos

• O widget filtro escolhe um campo do dado; em modo de visualização ele vira um seletor com os valores reais daquele campo ("Todos" limpa). O valor escolhido filtra todos os widgets do mesmo dado (mesmo contexto e mesmo dado).
• O widget busca declara em quais campos o texto procura; a busca é aplicada com "contém", sem diferenciar maiúsculas, nos widgets do mesmo dado. Enter atualiza.
• A métrica tem a condição Considerar só quando: escolha o campo, a comparação (é igual a, é diferente de, contém, é maior que, é menor que) e o valor — sem escrever sintaxe de consulta. Ela é combinada com E ao filtro do painel. Condições escritas como texto em painéis antigos continuam valendo e podem ser trocadas por uma condição simples.

Tabelas: ordenação, paginação e ações

• Clique no cabeçalho de uma coluna para ordenar (segundo clique inverte).
• Largura das colunas: arraste a borda direita do título da coluna, ou informe a largura em pixels no painel lateral (60 a 800 px). A largura é gravada com o painel.
• Tabelas e demais widgets têm barra de rolagem horizontal e vertical: o texto não é espremido — o que não cabe rola dentro do widget, e o cabeçalho da tabela fica fixo enquanto as linhas rolam. Números saem no formato brasileiro e alinhados à direita.
• "Linhas por página" controla a paginação (‹ › no rodapé).
• Ações de linha: cada ação é um botão por linha — Link navega para uma URL com valores da linha interpolados (${campo}), e Abrir BPM cria uma instância do processo publicado com chave de negócio, título e variáveis da linha.
• Processo BPM (status por linha): informando o nome do modelo publicado e o template da chave de negócio, a tabela ganha a coluna "Processo" com o estado da instância correspondente (clicável — abre o Process Monitor). A mesma chave faz o botão "Abrir BPM" sumir quando já existe tratamento.

Publicar na galeria

Marque Publicar na galeria na barra do construtor e salve. Sem a marca, o painel continua acessível apenas pelo Gerenciador de Painéis.

O construtor de painéis está em preview. Enquanto estiver, painéis de canvas não aparecem na galeria "Painéis" nem no atalho de painéis da tela inicial, mesmo marcados como publicados — essas superfícies mostram só os painéis nativos da plataforma e os dashboards do DATTA BI. A marca continua valendo e passa a ter efeito quando o construtor sair de preview; até lá, o caminho para abrir um painel de canvas é o Gerenciador de Painéis.

Editar um painel existente

• Painéis de canvas: Editar abre o construtor.
• Dashboards de BI: Editar abre o editor do DATTABI.
• Painéis nativos (selo Plataforma) não são editáveis — o conteúdo é gerenciado pela plataforma, e a tela avisa em português se você tentar.

Links configurados em painéis passam por validação antes de abrir: só endereços http/https ou relativos são aceitos, o que bloqueia endereços maliciosos do tipo javascript: e data:.

Por que existe um só construtor

Existiam dois construtores de painéis. O antigo, na entrada Sistema›Contextos›Painéis, montava cartões de indicador por descoberta interativa sem persistência — o usuário perdia tudo ao sair da tela. O outro, o construtor de workspaces, era o construtor real: canvas, pré-visualização com dados reais e persistência. Como as capacidades do primeiro eram um subconjunto das do segundo, a unificação retirou o construtor fraco em vez de fundir código.

Hoje "Contextos → Painéis" é uma tela fina de gerenciamento sobre o catálogo de painéis da plataforma — o mesmo catálogo que alimenta o atalho de painéis da tela inicial e o menu lateral (ver Workspaces: dashboards do DATTABI e filtro por contexto). Além dos painéis de canvas e dos dashboards de BI de cada workspace, esse catálogo traz as entradas nativas do registro de painéis da plataforma.

Painel nativo: o tipo do contexto diz o que ele lê, o gerenciador o liga

O tipo do contexto de dados diz qual contexto cada painel nativo lê:

Um tipo de contexto pode ofertar mais de um painel — é o caso do dossiê cadastral, que traz dois cartões. Um tipo sem painel declarado não oferece nenhum — antes o painel de processos judiciais aparecia até para contexto de dossiê cadastral, e a tela abria com a lista errada.

Quem liga é o gerenciador de workspaces. Nenhum painel nativo entra sozinho num workspace: nem ao salvar os contextos, nem ao reiniciar a plataforma, nem na instalação nova. Para ver um painel nativo num workspace, abra Sistema›Workspaces, escolha o workspace e, na aba Painéis, clique em Vincular existentes e marque o painel no grupo Nativo. Depois de salvar contextos que oferecem um painel ainda não ligado, a aba Contextos de Dados lembra: "Para ver o Painel de Processos neste workspace, ligue-o na aba Painéis".

Ligar um painel a um workspace que não tem o contexto que ele lê é permitido: a tela avisa o que o painel vai mostrar ali e salva normalmente. O Painel de Processos e os painéis por âncora são a mesma tela, que lê qualquer contexto ancorado do workspace: sem nenhum, o aviso é "Este workspace não tem contexto do tipo Processo Judicial; o painel abrirá sem registros"; com um contexto ancorado de outro tipo, o painel abre com os registros dele — "…; o painel mostrará os registros de Contratos, com o título "Painel de Contratos"". Os painéis de dossiê não são filtrados pelo workspace: abrem no dossiê do workspace quando ele é o único contexto dele, e senão no primeiro dossiê cadastrado na instalação — o aviso diz qual. Contexto cadastrado antes do campo "tipo de contexto" existir não declara tipo; num workspace só com contextos assim o aviso do painel de triagem não aparece, porque não há como saber o que ele mostrará.

A galeria Painéis e o atalho de painéis da tela inicial mostram um painel nativo só quando ele está ligado ao workspace ativo; em Todos os workspaces, os ligados a algum workspace que você enxerga.

A mudança de 27/09/2026. Até essa data a plataforma ligava o painel nativo sozinha, pelo tipo dos contextos do workspace, e corrigia o vínculo a cada reinício. Na primeira subida depois da mudança, todos os vínculos a painel nativo foram removidos de todos os workspaces: religue pela aba Painéis os que devem continuar. Cada painel que você liga pelo gerenciador fica registrado junto dos workspaces, no arquivo paineis-nativos-manuais.json, e não é removido por reinício nenhum; a mesma lista guarda o que saiu (removidos). Se uma versão anterior da plataforma voltar ao ar (rollback) e religar painéis pelo tipo, a subida seguinte desta versão os remove de novo — só os que o gerenciador não ligou.

Os cartões de dossiê cadastral só são oferecidos a quem tem permissão para consultar dossiês PJ — a mesma permissão que já esconde o item "Onboarding PJ" no menu lateral, e que os dois painéis exigem para ler os dados. Sem ela o cartão não aparece em lugar nenhum (galeria, atalho de painéis da tela inicial ou gerenciador), em vez de aparecer e abrir sem acesso.

Criação automática na subida

O seed de workspaces roda na inicialização da plataforma e é best-effort (uma falha de seed nunca derruba a subida do sistema):

• Instalação nova (nenhum workspace ainda) — cria os workspaces "Processos" e "Assistência Social"; o "Processos" já vem com o painel de canvas "Painel de Processos". Nenhum dos dois nasce ligado a painel nativo: ligue os que quiser pela aba Painéis do gerenciador.
• Instalação existente — nenhum workspace é criado (nem o que o admin renomeou ou apagou). Painéis criados pelo admin nunca são tocados, e vínculo a painel nativo não é acrescentado, trocado nem apagado.
• O canvas "Painel de Processos" é acrescentado uma vez por workspace, nunca de novo. Um workspace chamado "Processos" que ainda não foi atendido (criado ou renomeado depois) ganha o canvas que faltar (checagem por título, sem diferenciar maiúsculas) e fica registrado em upgrades-de-boot-aplicados.json, ao lado do workspaces.json. Se o usuário tirar o canvas depois, ele não volta em restart nem em release. Até 29/09/2026 o canvas voltava a cada subida. Na primeira subida com essa regra, os workspaces existentes são só registrados, sem mudança: as versões anteriores já tinham acrescentado o canvas em toda subida, então o que falta foi o usuário que tirou. Registro ilegível: nenhuma subida acrescenta nada, e o log avisa com o caminho do arquivo. Se o registro gravar e o workspaces.json não (volume cheio, falha de disco), o workspace sai do registro e a próxima subida tenta de novo — o log diz sera retentado na proxima subida. Se nem essa correção do registro gravar, o log nomeia o workspace que ficou sem o canvas e avisa que não haverá nova tentativa. Limite: um rollback para versão anterior a essa regra devolve o canvas em toda subida; de volta à versão atual, tire-o de novo e ele não volta mais.

A configuração inicial do painel de canvas traz uma métrica "Total de Processos" (contagem sobre o recurso Processo no Neo4j) e uma tabela com as colunas número, classe e status. O vínculo com o contexto é dinâmico: usa o contexto ativo cadastrado pela interface, se houver; sem contexto, o painel nasce sem vínculo e o admin associa depois no construtor — nada fica fixo no código.

Para o admin: quando um workspace "Processos" recebe o canvas, o log registra Workspace seed: 'Processos' atualizado; a primeira subida com o registro dos upgrades registra Workspace seed: registro ... criado. A remoção dos vínculos nativos aparece no log como Painel nativo desvinculado (remocao unica...), uma linha por workspace com os painéis que saíram, seguida do total; numa subida depois de um rollback, como Painel nativo desvinculado: ... o vinculo nao foi feito pelo gerenciador.

Quem pode o quê

O frontend esconde as ações sem permissão apenas como dica visual; a barreira real é a validação no backend. Uma negação retorna mensagem em português explicando a falta de permissão, sem detalhe técnico na tela.

Endereços diretos e telemetria

O construtor aceita os parâmetros ws (workspace), panel (painel), mode=view (visualizador) e embed=1 (sem moldura, já implica visualização).

As duas telas — gerenciador e construtor — enviam telemetria de navegação e uso (identificadas como datta-fe-paineis e datta-fe-panelbuilder), propagam o contexto de rastreamento nas chamadas ao backend e reportam a atividade do usuário para a aplicação.

A criação e a atualização de painéis também estão disponíveis pela API — veja a referência de API.

Limitações conhecidas

• Nomes legíveis vêm do identificador: "dataAssinatura" vira "Data assinatura", com acento restaurado para as palavras mais comuns. A Ficha do Ativo guarda descrição, não nome: a descrição aparece junto do nome, sem trocá-lo. Quem não tem permissão de ver o Knowledge Catalog vê a lista sem descrições. Descrições de tabelas de bases externas ainda não aparecem.
• Sem widgets de gráfico (barras, rosca, linha) no construtor. O Painel de Processos nativo é replicável com métrica + tabela + filtro; para dashboards com gráficos ricos, use o DATTABI.
• Painel nativo não é editável pelo construtor — ele é uma tela da própria aplicação, não um canvas.
• Só três famílias de contexto têm painel nativo hoje (processo judicial, dossiê cadastral e personalizado com âncora declarada). Contexto de código processual, de análise de crédito ou personalizado sem âncora não oferece cartão nativo até que um painel seja declarado para o tipo — de propósito: um cartão errado é pior que nenhum.
• Painéis de canvas não aparecem na galeria "Painéis" nem no atalho da tela inicial enquanto o construtor estiver em preview — nem com a marca "Publicar na galeria". Eles continuam acessíveis pelo Gerenciador de Painéis e pela aba de painéis do workspace.
• Paginação em bancos JDBC usa a sintaxe LIMIT/OFFSET (Postgres, MySQL, H2, SQLite). Dialetos sem esse suporte mostram o erro do próprio banco no widget.
• Identificação do painel recém-criado no fluxo Novo Painel usa a data de criação mais recente do workspace retornado — heurística suficiente porque a criação é síncrona, mas o identificador do painel não vem direto na resposta.