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>

packages/twenty-docs/l/ru/getting-started/introduction.mdx

@@ -0,0 +1,72 @@
+---
+title: Почему Twenty
+icon: heart
+---
+
+import { CardTitle } from "/snippets/card-title.mdx"
+
+Вы выбирали между программным обеспечением, которое легко запустить, но невозможно менять, и программным обеспечением, которое гибкое, но требует месяцев на настройку. Twenty — это третий вариант: **готовая к промышленной эксплуатации CRM, которую вы можете менять по ходу дела.**
+
+## Чем Twenty отличается
+
+Twenty — это платформа, на основе которой вы можете строить решения, а не продукт, который вы просто настраиваете.
+
+<CardGroup cols={2}>
+  <Card img="/images/user-guide/halftone/ai.png">
+    <CardTitle>Создано для агентов</CardTitle>
+    Агенты работают внутри вашей модели данных с реальными правами доступа. Навыки, инструменты, MCP.
+  </Card>
+  <Card img="/images/user-guide/halftone/permissions.png">
+    <CardTitle>Безопасная расширяемость</CardTitle>
+    Гибкость vibe-coded инструментов на защищённой основе.
+  </Card>
+  <Card img="/images/user-guide/halftone/dev-api.png">
+    <CardTitle>Современный стек</CardTitle>
+    React, TypeScript. Ваша команда уже знает, как расширять Twenty. Никаких проприетарных языков, никакого гейткипинга.
+  </Card>
+  <Card img="/images/user-guide/halftone/dev-self-host.png">
+    <CardTitle>Без привязки</CardTitle>
+    Ядро с открытым исходным кодом, можно развернуть у себя, экспортируйте свои данные в любой момент.
+  </Card>
+</CardGroup>
+
+## Для кого Twenty
+
+* **Крупные предприятия, заменяющие Salesforce** — ваша команда
+  тратит больше времени на борьбу с инструментом, чем на его использование.
+  Вы чувствуете себя запертыми в рамках решения, а затраты продолжают расти.
+* **Стартапы с техническими основателями** — вы переросли
+  таблицы и Notion. У вас большие амбиции, и вы хотите
+  CRM, которая будет масштабироваться вместе с вами.
+* **Команды GTM, ищущие преимущество** — вы хотите строить
+  собственный скоринг лидов, собственное обогащение, собственные
+  исходящие рабочие процессы.
+* **Организации, ориентированные на конфиденциальность** — вам нужно
+  размещать решение у себя и полностью владеть своими данными от начала и до конца. По регуляторным,
+  договорным причинам или просто по принципу.
+* **Партнёры Salesforce** —
+  ваши разработчики устали рассказывать клиентам о повышении стоимости лицензий.
+  Вы хотите лучший DX и возможность сдавать проекты быстрее при более низкой лицензионной стоимости для своих клиентов.
+* **Веб-агентства по разработке** — ваша команда знает TypeScript, React
+  и PostgreSQL. Twenty открывает для вас рынок CRM,
+  не требуя изучения APEX или получения проприетарных сертификатов.
+
+## Для кого Twenty не подходит
+
+* **Команды, которым нужна CRM, о которой никогда не придётся
+  думать.** Twenty подходит командам, которые хотят оставаться близко к
+  своим инструментам и со временем формировать их под себя. Если вы хотите
+  полностью управляемое решение, Pipedrive или
+  HubSpot вас не подведут.
+* **Компании, которым уже сегодня нужны сотни готовых интеграций.** Наша экосистема быстро растёт, но она пока
+  не такая широкая, как у Salesforce или HubSpot. Если вы готовы
+  разрабатывать недостающее, вам это понравится. Если нет —
+  дайте нам ещё год.
+* **Организации, где инструменты выбирают в переговорных,
+  а не те, кто ими пользуется.** Мы не устраиваем стейк-ужины
+  и executive-брифинги. Мы побеждаем с командами, у которых
+  есть полномочия выбирать собственные инструменты.
+
+<Card title="Готовы начать?" icon="rocket" href="/l/ru/getting-started/quickstart">
+  Настройте Twenty менее чем за 5 минут — в облаке или на собственном сервере.
+</Card>

packages/twenty-docs/l/ru/getting-started/key-features.mdx

@@ -0,0 +1,70 @@
+---
+title: Ключевые функции
+description: Обзор всех возможностей Twenty — от настраиваемых моделей данных до автоматизации на базе ИИ.
+icon: star
+---
+
+import { CardTitle } from "/snippets/card-title.mdx"
+
+Twenty — это полнофункциональная платформа CRM. Вот что вы можете с ней создать.
+
+<CardGroup cols={2}>
+  <Card href="/l/ru/user-guide/data-model/overview" img="/images/user-guide/halftone/data-model.png">
+    <CardTitle>Настраиваемая модель данных</CardTitle>
+    Определяйте точную структуру данных, которая нужна вашему бизнесу.
+    <br />Создавайте пользовательские объекты, добавляйте настраиваемые поля с более чем 20 типами полей и выстраивайте связи между любыми объектами.
+  </Card>
+
+  <Card href="/l/ru/user-guide/views-pipelines/overview" img="/images/user-guide/halftone/layout.png">
+    <CardTitle>Представления и воронки</CardTitle>
+    Переключайтесь между табличными представлениями, досками канбан и календарными представлениями.
+    <br />Фильтруйте с логикой AND/OR, сортируйте по нескольким полям, группируйте записи и сохраняйте пользовательские представления.
+  </Card>
+
+  <Card href="/l/ru/user-guide/workflows/overview" img="/images/user-guide/halftone/workflows.png">
+    <CardTitle>Рабочие процессы и автоматизация</CardTitle>
+    Автоматизируйте любые бизнес-процессы без написания кода.
+    <br />Запускайте рабочие процессы при изменении записей, по расписанию, вручную или при получении входящих вебхуков.
+  </Card>
+
+  <Card href="/l/ru/user-guide/calendar-emails/overview" img="/images/user-guide/halftone/calendar-emails.png">
+    <CardTitle>Синхронизация календаря и электронной почты</CardTitle>
+    Подключите свою учетную запись Google Workspace или Microsoft 365.
+    <br />Письма и события календаря автоматически появляются в соответствующих записях CRM.
+  </Card>
+
+  <Card href="/l/ru/user-guide/ai/overview" img="/images/user-guide/halftone/ai.png">
+    <CardTitle>ИИ</CardTitle>
+    Автономные ИИ-агенты, работающие внутри вашей CRM — отвечают на вопросы, обогащают записи и выполняют многошаговые задачи в рамках вашей модели разрешений.
+  </Card>
+
+  <Card href="/l/ru/user-guide/dashboards/overview" img="/images/user-guide/halftone/dashboards.png">
+    <CardTitle>Панели и отчеты</CardTitle>
+    Создавайте настраиваемые панели с виджетами в реальном времени.
+    <br />Отслеживайте метрики воронки, эффективность команды и бизнес-KPI с помощью настраиваемых диаграмм и фильтров.
+  </Card>
+
+  <Card href="/l/ru/user-guide/permissions-access/overview" img="/images/user-guide/halftone/permissions.png">
+    <CardTitle>Права и контроль доступа</CardTitle>
+    Ролевое управление доступом на каждом уровне — объекты, поля и отдельные записи.
+    <br />Настройте SSO с SAML или OIDC. Журналы аудита отслеживают, кто что сделал.
+  </Card>
+
+  <Card href="/l/ru/developers/extend/api" img="/images/user-guide/halftone/dev-api.png">
+    <CardTitle>API и расширяемость</CardTitle>
+    Ориентированный на разработчиков API, который адаптируется к вашей настраиваемой модели данных.
+    <br />И GraphQL, и REST-эндпоинты с автоматически генерируемой документацией для каждого рабочего пространства.
+  </Card>
+
+  <Card href="/l/ru/user-guide/data-migration/overview" img="/images/user-guide/halftone/data-migration.png">
+    <CardTitle>Импорт и экспорт данных</CardTitle>
+    Импортируйте данные из файлов CSV или через API.
+    <br />Встроены сопоставление полей, обнаружение дубликатов и обработка ошибок. Экспортируйте свои данные в любой момент — без привязки к поставщику.
+  </Card>
+
+  <Card href="/l/ru/developers/self-host/self-host" img="/images/user-guide/halftone/dev-self-host.png">
+    <CardTitle>Самостоятельный хостинг</CardTitle>
+    Запустите Twenty в своей инфраструктуре одной командой Docker Compose.
+    <br />Полный контроль над вашими данными, обновления по вашему графику.
+  </Card>
+</CardGroup>

packages/twenty-docs/l/ru/getting-started/quickstart.mdx

@@ -0,0 +1,73 @@
+---
+title: Быстрый старт
+description: Запустите Twenty и начните работу менее чем за 5 минут — в облаке или на собственном сервере.
+icon: play
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Регистрация
+
+<Steps>
+  <Step title="Создайте аккаунт">
+    Перейдите на [app.twenty.com](https://app.twenty.com) и зарегистрируйтесь с помощью Google, Microsoft или электронной почты.
+  </Step>
+  <Step title="Выберите пробный период">
+    Выберите **30 дней** (с картой) или **7 дней** (без карты). Оба варианта включают полный доступ — неограниченное количество контактов, интеграцию с электронной почтой, пользовательские объекты, API. Вы можете изменить тариф или платёжный интервал в любое время.
+  </Step>
+  <Step title="Создайте свое рабочее пространство">
+    После подтверждения оплаты через Stripe вы настроите название рабочего пространства и профиль пользователя. Вы можете отменить подписку в любое время.
+  </Step>
+</Steps>
+
+<VimeoEmbed videoId="1185227242" title="Создание рабочего пространства" />
+
+## Настройка рабочего пространства
+
+Когда вы войдёте в систему, выполните три шага, чтобы сделать Twenty именно вашим:
+
+### 1. Подключите свою почту
+
+Перейдите в раздел **Настройки → Аккаунты** и подключите свой аккаунт Google или Microsoft. Twenty импортирует ваши электронные письма и события в календаре и автоматически создаст контакты на основе взаимодействий. Пользуетесь другим провайдером? Вы можете добавить почтовые ящики через SMTP или календари через CalDAV на этой же странице.
+
+<Note>Начните отсюда — подключение почтового ящика даёт вашей команде мгновенную ценность за счёт реальных данных ещё до того, как вы настроите что‑либо ещё.</Note>
+
+<VimeoEmbed videoId="1185416821" title="Подключите свою почту" />
+
+### 2. Сформируйте свою модель данных
+
+Перейдите в раздел **Настройки → Модель данных**, чтобы создавать пользовательские объекты и поля. Несколько важных моментов:
+
+* Пользовательские объекты и поля **не ограничены на всех тарифах** — без дополнительных доплат.
+* **People, Companies и Opportunities** — это объекты, в которых отображаются синхронизированные письма и встречи. Используйте их как основу и добавляйте поля для категоризации (например, поле `Person Type`), вместо того чтобы создавать отдельные объекты без истории электронной почты.
+* Два человека не могут иметь один и тот же адрес электронной почты. Две компании не могут использовать один и тот же домен.
+* Вы можете деактивировать стандартные поля и объекты, которые вам не нужны, а также скрывать поля из представлений, не удаляя их.
+
+[Справочник по модели данных →](/l/ru/user-guide/data-model/overview)
+
+<VimeoEmbed videoId="1185416793" title="Сформируйте свою модель данных" />
+
+### 3. Импортируйте ваши данные
+
+Используйте меню команд (`Cmd+K` / `Ctrl+K`), чтобы импортировать People, Companies, Opportunities или любые пользовательские объекты через CSV. Сначала скачайте пример файла, чтобы увидеть ожидаемый формат. Ограничьте файлы 10 000 записей и удалите дубликаты адресов электронной почты/доменов перед импортом.
+
+[Руководство по миграции данных →](/l/ru/user-guide/data-migration/overview)
+
+<VimeoEmbed videoId="1185416775" title="Импортируйте ваши данные" />
+
+## Следующие шаги
+
+<CardGroup cols={2}>
+  <Card title="Изучите интерфейс" icon="table-columns" href="/l/ru/getting-started/core-concepts/layout">
+    Навигация, представления, командное меню, боковая панель.
+  </Card>
+  <Card title="Создавайте рабочие процессы" icon="bolt" href="/l/ru/user-guide/workflows/overview">
+    Автоматизируйте свои бизнес-процессы.
+  </Card>
+  <Card title="Создавайте представления" icon="table" href="/l/ru/user-guide/layout/overview">
+    Таблица, канбан, календарь — фильтруйте и сортируйте свои данные.
+  </Card>
+  <Card title="Изучите API" icon="plug" href="/l/ru/developers/extend/api">
+    REST и GraphQL с отдельной схемой для каждого арендатора.
+  </Card>
+</CardGroup>