Sanasto

Tämä sivu on Keplinin sanaston pikahakemisto. Jokaisesta termistä on määritelmä kahdella tai kolmella lauseella ja, jos sellainen on, se paikka alustalla, josta sen löydät. Lihavoidut nimet ovat täsmälleen ne nimet, jotka näet näytöllä.

#A

Ajastus — Skriptin automaattinen suoritus tiettyyn kellonaikaan tai tietyin välein. Se elää skriptin alla, Koodi-minivälilehden puussa; sen voi ottaa käyttöön ja poistaa käytöstä poistamatta sitä kokonaan.

API — Sovelluksen dataoperaatio, jonka sen GraphQL-endpoint tarjoilee. Se rakennetaan omassa editorissaan: joko taulu-API:na tai vaiheiden pipelinena (SQL, koodi, HTTP-kutsu, skripti).

API-avain — Pääsyavain, jolla ulkoiset asiakkaat kutsuvat GraphQL-API:ta. Sitä hallitaan yleisessä valikossa API-avaimet; jokaisella avaimella on scope — ne sovellukset ja endpointit, joihin se antaa pääsyn. Avain näytetään selkokielisenä vain sillä hetkellä, kun se luodaan.

Asset — Sovelluksen tiedosto (kuva, dokumentti, …), joka ladataan UI-minivälilehden osioon Assetit näytöillä käytettäväksi — esimerkiksi logo.

#C

Checkout (lukitus) — Elementin (näytön, API:n, skriptin) varaaminen itselle: Checkout — lukitse minulle elementin valikossa. Muut näkevät lukon ja tekstin {nimi} on ottanut checkoutin eivätkä kirjoita päälle; Checkin — vapauta palauttaa sen.

#D

Datasource — Katso Tietolähde.

Datastore — Yhden näytön datasäiliö: se sitoo API:n tietueen tai listan kyseisen näytön widgetteihin (lomakkeen tietueeseen, ruudukon listaan). Se määritetään näyttöeditorissa, kategoriassa Data.

Developer — Rajoitetun pääsyn rakentajan rooli: näkee vain ne sovellukset, jotka hänelle on määritetty — ja niissä hän tekee kaiken paitsi sen, mikä on vain ylläpitäjille (sovellusten luonti ja poisto, tilien ja avainten hallinta).

#E

Endpoint — Sovelluksen julkinen GraphQL-sisääntulo: /api/graphql/<slug>. Kaikki sovelluksen julkaistut API:t tarjoillaan sieltä; osoite näkyy välilehdellä Yleiskatsaus.

Enum — Suljettu lista arvoja nimikkeineen (esim. tila Aktiivinen/Ei aktiivinen). Mallin enumit syöttävät näyttöjen valintakenttiä, kanban-sarakkeita ja API:en argumentteja.

#G

GraphQL — Keplinin API:en kieli: asiakkaat tekevät queryjä (lukuja) ja mutationeita (kirjoituksia) sovelluksen endpointia vasten. API-editori tuottaa dokumentaation ja valmiit, kopioitavat esimerkit.

#H

Havainnointi — Yleinen valikko, jossa on koko asennuksen tila: tapahtumat, virheet, auditointi. Sama katse YHDEN sovelluksen sisälle on Radar.

Historia — Kirjaus version kaikista tallennuksista: kuka, milloin ja mitä. Se avautuu valikosta Versiot; sen kautta onnistuvat Palauta sovellus tähän tilaan ja Peru tämä muutos.

Host — Sovelluksen julkaistu osoite (esim. crm.yritys.fi). Kukin host tarjoilee täsmälleen yhtä versiota; hosteja hallitaan sovelluksen asetusten osiossa Julkaisu.

#I

Ilmoitukset — Reaaliaikaisia viestejä sovelluksen käyttäjille (kello kulmassa) ja lähetyskanavia (esim. sähköposti), jotka määritetään sovelluksen asetuksissa.

Istunto — Aika sisään- ja uloskirjautumisen välillä. Radarissa sovelluksen käyttäjän istunto näyttää hänen kulkemansa reitin, askel askeleelta.

#J

Julkaisu — Liitos host → versio, joka ratkaisee, minkä version sovelluksesta kukin osoite tarjoilee. Katso Keskeiset käsitteet.

Julkinen näyttö — Näyttö, joka tarjoillaan ilman kirjautumista. Se lataa dataa vain niistä API:sta, joilla on julkinen lukuoikeus.

Järjestelmänäyttö — Näyttö, joka on olemassa kaikissa sovelluksissa ja jonka reitti ja pääsy ovat kiinteitä: Login, Salasanan palautus ja Rekisteröityminen. Se elää näyttöpuun ryhmässä Järjestelmä; ulkoasua muokataan kuten minkä tahansa muun näytön.

#K

Käyttäjät (alusta) — Yleinen valikko, jossa ylläpitäjät hallitsevat rakentajien tilejä: luovat tilejä, vaihtavat rooleja, nollaavat salasanoja, poistavat käyttöoikeuksia.

Käyttöoikeudet — Sovelluksen asetusten osio, jossa määritellään sovelluksen käyttäjien toiminnot ja roolit — kuka saa tehdä mitäkin rakennetun sovelluksen sisällä.

Käännökset — Rakennetun sovelluksen kielet ja sen tekstit kullakin kielellä; niitä hallitaan sovelluksen asetusten osiossa Käännökset.

#L

Layout — Uudelleenkäytettävä näytön runko (esim. perusta ylätunnisteella): sitä käyttävät näytöt perivät rakenteen. Se elää näyttöpuussa ja luodaan painikkeella Uusi layout.

#M

main — Sovelluksen ensimmäinen versio, joka syntyy sen mukana. Sitä ei voi poistaa.

MCP-yhteydet — Tilisivu, jolla näet ja mitätöit ne ulkoiset sovellukset (avustajat, agentit), joille olet myöntänyt pääsyn tiliisi. Kukin niistä näkee ja tekee täsmälleen sen, mitä sinä näet ja teet.

Mutation — GraphQL-operaatio, joka kirjoittaa dataa. Taulu-API:t muodostavat operaatiot add, update ja delete; pipelinessa API merkitään valinnalla Mutation — kirjoittaa dataa.

#N

Navigointi — Rakennetun sovelluksen valikko (ylä- ja sivupalkki), jossa on kohteita, alavalikoita, välilehtiä ja käyttäjävalikko. Sitä muokataan UI-minivälilehden solmussa Navigointi.

Näyttö — Rakennetun sovelluksen sivu, joka suunnitellaan visuaalisessa editorissa. Sillä on reitti, se voi ottaa parametreja, ja se koostuu dataan sidotuista widgeteistä.

#P

Paketti (.keplinapp) — Sovelluksen vientitiedosto, jolla se asennetaan muualle: Asetukset ▸ Yleistä ▸ Ota tämä sovellus mukaan vie; Uusi sovellus ▸ Tuo paketti tuo.

Python — Sovelluksen skriptien kieli. Jokaisella skriptillä on oma ympäristönsä, jonka riippuvuuksia hallitaan puussa (pip).

#Q

Query — GraphQL-operaatio, joka lukee dataa. Taulu-API:ssa se on operaatio get…, suodattimineen ja järjestyksineen.

#R

Radar — Sovelluspuun minivälilehti, joka näyttää, mitä sovellus tekee ja missä se pettää: API-kutsut, skriptien suoritukset, käyttäjien istunnot ja ongelmat — erotellen oman koodisi virheet alustan virheistä.

Raportti — Alustalla suunniteltu PDF- tai Excel-dokumentti, jossa on ryhmittelyjä, kaavioita ja ajastettu lähetys. Se elää Data-minivälilehdessä, osiossa Raportit.

Reitti — Näytön polku sovelluksen osoitteen sisällä (esim. /clientes). Järjestelmänäytöillä on kiinteät reitit.

Reittiparametri — Arvo, joka tulee sisään näytön osoitteen kautta (esim. asiakkaan id tiedoissa). Se määritellään näytön osiossa Reitin parametrit ja sitä käytetään datasidonnoissa.

Rooli — Rakentajan tilin profiili: admin tai developer. Se vaihdetaan yleisessä valikossa Käyttäjät ja astuu voimaan seuraavalla kirjautumisella.

#S

Salaisuudet — Sovelluksen arkaluontoisia arvoja (tokenit, palveluiden salasanat), jotka säilytetään salattuina ja jotka ovat skriptien ja API:en käytettävissä ilman että ne näkyvät koodissa. Ne elävät Koodi-minivälilehdessä, ryhmässä Sovellus.

Skripti — Python-logiikkaa, joka ajetaan palvelimella: käsin, ajastuksella tai API:n vaiheena. Jokaisella skriptillä on omat tiedostonsa, riippuvuutensa ja suoritushistoriansa.

Slug — Sovelluksen nimen lyhyt muoto, joka johdetaan automaattisesti (esim. Asiakashallinta → gestao-clientes). Se tulee osoitteisiin: /app/gestao-clientes, /api/graphql/gestao-clientes.

Sovelluksen asetukset — Sovelluksen määrityspaneeli, joka avataan puun yläreunan rattaasta: Yleistä, Tunnistautuminen, Ilmoitukset, Tallennustila, Sovelluksen käyttäjät, Käyttöoikeudet, Teema, Käännökset ja Merkintöjen kierrätys.

Sovelluksen käyttäjä — Sen tili, joka käyttää rakennettua sovellusta. Sitä hallitaan sovelluksen asetuksissa (Sovelluksen käyttäjät); kirjautuminen tapahtuu sovelluksen järjestelmänäyttöjen kautta, ei koskaan alustan kautta.

Sovellus — Kaiken perusyksikkö Keplinissä: kokonainen ohjelmisto omine näyttöineen, tietoineen, API:neen, skripteineen, asetuksineen ja käyttäjineen. Katso tämän luvun sivu Keskeiset käsitteet.

Sovelluspuu — Sovelluksen työtilan sivupalkki, jossa on kaikki sen sisältö järjestettynä minivälilehtiin (UI, Koodi, Data, Radar). Sen kokoa muutetaan vetämällä oikeasta reunasta.

#T

Taulu-API — Tietomallin taulusta muodostettu API: valitset taulun, julkaistavat toiminnot (luku, lisäys, päivitys, poisto) ja mukaan tulevat kentät, ja operaatiot ovat valmiit.

Teema — Rakennetun sovelluksen värit, kirjasimet ja ulkoasu, jotka määritellään sovelluskohtaisesti asetusten osiossa Teema.

Tietolähde — Yhteys tietokantaan (sisäiseen tai ulkoiseen), jota sovelluksen API:t, skriptit ja malli käyttävät. Sitä hallitaan Data-minivälilehdessä, osiossa Tietolähteet; tunnistetiedot säilytetään salattuina.

Tietomalli — Kartta sovelluksen entiteeteistä: tietolähteistä tuodut taulut, kentät selkonimineen, suhteet ja enumit. Se on taulu-API:en ja näyttöjen datasidontojen perusta.

Toiminto (käyttöoikeudet) — Sovelluksen kohdassa Käyttöoikeudet määritelty kyky (esim. ”hyväksy-tilaus”). Widgetit voivat vaatia tiettyä toimintoa: se, jolla sitä ei ole, ei näe widgetiä tai näkee sen pois käytöstä kytkettynä.

Triggeri — Tietokanta-automaatio, joka reagoi taulun lisäyksiin, muutoksiin tai poistoihin ja joka rakennetaan visuaalisesti tietolähteen päälle.

Tunnistautuminen (sovelluksen) — Sovelluksen asetusten osio, joka ratkaisee, miten sen käyttäjät kirjautuvat: sovelluksessa hallitut käyttäjätunnukset ja salasanat, julkinen rekisteröityminen päällä tai pois, ja salasanan palautus.

TypeScript — Näyttötapahtumien kieli: koodi, joka ajetaan kun painiketta napsautetaan tai arvo muuttuu, kirjoitettuna näyttöjen rakentimen koodieditorissa.

Työnkulku — Liiketoimintaprosessi, joka suunnitellaan vaiheina: päätökset, odotukset, ihmisen tehtävät. Se elää UI-minivälilehdessä, osiossa Työnkulut.

Työtila — Katso Workspace.

Työversio — Se versio, jossa SINÄ työskentelet, valittuna valikosta Versiot. Se on henkilökohtainen: oman versiosi vaihtaminen ei muuta kenenkään muun versiota.

#V

Versio — Täydellinen kopio sovelluksen suunnitelmasta ja datasta, omaa elämäänsä elävänä. Katso Keskeiset käsitteet.

Välilehti — Työalueen välilehti: jokainen avattu näyttö, API, skripti tai paneeli on välilehti. Niitä voi vetää tilan jakamiseksi; välilehden sulkeminen, kun siinä on tallentamattomia muutoksia, pyytää vahvistusta.

#W

Widget — Näytön palanen: taulu, kenttä, painike, kaavio, kalenteri, kanban, … Sovellus tuo mukanaan yli 30 Järjestelmä-widgetiä, ja voit ohjelmoida omiasi, jotka tulevat samaan palettiin.

Workspace — Sovelluksen työalue: välilehdet, joissa kaikkea muokataan, puun vieressä. Kutsumme sitä myös ”työtilaksi”; välilehtien asettelu säilyy sovelluskohtaisesti.

#Y

Yleiskatsaus — Välilehti, joka avautuu oletuksena sovelluksen työtilassa: nimi, kuvaus, lukumäärät (API:t, tietolähteet, API-avaimet) ja GraphQL-endpoint.

Ylläpitäjä (admin) — Täyden pääsyn rakentajan rooli: kaikki sovellukset, lisäksi käyttäjien, API-avainten ja alustan asetusten hallinta sekä sovellusten luonti ja poisto.