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

packages/twenty-docs/l/ru/getting-started/core-concepts/ai.mdx

@@ -0,0 +1,34 @@
+---
+title: ИИ
+description: Как Twenty использует ИИ, чтобы улучшить ваш опыт работы с CRM.
+icon: robot
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Twenty интегрирует ИИ напрямую в вашу CRM — не как маркетинговый трюк, а как инструмент, который работает в рамках вашей модели данных и системы разрешений.
+
+## Чат-бот на базе ИИ
+
+Задавайте вопросы о своих данных на естественном языке. Чат-бот на базе ИИ может выполнять запросы к записям в вашей CRM, обобщать информацию и помогать находить то, что вам нужно, без создания сложных фильтров.
+
+<VimeoEmbed videoId="1185511734" title="Чат-бот на базе ИИ" />
+
+## Агенты ИИ
+
+Агенты ИИ выходят за рамки чата — они могут автономно выполнять многошаговые задачи:
+
+* Обогащать записи данными из внешних источников
+* Подготавливать и отправлять последующие письма
+* Анализировать состояние воронки и помечать сделки с повышенным риском
+* Обрабатывать входящие данные и направлять их в нужную команду
+
+Агенты работают в рамках ваших существующих рабочих процессов, поэтому вы можете сочетать ИИ с ручными утверждениями, условной логикой и внешними вызовами API.
+
+## Разрешения и безопасность
+
+ИИ в Twenty соблюдает вашу модель разрешений. Агенты могут получать доступ только к объектам и полям, к просмотру которых у пользователя (или роли) есть разрешение. Конфиденциальные данные остаются защищенными, даже когда используется ИИ.
+
+<Card title="Полное руководство по ИИ" icon="arrow-right" href="/l/ru/user-guide/ai/overview">
+  Подробная справка по чат-боту, агентам и настройкам разрешений.
+</Card>

packages/twenty-docs/l/ru/getting-started/core-concepts/apps.mdx

@@ -0,0 +1,41 @@
+---
+title: Приложения
+icon: cube
+description: Расширяйте Twenty с помощью кода — пользовательских объектов, серверной логики, UI-компонентов и ИИ-агентов, всё в виде пакетов TypeScript.
+---
+
+Большинство CRM-систем дают вам панель настроек. Twenty даёт вам платформу. Приложения — это способ, с помощью которого разработчики расширяют Twenty за рамки возможностей интерфейса: они определяют модели данных, серверную логику, UI-компоненты и возможности ИИ как код, а затем развёртывают их в одном или нескольких рабочих пространствах.
+
+## Зачем нужны приложения
+
+Рабочие процессы охватывают автоматизацию без кода. Но для некоторых вещей нужен код: пользовательский механизм ценообразования, проприетарный конвейер обогащения данных, проверка на соответствие требованиям, которая запускается при каждом обновлении записи, пользовательская панель интерфейса, подтягивающая данные из внутреннего инструмента.
+
+Приложения позволяют создавать всё это как полноценные расширения — не хрупкие скрипты, которые снаружи обращаются к API, а код, который запускается на платформе с полным доступом к системе типов, модели прав доступа и пользовательскому интерфейсу.
+
+## Что может определять приложение
+
+Приложение — это пакет TypeScript, который объявляет **сущности** с помощью `twenty-sdk`:
+
+| Сущность                      | Что делает                                                                                                               |
+| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
+| **Объекты и поля**            | Новые таблицы данных и поля в существующих объектах — такой же подход, как и для встроенных.                             |
+| **Логические функции**        | Серверный TypeScript, запускаемый HTTP-маршрутами, расписаниями cron или событиями базы данных                           |
+| **Компоненты фронтенда**      | Изолированные React-компоненты, которые отображаются внутри интерфейса Twenty (боковая панель, виджеты, командное меню). |
+| **Навыки и агенты**           | Возможности ИИ — многократно используемые инструкции и автономные помощники                                              |
+| **Представления и навигация** | Предварительно настроенные представления списков и элементы бокового меню                                                |
+
+Всё определяется с помощью анализа AST на этапе сборки — без конфигурационных файлов и шаблонного кода регистрации. Добавьте `export default defineObject(...)` в любой файл `.ts`, и SDK его подхватит.
+
+## Как они выполняются
+
+* **Логические функции** выполняются в изолированных процессах Node.js, отделённых от хоста. Они получают доступ к данным через типизированный клиент API, ограниченный правами роли приложения.
+* **Компоненты фронтенда** запускаются в Web Workers с использованием Remote DOM — изолированы от основной страницы, но при этом рендерят нативные элементы DOM (не iframes).
+* **Права доступа** применяются на уровне API. Приложение видит только то, что разрешает его роль.
+
+## Опыт разработки
+
+Вы пишете своё приложение как TypeScript-проект на своём компьютере. CLI отслеживает ваши исходные файлы и в реальном времени синхронизирует их с запущенным сервером Twenty — редактируйте файл и увидите изменения в интерфейсе за секунду. Типизированный клиент API автоматически пересоздаётся при изменении схемы. Когда будете готовы, `yarn twenty app:publish --private` развернёт приложение на production-сервере, а `yarn twenty app:publish` опубликует его в npm и на маркетплейсе Twenty.
+
+<Card title="Создайте своё первое приложение" icon="arrow-right" href="/l/ru/developers/extend/apps/getting-started/quick-start">
+  Пошаговое руководство из трёх этапов — создание каркаса, запуск локального сервера, синхронизация изменений.
+</Card>

packages/twenty-docs/l/ru/getting-started/core-concepts/calendar-and-email.mdx

@@ -0,0 +1,46 @@
+---
+title: Календарь и электронная почта
+description: Синхронизируйте свою электронную почту и календарь с Twenty.
+icon: envelope
+---
+
+Twenty подключается к вашим существующим инструментам, поэтому ваша CRM-система остается актуальной без ручного ввода данных.
+
+## Синхронизация электронной почты
+
+Подключите свой почтовый ящик **Google Workspace** или **Microsoft 365**. После подключения:
+
+* Электронные письма автоматически привязываются к соответствующим записям компаний и людей
+* Полные цепочки писем отображаются на временной шкале каждой записи
+* Вы можете отправлять письма непосредственно из Twenty
+* Поддерживается несколько почтовых ящиков на одного пользователя
+
+Вы контролируете, что импортируется — фильтруйте по диапазону дат или отправителю, чтобы не импортировать нерелевантные письма.
+
+## Синхронизация календаря
+
+События календаря автоматически синхронизируются из подключенной учетной записи. События отображаются в соответствующих записях CRM-системы, давая вам полное представление о ваших взаимодействиях с каждым контактом или компанией.
+
+## Интеграции
+
+Помимо электронной почты и календаря, Twenty подключается к внешним инструментам через:
+
+| Метод                                 | Сценарий использования                                                              |
+| ------------------------------------- | ----------------------------------------------------------------------------------- |
+| **API**                               | Создавайте собственные интеграции с помощью GraphQL или REST API                    |
+| **Вебхуки**                           | Отправляйте уведомления в реальном времени во внешние системы при изменении записей |
+| **Zapier**                            | Подключайте более 5 000 приложений без написания кода                               |
+| **Действия HTTP в рабочих процессах** | Вызывайте любой внешний API как часть автоматизированного рабочего процесса         |
+
+## Пользовательские приложения
+
+Разработчики могут создавать полнофункциональные приложения поверх Twenty — добавляя пользовательский интерфейс, серверную логику и глубокие интеграции. Приложения можно публиковать для сообщества или оставлять приватными.
+
+<CardGroup cols={2}>
+  <Card title="Руководство по календарю и электронной почте" icon="envelope" href="/l/ru/user-guide/calendar-emails/overview">
+    Настройте синхронизацию электронной почты и календаря и устраните неполадки.
+  </Card>
+  <Card title="API и расширения" icon="plug" href="/l/ru/developers/extend/api">
+    Создавайте собственные интеграции с помощью API Twenty.
+  </Card>
+</CardGroup>

packages/twenty-docs/l/ru/getting-started/core-concepts/dashboards.mdx

@@ -0,0 +1,37 @@
+---
+title: Панели управления
+description: Отслеживайте эффективность и визуализируйте данные вашей CRM-системы с помощью настраиваемых панелей управления.
+icon: chart-bar
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Панели управления дают доступ к бизнес-показателям в режиме реального времени — состоянию воронки, эффективности команды, динамике выручки и любым другим метрикам, которые вы хотите отслеживать.
+
+<VimeoEmbed videoId="1185511768" title="Панель управления" />
+
+## Виджеты
+
+Каждая панель управления состоит из виджетов. Виджет — это отдельный график или метрика, привязанная к данным вашей CRM-системы. Вы можете настроить:
+
+* **Тип диаграммы** — столбчатая, линейная, круговая, числовой показатель и другие
+* **Источник данных** — любой объект в вашей модели данных (стандартный или настраиваемый)
+* **Фильтры** — сужение выборки до конкретных записей, диапазонов дат или сегментов
+* **Агрегация** — количество, сумма, среднее, минимум, максимум по любому числовому полю
+* **Группировка** — разбивка по выбранным полям, датам или связям
+
+## Что вы можете отслеживать
+
+* Сумма воронки по этапам
+* Сделки, закрытые за период
+* Средний размер сделки по источнику
+* Показатели выполнения задач
+* Пользовательские метрики по любому объекту
+
+## Совместный доступ
+
+Панели управления — на уровне рабочего пространства: их видит каждый участник вашей команды. Располагайте виджеты в сетке и изменяйте их размер, чтобы создать представление, которое подходит вашей команде.
+
+<Card title="Полное руководство по панелям управления" icon="arrow-right" href="/l/ru/user-guide/dashboards/overview">
+  Подробная справка по созданию панелей управления, настройке виджетов и диаграмм.
+</Card>

packages/twenty-docs/l/ru/getting-started/core-concepts/data-model.mdx

@@ -0,0 +1,47 @@
+---
+title: Модель данных
+description: Разберитесь, как Twenty структурирует ваши данные с помощью объектов, полей и связей.
+icon: database
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+В Twenty всё построено вокруг **объектов** и **полей** — строительных блоков вашей модели данных.
+
+## Объекты
+
+Объекты — это таблицы, в которых хранятся ваши данные. В Twenty предусмотрены стандартные объекты:
+
+* **Companies** — организации, с которыми вы работаете
+* **People** — отдельные контакты
+* **Opportunities** — сделки в вашей воронке продаж
+* **Tasks** — задачи для вашей команды
+* **Notes** — произвольный текст, связанный с записями
+
+Вы также можете создавать **пользовательские объекты** под любые нужды вашего бизнеса — проекты, заявки в поддержку, продукты, контракты и что угодно ещё.
+
+## Поля
+
+Поля — это свойства каждого объекта. Twenty поддерживает широкий набор типов полей:
+
+| Категория       | Типы                                                                           |
+| --------------- | ------------------------------------------------------------------------------ |
+| **Базовые**     | Текст, Число, Булево значение, Дата, Валюта, Оценка, Список                    |
+| **Составные**   | Адрес (улица, город, штат, индекс), Полное имя, Ссылки, Телефоны, Email-адреса |
+| **Специальные** | Связь, Файловое вложение, JSON, Автор (кто создал/изменил)                     |
+
+Каждый объект также получает автоматические системные поля: `id`, `createdAt`, `updatedAt`, `createdBy` и `position`.
+
+## Связи
+
+Объекты соединяются друг с другом с помощью связей. У компании может быть много контактов, а сделка принадлежит компании и т. д. Вы можете создавать пользовательские связи между любыми объектами, включая связи «многие ко многим».
+
+## Почему это мощно
+
+В отличие от традиционных CRM-систем, в которых вы ограничены предопределёнными полями на предопределённых объектах, Twenty позволяет моделировать данные именно так, как устроен ваш бизнес. Пользовательские объекты получают такой же статус, как и встроенные, — включая конечные точки API, представления, права доступа и триггеры рабочих процессов.
+
+<Card title="Подробно о модели данных" icon="arrow-right" href="/l/ru/user-guide/data-model/overview">
+  Полная справка по объектам, полям, связям и их настройке.
+</Card>
+
+<VimeoEmbed videoId="1185511827" title="Модель данных" />

packages/twenty-docs/l/ru/getting-started/core-concepts/glossary.mdx

@@ -0,0 +1,105 @@
+---
+title: Глоссарий
+icon: book
+description: Ключевые термины, используемые в Twenty.
+---
+
+## API
+
+API (интерфейс программирования приложений) позволяет подключать Twenty к другим программным системам и создавать пользовательские интеграции.
+
+## Приложения
+
+Приложения — это настраиваемые расширения, создаваемые в виде кода, которые могут определять модели данных и функции бизнес-логики. Они позволяют разработчикам создавать повторно используемые пользовательские настройки, которые можно развертывать в нескольких рабочих пространствах.
+
+## Действия кода
+
+Действия кода — это шаги рабочего процесса, которые позволяют писать пользовательский JavaScript для преобразования данных, выполнения вычислений или реализации сложной логики, недоступной во встроенных действиях.
+
+## Меню команд
+
+Меню команд — это интерфейс быстрого доступа (открывается с помощью `Cmd + K` на Mac и `Ctrl + K` на Windows), который позволяет выполнять действия, создавать записи и эффективно перемещаться по рабочему пространству.
+
+## Компания и Люди
+
+CRM имеет два основных типа записей:
+
+* «Компания» представляет собой бизнес или организацию.
+* «Люди» представляют собой текущих и потенциальных клиентов вашей компании.
+
+## Пользовательские поля
+
+Пользовательские поля — это поля данных, которые вы создаете для сбора информации, специфичной для ваших бизнес-потребностей и процессов.
+
+## Модель данных
+
+Модель данных — это структура, которая определяет, как информация организована в вашей CRM, включая какие объекты существуют, их свойства (поля) и как они связаны друг с другом.
+
+## Избранное
+
+Избранное — это записи, которые вы пометили для быстрого доступа, они появляются в вашей боковой панели для мгновенной навигации к важным данным.
+
+## Поле
+
+Поле — это определенная область, в которой хранится конкретная информация об объекте.
+
+## Итератор
+
+Итератор — это действие рабочего процесса, которое перебирает массив элементов, выполняя последующие действия для каждого элемента в списке.
+
+## Канбан
+
+Канбан — это визуальный способ отслеживания бизнес-процессов с использованием карточек и колонок. Каждая колонка представляет этап в вашем процессе (например: новые, в работе, выиграны, потеряны), и вы перемещаете записи через эти этапы по мере их продвижения.
+
+## Объект
+
+Объект — это структура данных, представляющая определенный тип сущности в вашей CRM (например, Люди, Компании или Возможности). Объекты могут быть стандартными (встроенными) или пользовательскими (созданными вами).
+
+## Возможности
+
+Возможности в Twenty CRM — это потенциальные сделки или продажи с аккаунтами или контактами.
+
+## Запись
+
+Запись указывает на экземпляр объекта, например, определенный аккаунт или контакт.
+
+## Поля связи
+
+Поля связи создают связи между различными объектами, позволяя связывать записи друг с другом (например, связывать Человека с Компанией).
+
+## Стандартные поля
+
+Стандартные поля — это предустановленные поля данных, которые включены в объекты по умолчанию и обеспечивают общую функциональность во всех рабочих пространствах.
+
+## Задачи
+
+Задачи в Twenty CRM — это назначенные действия, связанные с контактами, аккаунтами или возможностями.
+
+## Триггеры
+
+Триггеры — отправная точка рабочего процесса — событие или условие, которое инициирует автоматизацию. К примерам относятся создание и обновление записей, вебхуки или запланированное время.
+
+## Представления
+
+Вы можете настраивать отображение своих записей, используя представления, устанавливая различные фильтры, макеты и параметры сортировки для каждого представления.
+
+## Upsert
+
+Upsert — это операция, сочетающая "update" и "insert" — она обновляет существующую запись, если найдено совпадение, или создает новую запись, если совпадения нет.
+
+## Вебхуки
+
+Вебхуки — это автоматизированные сообщения, отправляемые от Twenty в другие приложения при возникновении определенных событий, обеспечивая синхронизацию данных в реальном времени.
+
+## Рабочие процессы
+
+Рабочие процессы — это автоматизированные процессы, которые запускают действия на основе определенных условий, помогая автоматизировать повторяющиеся задачи и бизнес-процессы.
+
+## Рабочее пространство
+
+Рабочее пространство обычно представляет собой компанию, использующую Twenty. В нем хранятся все записи и данные, которые вы и участники вашей команды добавляете в Twenty.
+У него одно доменное имя — обычно то, которое ваша компания использует для адресов электронной почты сотрудников.
+
+## Участники рабочего пространства
+
+Участники рабочего пространства — это пользователи Twenty из вашей команды, которые имеют доступ к вашему рабочему пространству. Они могут быть назначены в качестве владельцев или ответственных за записи.

packages/twenty-docs/l/ru/getting-started/core-concepts/layout.mdx

@@ -0,0 +1,74 @@
+---
+title: Макет
+description: Как ориентироваться, просматривать и открывать записи в Twenty.
+icon: table-columns
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Основная компоновка
+
+В центре экрана находятся ваши записи — люди, компании, сделки, задачи, заметки, дашборды, рабочие процессы и любые настраиваемые объекты. Здесь вы просматриваете, изменяете и удаляете записи, а также создаете новые представления.
+
+<img src="/images/user-guide/home/main-layout.png" style={{width:'100%'}} />
+
+## Панель навигации
+
+Левая боковая панель содержит:
+
+* **Переключатель рабочих пространств** — переключайтесь между рабочими пространствами или создавайте новое (выпадающий список вверху)
+* **Поиск** — нажмите `/`, чтобы сразу перейти к нему; поиск выполняется по всем объектам
+* **Настройки** — доступ из левого верхнего угла
+* **Избранное** — закрепленные представления, уникальные для каждого пользователя
+* **Ярлыки объектов** — быстрый доступ к людям, компаниям, сделкам и т. д.
+* **Рабочие процессы** — создавайте автоматизации
+
+Перетаскивайте элементы, чтобы изменить порядок; создавайте папки для группировки связанных объектов; скрывайте то, чем не пользуетесь.
+
+<img src="/images/user-guide/home/navigation-bar.png" style={{width:'100%'}} />
+
+## Меню команд
+
+Нажмите `Cmd+K` (Mac) или `Ctrl+K` (Windows) — либо кликните по трем точкам в правом верхнем углу. Отсюда вы можете:
+
+* Создавать новые записи
+* Импортировать и экспортировать данные в формате CSV
+* Создавать новые представления
+* Получать доступ к удалённым записям (в Twenty поддерживаются мягкое и жёсткое удаление)
+* Просматривать сочетания клавиш для навигации по рабочему пространству
+
+<img src="/images/user-guide/home/command-menu.png" style={{width:'100%'}} />
+
+## Поиск
+
+Доступно через меню команд, в верхней части панели навигации или по нажатию `/`. Поиск работает по всем объектам.
+
+<img src="/images/user-guide/home/search-bar.png" style={{width:'100%'}} />
+
+## Боковая панель
+
+Щелкните по записи, чтобы открыть боковую панель справа — краткий обзор ключевой информации о записи без перехода на другую страницу. Нажмите **Открыть**, чтобы перейти на полную страницу записи.
+
+<img src="/images/user-guide/home/side-panel.png" style={{width:'100%'}} />
+
+## Представления
+
+Каждый объект поддерживает несколько представлений — без ограничений для каждого объекта. Используйте выпадающий список в левом верхнем углу, чтобы переключаться между ними.
+
+* **Таблица** — строки и столбцы в формате электронных таблиц с группировкой, встроенным редактированием и настройкой столбцов
+* **Канбан** — перетаскиваемые карточки, организованные по полю выбора, идеально для воронок
+* **Календарь** — записи, отображаемые по полю даты для планирования во времени
+
+Каждое представление сохраняет свои собственные фильтры, сортировку и видимость полей. Делитесь представлениями со своим рабочим пространством или оставляйте их личными. Добавляйте представления в избранное для быстрого доступа из боковой панели.
+
+<img src="/images/user-guide/home/view-menu.png" style={{width:'100%'}} />
+
+## Страницы записей
+
+Когда вы открываете запись, страница сведений формируется из настраиваемых **вкладок** и **виджетов**. Добавляйте, удаляйте, меняйте порядок и изменяйте размер виджетов в сетке — поля, связанные записи, электронные письма, ленту активности, задачи, заметки, файлы, диаграммы, iframes и многое другое. У каждого типа объекта есть собственная компоновка.
+
+<Card title="Полное руководство по компоновке" icon="arrow-right" href="/l/ru/user-guide/layout/overview">
+  Навигация, представления, страницы записей — подробная справка и практические инструкции.
+</Card>
+
+<VimeoEmbed videoId="1185511790" title="Макет" />

packages/twenty-docs/l/ru/getting-started/core-concepts/workflows.mdx

@@ -0,0 +1,55 @@
+---
+title: Рабочие процессы
+description: Автоматизируйте бизнес-процессы с помощью визуального конструктора рабочих процессов Twenty.
+icon: bolt
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Рабочие процессы позволяют автоматизировать повторяющиеся задачи и подключать Twenty к внешним инструментам — без написания кода (хотя при желании вы можете его использовать).
+
+<VimeoEmbed videoId="1185511711" title="Рабочий процесс" />
+
+## Как работают рабочие процессы
+
+У каждого рабочего процесса есть три части:
+
+1. **Триггер** — что запускает рабочий процесс
+2. **Шаги** — что происходит дальше (одно или несколько действий последовательно)
+3. **Переменные** — данные, которые передаются между шагами
+
+## Триггеры
+
+| Триггер            | Когда срабатывает                                                                 |
+| ------------------ | --------------------------------------------------------------------------------- |
+| **Событие записи** | Запись создается, обновляется, удаляется или вставляется/обновляется              |
+| **Вручную**        | Пользователь нажимает кнопку (для одной записи, нескольких записей или глобально) |
+| **Расписание**     | Через регулярные интервалы (синтаксис cron)                                       |
+| **Вебхук**         | Внешняя система отправляет HTTP POST                                              |
+
+## Действия
+
+Рабочие процессы могут объединять в цепочку любую комбинацию следующих элементов:
+
+* **Операции с записями** — создание, обновление, поиск, удаление или вставка/обновление записей
+* **Отправка писем** — отправка или создание черновиков писем из подключенных учетных записей
+* **HTTP-запрос** — вызов любого внешнего API
+* **Код** — запуск пользовательского JavaScript для сложной логики
+* **Ветвления** — условия if/else для разветвления пути рабочего процесса
+* **Iterator** — перебор массивов данных
+* **Агент ИИ** — позволяет агенту ИИ автономно обрабатывать данные
+* **Задержка** — ожидание перед продолжением
+* **Форма** — сбор пользовательского ввода в середине рабочего процесса
+
+## Что вы можете создать
+
+* Отправляйте оповещения в Slack, когда сделка достигает определенного этапа
+* Автоматически обогащайте новые контакты данными из внешних API
+* Выявляйте зависшие сделки и уведомляйте их владельца
+* Синхронизируйте данные между Twenty и вашей биллинговой системой
+* Генерируйте PDF или счета на основе данных записей
+* Автоматически отвечайте на входящие письма, соответствующие определенным критериям
+
+<Card title="Полное руководство по рабочим процессам" icon="arrow-right" href="/l/ru/user-guide/workflows/overview">
+  Подробный справочник по триггерам, действиям, переменным и практическим сценариям автоматизации.
+</Card>