Glossário

Esta página é a referência rápida do vocabulário do Keplin. Cada termo tem a definição em duas ou três frases e, quando existe, o sítio da plataforma onde o encontras. Os nomes a negrito são os nomes exactos que vês no ecrã.

#A

Acção (permissões) — Uma capacidade declarada nas Permissões da app (ex.: «aprovar-encomenda»). Os widgets podem exigir uma acção: quem não a tiver não vê o widget, ou vê-o desactivado.

Administrador (admin) — O perfil de quem constrói com acesso total: todas as apps, mais a gestão de utilizadores, API keys, definições da plataforma e a criação e eliminação de apps.

Agendamento — A execução automática de um script num horário ou intervalo. Vive debaixo do script, na árvore do minitab Código; pode ser activado e desactivado sem o apagar.

API — Uma operação de dados da app, servida pelo endpoint GraphQL dela. Constrói-se num editor próprio: ou como API de tabela ou como um pipeline de passos (SQL, código, chamada HTTP, script).

API de tabela — Uma API gerada a partir de uma tabela do modelo de dados: escolhes a tabela, as acções expostas (ler, inserir, actualizar, apagar) e os campos incluídos, e as operações ficam prontas.

API Key — Uma chave de acesso para clientes externos chamarem as APIs GraphQL. Gerida no menu global API Keys; cada key tem um scope — as apps e endpoints a que dá acesso. A chave em texto claro só é mostrada no momento em que é gerada.

App — A unidade de tudo no Keplin: uma aplicação completa com ecrãs, dados, APIs, scripts, definições e utilizadores próprios. Ver a página Conceitos essenciais deste capítulo.

Árvore da app — A barra lateral do espaço de trabalho de uma app, com tudo o que ela contém organizado em minitabs (UI, Código, Dados, Radar). Redimensiona-se arrastando a borda direita.

Asset — Um ficheiro da app (imagem, documento, …) carregado na secção Assets do minitab UI, para usar nos ecrãs — por exemplo o logótipo.

Autenticação (da app) — A secção das definições da app que decide como os utilizadores dela entram: username e password geridos na app, registo público ligado ou desligado, e recuperação de palavra-passe.

#C

Checkout (bloqueio) — Reservar um elemento (um ecrã, uma API, um script) para ti: Checkout — bloquear para mim no menu do elemento. Os outros vêem o cadeado Em checkout por… e não gravam por cima; Checkin — libertar devolve-o.

#D

Datasource — Ver Fonte de dados.

Datastore — Um contentor de dados de um ecrã: liga um registo ou uma lista de uma API aos widgets desse ecrã (um formulário a um registo, uma grelha a uma lista). Configura-se no editor de ecrãs, na categoria Dados.

Developer — O perfil de quem constrói com acesso restrito: só vê as apps que lhe forem atribuídas — e nelas faz tudo, excepto o que é exclusivo de administradores (criar e apagar apps, gerir contas e keys).

Definições da app — O painel de configuração de uma app, aberto pela engrenagem no topo da árvore: Geral, Autenticação, Notificações, Armazenamento, Utilizadores da app, Permissões, Tema, Traduções e Rotação de registos.

#E

Ecrã — Uma página da app construída, desenhada no editor visual. Tem uma rota, pode ter parâmetros, e é composta por widgets ligados a dados.

Ecrã de sistema — Um ecrã que existe em todas as apps, com rota e acesso fixos: Login, Recuperar palavra-passe e Registo. Vive no grupo Sistema da árvore de ecrãs; o aspecto edita-se como o de qualquer outro ecrã.

Ecrã público — Um ecrã servido sem sessão iniciada. Só carrega dados de APIs com leitura pública.

Endpoint — A entrada GraphQL pública de uma app: /api/graphql/<slug>. Todas as APIs publicadas da app são servidas aí; o endereço aparece no separador Visão geral.

Enum — Uma lista fechada de valores com etiqueta (ex.: estado Activo/Inactivo). Os enums do modelo alimentam campos de escolha nos ecrãs, colunas kanban e argumentos de APIs.

Espaço de trabalho — Ver Workspace.

#F

Fonte de dados — Uma ligação a uma base de dados (interna ou externa) usada pelas APIs, scripts e pelo modelo da app. Gere-se no minitab Dados, secção Fontes de dados; as credenciais ficam cifradas.

#G

GraphQL — A linguagem das APIs do Keplin: os clientes fazem queries (leituras) e mutations (escritas) contra o endpoint da app. O editor de APIs gera a documentação e exemplos prontos a copiar.

#H

Histórico — O registo de todas as gravações de uma versão: quem, quando e o quê. Abre-se no menu Versões; permite Repor a app neste estado e Reverter esta alteração.

Host — Um endereço publicado de uma app (ex.: crm.empresa.com). Cada host serve exactamente uma versão; gere-se na secção Publicação das definições da app.

#L

Layout — Um esqueleto reutilizável de ecrã (ex.: base com cabeçalho): os ecrãs que o usam herdam a estrutura. Vive na árvore de ecrãs, criado com Novo layout.

Ligações MCP — A página de conta onde vês e revogas as aplicações externas (assistentes, agentes) a que autorizaste acesso à tua conta. Cada uma vê e faz exactamente o que tu vês e fazes.

#M

main — A primeira versão de toda a app, criada com ela. Não pode ser apagada.

Modelo de dados — O mapa das entidades da app: tabelas importadas das fontes de dados, campos com nomes amigáveis, relações e enums. É a base das APIs de tabela e das ligações de dados nos ecrãs.

Mutation — Uma operação GraphQL que escreve dados. As APIs de tabela geram add, update e delete; num pipeline, marca-se a API como Mutation — escreve dados.

#N

Navegação — O menu da app construída (barra superior e lateral), com itens, submenus, separadores e o menu do utilizador. Edita-se no nó Navegação do minitab UI.

Notificações — Mensagens em tempo real para os utilizadores da app (sino no canto) e canais de envio (ex.: email) configurados nas definições da app.

#O

Observabilidade — O menu global com o estado de toda a instalação: eventos, erros, auditoria. Para o mesmo olhar dentro de UMA app, ver Radar.

#P

Pacote (.keplinapp) — O ficheiro de exportação de uma app, para a instalar noutro sítio: Definições ▸ Geral ▸ Levar esta app exporta; Nova app ▸ Importar pacote importa.

Parâmetro de rota — Um valor que entra pelo endereço de um ecrã (ex.: o id do cliente na ficha). Declara-se na secção Parâmetros de rota do ecrã e usa-se nas ligações de dados.

Permissões — A secção das definições da app onde se declaram as acções e os perfis dos utilizadores da app — quem pode fazer o quê dentro da app construída.

Publicação — A associação host → versão que decide que versão da app cada endereço serve. Ver Conceitos essenciais.

Python — A linguagem dos scripts da app. Cada script tem o seu ambiente com dependências geridas na árvore (pip).

#Q

Query — Uma operação GraphQL que lê dados. Nas APIs de tabela é a operação get…, com filtros e ordenação incluídos.

#R

Radar — O minitab da árvore da app que mostra o que ela está a fazer e onde falha: chamadas às APIs, execuções de scripts, sessões dos utilizadores e problemas — distinguindo erros do teu código dos erros da plataforma.

Relatório — Um documento PDF ou Excel desenhado na plataforma, com agrupamentos, gráficos e envio agendado. Vive no minitab Dados, secção Relatórios.

Role — O perfil de uma conta de quem constrói: admin ou developer. Muda-se no menu global Utilizadores e aplica-se no login seguinte.

Rota — O caminho de um ecrã dentro do endereço da app (ex.: /clientes). Ecrãs de sistema têm rotas fixas.

#S

Script — Lógica em Python que corre no servidor: à mão, por agendamento, ou como passo de uma API. Cada script tem ficheiros próprios, dependências e histórico de execuções.

Secrets — Valores sensíveis da app (tokens, passwords de serviços) guardados cifrados e disponíveis aos scripts e APIs sem aparecerem no código. Vivem no minitab Código, grupo App.

Separador — Uma tab da zona de trabalho: cada ecrã, API, script ou painel aberto é um separador. Arrastam-se para dividir o espaço; fechar um separador com alterações por gravar pede confirmação.

Sessão — O período entre entrar e sair. No Radar, uma sessão de um utilizador da app mostra o caminho que ele percorreu, passo a passo.

Slug — A forma curta do nome de uma app, derivada automaticamente (ex.: Gestão de Clientes → gestao-clientes). Entra nos endereços: /app/gestao-clientes, /api/graphql/gestao-clientes.

#T

Tema — As cores, tipos de letra e aparência da app construída, definidos por app na secção Tema das definições.

Traduções — Os idiomas da app construída e os textos dela em cada um, geridos na secção Traduções das definições da app.

Trigger — Um automatismo de base de dados que reage a inserções, alterações ou eliminações numa tabela, construído visualmente sobre uma fonte de dados.

TypeScript — A linguagem dos eventos de ecrã: o código que corre quando um botão é clicado ou um valor muda, escrito no editor de código do construtor de ecrãs.

#U

Utilizador da app — Uma conta de quem usa a aplicação construída. Gerida nas definições da app (Utilizadores da app); entra pelos ecrãs de sistema da app, nunca pela plataforma.

Utilizadores (plataforma) — O menu global onde os administradores gerem as contas de quem constrói: criar contas, mudar roles, repor passwords, desactivar acessos.

#V

Versão — Uma cópia completa do desenho e dos dados de uma app, com vida própria. Ver Conceitos essenciais.

Versão de trabalho — A versão em que TU estás a mexer, escolhida no menu Versões. É individual: trocar a tua não muda a de mais ninguém.

Visão geral — O separador que abre por defeito no workspace de uma app: nome, descrição, contagens (APIs, datasources, API keys) e o endpoint GraphQL.

#W

Widget — Uma peça de ecrã: tabela, campo, botão, gráfico, calendário, kanban, … A app traz mais de 30 widgets de Sistema e podes programar os teus, que ficam disponíveis na mesma palete.

Workflow — Um processo de negócio desenhado em passos: decisões, esperas, tarefas humanas. Vive no minitab UI, secção Workflows.

Workspace — A zona de trabalho de uma app: os separadores onde tudo se edita, ao lado da árvore. Também lhe chamamos «espaço de trabalho»; o layout dos separadores persiste por app.