Přejít na hlavní obsah
Konfigurační vrstva aplikace Twenty popisuje aplikaci platformě – její identitu, oprávnění, která má, a kód, který se spouští během instalace nebo aktualizace. Tato deklarativní nastavení nepřidávají nové datové struktury ani chování za běhu; říkají Twenty, co je aplikace zač a jak ji nastavit.

​
V této části

Konfigurace aplikace

defineApplication – identita, výchozí role, proměnné, metadata pro marketplace.

Role a oprávnění

defineRole – deklaruje, co mohou logické funkce vaší aplikace číst a zapisovat.

Instalační hooky

definePreInstallLogicFunction a definePostInstallLogicFunction – zálohují data, nastavují výchozí hodnoty, validují aktualizace.

​
Jak spolu části souvisejí

  • Aplikace je vstupní bod. Každá aplikace má právě jedno volání defineApplication(), které ukazuje na jednu roli jako výchozí.
  • Role určuje, co mohou logické funkce aplikace a front-endové komponenty číst a zapisovat. Dodržujte zásadu nejmenších oprávnění: udělujte pouze ta oprávnění, která váš kód skutečně potřebuje.
  • Instalační hooky se spouštějí během instalace nebo aktualizace – pre-install před migrací metadat (aby mohly odmítnout rizikovou aktualizaci), post-install po migraci (aby mohly proti novému schématu naplnit výchozí data).
Instalační hooky sdílejí běhové prostředí logických funkcí – stejný podpis handleru, stejné proměnné prostředí, stejný typovaný klient API – ale deklarují se pomocí vlastních funkcí define a fungují mimo běžný model spouštěčů (HTTP, cron, databázové události).