snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)

packages/twenty-docs/l/ru/developers/extend/apps/getting-started/scaffolding.mdx

@@ -0,0 +1,63 @@
+---
+title: Создание каркаса
+description: Интерактивно генерируйте файлы сущностей с помощью yarn twenty dev:add — объекты, поля, представления, логические функции и многое другое.
+icon: wand-magic-sparkles
+---
+
+Вместо ручного создания файлов сущностей используйте интерактивный генератор:
+
+```bash filename="Terminal"
+yarn twenty dev:add
+```
+
+Он предлагает выбрать тип сущности и пошагово проводит через обязательные поля, а затем записывает готовый к использованию файл со стабильным `universalIdentifier` и корректным вызовом `defineEntity()`.
+
+Вы также можете передать тип сущности напрямую, чтобы пропустить первый запрос:
+
+```bash filename="Terminal"
+yarn twenty dev:add object
+yarn twenty dev:add logicFunction
+yarn twenty dev:add frontComponent
+```
+
+## Доступные типы сущностей
+
+| Тип сущности                    | Команда                                    | Сгенерированный файл                                      |
+| ------------------------------- | ------------------------------------------ | --------------------------------------------------------- |
+| Объект                          | `yarn twenty dev:add object`               | `src/objects/\<name>.ts`                 |
+| Поле                            | `yarn twenty dev:add field`                | `src/fields/\<name>.ts`                  |
+| Логическая функция              | `yarn twenty dev:add logicFunction`        | `src/logic-functions/\<name>.ts`         |
+| Компонент фронтенда             | `yarn twenty dev:add frontComponent`       | `src/front-components/\<name>.tsx`       |
+| Роль                            | `yarn twenty dev:add role`                 | `src/roles/\<name>.ts`                   |
+| Навык                           | `yarn twenty dev:add skill`                | `src/skills/\<name>.ts`                  |
+| Агент                           | `yarn twenty dev:add agent`                | `src/agents/\<name>.ts`                  |
+| Представление                   | `yarn twenty dev:add view`                 | `src/views/\<name>.ts`                   |
+| Пункт меню навигации            | `yarn twenty dev:add navigationMenuItem`   | `src/navigation-menu-items/\<name>.ts`   |
+| Макет страницы                  | `yarn twenty dev:add pageLayout`           | `src/page-layouts/\<name>.ts`            |
+| Вкладка компоновки страницы     | `yarn twenty dev:add pageLayoutTab`        | `src/page-layout-tabs/\<name>.ts`        |
+| Элемент меню команд             | `yarn twenty dev:add commandMenuItem`      | `src/command-menu-items/\<name>.ts`      |
+| Поле представления              | `yarn twenty dev:add viewField`            | `src/view-fields/\<name>.ts`             |
+| Провайдер подключения           | `yarn twenty dev:add connectionProvider`   | `src/connection-providers/\<name>.ts`    |
+| Тип действия на временной шкале | `yarn twenty dev:add timelineActivityType` | `src/timeline-activity-types/\<name>.ts` |
+
+## Что генерирует скэффолдер
+
+У каждого типа сущности есть свой шаблон. Например, `yarn twenty dev:add object` запрашивает:
+
+1. **Имя (единственное число)** — например, `invoice`
+2. **Имя (множественное число)** — например, `invoices`
+3. **Метка (единственное число)** — заполняется автоматически из имени (например, `Invoice`)
+4. **Метка (множественное число)** — заполняется автоматически (например, `Invoices`)
+5. **Создать представление и пункт навигации?** — если вы ответите «да», скэффолдер также сгенерирует соответствующее представление и ссылку в боковой панели для нового объекта.
+
+У других типов сущностей подсказки проще — в большинстве случаев запрашивается только имя.
+
+Тип сущности `field` более детализирован: он запрашивает имя поля, метку, тип (из списка всех доступных типов полей, таких как `TEXT`, `NUMBER`, `SELECT`, `RELATION` и т. д.), а также `universalIdentifier` целевого объекта.
+
+## Пользовательский путь вывода
+
+Используйте флаг `--path`, чтобы поместить сгенерированный файл в пользовательское расположение:
+
+```bash filename="Terminal"
+yarn twenty dev:add logicFunction --path src/custom-folder
+```