Glossario

Questa pagina è il riferimento rapido del vocabolario di Keplin. Ogni termine ha la definizione in due o tre frasi e, quando esiste, il posto della piattaforma dove lo trovi. I nomi in grassetto sono i nomi esatti che vedi sullo schermo.

#A

Albero dell'app — La barra laterale dello spazio di lavoro di un'app, con tutto ciò che essa contiene organizzato in minitab (UI, Codice, Dati, Radar). Si ridimensiona trascinando il bordo destro.

Amministratore (admin) — Il profilo di chi costruisce con accesso totale: tutte le app, più la gestione degli utenti, delle chiavi API, delle impostazioni della piattaforma e la creazione ed eliminazione di app.

API — Un'operazione sui dati dell'app, servita dal suo endpoint GraphQL. Si costruisce in un editor proprio: o come API di tabella o come pipeline di passi (SQL, codice, chiamata HTTP, script).

API di tabella — Un'API generata a partire da una tabella del modello dei dati: scegli la tabella, le azioni esposte (leggere, inserire, aggiornare, eliminare) e i campi inclusi, e le operazioni sono pronte.

App — L'unità di tutto in Keplin: un'applicazione completa con schermate, dati, API, script, impostazioni e utenti propri. Vedi la pagina Concetti essenziali di questo capitolo.

Asset — Un file dell'app (immagine, documento, …) caricato nella sezione Assets del minitab UI, da usare nelle schermate — per esempio il logo.

Autenticazione (dell'app) — La sezione delle impostazioni dell'app che decide come entrano i suoi utenti: username e password gestiti nell'app, registrazione pubblica attiva o disattivata, e recupero della password.

Autorizzazioni — La sezione delle impostazioni dell'app dove si dichiarano le azioni e i profili degli utenti dell'app — chi può fare che cosa dentro l'applicazione costruita.

Azione (autorizzazioni) — Una capacità dichiarata nelle Autorizzazioni dell'app (es.: «approvare-ordine»). I widget possono richiedere un'azione: chi non ce l'ha non vede il widget, o lo vede disattivato.

#C

Checkout (blocco) — Riservare un elemento (una schermata, un'API, uno script) per te: Checkout — blocca per me nel menu dell'elemento. Gli altri vedono il lucchetto In checkout da… e non salvano sopra; Checkin — rilascia lo restituisce.

Chiave API — Una chiave di accesso perché i client esterni chiamino le API GraphQL. Gestita nel menu globale Chiavi API; ogni chiave ha uno scope — le app e gli endpoint a cui dà accesso. La chiave in chiaro viene mostrata solo nel momento in cui è generata.

Connessioni MCP — La pagina di account dove vedi e revochi le applicazioni esterne (assistenti, agenti) a cui hai autorizzato l'accesso al tuo account. Ognuna vede e fa esattamente ciò che vedi e fai tu.

Cronologia — Il registro di tutti i salvataggi di una versione: chi, quando e che cosa. Si apre nel menu Versioni; permette Ripristina l'app a questo stato e Annulla questa modifica.

#D

Datasource — Vedi Origine dati.

Datastore — Un contenitore di dati di una schermata: collega un record o un elenco di un'API ai widget di quella schermata (un modulo a un record, una griglia a un elenco). Si configura nell'editor di schermate, nella categoria Dati.

Developer — Il profilo di chi costruisce con accesso limitato: vede solo le app che gli sono state assegnate — e in quelle fa tutto, tranne ciò che è esclusivo degli amministratori (creare ed eliminare app, gestire account e chiavi).

#E

Endpoint — L'ingresso GraphQL pubblico di un'app: /api/graphql/<slug>. Tutte le API pubblicate dell'app sono servite lì; l'indirizzo appare nella scheda Panoramica.

Enum — Un elenco chiuso di valori con etichetta (es.: stato Attivo/Inattivo). Gli enum del modello alimentano i campi di scelta nelle schermate, le colonne kanban e gli argomenti delle API.

#G

GraphQL — Il linguaggio delle API di Keplin: i client fanno query (letture) e mutation (scritture) contro l'endpoint dell'app. L'editor di API genera la documentazione e gli esempi pronti da copiare.

#H

Host — Un indirizzo pubblicato di un'app (es.: crm.azienda.com). Ogni host serve esattamente una versione; si gestisce nella sezione Pubblicazione delle impostazioni dell'app.

#I

Impostazioni dell'app — Il pannello di configurazione di un'app, aperto dall'ingranaggio in cima all'albero: Generale, Autenticazione, Notifiche, Archiviazione, Utenti dell'app, Autorizzazioni, Tema, Traduzioni e Rotazione dei record.

#L

Layout — Uno scheletro riutilizzabile di schermata (es.: base con intestazione): le schermate che lo usano ereditano la struttura. Vive nell'albero delle schermate, creato con Nuovo layout.

#M

main — La prima versione di ogni app, creata insieme a lei. Non può essere eliminata.

Modello dei dati — La mappa delle entità dell'app: tabelle importate dalle origini dati, campi con nomi amichevoli, relazioni ed enum. È la base delle API di tabella e dei collegamenti ai dati nelle schermate.

Mutation — Un'operazione GraphQL che scrive dati. Le API di tabella generano add, update e delete; in una pipeline, l'API si contrassegna come Mutation — scrive dati.

#N

Navigazione — Il menu dell'app costruita (barra superiore e laterale), con voci, sottomenu, separatori e il menu dell'utente. Si modifica nel nodo Navigazione del minitab UI.

Notifiche — Messaggi in tempo reale per gli utenti dell'app (campanella nell'angolo) e canali di invio (es.: email) configurati nelle impostazioni dell'app.

#O

Origine dati — Una connessione a un database (interno o esterno) usata dalle API, dagli script e dal modello dell'app. Si gestisce nel minitab Dati, sezione Origini dati; le credenziali restano cifrate.

Osservabilità — Il menu globale con lo stato di tutta l'installazione: eventi, errori, audit. Per lo stesso sguardo dentro UNA app, vedi Radar.

#P

Pacchetto (.keplinapp) — Il file di esportazione di un'app, per installarla altrove: Impostazioni ▸ Generale ▸ Porta questa app esporta; Nuova app ▸ Importa pacchetto importa.

Panoramica — La scheda che si apre per impostazione predefinita nel workspace di un'app: nome, descrizione, conteggi (API, datasource, chiavi API) e l'endpoint GraphQL.

Parametro di percorso — Un valore che entra dall'indirizzo di una schermata (es.: l'id del cliente nella scheda). Si dichiara nella sezione Parametri del percorso della schermata e si usa nei collegamenti ai dati.

Percorso — Il cammino di una schermata dentro l'indirizzo dell'app (es.: /clientes). Le schermate di sistema hanno percorsi fissi.

Pianificazione — L'esecuzione automatica di uno script a un orario o a intervalli. Vive sotto lo script, nell'albero del minitab Codice; può essere attivata e disattivata senza eliminarla.

Pubblicazione — L'associazione host → versione che decide quale versione dell'app serve ogni indirizzo. Vedi Concetti essenziali.

Python — Il linguaggio degli script dell'app. Ogni script ha il proprio ambiente con le dipendenze gestite nell'albero (pip).

#Q

Query — Un'operazione GraphQL che legge dati. Nelle API di tabella è l'operazione get…, con filtri e ordinamento inclusi.

#R

Radar — Il minitab dell'albero dell'app che mostra che cosa sta facendo e dove fallisce: chiamate alle API, esecuzioni di script, sessioni degli utenti e problemi — distinguendo gli errori del tuo codice da quelli della piattaforma.

Report — Un documento PDF o Excel disegnato nella piattaforma, con raggruppamenti, grafici e invio pianificato. Vive nel minitab Dati, sezione Report.

Ruolo — Il profilo di un account di chi costruisce: admin o developer. Si cambia nel menu globale Utenti e si applica all'accesso successivo.

#S

Scheda — Una tab della zona di lavoro: ogni schermata, API, script o pannello aperto è una scheda. Si trascinano per dividere lo spazio; chiudere una scheda con modifiche da salvare chiede conferma.

Schermata — Una pagina dell'app costruita, disegnata nell'editor visuale. Ha un percorso, può avere parametri, ed è composta da widget collegati ai dati.

Schermata di sistema — Una schermata che esiste in tutte le app, con percorso e accesso fissi: Login, Recupero password e Registrazione. Vive nel gruppo Sistema dell'albero delle schermate; l'aspetto si modifica come quello di qualsiasi altra schermata.

Schermata pubblica — Una schermata servita senza sessione avviata. Carica dati solo da API con lettura pubblica.

Script — Logica in Python che gira sul server: a mano, per pianificazione, o come passo di un'API. Ogni script ha file propri, dipendenze e cronologia delle esecuzioni.

Secrets — Valori sensibili dell'app (token, password di servizi) conservati cifrati e disponibili agli script e alle API senza apparire nel codice. Vivono nel minitab Codice, gruppo App.

Sessione — Il periodo fra l'entrata e l'uscita. Nel Radar, la sessione di un utente dell'app mostra il cammino che ha percorso, passo per passo.

Slug — La forma breve del nome di un'app, derivata automaticamente (es.: Gestione Clienti → gestao-clientes). Entra negli indirizzi: /app/gestao-clientes, /api/graphql/gestao-clientes.

Spazio di lavoro — Vedi Workspace.

#T

Tema — I colori, i caratteri e l'aspetto dell'app costruita, definiti per app nella sezione Tema delle impostazioni.

Traduzioni — Le lingue dell'app costruita e i suoi testi in ciascuna, gestiti nella sezione Traduzioni delle impostazioni dell'app.

Trigger — Un automatismo di database che reagisce a inserimenti, modifiche o eliminazioni in una tabella, costruito visualmente su un'origine dati.

TypeScript — Il linguaggio degli eventi di schermata: il codice che gira quando un pulsante viene cliccato o un valore cambia, scritto nell'editor di codice del costruttore di schermate.

#U

Utente dell'app — Un account di chi usa l'applicazione costruita. Gestito nelle impostazioni dell'app (Utenti dell'app); entra dalle schermate di sistema dell'app, mai dalla piattaforma.

Utenti (piattaforma) — Il menu globale dove gli amministratori gestiscono gli account di chi costruisce: creare account, cambiare ruoli, reimpostare password, disattivare accessi.

#V

Versione — Una copia completa del progetto e dei dati di un'app, con vita propria. Vedi Concetti essenziali.

Versione di lavoro — La versione su cui stai mettendo le mani TU, scelta nel menu Versioni. È individuale: cambiare la tua non cambia quella di nessun altro.

#W

Widget — Un pezzo di schermata: tabella, campo, pulsante, grafico, calendario, kanban, … L'app porta con sé più di 30 widget di Sistema e puoi programmare i tuoi, che restano disponibili nella stessa palette.

Workflow — Un processo di business disegnato in passi: decisioni, attese, attività umane. Vive nel minitab UI, sezione Workflows.

Workspace — La zona di lavoro di un'app: le schede dove si modifica tutto, accanto all'albero. La chiamiamo anche «spazio di lavoro»; il layout delle schede persiste per app.