Skip to main content
Конфигурационный слой приложения Twenty описывает приложение для платформы — его идентичность, разрешения, которыми оно обладает, и код, который выполняется при установке или обновлении. Эти декларации не добавляют новых структур данных или поведения во время выполнения; они сообщают Twenty, что это за приложение и как его настроить.

​
В этом разделе

Конфигурация приложения

defineApplication — идентичность, роль по умолчанию, переменные, метаданные маркетплейса.

Роли и разрешения

defineRole — определите, что логические функции вашего приложения могут читать и записывать.

Установочные хуки

definePreInstallLogicFunction и definePostInstallLogicFunction — создавайте резервные копии данных, заполняйте значения по умолчанию, проверяйте обновления.

​
Связь между частями

  • Приложение — это точка входа. У каждого приложения есть ровно один вызов defineApplication(), и он указывает на одну роль по умолчанию.
  • Роль управляет тем, что логические функции и фронтенд‑компоненты приложения могут читать и записывать. Следуйте принципу наименьших привилегий: выдавайте только те разрешения, которые вашему коду действительно нужны.
  • Установочные хуки запускаются при установке или обновлении — предустановочный до миграции метаданных (чтобы можно было отклонить рискованное обновление), постустановочный после миграции (чтобы можно было заполнить данные по умолчанию в соответствии с новой схемой).
Установочные хуки используют то же окружение выполнения, что и логическая функция — тот же формат обработчика, те же переменные окружения, тот же типизированный клиент API, — но объявляются через собственные функции define и находятся вне обычной модели триггеров (HTTP, cron, события базы данных).