@intlayer/docs 9.0.0-canary.9 → 9.0.0

package/docs/ru/releases/v9.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-26
+updatedAt: 2026-07-08
 title: Новый Intlayer v9 — Что нового?
 description: Узнайте, что нового в Intlayer v9. Представляем пакеты совместимости drop-in для популярных библиотек i18n, а также поддержку Collections и Variants.
 keywords:
@@ -9,9 +9,13 @@ keywords:
   - Миграция
   - Collections
   - Variants
+  - Self-Hosting
+  - Docker
+  - CMS SDK
   - i18next
   - next-intl
   - vue-i18n
+youtubeVideo: https://www.youtube.com/watch?v=ia6JmVf-kkU
 slugs:
   - doc
   - releases
@@ -23,6 +27,14 @@ author: aymericzip
 
 Добро пожаловать в Intlayer v9! Этот мажорный релиз знаменует собой важную веху в упрощении миграции на Intlayer благодаря **пакетам адаптеров совместимости (Compat Adapter Packages)** для популярных библиотек i18n (`react-i18next`, `next-intl`, `vue-i18n` и др.), а также добавляет поддержку сложных структур контента: **Collections** (Коллекции) и **Variants** (Варианты).
 
+<iframe
+  src="https://www.youtube.com/embed/ia6JmVf-kkU"
+  className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
+  title="Demo Video - New Intlayer v9 - What's new?"
+  sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
+  loading="lazy"
+/>
+
 ## Содержание
 
 <TOC levels={[2]} maxDepth={1} />
@@ -109,36 +121,40 @@ Intlayer v9 выходит за рамки статических объекто
 
 Определяйте управляемый CMS упорядоченный список элементов (например, FAQ, товары или списки блогов):
 
-```ts fileName="faq.content.ts"
+```ts fileName="faq.1.content.ts"
 import { t, type Dictionary } from "intlayer";
 
 export default {
   key: "faq",
-  content: [
-    {
-      question: t({
-        ru: "Что такое Intlayer?",
-        en: "What is Intlayer?",
-        fr: "Qu'est-ce qu'Intlayer ?",
-      }),
-      answer: t({
-        ru: "Инструментарий i18n.",
-        en: "An i18n toolkit.",
-        fr: "Une boîte à outils i18n.",
-      }),
-    },
-  ],
+  item: 1,
+  content: {
+    question: t({ en: "What is Intlayer?", fr: "Qu'est-ce qu'Intlayer ?" }),
+    answer: t({ en: "An i18n toolkit.", fr: "Une boîte à outils i18n." }),
+  },
+} satisfies Dictionary;
+```
+
+```ts fileName="faq.2.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "faq",
+  item: 2,
+  content: {
+    question: t({ en: "Is it free?", fr: "Est-ce gratuit ?" }),
+    answer: t({ en: "Yes, open-source.", fr: "Oui, open-source." }),
+  },
 } satisfies Dictionary;
 ```
 
 #### Использование:
 
 ```ts
-// Получить все элементы
+// Fetch all items as an array
 const allFaqs = useIntlayer("faq"); // -> { question: string, answer: string }[]
 
-// Получить один элемент по индексу
-const faq = useIntlayer("faq", { item: 1 }); // -> { question: string, answer: string }
+// Fetch a single item by index
+const faq = useIntlayer("faq", { item: 2 }); // -> { question: string, answer: string }
 ```
 
 ### 2. Варианты (Variants)
@@ -192,28 +208,52 @@ export default {
 ```ts
 // Динамически загружает только запрошенный элемент (требуется Suspense)
 const product = useIntlayer("product-copy", {
-  id: "prod_123",
-  category: "books",
+  variant: { id: "prod_123", category: "books" },
 });
 ```
 
 ---
 
-## Динамическая загрузка и оптимизация размера бандла
-
-Чтобы сохранять размер бандлов минимальным, Intlayer v9 поддерживает динамическую ленивую загрузку (lazy loading).
-
-В вашей конфигурации установите `importMode` в значение `'dynamic'` или `'fetch'`:
-
-```ts fileName="intlayer.config.ts"
-export default {
-  dictionary: {
-    importMode: "dynamic", // "static" | "dynamic" | "fetch"
-  },
+## `@intlayer/analytics`: отслеживание показов контента и A/B-тестирование
+
+Новый необязательный пакет [`@intlayer/analytics`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md) показывает, какой контент реально видят ваши посетители — и замыкает цикл с **Collections и Variants**, позволяя проводить A/B-тесты контента и измерять конверсии по каждому варианту.
+
+- **Отслеживание на уровне провайдера**: `IntlayerProvider` (React / Next.js / React Native) автоматически регистрирует события `page_view` при загрузке, смене маршрута и смене локали.
+- **Отслеживание на уровне узла**: каждое разрешение `useIntlayer` отправляет событие `content_exposure` — какой ключ словаря, путь ключа, локаль и (если применимо) A/B-**вариант** были показаны. Повторные показы одного и того же узла в пределах окна отправки объединяются в одно событие.
+- **Детерминированное назначение A/B-варианта**: `getVariant(experimentKey, variants)` назначает сессии вариант **без обращения к серверу**, поэтому перед первым рендером не возникает мерцания.
+- **`useConversion()`**: привязывает цель (регистрация, клик, покупка…) к варианту, который видела сессия.
+- **Нулевая стоимость, если не установлен**: тот же tree-shakeable паттерн, что и у `@intlayer/editor` — динамический `import()`, обёрнутый в `try/catch`, плюс переменная окружения времени сборки (`INTLAYER_ANALYTICS_ENABLED`), которая полностью удаляет интеграцию из бандла для приложений, которые её не подключили.
+- **Без новой схемы конфигурации**: переиспользует `editor.backendURL` (эндпоинт для отправки событий / самостоятельный хостинг) и `editor.clientId` (ключ проекта, он же переключатель включения).
+- **Уважение к приватности**: анонимное хеширование сессии (SHA-256, без хранения исходных id), без хранения IP, только приблизительная геолокация по стране, пакетная отправка запросов примерно раз в 20 секунд.
+- **Дашборд**: новая страница **Analytics** (отображается в боковой панели после выбора проекта) показывает активных пользователей, пользователей за сегодня, за последние 7/30/90 дней, график динамики посетителей и разбивку по локалям и странам.
+
+```tsx fileName="CTAButton.tsx" codeFormat="tsx"
+import { useConversion } from "react-intlayer";
+
+const CTAButton = () => {
+  const trackConversion = useConversion();
+
+  return (
+    <button
+      onClick={() =>
+        trackConversion({
+          experimentKey: "homepage-hero",
+          variant: "black_friday",
+          goal: "cta_click",
+        })
+      }
+    >
+      Get started
+    </button>
+  );
 };
 ```
 
-Во время сборки `@intlayer/swc` и `@intlayer/babel` сканируют ваши файлы и заменяют вызовы `useIntlayer` / `getIntlayer` на tree-shakeable обертки (`useDictionary` / `useDictionaryDynamic`). Загружается только контент, необходимый для выбранного элемента коллекции, варианта или локали, что предотвращает попадание неиспользуемых переводов в ваш продакшн-бандл.
+```bash packageManager="npm"
+npm install @intlayer/analytics
+```
+
+Уже доступно для React, Next.js и React Native (через `react-intlayer`); привязки для других фреймворков (Vue, Svelte, Angular, …) планируются по той же схеме внедрения, что и `@intlayer/editor`. Полное руководство см. в [документации Analytics](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md).
 
 ---
 
@@ -296,6 +336,59 @@ npm install intlayer react-native-intlayer
 
 ---
 
+## CMS SDK: используйте Intlayer как headless-базу данных контента
+
+Intlayer v9 включает аккуратный SDK с автоматической аутентификацией в `@intlayer/api` для программного взаимодействия с CMS — получать проекты, получать словари, а также отправлять или обновлять их с вашего сервера, скриптов или CI. Аутентификация (OAuth2 `client_credentials`) выполняется и обновляется за вас.
+
+SDK разделён на **два отдельных импорта**, чтобы ваш бандл включал только те домены, которые вы действительно используете:
+
+1. `createIntlayerCMS` — лёгкий **аутентификатор**, который хранит учётные данные и управляемый токен (клиенты доменов не включаются).
+2. `dictionaryEndpoint`, `projectEndpoint`, … — **привязки эндпоинтов** по доменам, каждая импортируется из своего подпути.
+
+```ts fileName="cms.ts"
+import { createIntlayerCMS } from "@intlayer/api";
+import { dictionaryEndpoint } from "@intlayer/api/dictionary";
+
+// Конфигурация необязательна: учётные данные берутся из INTLAYER_CLIENT_ID /
+// INTLAYER_CLIENT_SECRET, разрешаемых через `@intlayer/config/built`.
+const cms = createIntlayerCMS();
+
+// Чтение
+const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
+
+// Запись — используйте CMS как базу данных
+await dictionaryEndpoint(cms).pushDictionaries([myDictionary]);
+```
+
+> Безопасность: учётные данные CMS дают доступ к вашему контенту на запись. Создавайте аутентификатор только **на стороне сервера** — никогда не передавайте `clientId` / `clientSecret` в браузер.
+
+---
+
+## Самостоятельное размещение (Self-Hosting)
+
+Intlayer v9 поставляется с первоклассной поддержкой запуска собственного экземпляра Intlayer с помощью одной команды — учётная запись Intlayer Cloud не требуется.
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Установщик загружает `docker-compose.yml` и `.env`, автоматически генерирует необходимые секреты и запускает `docker compose up -d`. Всё — дашборд, API, база данных, хранилище объектов и транзакционная электронная почта — работает локально в контейнерах.
+
+### Включённые сервисы
+
+| Сервис                                   | Назначение                                                                       |
+| ---------------------------------------- | -------------------------------------------------------------------------------- |
+| **app** (TanStack Start)                 | Дашборд UI на порту `3000`                                                       |
+| **backend** (Fastify/Bun)                | REST API на порту `3100`                                                         |
+| **MongoDB 7** (одноузловой набор реплик) | Основная база данных                                                             |
+| **Redis 7**                              | Очереди задач и кэширование                                                      |
+| **MinIO**                                | S3-совместимое хранилище объектов (аватары, скриншоты)                           |
+| **Mailpit**                              | Локальный SMTP-приёмник + веб-интерфейс для транзакционной почты на порту `8025` |
+
+Chromium (используемый для генерации скриншотов через Puppeteer) встроен в образ бэкенда — дополнительный контейнер не требуется.
+
+---
+
 ## Примечания по миграции с v8
 
 Если вы обновляетесь с v8, обратите внимание, что v9 не содержит ломающих изменений (breaking changes). Однако вот ключевые изменения:
@@ -310,4 +403,7 @@ npm install intlayer react-native-intlayer
 
 - [Руководство по пакетам адаптеров совместимости](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/compat/index.md)
 - [Динамические словари — Collections и Variants](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dynamic_dictionaries/index.md)
+- [Аналитика - отслеживание показов контента и A/B-тестирование](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md)
 - [Справочник по конфигурации](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/configuration.md)
+- [CMS SDK — программный доступ через @intlayer/api](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_CMS.md)
+- [Руководство по самостоятельному размещению](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/self_hosting.md)

package/docs/ru/self_hosting.md

@@ -0,0 +1,350 @@
+---
+createdAt: 2026-06-30
+updatedAt: 2026-06-30
+title: Самостоятельный хостинг Intlayer
+description: Запустите полноценный экземпляр Intlayer на собственной инфраструктуре с помощью одной команды. Аккаунт Intlayer Cloud не требуется.
+keywords:
+  - Самостоятельный хостинг
+  - Docker
+  - Docker Compose
+  - Intlayer
+  - CMS
+  - Установка
+  - Инфраструктура
+slugs:
+  - doc
+  - self-hosting
+author: aymericzip
+---
+
+# Самостоятельный хостинг Intlayer
+
+Intlayer может полностью работать на вашей собственной инфраструктуре — аккаунт Intlayer Cloud не требуется. Одна команда запускает готовый к production стек:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Установщик загружает `docker-compose.yml` и `.env`, автоматически генерирует необходимые секреты и запускает все контейнеры с помощью `docker compose up -d`.
+
+## Оглавление
+
+<TOC/>
+
+---
+
+## Архитектура
+
+```
+                ┌─────────────────────────────┐
+ браузер ──────▶ │ приложение  (TanStack Start)  :3000│ ──┐
+                └─────────────────────────────┘   │ VITE_BACKEND_URL
+                ┌─────────────────────────────┐   │
+                │  бэкенд (Fastify/Bun)  :3100│ ◀─┘
+                └──────────────┬──────────────┘
+          ┌──────────┬─────────┼──────────┬───────────┐
+          ▼          ▼         ▼          ▼           ▼
+     mongo:27017  redis:6379  minio:9000  mailpit:1025  Chromium
+     (RS из 1 узла)          (API S3)     (SMTP)        (в образе)
+                             minio:9001   mailpit:8025
+                             (консоль)    (веб-интерфейс)
+```
+
+Chromium (используемый для генерации скриншотов Puppeteer) включен в образ бэкенда — отдельный контейнер не требуется.
+
+---
+
+## Предварительные требования
+
+- **Docker** ≥ 24 и **Docker Compose** ≥ v2. Если что-либо из этого отсутствует, установщик выведет ссылку для установки и завершит работу.
+- Порты `3000`, `3100`, `8025`, `9000` и `9001` должны быть доступны на хосте.
+- Хост на Linux или macOS (или WSL2 на Windows).
+
+---
+
+## Быстрый старт
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Что делает установщик:
+
+1.  Проверяет наличие `docker` и `docker compose`.
+2.  Загружает `docker-compose.yml` и `.env.example` в `./intlayer/`.
+3.  Если файл `.env` отсутствует, копирует пример и генерирует случайные секреты для `BETTER_AUTH_SECRET`, `S3_ACCESS_KEY_ID` и `S3_SECRET_ACCESS_KEY` с помощью `openssl rand`.
+4.  Запускает `docker compose pull` + `docker compose up -d`.
+5.  Выводит URL: панель управления `:3000`, API `:3100`, интерфейс электронной почты `:8025`, консоль MinIO `:9001`.
+
+После запуска стека откройте **http://localhost:3000** и создайте свою первую учетную запись.
+
+---
+
+## Сервисы
+
+| Сервис      | Образ                                 | Порт(ы) хоста                         | Назначение                                                        |
+| ----------- | ------------------------------------- | ------------------------------------- | ----------------------------------------------------------------- |
+| **app**     | построен из `apps/app/Dockerfile`     | `3000`                                | Панель управления TanStack Start (пользовательский интерфейс CMS) |
+| **backend** | построен из `apps/backend/Dockerfile` | `3100`                                | REST API Fastify (эндпоинт `/health`)                             |
+| **mongo**   | `mongo:7`                             | внутренний                            | Репликационный набор из одного узла (`rs0`)                       |
+| **redis**   | `redis:7-alpine`                      | внутренний                            | Очереди заданий (BullMQ) и кеширование (ioredis)                  |
+| **minio**   | `minio/minio`                         | `9000` (S3), `9001` (консоль)         | S3-совместимое объектное хранилище для аватаров и скриншотов      |
+| **mailpit** | `axllent/mailpit`                     | `1025` (SMTP), `8025` (веб-интерфейс) | Локальный приемник транзакционных электронных писем               |
+
+Внутренние порты (mongo, redis) по умолчанию не открыты на хосте.
+
+> Порт MinIO `9000` должен быть доступен из браузера, поскольку загруженные активы (аватары, скриншоты) загружаются непосредственно из `S3_PUBLIC_URL=http://localhost:9000/intlayer`.
+
+---
+
+## Переменные окружения
+
+Установщик генерирует готовый к использованию файл `.env`. В таблице ниже описана каждая переменная.
+
+### Обязательные (автоматически генерируемые или запрашиваемые)
+
+| Переменная             | Пример                                          | Описание                                                    |
+| ---------------------- | ----------------------------------------------- | ----------------------------------------------------------- |
+| `NODE_ENV`             | `production`                                    | Среда выполнения                                            |
+| `PORT`                 | `3100`                                          | Порт прослушивания бэкенда                                  |
+| `BACKEND_URL`          | `http://localhost:3100`                         | Публичный URL API бэкенда                                   |
+| `APP_URL`              | `http://localhost:3000`                         | Публичный URL панели управления                             |
+| `DOMAIN`               | `localhost`                                     | Домен для файлов cookie                                     |
+| `MONGODB_URI`          | `mongodb://mongo:27017/intlayer?replicaSet=rs0` | Полный URI для подключения к MongoDB                        |
+| `REDIS_URL`            | `redis://redis:6379`                            | URL для подключения к Redis                                 |
+| `BETTER_AUTH_SECRET`   | _(сгенерирован)_                                | 32-байтный секрет для подписи сессий                        |
+| `MAIL_PROVIDER`        | `smtp`                                          | Транспорт для почты: `smtp` или `resend`                    |
+| `MAIL_SMTP_HOST`       | `mailpit`                                       | Имя хоста SMTP (имя контейнера Mailpit)                     |
+| `MAIL_SMTP_PORT`       | `1025`                                          | Порт SMTP                                                   |
+| `MAIL_FROM`            | `Intlayer <no-reply@localhost>`                 | Адрес отправителя                                           |
+| `S3_ENDPOINT`          | `http://minio:9000`                             | S3-совместимый эндпоинт                                     |
+| `S3_PUBLIC_URL`        | `http://localhost:9000/intlayer`                | Публичный URL для загрузки активов браузером                |
+| `S3_BUCKET_NAME`       | `intlayer`                                      | Имя корзины                                                 |
+| `S3_ACCESS_KEY_ID`     | _(сгенерирован)_                                | Ключ доступа MinIO                                          |
+| `S3_SECRET_ACCESS_KEY` | _(сгенерирован)_                                | Секретный ключ MinIO                                        |
+| `VITE_BACKEND_URL`     | `http://localhost:3100`                         | URL бэкенда, встроенный в панель управления во время сборки |
+| `VITE_DOMAIN`          | `localhost`                                     | Домен, встроенный в панель управления во время сборки       |
+
+### Необязательные (функции работают с ограничениями, если отсутствуют)
+
+| Переменная                                               | Функция                                                                                   |
+| -------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
+| `OPENAI_API_KEY`                                         | Перевод и аудит контента с помощью ИИ                                                     |
+| `STRIPE_SECRET_KEY`, `STRIPE_WEBHOOK_SECRET`, `STRIPE_*` | Управление счетами и подписками                                                           |
+| `RESEND_API_KEY`                                         | Транзакционные электронные письма через Resend (переопределяет Mailpit, если установлено) |
+| `GITHUB_CLIENT_ID`, `GITHUB_CLIENT_SECRET`               | Вход через GitHub OAuth                                                                   |
+| `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`               | Вход через Google OAuth                                                                   |
+| `GITLAB_CLIENT_ID`, `GITLAB_CLIENT_SECRET`               | Вход через GitLab OAuth                                                                   |
+| `MICROSOFT_CLIENT_ID`, `MICROSOFT_CLIENT_SECRET`         | Вход через Microsoft OAuth                                                                |
+| `LINKEDIN_CLIENT_ID`, `LINKEDIN_CLIENT_SECRET`           | Вход через LinkedIn OAuth                                                                 |
+| `ATLASSIAN_CLIENT_ID`, `ATLASSIAN_CLIENT_SECRET`         | Вход через Atlassian OAuth                                                                |
+
+---
+
+## Подключение вашего проекта Intlayer
+
+После запуска стека направьте свой проект на самохостинговый бэкенд и панель управления вместо `intlayer.org`.
+
+### Конфигурация проекта
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  editor: {
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+
+    /**
+     * URL самохостинговой панели управления CMS.
+     * По умолчанию: https://app.intlayer.org
+     */
+    cmsURL: process.env.INTLAYER_CMS_URL, // e.g. http://localhost:3000
+
+    /**
+     * URL самохостингового API бэкенда.
+     * По умолчанию: https://back.intlayer.org
+     */
+    backendURL: process.env.INTLAYER_BACKEND_URL, // e.g. http://localhost:3100
+  },
+};
+
+export default config;
+```
+
+Установите переменные окружения в файле `.env` вашего проекта:
+
+```sh
+INTLAYER_CMS_URL=http://localhost:3000
+INTLAYER_BACKEND_URL=http://localhost:3100
+INTLAYER_CLIENT_ID=<your-client-id>
+INTLAYER_CLIENT_SECRET=<your-client-secret>
+```
+
+Создайте учетные данные доступа на вашей самохостинговой панели управления в разделе **Проекты → Ключи доступа** по адресу `http://localhost:3000/projects`.
+
+### SDK `@intlayer/api`
+
+При программном использовании SDK `@intlayer/api` явно передайте `backendURL`:
+
+```typescript fileName="cms.ts" codeFormat="typescript"
+import { createIntlayerCMS } from "@intlayer/api";
+import { dictionaryEndpoint } from "@intlayer/api/dictionary";
+
+const cms = createIntlayerCMS({
+  editor: {
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+    backendURL: process.env.INTLAYER_BACKEND_URL, // http://localhost:3100
+  },
+});
+
+const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
+```
+
+---
+
+## Обновление
+
+Повторный запуск установщика на существующем развертывании выполняет скользящее обновление:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Это загружает последние образы и перезапускает контейнеры с помощью `docker compose pull && docker compose up -d`. Существующие тома (`mongo-data`, `redis-data`, `minio-data`) сохраняются — потери данных нет.
+
+Для обновления вручную из директории `./intlayer/`:
+
+```sh
+docker compose pull
+docker compose up -d
+```
+
+---
+
+## Резервное копирование и восстановление
+
+Все постоянные данные хранятся в трех именованных томах Docker.
+
+### Резервное копирование
+
+```sh
+docker run --rm \
+  -v intlayer_mongo-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar czf /backup/mongo-data.tar.gz /data
+
+docker run --rm \
+  -v intlayer_redis-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar czf /backup/redis-data.tar.gz /data
+
+docker run --rm \
+  -v intlayer_minio-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar czf /backup/minio-data.tar.gz /data
+```
+
+### Восстановление
+
+```sh
+docker run --rm \
+  -v intlayer_mongo-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar xzf /backup/mongo-data.tar.gz -C /
+
+# Повторите для redis-data и minio-data
+```
+
+---
+
+## Использование обратного прокси (Nginx / Caddy)
+
+Для production развертываний разместите обратный прокси перед контейнерами приложения и бэкенда вместо того, чтобы открывать их напрямую.
+
+### Пример Nginx
+
+```nginx
+server {
+    listen 80;
+    server_name cms.example.com;
+
+    location / {
+        proxy_pass http://localhost:3000;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+    }
+}
+
+server {
+    listen 80;
+    server_name api.example.com;
+
+    location / {
+        proxy_pass http://localhost:3100;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+    }
+}
+```
+
+Обновите следующие переменные `.env`, чтобы они соответствовали вашим публичным доменам:
+
+```sh
+BACKEND_URL=https://api.example.com
+APP_URL=https://cms.example.com
+DOMAIN=example.com
+VITE_BACKEND_URL=https://api.example.com
+VITE_DOMAIN=example.com
+```
+
+> Переменные `VITE_*` встраиваются в образ панели управления во время сборки. Если вы измените их после сборки образа, вам потребуется пересобрать образ `app` (`docker compose build app`) или использовать инъекцию runtime-конфигурации.
+
+---
+
+## Устранение неполадок
+
+### Бэкенд циклически перезапускается при первом запуске
+
+MongoDB и Redis должны быть работоспособны до запуска бэкенда. Файл compose использует `depends_on` с `condition: service_healthy`. Если вы видите повторяющиеся перезапуски бэкенда, убедитесь, что проверки работоспособности `mongo` и `redis` проходят:
+
+```sh
+docker compose ps
+docker compose logs mongo
+docker compose logs redis
+```
+
+### Панель управления не может связаться с API
+
+Убедитесь, что `VITE_BACKEND_URL` соответствует URL, по которому бэкенд доступен из **браузера** (а не из сети Docker). Если вы изменили порт бэкенда или добавили обратный прокси, пересоберите образ панели управления:
+
+```sh
+docker compose build app
+docker compose up -d app
+```
+
+### Электронные письма не отправляются
+
+По умолчанию вся исходящая почта перехватывается Mailpit. Откройте `http://localhost:8025`, чтобы увидеть отправленные сообщения. Для отправки реальных писем установите `MAIL_PROVIDER=resend` и `RESEND_API_KEY=<your-key>` в `.env`, затем перезапустите бэкенд:
+
+```sh
+docker compose restart backend
+```
+
+### Отсутствует корзина MinIO
+
+Если одноразовый сервис `minio-init` не запустился (или запустился до того, как MinIO был готов), создайте корзину вручную:
+
+```sh
+docker compose run --rm minio-init
+```
+
+---
+
+## Полезные ссылки
+
+- [Документация Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_CMS.md)
+- [Справочник по конфигурации](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/configuration.md)
+- [CMS SDK — `@intlayer/api`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_CMS.md#programmatic-access-with-the-intlayerapi-sdk)
+- [Docker Image (aymercizip/intlayer-selfhost)](https://hub.docker.com/repository/docker/aymercizip/intlayer-selfhost/general)

package/docs/tr/bundle_optimization.md

@@ -231,6 +231,9 @@ Next.js, derleme işlemleri için SWC kullandığından, optimize adımı (impor
 
 > Bu eklenti varsayılan olarak yüklenmez çünkü SWC eklentileri Next.js için hala deneysel aşamadadır. İlerleyen zamanlarda bu durum değişebilir.
 
+<Tabs>
+ <Tab value="npm">
+
 ```bash packageManager="npm"
 npm install -D @intlayer/swc
 ```
@@ -247,6 +250,19 @@ pnpm add -D @intlayer/swc
 bun add -d @intlayer/swc
 ```
 
+ </Tab>
+ <Tab value="Crates.io (rust)">
+
+```toml fileName="Cargo.toml"
+[dependencies]
+intlayer-swc-plugin = "*"
+```
+
+[View on Crates.io](https://crates.io/crates/intlayer-swc-plugin)
+
+ </Tab>
+</Tabs>
+
 Yüklendikten sonra Intlayer eklentiyi otomatik olarak algılar ve kullanır.
 
 **Purge ve minify** adımları için (alan kaldırma ve alan yeniden adlandırma), bununla birlikte `@intlayer/babel` paketini de kurun ve Babel eklentilerini ekleyin. Next.js dönüşüm için SWC'yi kullansa da, eklenti yapılandırması için hala `babel.config.js` dosyasını kontrol ettiği için Babel eklentileri SWC'den önceki bir adım olarak çalışır.

package/docs/tr/cli/index.md

@@ -125,7 +125,7 @@ Mevcut dillerin veya diğer parametrelerin nasıl yapılandırılacağını öğ
 
 ### Kimlik Doğrulama
 
-- **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/login.md)** - Intlayer CMS ile kimlik doğrulaması yapın ve erişim kimlik bilgilerini alın
+- **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/cli/login.md)** - Intlayer CMS ile kimlik doğrulaması yapın ve erişim kimlik bilgilerini alın
 
 ### Temel Komutlar
 

package/docs/tr/cli/scan.md

@@ -150,10 +150,10 @@ await scan("https://example.com", {
 });
 ```
 
-Daha düşük seviyeli erişim için, `@intlayer/chokidar/scan` altındaki `scanWebsite` yapılandırılmış bir `ScanResult` nesnesi döndürür:
+Daha düşük seviyeli erişim için, `@intlayer/engine/scan` altındaki `scanWebsite` yapılandırılmış bir `ScanResult` nesnesi döndürür:
 
 ```ts
-import { scanWebsite } from "@intlayer/chokidar/scan";
+import { scanWebsite } from "@intlayer/engine/scan";
 
 const result = await scanWebsite("https://example.com", { deep: false });
 console.log(result.score, result.totalPageSize, result.events);