Glosario

Esta página es la referencia rápida del vocabulario de Keplin. Cada término tiene la definición en dos o tres frases y, cuando existe, el sitio de la plataforma donde lo encuentras. Los nombres en negrita son los nombres exactos que ves en pantalla.

#A

Acción (permisos) — Una capacidad declarada en los Permisos de la app (ej.: «aprobar-pedido»). Los widgets pueden exigir una acción: quien no la tenga no ve el widget, o lo ve desactivado.

Administrador (admin) — El perfil de quien construye con acceso total: todas las apps, más la gestión de usuarios, claves API, ajustes de la plataforma y la creación y eliminación de apps.

Ajustes de la app — El panel de configuración de una app, abierto por el engranaje en la parte superior del árbol: General, Autenticación, Notificaciones, Almacenamiento, Usuarios de la app, Permisos, Tema, Traducciones y Rotación de registros.

API — Una operación de datos de la app, servida por su endpoint GraphQL. Se construye en un editor propio: o como API de tabla o como un pipeline de pasos (SQL, código, llamada HTTP, script).

API de tabla — Una API generada a partir de una tabla del modelo de datos: eliges la tabla, las acciones expuestas (leer, insertar, actualizar, eliminar) y los campos incluidos, y las operaciones quedan listas.

App — La unidad de todo en Keplin: una aplicación completa con pantallas, datos, APIs, scripts, ajustes y usuarios propios. Ver la página Conceptos esenciales de este capítulo.

Árbol de la app — La barra lateral del espacio de trabajo de una app, con todo lo que contiene organizado en minitabs (UI, Código, Datos, Radar). Se redimensiona arrastrando el borde derecho.

Asset — Un archivo de la app (imagen, documento, …) subido en la sección Assets del minitab UI, para usar en las pantallas — por ejemplo el logotipo.

Autenticación (de la app) — La sección de los ajustes de la app que decide cómo entran sus usuarios: username y contraseña gestionados en la app, registro público activado o desactivado, y recuperación de contraseña.

#C

Checkout (bloqueo) — Reservar un elemento (una pantalla, una API, un script) para ti: Checkout — bloquear para mí en el menú del elemento. Los demás ven el candado En checkout por… y no guardan encima; Checkin — liberar lo devuelve.

Clave API — Una clave de acceso para que clientes externos llamen a las APIs GraphQL. Gestionada en el menú global Claves API; cada clave tiene un scope — las apps y endpoints a los que da acceso. La clave en texto claro solo se muestra en el momento en que se genera.

Conexiones MCP — La página de cuenta donde ves y revocas las aplicaciones externas (asistentes, agentes) a las que autorizaste acceso a tu cuenta. Cada una ve y hace exactamente lo que tú ves y haces.

#D

Datasource — Ver Fuente de datos.

Datastore — Un contenedor de datos de una pantalla: conecta un registro o una lista de una API a los widgets de esa pantalla (un formulario a un registro, una tabla a una lista). Se configura en el editor de pantallas, en la categoría Datos.

Developer — El perfil de quien construye con acceso restringido: solo ve las apps que le han sido asignadas — y en ellas lo hace todo, excepto lo exclusivo de administradores (crear y eliminar apps, gestionar cuentas y claves).

#E

Endpoint — La entrada GraphQL pública de una app: /api/graphql/<slug>. Todas las APIs publicadas de la app se sirven ahí; la dirección aparece en la pestaña Vista general.

Enum — Una lista cerrada de valores con etiqueta (ej.: estado Activo/Inactivo). Los enums del modelo alimentan campos de elección en las pantallas, columnas kanban y argumentos de APIs.

Espacio de trabajo — Ver Workspace.

#F

Fuente de datos — Una conexión a una base de datos (interna o externa) usada por las APIs, los scripts y el modelo de la app. Se gestiona en el minitab Datos, sección Fuentes de datos; las credenciales quedan cifradas.

#G

GraphQL — El lenguaje de las APIs de Keplin: los clientes hacen queries (lecturas) y mutations (escrituras) contra el endpoint de la app. El editor de APIs genera la documentación y ejemplos listos para copiar.

#H

Historial — El registro de todas las grabaciones de una versión: quién, cuándo y qué. Se abre en el menú Versiones; permite Restaurar la app a este estado y Revertir este cambio.

Host — Una dirección publicada de una app (ej.: crm.empresa.com). Cada host sirve exactamente una versión; se gestiona en la sección Publicación de los ajustes de la app.

#I

Informe — Un documento PDF o Excel diseñado en la plataforma, con agrupaciones, gráficos y envío programado. Vive en el minitab Datos, sección Informes.

#L

Layout — Un esqueleto reutilizable de pantalla (ej.: base con cabecera): las pantallas que lo usan heredan la estructura. Vive en el árbol de pantallas, creado con Nuevo layout.

#M

main — La primera versión de toda app, creada con ella. No puede eliminarse.

Modelo de datos — El mapa de las entidades de la app: tablas importadas de las fuentes de datos, campos con nombres amigables, relaciones y enums. Es la base de las APIs de tabla y de las conexiones de datos en las pantallas.

Mutation — Una operación GraphQL que escribe datos. Las APIs de tabla generan add, update y delete; en un pipeline, la API se marca como Mutation — escribe datos.

#N

Navegación — El menú de la app construida (barra superior y lateral), con elementos, submenús, separadores y el menú del usuario. Se edita en el nodo Navegación del minitab UI.

Notificaciones — Mensajes en tiempo real para los usuarios de la app (campana en la esquina) y canales de envío (ej.: correo) configurados en los ajustes de la app.

#O

Observabilidad — El menú global con el estado de toda la instalación: eventos, errores, auditoría. Para la misma mirada dentro de UNA app, ver Radar.

#P

Paquete (.keplinapp) — El archivo de exportación de una app, para instalarla en otro sitio: Ajustes ▸ General ▸ Llevar esta app exporta; Nueva app ▸ Importar paquete importa.

Pantalla — Una página de la app construida, diseñada en el editor visual. Tiene una ruta, puede tener parámetros, y se compone de widgets conectados a datos.

Pantalla de sistema — Una pantalla que existe en todas las apps, con ruta y acceso fijos: Login, Recuperar contraseña y Registro. Vive en el grupo Sistema del árbol de pantallas; el aspecto se edita como el de cualquier otra pantalla.

Pantalla pública — Una pantalla servida sin sesión iniciada. Solo carga datos de APIs con lectura pública.

Parámetro de ruta — Un valor que entra por la dirección de una pantalla (ej.: el id del cliente en la ficha). Se declara en la sección Parámetros de ruta de la pantalla y se usa en las conexiones de datos.

Permisos — La sección de los ajustes de la app donde se declaran las acciones y los perfiles de los usuarios de la app — quién puede hacer qué dentro de la app construida.

Pestaña — Una tab de la zona de trabajo: cada pantalla, API, script o panel abierto es una pestaña. Se arrastran para dividir el espacio; cerrar una pestaña con cambios sin guardar pide confirmación.

Publicación — La asociación host → versión que decide qué versión de la app sirve cada dirección. Ver Conceptos esenciales.

Python — El lenguaje de los scripts de la app. Cada script tiene su entorno con dependencias gestionadas en el árbol (pip).

#Q

Query — Una operación GraphQL que lee datos. En las APIs de tabla es la operación get…, con filtros y ordenación incluidos.

#R

Radar — El minitab del árbol de la app que muestra qué está haciendo y dónde falla: llamadas a las APIs, ejecuciones de scripts, sesiones de los usuarios y problemas — distinguiendo los errores de tu código de los errores de la plataforma.

Role — El perfil de una cuenta de quien construye: admin o developer. Se cambia en el menú global Usuarios y se aplica en el siguiente login.

Ruta — El camino de una pantalla dentro de la dirección de la app (ej.: /clientes). Las pantallas de sistema tienen rutas fijas.

#S

Script — Lógica en Python que corre en el servidor: a mano, por programación, o como paso de una API. Cada script tiene archivos propios, dependencias e historial de ejecuciones.

Secrets — Valores sensibles de la app (tokens, contraseñas de servicios) guardados cifrados y disponibles para los scripts y APIs sin aparecer en el código. Viven en el minitab Código, grupo App.

Sesión — El período entre entrar y salir. En el Radar, una sesión de un usuario de la app muestra el camino que recorrió, paso a paso.

Slug — La forma corta del nombre de una app, derivada automáticamente (ej.: Gestão de Clientes → gestao-clientes). Entra en las direcciones: /app/gestao-clientes, /api/graphql/gestao-clientes.

#T

Tema — Los colores, tipografías y apariencia de la app construida, definidos por app en la sección Tema de los ajustes.

Traducciones — Los idiomas de la app construida y sus textos en cada uno, gestionados en la sección Traducciones de los ajustes de la app.

Trigger — Un automatismo de base de datos que reacciona a inserciones, cambios o eliminaciones en una tabla, construido visualmente sobre una fuente de datos.

TypeScript — El lenguaje de los eventos de pantalla: el código que corre cuando se hace clic en un botón o cambia un valor, escrito en el editor de código del constructor de pantallas.

#U

Usuario de la app — Una cuenta de quien usa la aplicación construida. Gestionada en los ajustes de la app (Usuarios de la app); entra por las pantallas de sistema de la app, nunca por la plataforma.

Usuarios (plataforma) — El menú global donde los administradores gestionan las cuentas de quien construye: crear cuentas, cambiar roles, restablecer contraseñas, desactivar accesos.

#V

Versión — Una copia completa del diseño y de los datos de una app, con vida propia. Ver Conceptos esenciales.

Versión de trabajo — La versión en la que TÚ estás trabajando, elegida en el menú Versiones. Es individual: cambiar la tuya no cambia la de nadie más.

Vista general — La pestaña que se abre por defecto en el workspace de una app: nombre, descripción, recuentos (APIs, datasources, claves API) y el endpoint GraphQL.

#W

Widget — Una pieza de pantalla: tabla, campo, botón, gráfico, calendario, kanban, … La app trae más de 30 widgets de Sistema y puedes programar los tuyos, que quedan disponibles en la misma paleta.

Workflow — Un proceso de negocio diseñado en pasos: decisiones, esperas, tareas humanas. Vive en el minitab UI, sección Workflows.

Workspace — La zona de trabajo de una app: las pestañas donde todo se edita, junto al árbol. También lo llamamos «espacio de trabajo»; la disposición de las pestañas persiste por app.