Понятия

Как работают приложения

Приложение — это набор сущностей, объявленных с помощью функций defineEntity() из пакета twenty-sdk. CLI обнаруживает эти объявления по AST анализу во время сборки и дает проявление — полное описание того, что добавляет ваше приложение в рабочую область. Эти функции проверяют вашу конфигурацию на этапе сборки и обеспечивают автодополнение в IDE и безопасность типов.

your-app/
├── src/
│   ├── application-config.ts    ← defineApplication (required, one per app)
│   ├── roles/                   ← defineRole
│   ├── objects/                 ← defineObject
│   ├── fields/                  ← defineField
│   ├── logic-functions/         ← defineLogicFunction
│   ├── front-components/        ← defineFrontComponent
│   ├── skills/                  ← defineSkill
│   ├── agents/                  ← defineAgent
│   ├── mcp-servers/             ← defineMcpServer
│   ├── views/                   ← defineView
│   ├── navigation-menu-items/   ← defineNavigationMenuItem
│   ├── settings-menu-items/     ← defineSettingsMenuItem
│   └── page-layouts/            ← definePageLayout
├── public/                      ← Static assets (images, icons)
└── package.json

Выбрана файловая организация. Определение сущности — на основе AST, SDK находит export default defineEntity(. .) вызовы, независимо от того, где находится файл . Структура папок выше — это соглашение, а не требование.

Типы сущностей

Сущность	Назначение	Документация
Приложение	Идентификация приложения, роль по умолчанию, переменные	Конфигурация приложения
Роль	Наборы прав для объектов и полей	Роли и разрешения
Object	Пользовательские типы записей с полями	Объекты
Поле	Добавляйте поля к объектам из других приложений	Расширение объектов
Связь	Двунаправленные связи между объектами	Связи
Логическая функция	Серверный TypeScript с триггерами	Логические функции
Навык	Повторно используемые инструкции для ИИ-агента	Навыки и агенты
Агент	ИИ-агенты с пользовательскими промптами	Навыки и агенты
Рабочий процесс	Готовые рабочие процессы с триггером и шагами	Рабочие процессы
Провайдер подключения	OAuth или пользовательский вход для сторонних учетных записей	Подключения
Поставщик сообщений	Отправляет ответы из каналов сообщений приложения через подключение	Каналы сообщений
Сервер MCP	Внешний сервер MCP, который может вызывать ИИ рабочего пространства	Навыки и агенты
Представление	Преднастроенные представления списков записей	Представления
Пункт меню навигации	Пользовательские элементы боковой панели	Элементы меню навигации
Макет страницы	Вкладки и виджеты на странице сведений о записи	Макеты страниц
Компонент фронтенда	Изолированный в песочнице интерфейс React внутри Twenty	Компоненты фронтенда
Общие зависимости	Зависимости, общие для фронтенд-компонентов приложения, указанные в package.json	Общие зависимости
Элемент меню команд	Быстрые действия и элементы Cmd+K	Элементы меню команд
Пункт меню настроек	Записи в меню настроек приложения, каждое отображение фронтального компонента	Настройки пунктов меню

Изоляция в песочнице

Логические функции выполняются в изолированных процессах Node.js на сервере. Они имеют доступ к данным только через напечатанный API-клиент, который действует либо как человек, который инициировал запуск, либо как само приложение. Смотрите Чей доступ к звонкам.
Компоненты фронтенда запускаются в Web Workers с использованием Remote DOM — изолированы от основной страницы, но при этом рендерят нативные элементы DOM (не iframes). Они взаимодействуют с Twenty через хостовый API обмена сообщениями.
Права доступа применяются на уровне API. Два токена во время выполнения вводятся в действие - оба из этих токенов, полученных от роли, заявленной с помощью defineApplicationRole(); по умолчанию один сужен дальше к тому, что запускающий человек может делать, когда кто-то находится за бегом.

Жизненный цикл приложения

┌─────────────────────────────────────────────────────────┐
│ Development                                             │
│   twenty app init → twenty app dev (live sync)   │
├─────────────────────────────────────────────────────────┤
│ Build & Deploy                                          │
│   twenty app build → twenty app publish        │
├─────────────────────────────────────────────────────────┤
│ Install flow                                            │
│   upload → [pre-install] → metadata migration →         │
│   generate SDK → [post-install] → … → [uninstall]       │
├─────────────────────────────────────────────────────────┤
│ Publish                                                 │
│   npm publish → appears in Twenty marketplace           │
└─────────────────────────────────────────────────────────┘

twenty app dev — смотрит на исходные файлы и live-синхронизирует изменения на подключенный Twenty сервер. Типизированный клиент API автоматически пересоздаётся при изменении схемы.
twenty app build — компилирует TypeScript, упаковывает логические функции и передние компоненты с esbuild, и производит манифест.
Хуки до/после установки и удаления — необязательные функции, которые выполняются во время установки или непосредственно перед удалением. См. раздел Install Hooks для подробностей.

Следующие шаги

Конфигурация

Идентификатор приложения, роль по умолчанию и установка и удаление хуков.

Данные

Объекты, поля и двунаправленные связи.

Логика

Функции логики, навыки, агенты, подключения и каналы сообщений.

Макет

просмотра, навигация, макеты страниц, передние компоненты.

Операции

CLI, тестирование, удаление, CI и публикация вашего приложения.

Разработчики

Приложения

API

Самостоятельный хостинг

Внести вклад

Библиотека интерфейса

Как работают приложения

Типы сущностей

Изоляция в песочнице

Жизненный цикл приложения

Следующие шаги

​Как работают приложения

​Типы сущностей

​Изоляция в песочнице

​Жизненный цикл приложения

​Следующие шаги

Как работают приложения

Типы сущностей

Изоляция в песочнице

Жизненный цикл приложения

Следующие шаги