Glossaire

Cette page est la référence rapide du vocabulaire de Keplin. Chaque terme a sa définition en deux ou trois phrases et, quand il y en a un, l'endroit de la plateforme où vous le trouvez. Les noms en gras sont les noms exacts que vous voyez à l'écran.

#A

Action (permissions) — Une capacité déclarée dans les Permissions de l'app (ex. : « approuver-commande »). Les widgets peuvent exiger une action : qui ne l'a pas ne voit pas le widget, ou le voit désactivé.

Administrateur (admin) — Le profil de celui qui construit avec un accès total : toutes les apps, plus la gestion des utilisateurs, des clés API, des paramètres de la plateforme, et la création et la suppression d'apps.

API — Une opération de données de l'app, servie par son endpoint GraphQL. Elle se construit dans un éditeur dédié : soit comme API de table, soit comme un pipeline d'étapes (SQL, code, appel HTTP, script).

API de table — Une API générée à partir d'une table du modèle de données : vous choisissez la table, les Actions exposées (lire, insérer, actualiser, supprimer) et les Champs inclus, et les opérations sont prêtes.

API Key — Une clé d'accès pour que des clients externes appellent les APIs GraphQL. Gérée dans le menu global Clés API ; chaque clé a un scope — les apps et endpoints auxquels elle donne accès. La clé en texte clair n'est affichée qu'au moment où elle est générée.

App — L'unité de tout dans Keplin : une application complète avec ses propres écrans, données, APIs, scripts, paramètres et utilisateurs. Voir la page Concepts essentiels de ce chapitre.

Arborescence de l'app — La barre latérale de l'espace de travail d'une app, avec tout ce qu'elle contient organisé en minitabs (UI, Code, Données, Radar). Elle se redimensionne en tirant son bord droit.

Asset — Un fichier de l'app (image, document, …) téléversé dans la section Assets du minitab UI, pour l'utiliser dans les écrans — par exemple le logo.

Authentification (de l'app) — La section des paramètres de l'app qui décide comment ses utilisateurs entrent : nom d'utilisateur et mot de passe gérés dans l'app, inscription publique activée ou désactivée, et récupération de mot de passe.

#C

Checkout (verrouillage) — Réserver un élément (un écran, une API, un script) pour vous : Checkout — verrouiller pour moi dans le menu de l'élément. Les autres voient le cadenas En checkout par… et n'enregistrent pas par-dessus ; Checkin — libérer le rend.

Connexions MCP — La page de compte où vous voyez et révoquez les applications externes (assistants, agents) auxquelles vous avez autorisé l'accès à votre compte. Chacune voit et fait exactement ce que vous voyez et faites.

#D

Datasource — Une connexion à une base de données (interne ou externe) utilisée par les APIs, les scripts et le modèle de l'app. Se gère dans le minitab Données, section Datasources ; les identifiants restent chiffrés.

Datastore — Un conteneur de données d'un écran : il relie un enregistrement ou une liste venue d'une API aux widgets de cet écran (un formulaire à un enregistrement, une grille à une liste). Se configure dans l'éditeur d'écrans, dans la catégorie Données.

Developer — Le profil de celui qui construit avec un accès restreint : il ne voit que les apps qui lui ont été attribuées — et il y fait tout, sauf ce qui est réservé aux administrateurs (créer et supprimer des apps, gérer les comptes et les clés).

#E

Écran — Une page de l'app construite, dessinée dans l'éditeur visuel. Il a une route, il peut avoir des paramètres, et il est composé de widgets reliés à des données.

Écran public — Un écran servi sans session ouverte. Il ne charge que les données d'APIs à lecture publique.

Écran système — Un écran qui existe dans toutes les apps, avec une route et un accès fixes : Login, Récupérer le mot de passe et Inscription. Il vit dans le groupe Système de l'arborescence des écrans ; son apparence se modifie comme celle de n'importe quel autre écran.

Endpoint — L'entrée GraphQL publique d'une app : /api/graphql/<slug>. Toutes les APIs publiées de l'app y sont servies ; l'adresse apparaît dans l'onglet Vue d'ensemble.

Enum — Une liste fermée de valeurs avec libellé (ex. : état Actif/Inactif). Les enums du modèle alimentent les champs de choix dans les écrans, les colonnes kanban et les arguments d'APIs.

Espace de travail — Voir Workspace.

#F

Fichier de package (.keplinapp) — Le fichier d'exportation d'une app, pour l'installer ailleurs : Paramètres ▸ Général ▸ Emporter cette app exporte ; Nouvelle app ▸ Importer un package importe.

#G

GraphQL — Le langage des APIs de Keplin : les clients font des queries (lectures) et des mutations (écritures) contre l'endpoint de l'app. L'éditeur d'APIs génère la documentation et des exemples prêts à copier.

#H

Historique — Le journal de tous les enregistrements d'une version : qui, quand et quoi. S'ouvre dans le menu Versions ; il permet Restaurer l'app dans cet état et Revenir sur cette modification.

Hôte — Une adresse publiée d'une app (ex. : crm.entreprise.com). Chaque hôte sert exactement une version ; se gère dans la section Publication des paramètres de l'app.

#L

Layout — Un squelette d'écran réutilisable (ex. : base avec en-tête) : les écrans qui l'utilisent héritent de la structure. Il vit dans l'arborescence des écrans, créé avec Nouveau layout.

#M

main — La toute première version de chaque app, créée avec elle. Elle ne peut pas être supprimée.

Modèle de données — La carte des entités de l'app : tables importées des datasources, champs avec des noms conviviaux, relations et enums. C'est la base des APIs de table et des liaisons de données dans les écrans.

Mutation — Une opération GraphQL qui écrit des données. Les APIs de table génèrent add, update et delete ; dans un pipeline, on marque l'API comme Mutation — écrit des données.

#N

Navigation — Le menu de l'app construite (barre supérieure et latérale), avec ses entrées, sous-menus, séparateurs et le menu de l'utilisateur. S'édite dans le nœud Navigation du minitab UI.

Notifications — Des messages en temps réel pour les utilisateurs de l'app (cloche dans le coin) et des canaux d'envoi (ex. : e-mail) configurés dans les paramètres de l'app.

#O

Observabilité — Le menu global avec l'état de toute l'installation : événements, erreurs, audit. Pour le même regard à l'intérieur d'UNE app, voir Radar.

Onglet — Une tab de la zone de travail : chaque écran, API, script ou panneau ouvert est un onglet. Ils se glissent pour partager l'espace ; fermer un onglet avec des Modifications non enregistrées demande confirmation.

#P

Paramètre de route — Une valeur qui entre par l'adresse d'un écran (ex. : l'id du client dans la fiche). Se déclare dans la section Paramètres de route de l'écran et s'utilise dans les liaisons de données.

Paramètres de l'app — Le panneau de configuration d'une app, ouvert par l'engrenage en haut de l'arborescence : Général, Authentification, Notifications, Stockage, Utilisateurs de l'app, Permissions, Thème, Traductions et Rotation des enregistrements.

Permissions — La section des paramètres de l'app où l'on déclare les actions et les profils des utilisateurs de l'app — qui peut faire quoi à l'intérieur de l'app construite.

Planification — L'exécution automatique d'un script à une heure ou à un intervalle. Elle vit sous le script, dans l'arborescence du minitab Code ; elle peut être activée et désactivée sans être supprimée.

Publication — L'association hôte → version qui décide quelle version de l'app chaque adresse sert. Voir Concepts essentiels.

Python — Le langage des scripts de l'app. Chaque script a son environnement, avec des dépendances gérées dans l'arborescence (pip).

#Q

Query — Une opération GraphQL qui lit des données. Dans les APIs de table, c'est l'opération get…, filtres et tri inclus.

#R

Radar — Le minitab de l'arborescence de l'app qui montre ce qu'elle est en train de faire et où elle échoue : appels aux APIs, exécutions de scripts, sessions des utilisateurs et problèmes — en distinguant les erreurs de votre code de celles de la plateforme.

Rapport — Un document PDF ou Excel dessiné dans la plateforme, avec regroupements, graphiques et envoi planifié. Il vit dans le minitab Données, section Rapports.

Rôle — Le profil d'un compte de celui qui construit : admin ou developer. Se change dans le menu global Utilisateurs et s'applique à la connexion suivante.

Route — Le chemin d'un écran à l'intérieur de l'adresse de l'app (ex. : /clientes). Les écrans système ont des routes fixes.

#S

Script — De la logique en Python qui tourne sur le serveur : à la main, par planification, ou comme étape d'une API. Chaque script a ses propres fichiers, dépendances et historique d'exécutions.

Secrets — Des valeurs sensibles de l'app (tokens, mots de passe de services) conservées chiffrées et disponibles aux scripts et aux APIs sans apparaître dans le code. Ils vivent dans le minitab Code, groupe App.

Session — La période entre l'entrée et la sortie. Dans le Radar, la session d'un utilisateur de l'app montre le chemin qu'il a parcouru, pas à pas.

Slug — La forme courte du nom d'une app, dérivée automatiquement (ex. : Gestion de Clients → gestao-clientes). Il entre dans les adresses : /app/gestao-clientes, /api/graphql/gestao-clientes.

#T

Thème — Les couleurs, les polices et l'apparence de l'app construite, définis par app dans la section Thème des paramètres.

Traductions — Les langues de l'app construite et ses textes dans chacune d'elles, gérés dans la section Traductions des paramètres de l'app.

Trigger — Un automatisme de base de données qui réagit aux insertions, modifications ou suppressions dans une table, construit visuellement sur un datasource.

TypeScript — Le langage des événements d'écran : le code qui tourne quand un bouton est cliqué ou qu'une valeur change, écrit dans l'éditeur de code du constructeur d'écrans.

#U

Utilisateur de l'app — Un compte de celui qui utilise l'application construite. Géré dans les paramètres de l'app (Utilisateurs de l'app) ; il entre par les écrans système de l'app, jamais par la plateforme.

Utilisateurs (plateforme) — Le menu global où les administrateurs gèrent les comptes de ceux qui construisent : créer des comptes, changer les rôles, réinitialiser les mots de passe, désactiver des accès.

#V

Version — Une copie complète du design et des données d'une app, avec sa vie propre. Voir Concepts essentiels.

Version de travail — La version sur laquelle VOUS travaillez, choisie dans le menu Versions. Elle est individuelle : changer la vôtre ne change celle de personne d'autre.

Vue d'ensemble — L'onglet qui s'ouvre par défaut dans le workspace d'une app : nom, description, comptages (APIs, datasources, clés API) et l'endpoint GraphQL.

#W

Widget — Une pièce d'écran : table, champ, bouton, graphique, calendrier, kanban, … L'app apporte plus de 30 widgets Système et vous pouvez programmer les vôtres, qui deviennent disponibles dans la même palette.

Workflow — Un processus métier dessiné en étapes : décisions, attentes, tâches humaines. Il vit dans le minitab UI, section Workflows.

Workspace — La zone de travail d'une app : les onglets où tout s'édite, à côté de l'arborescence. Nous l'appelons aussi « espace de travail » ; la disposition des onglets persiste par app.