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

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

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

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

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

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

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

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

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

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