Definições da plataforma
As secções de administração da plataforma, uma de cada vez: processos, limites, antivírus, email, alarmes, OpenTelemetry, inteligência artificial, autenticação das apps, app móvel, templates, ficheiros sem uso, instalação e código aberto.
As Definições são o painel de controlo da instalação inteira. Não são as definições de uma app — essas vivem dentro de cada app e viajam com ela. Aqui decide-se o que a plataforma faz sozinha, para onde manda os avisos, a partir de que valores se preocupa, e quanto tempo dura uma sessão.
Abre-se pelo item Definições, no fundo da barra lateral. Só contas com perfil de administrador lá entram.
As secções estão numa navegação à esquerda, por grupos: Plataforma, Avisos, Observabilidade, Inteligência artificial, Apps, Instalação e Sobre. Abre-se uma secção de cada vez, e o endereço muda com ela, por isso o botão de voltar do browser leva à secção anterior. O grupo Instalação só aparece numa instalação de uma só organização. Num ecrã estreito, a navegação passa a uma lista de escolha por cima da secção.

Nota
Cada secção tem o seu botão Gravar, no cabeçalho, e grava só essa secção. Mudar de secção sem gravar perde o que estava escrito nela.
Processos
A secção Processos liga e desliga o que corre sozinho enquanto ninguém está a olhar. São três interruptores independentes:
| Interruptor | O que acontece quando está ligado | O que perde quando o desliga |
|---|---|---|
| Agendador | Corre os agendamentos, os relatórios agendados e os temporizadores dos workflows. | Nada se apaga: as horas marcadas simplesmente não correm até voltar a ligar. |
| Índice de observabilidade | Leva o que as apps registam para o índice central e aplica os prazos de retenção de cada app. | Os ecrãs do Radar mostram dados velhos e os registos ficam guardados para sempre. |
| Notificações em tempo real | As notificações chegam ao ecrã de quem está a trabalhar, no momento. | As notificações continuam a ser criadas e entregues — mas só aparecem na visita seguinte. |
O interruptor dos avisos por email fica na secção Alarmes.
Cada interruptor tem efeito quando carregas em Gravar, sem reiniciar o servidor: o que ligares arranca nesse momento, e as notificações em tempo real desligadas fecham logo.

Atenção
Desligar o Agendador é a causa número um de "os meus scripts deixaram de correr". Se um agendamento parece morto, confirma este interruptor antes de investigar o script. Vale o mesmo para relatórios agendados e para passos de espera em workflows — dependem todos do mesmo motor.
Antivírus
A secção Antivírus liga a plataforma a um antivírus por ICAP, para os ficheiros que entram nas apps serem verificados antes de se guardarem, e mostra os ficheiros em quarentena. Está explicada em Antivírus.
É por aqui que a plataforma manda os alarmes dela — não confundir com o email que cada app manda aos utilizadores dela, que se configura nos canais de notificação da app.
Preenche:
- Servidor e Porta do serviço de email.
- Segurança — SSL/TLS encripta desde o início da ligação (porta 465); STARTTLS se o servidor oferecer abre a ligação sem encriptação e passa a TLS se o servidor o oferecer (porta 587); Nenhuma nunca encripta, para servidores internos sem TLS (porta 25). Sem utilizador nem palavra-passe, o envio não autentica.
- Utilizador e Palavra-passe da conta de envio. A palavra-passe escreve-se uma vez e nunca volta ao ecrã: o campo passa a dizer que está definida, e deixá-lo vazio significa "não mexer", nunca "apagar".
- Remetente — o endereço que aparece a quem recebe.
- Destinatários: endereços, separados por vírgulas, que recebem todos os alarmes. Em branco, cada app avisa as pessoas atribuídas a ela, e as apps sem ninguém atribuído e a plataforma avisam os administradores activos.

Alarmes
A secção Alarmes diz se a plataforma avisa por email e a partir de que valores.
O interruptor Avisos por email, no topo, liga os avisos. Desligado, ninguém é avisado, e os problemas só se descobrem ao abrir o Radar. Os avisos saem pelo servidor da secção Email.
Um problema novo numa app publicada, ou um problema resolvido que volta a acontecer, avisa sempre, sem limiar. O que gera cada alerta e o que diz o email está em Alertas por email.
Os Limiares dizem à plataforma quando o resto merece um email. Todos são avaliados dentro da janela definida no fim da secção.
| Valor | O que significa |
|---|---|
| Falhas do servidor nas APIs (%) | Percentagem de pedidos que falham no servidor (5xx) acima da qual se abre um alarme de falha generalizada, com pelo menos 5 falhas na janela. Recusas, pedidos cancelados e erros de validação não contam. |
| Pedidos mínimos | Abaixo deste número de pedidos, a percentagem não conta. Um erro em três pedidos são 33% e não quer dizer nada. |
| Scripts falhados | Quantas execuções falhadas abrem um alarme. |
| Atraso da fila (s) | Quanto tempo o trabalho de fundo pode ficar para trás antes de ser considerado atrasado. |
| Disco livre (%) | Abaixo desta percentagem, avisa. |
| Janela (min) | O período em que tudo o que está acima é contado. |
Dica
Numa instalação com pouco tráfego, sobe os Pedidos mínimos. É o campo que evita alarmes de falha generalizada em apps que só são usadas de manhã.
Limites
Duas definições que valem para toda a plataforma:
- Duração da sessão (h) — quanto tempo uma sessão dura sem actividade. Enquanto se trabalha, a sessão renova-se sozinha; só a inactividade prolongada obriga a entrar de novo.
- Ficheiro máximo (MB) — o tamanho máximo de um ficheiro carregado em qualquer app da instalação. Vale também para os ficheiros carregados nos assets de uma app. Vai até 100 MB. A importação de apps não depende deste valor: aceita pacotes até 1 GB (ver Importar e exportar apps).
OpenTelemetry
A secção OpenTelemetry, no grupo Observabilidade, envia o que acontece nas apps para o servidor OpenTelemetry da empresa, pelo OTLP por HTTP em JSON. O Radar continua a funcionar como antes: o envio é uma cópia.
- Em Endereço, escreve o endereço base do OTLP por HTTP, por exemplo
https://otel.empresa.pt:4318. O Keplin acrescenta/v1/tracese/v1/logs. - Opcional: em Cabeçalhos, carrega em Acrescentar cabeçalho e
escreve o Nome e o Valor dos cabeçalhos de autenticação do
serviço, por exemplo
Authorizationoux-api-key. Os valores ficam cifrados e não voltam a aparecer; em branco, fica o valor gravado. - Em O que enviar, escolhe:
- Chamadas às APIs e execuções de scripts, como traces, com os ids de trace e de span que o Keplin já usa;
- Erros do Radar, como logs, com o tipo, a mensagem e o rasto do erro, ligados ao trace;
- Auditoria, como logs: quem mudou o quê na plataforma, sem o antes e o depois;
- Actividade no browser, como traces: os ecrãs abertos, os cliques e as leituras. É muita: liga-a só se o serviço a aguentar.
- Carrega em Testar ligação. O teste passa quando o servidor aceita um envio de teste.
- Liga Enviar para o OpenTelemetry e carrega em Gravar.

O envio começa no momento em que se liga, sem o histórico. Os dados dos pedidos e das respostas nunca são enviados. O Estado mostra a hora do último envio e quantos spans e logs saíram desde que o servidor arrancou, e o último erro, se for mais recente do que o último envio.
Endereço público
O Endereço público é o endereço por onde as pessoas abrem a plataforma,
por exemplo https://plataforma.exemplo.pt. É o que vai nos links dos emails,
como o da recuperação da palavra-passe das contas das apps. A secção fica
no grupo Instalação, que só aparece numa instalação com um só tenant; em
multitenant vale o endereço de cada tenant.
Fica preenchido no primeiro login de um administrador, com o endereço por onde ele entrou. Se não for o endereço que as pessoas usam (por exemplo, se o administrador entrou pelo IP da rede interna), corrige-o e carrega em Gravar.
Sem Endereço público, a recuperação da palavra-passe só funciona nas apps publicadas num domínio próprio. O endereço que vem num pedido nunca serve para o link, porque é quem faz o pedido que o escolhe.
Servidor PostgreSQL da plataforma
Para os datasources internos em PostgreSQL (ver Ligar bases de dados), a instalação precisa de um servidor PostgreSQL onde a plataforma cria as bases. A configuração é da instalação, não de uma app: numa instalação de uma só organização fica nas Definições, na secção PostgreSQL gerido do grupo Instalação; numa instalação com vários clientes fica no backoffice da instalação. Preenche o endereço, o porto, a conta de administração e o limite de bases por cliente, grava e usa Testar servidor para confirmar que a plataforma consegue criar bases nesse servidor. Enquanto não estiver configurado, a opção PostgreSQL do separador Interno aparece desactivada ao criar um datasource.
Motor do browser
As capturas de ecrã que os agentes pedem pelo MCP e os testes de ecrã (ver O projecto de testes) usam um browser sem ecrã que corre no servidor. Há um só para a instalação inteira, num processo à parte e com prioridade baixa: quando a máquina aperta, quem cede é o browser, não os pedidos das apps.
A secção Motor do browser, no grupo Instalação (numa instalação com vários clientes, no backoffice da instalação), mostra o Estado (a correr, ou fechado até ao próximo trabalho), se o Chromium está instalado, os Trabalhos a correr e na fila, a Memória livre e o Último erro. E tem os limites que protegem o servidor:
| Limite | O que faz |
|---|---|
| Trabalhos ao mesmo tempo | Quantas páginas abertas ao mesmo tempo. Mais páginas, mais memória e CPU. |
| Pedidos na fila | Com a fila cheia, um pedido novo é recusado logo, com a razão. |
| Minutos parado até fechar | Fechado, o browser não ocupa memória; o trabalho seguinte volta a abri-lo. |
| Memória livre mínima (MB) | Abaixo disto nenhuma página nova abre. 0 desliga a guarda. |
Fechar o browser agora devolve a memória já. Se o Chromium faltar, Instalar o Chromium descarrega-o; a instalação e as actualizações da plataforma já o instalam e verificam que arranca.
Actualizar a plataforma
Onde e como se actualiza depende do modo da instalação:
- Instalação de uma só organização: não há actualização pela interface. A secção Actualizações das Definições mostra a Versão instalada: e o comando a correr na consola do servidor com o zip da versão nova, com um botão para o copiar. O instalador mantém as configurações e os dados e corre as migrações; para voltar a uma versão anterior, instala-se o zip dessa versão.
- Instalação com vários clientes: a actualização faz-se no backoffice da instalação, em Actualizações, e é esse ecrã que o resto desta secção descreve. As Definições de cada cliente não têm actualizações.
A secção de actualização mostra a versão instalada e a lista de versões disponíveis. O processo tem dois botões de propósito:
- Preparar — vai buscar a versão escolhida e prepara-a sem tocar em nada do que está a servir. A plataforma continua a funcionar.
- Quando a preparação termina, aparece o plano: quantas bases de dados vão ser migradas, que ficheiros de apps são reescritos e em quantas versões, mais o aviso de que as bases de dados são copiadas antes de se mexer em nada.
- Aplicar esta actualização — só depois de leres o plano. A plataforma fica indisponível durante o reinício e volta na versão nova.

Nota
Se alguma app tiver em disco alterações que ainda não estão no histórico, o plano di-lo e a actualização grava-as primeiro, num registo à parte, antes de reescrever os ficheiros. Os ficheiros que a plataforma escreve sozinha, como as cópias das dependências dos scripts que um agendamento faz, não contam.
Se alguma coisa correr mal a meio, a versão anterior é reposta automaticamente e o ecrã di-lo — incluindo o registo do que falhou.
A reposição devolve ao estado de antes da actualização as bases de dados e também os ficheiros das apps que as migrações tinham reescrito.
Verificação do servidor
No ecrã das actualizações, o bloco Verificação do servidor mostra se a máquina tem o que os scripts das apps, as capturas de ecrã e os testes de ecrã precisam: o Chromium, o isolamento dos scripts, as regras de rede dos scripts e os processos da plataforma a correr com o utilizador da instalação. A verificação corre no fim da instalação, no fim de cada actualização e no arranque do servidor; Verificar agora corre-a a pedido.
O resumo diz «Está tudo bem.», quantos avisos há, ou quantos problemas estão por resolver. Cada problema diz o que falha e mostra o comando que o resolve, para correr como root na consola do servidor.
Inteligência artificial
O grupo Inteligência artificial tem os Fornecedores de IA do tenant: os serviços de IA que os scripts das apps podem usar, com as credenciais e os modelos autorizados. Está explicado no capítulo Fornecedores de IA.
Autenticação das apps
A secção Autenticação das apps, no grupo Apps, regista os fornecedores por onde os utilizadores das apps podem entrar: o Microsoft Entra ID, o Google, um serviço OpenID Connect ou OAuth 2.0 e, numa instalação com um só tenant, o Active Directory. Está explicada em Entrar com fornecedores de autenticação.
App móvel
A secção App móvel serve a app Android com que se entra nas apps desta plataforma. Tem dois ficheiros para transferir e um código QR por app — está explicado em detalhe no capítulo App móvel.

Templates
A secção Templates, no grupo Apps, lista os templates desta plataforma: os que se guardaram nas apps com Guardar como template (ver Templates). Os templates de sistema são da instalação e não aparecem aqui.
Cada linha mostra o nome, a versão, a descrição, a app de onde veio, a data em que foi guardado e o tamanho. Em cada uma:
- Descarregar transfere o ficheiro
.keplintemplate, para o levar para outra instalação. - O ícone do caixote apaga o template. A confirmação aparece na própria linha: carrega em Apagar para confirmar, ou em Cancelar. O template sai da galeria da Nova app, e as apps já criadas a partir dele não mudam.

Ficheiros sem uso
Os ficheiros carregados nas apps não se apagam sozinhos: nem quando o registo que os tinha é apagado, nem quando um anexo é substituído, nem quando um formulário fica a meio. A secção Ficheiros sem uso encontra-os e deixa escolher o que sai. Nada é apagado sozinho.
- Carrega em Procurar ficheiros sem uso, no cabeçalho. A procura corre em segundo plano no servidor: podes sair da página e voltar, e ela continua.
- Enquanto procura, a página mostra o progresso (por exemplo, «3 de 12 apps») e o que está a ler. Cada app aparece logo que acaba, com os ficheiros que nenhuma referência conhecida usa: nome, tamanho, data de carregamento e versões. O ícone ao lado do nome descarrega o ficheiro, para confirmares o que é.
- Escolhe os ficheiros e carrega em Apagar seleccionados. A página pede confirmação; antes de apagar, a plataforma volta a verificar os ficheiros escolhidos, e um ficheiro que entretanto passou a ser usado fica.

O resultado fica guardado: ao voltar à secção, aparece a última procura, com a data e quanto tempo durou. Procurar outra vez repete a procura em todas as apps, e Procurar nesta app, no cabeçalho de uma app, só nessa. Cancelar a procura pára uma procura a decorrer. Se o servidor reiniciar a meio, a página diz que a última procura ficou a meio. Tempo de cada fonte mostra quanto demorou cada base lida, para se perceber onde está o tempo de uma procura lenta.
Um ficheiro conta como usado quando o token dele aparece no desenho da app, nas bases SQLite da app (incluindo processos e notificações) ou numa coluna de texto de uma tabela do modelo, em qualquer versão. Os datasources só de leitura não se lêem, porque o Keplin nunca escreve neles. Uma tabela fora do modelo ou um sistema externo não são vistos: confirma antes de apagar. Os ficheiros das últimas 24 horas não entram, e uma app com uma base que não se consegue ler fica de fora da lista.
Atenção
Um ficheiro apagado não volta. Os bytes saem do armazenamento da app e o ficheiro sai do registo de todas as versões.
Código aberto
A secção Código aberto lista as bibliotecas de código aberto instaladas na plataforma, com a versão e a licença de cada uma. O nome de cada biblioteca abre a página do projecto. Escreve no campo de pesquisa para filtrar a lista por nome ou por licença.
Perguntas frequentes
Mudei um limiar e não recebi nada. Os alarmes só são avaliados de minuto a minuto e apenas dentro da janela definida. Confirma também que o interruptor Avisos por email, na secção Alarmes, está ligado, e que o servidor da secção Email está preenchido.
Posso ter servidores de email diferentes por app? Sim — e é o normal. O email desta página é só o dos avisos da plataforma; cada app configura os seus canais nas definições dela.
Quem consegue ver esta página? Apenas contas com perfil de administrador. Um developer não a vê na barra lateral nem lá entra por endereço directo.