@intlayer/docs 9.0.0-canary.9 → 9.0.1

package/docs/pt/releases/v9.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-26
+updatedAt: 2026-07-08
 title: Novo Intlayer v9 - O que há de novo?
 description: Descubra o que há de novo no Intlayer v9. Apresentando pacotes de compatibilidade drop-in para bibliotecas i18n populares e suporte para Collections e Variants.
 keywords:
@@ -9,9 +9,13 @@ keywords:
   - Migration
   - Collections
   - Variants
+  - CMS SDK
+  - Self-Hosting
+  - Docker
   - i18next
   - next-intl
   - vue-i18n
+youtubeVideo: https://www.youtube.com/watch?v=zmCN4z_B4jk
 slugs:
   - doc
   - releases
@@ -23,6 +27,14 @@ author: aymericzip
 
 Bem-vindo ao Intlayer v9! Este grande lançamento marca um marco enorme na simplificação do caminho de migração para o Intlayer com **Compat Adapter Packages** para as principais bibliotecas de i18n (`react-i18next`, `next-intl`, `vue-i18n`, etc.) e adiciona suporte para estruturas de conteúdo ricas: **Collections** e **Variants**.
 
+<iframe
+  src="https://www.youtube.com/embed/zmCN4z_B4jk"
+  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"
+/>
+
 ## Tabela de conteúdos
 
 <TOC levels={[2]} maxDepth={1} />
@@ -109,36 +121,40 @@ O Intlayer v9 vai além de objetos estáticos de chave-valor, permitindo que os
 
 Defina uma lista gerenciada por CMS de itens ordenados (ex: FAQs, produtos ou listas de blog):
 
-```ts fileName="faq.content.ts"
+```ts fileName="faq.1.content.ts"
 import { t, type Dictionary } from "intlayer";
 
 export default {
   key: "faq",
-  content: [
-    {
-      question: t({
-        pt: "O que é o Intlayer?",
-        en: "What is Intlayer?",
-        fr: "Qu'est-ce qu'Intlayer ?",
-      }),
-      answer: t({
-        pt: "Um kit de ferramentas 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;
 ```
 
 #### Uso:
 
 ```ts
-// Buscar todos os itens
+// Fetch all items as an array
 const allFaqs = useIntlayer("faq"); // -> { question: string, answer: string }[]
 
-// Buscar um único item por índice
-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
 // Busca apenas o item solicitado dinamicamente (requer Suspense)
 const product = useIntlayer("product-copy", {
-  id: "prod_123",
-  category: "books",
+  variant: { id: "prod_123", category: "books" },
 });
 ```
 
 ---
 
-## Carregamento Dinâmico & Otimizações de Tamanho de Bundle
-
-Para manter os bundles extremamente pequenos, o Intlayer v9 suporta dynamic lazy loading.
-
-Na sua configuração, defina `importMode` como `'dynamic'` ou `'fetch'`:
-
-```ts fileName="intlayer.config.ts"
-export default {
-  dictionary: {
-    importMode: "dynamic", // "static" | "dynamic" | "fetch"
-  },
+## `@intlayer/analytics`: rastreamento de exposição de conteúdo e testes A/B
+
+Um novo pacote opcional, [`@intlayer/analytics`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md), mostra qual conteúdo é realmente exibido aos seus visitantes — e fecha o ciclo com **Collections & Variants**, permitindo testar conteúdo em A/B e medir conversões por variante.
+
+- **Rastreamento em nível de provider**: `IntlayerProvider` (React / Next.js / React Native) registra automaticamente eventos `page_view` no carregamento, na mudança de rota e na mudança de idioma.
+- **Rastreamento em nível de nó**: cada resolução de `useIntlayer` reporta um evento `content_exposure` — qual chave de dicionário, caminho de chave, idioma e, quando aplicável, qual **variante** A/B foi exibida. Exposições repetidas do mesmo nó dentro de uma janela de envio são combinadas em um único evento.
+- **Atribuição determinística de A/B**: `getVariant(experimentKey, variants)` atribui uma variante a cada sessão **sem ida e volta ao servidor**, portanto não há cintilação antes da primeira renderização.
+- **`useConversion()`**: atribui uma meta (cadastro, clique, compra…) à variante à qual a sessão foi exposta.
+- **Custo zero quando não instalado**: mesmo padrão tree-shakeable do `@intlayer/editor` — `import()` dinâmico envolto em `try/catch`, mais uma variável de ambiente em tempo de compilação (`INTLAYER_ANALYTICS_ENABLED`) que elimina completamente a integração do bundle para apps que não a ativam.
+- **Sem novo esquema de configuração**: reutiliza `editor.backendURL` (endpoint de ingestão / auto-hospedagem) e `editor.clientId` (chave do projeto, também o interruptor de ativação).
+- **Respeita a privacidade**: hash anônimo de sessão (SHA-256, sem armazenar ids brutos), sem armazenamento de IP, geolocalização aproximada apenas por país, requisições enviadas em lote a cada ~20 segundos.
+- **Painel**: uma nova página **Analytics** (exibida na barra lateral assim que um projeto é selecionado) mostra usuários ativos, usuários de hoje, usuários dos últimos 7/30/90 dias, um gráfico de evolução de visitantes e a divisão por idioma e localização.
+
+```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>
+  );
 };
 ```
 
-Em tempo de build, o `@intlayer/swc` e o `@intlayer/babel` escaneiam seus arquivos e substituem as chamadas de `useIntlayer` / `getIntlayer` por wrappers tree-shakeable (`useDictionary` / `useDictionaryDynamic`). Apenas o conteúdo necessário para o item da coleção, variante ou locale selecionado é carregado, evitando que seu bundle de produção contenha traduções não utilizadas.
+```bash packageManager="npm"
+npm install @intlayer/analytics
+```
+
+Já disponível para React, Next.js e React Native (via `react-intlayer`); outras integrações de frameworks (Vue, Svelte, Angular, …) estão planejadas, seguindo o mesmo padrão de lançamento do `@intlayer/editor`. Consulte a [documentação do Analytics](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md) para o guia completo.
 
 ---
 
@@ -296,13 +336,68 @@ npm install intlayer react-native-intlayer
 
 ---
 
+## SDK do CMS: use o Intlayer como um banco de dados de conteúdo headless
+
+O Intlayer v9 traz um SDK limpo e com autenticação automática em `@intlayer/api` para interagir com o CMS de forma programática — buscar projetos, buscar dicionários e enviá-los ou atualizá-los a partir do seu próprio servidor, scripts ou CI. A autenticação (OAuth2 `client_credentials`) é tratada e renovada para você.
+
+O SDK é dividido em **duas importações separadas**, para que seu bundle inclua apenas os domínios que você realmente usa:
+
+1. `createIntlayerCMS` — um **autenticador** leve que guarda as credenciais e o token gerenciado (nenhum cliente de domínio incluído).
+2. `dictionaryEndpoint`, `projectEndpoint`, … — **vinculadores de endpoint** por domínio, cada um importado de seu próprio subcaminho.
+
+```ts fileName="cms.ts"
+import { createIntlayerCMS } from "@intlayer/api";
+import { dictionaryEndpoint } from "@intlayer/api/dictionary";
+
+// A configuração é opcional: as credenciais recorrem a INTLAYER_CLIENT_ID /
+// INTLAYER_CLIENT_SECRET resolvidos por `@intlayer/config/built`.
+const cms = createIntlayerCMS();
+
+// Leitura
+const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
+
+// Escrita — use o CMS como um banco de dados
+await dictionaryEndpoint(cms).pushDictionaries([myDictionary]);
+```
+
+> Segurança: as credenciais do CMS concedem acesso de escrita ao seu conteúdo. Crie o autenticador sempre **no lado do servidor** — nunca envie `clientId` / `clientSecret` para o navegador.
+
+---
+
+## Auto-hospedagem
+
+O Intlayer v9 traz suporte de primeira classe para executar sua própria instância do Intlayer com um único comando — sem necessidade de conta no Intlayer Cloud.
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+O instalador baixa um `docker-compose.yml` e um `.env`, gera automaticamente os secrets necessários e executa `docker compose up -d`. Tudo — o dashboard, a API, o banco de dados, o armazenamento de objetos e o e-mail transacional — roda localmente em contêineres.
+
+### Serviços incluídos
+
+| Serviço                                 | Finalidade                                                                      |
+| --------------------------------------- | ------------------------------------------------------------------------------- |
+| **app** (TanStack Start)                | Interface do dashboard na porta `3000`                                          |
+| **backend** (Fastify/Bun)               | API REST na porta `3100`                                                        |
+| **MongoDB 7** (single-node replica set) | Banco de dados principal                                                        |
+| **Redis 7**                             | Filas de tarefas e cache                                                        |
+| **MinIO**                               | Armazenamento de objetos compatível com S3 (avatares, capturas de tela)         |
+| **Mailpit**                             | Sumidouro SMTP local + interface web para e-mails transacionais na porta `8025` |
+
+O Chromium (usado para geração de capturas de tela com Puppeteer) está incluído na imagem do backend — nenhum contêiner adicional é necessário.
+
+---
+
 ## Notas de migração da v8
 
 Se você estiver atualizando da v8, observe que a v9 não inclui breaking changes. Mas aqui estão as principais mudanças:
 
 - **Compilador desativado por padrão**: `compiler.enabled` agora tem o valor padrão `false`. Se você depende da extração dos seus arquivos `.content.ts` em tempo de build, defina `compiler.enabled: true` no seu `intlayer.config.ts`.
+- **Plugin Vite**: O compilador e o proxy de roteamento de locale agora estão integrados em `intlayer()`. Se você registrou anteriormente `intlayerCompiler()` ou `intlayerProxy()` manualmente, pode removê-los — eles são deduplicados automaticamente, então mantê-los não causa problemas. Use `routing.enableProxy: false` para desativar o proxy.
 - **Locales & Dialects**: Se estiver usando dependências externas de i18n, adicione seus respectivos plugins de compatibilidade na sua configuração ou setup do bundler para reescrever os imports automaticamente.
 - **Custom Selectors**: Ao chamar `useIntlayer`, o segundo parâmetro agora é reservado para um objeto de opções contendo `{ locale, item, variant }`. Se você passava anteriormente uma string de locale diretamente, ainda pode fazer isso, mas o uso do objeto de opções é recomendado para seleções avançadas.
+- **React Native**: `react-native-intlayer` agora reexporta toda a API do `react-intlayer`. Em um aplicativo React Native, importe tudo de `react-native-intlayer` e remova a dependência direta de `react-intlayer`. Os imports existentes de `react-intlayer` continuam funcionando.
 
 ---
 
@@ -310,4 +405,7 @@ Se você estiver atualizando da v8, observe que a v9 não inclui breaking change
 
 - [Guia de Compat Adapter Packages](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/compat/index.md)
 - [Dicionários Dinâmicos - Collections & Variants](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dynamic_dictionaries/index.md)
+- [Analytics - Rastreamento de exposição de conteúdo e testes A/B](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md)
 - [Referência de Configuração](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/configuration.md)
+- [SDK do CMS - Acesso programático com @intlayer/api](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_CMS.md)
+- [Guia de Auto-hospedagem](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/self_hosting.md)

package/docs/pt/self_hosting.md

@@ -0,0 +1,350 @@
+---
+createdAt: 2026-06-30
+updatedAt: 2026-06-30
+title: Auto-hospedagem do Intlayer
+description: Execute uma instância completa do Intlayer na sua própria infraestrutura com um único comando. Nenhuma conta Intlayer Cloud é necessária.
+keywords:
+  - Auto-hospedagem
+  - Docker
+  - Docker Compose
+  - Intlayer
+  - CMS
+  - Instalação
+  - Infraestrutura
+slugs:
+  - doc
+  - self-hosting
+author: aymericzip
+---
+
+# Auto-hospedagem do Intlayer
+
+O Intlayer pode ser executado inteiramente na sua própria infraestrutura — nenhuma conta Intlayer Cloud é necessária. Um único comando inicializa uma stack pronta para produção:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+O instalador baixa um `docker-compose.yml` e um `.env`, gera automaticamente os segredos necessários e inicia todos os containers com `docker compose up -d`.
+
+## Sumário
+
+<TOC/>
+
+---
+
+## Arquitetura
+
+```
+                ┌─────────────────────────────┐
+ browser ──────▶ │  app  (TanStack Start)  :3000│ ──┐
+                └─────────────────────────────┘   │ VITE_BACKEND_URL
+                ┌─────────────────────────────┐   │
+                │  backend (Fastify/Bun)  :3100│ ◀─┘
+                └──────────────┬──────────────┘
+          ┌──────────┬─────────┼──────────┬───────────┐
+          ▼          ▼         ▼          ▼           ▼
+     mongo:27017  redis:6379  minio:9000  mailpit:1025  Chromium
+     (1-node RS)             (S3 API)     (SMTP)        (in-image)
+                             minio:9001   mailpit:8025
+                             (console)    (web UI)
+```
+
+O Chromium (usado para a geração de screenshots do Puppeteer) é empacotado dentro da imagem do backend — nenhum container separado é necessário.
+
+---
+
+## Pré-requisitos
+
+- **Docker** ≥ 24 e **Docker Compose** ≥ v2. Se algum deles estiver faltando, o instalador exibe o link de instalação e sai.
+- Portas `3000`, `3100`, `8025`, `9000` e `9001` disponíveis no host.
+- Um host Linux ou macOS (ou WSL2 no Windows).
+
+---
+
+## Início rápido
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+O que o instalador faz:
+
+1. Verifica se `docker` e `docker compose` estão presentes.
+2. Baixa `docker-compose.yml` e `.env.example` para `./intlayer/`.
+3. Se nenhum `.env` existir, copia o exemplo e gera segredos aleatórios para `BETTER_AUTH_SECRET`, `S3_ACCESS_KEY_ID` e `S3_SECRET_ACCESS_KEY` via `openssl rand`.
+4. Executa `docker compose pull` + `docker compose up -d`.
+5. Imprime as URLs: dashboard `:3000`, API `:3100`, UI de e-mail `:8025`, console MinIO `:9001`.
+
+Após a stack estar ativa, abra **http://localhost:3000** e crie sua primeira conta.
+
+---
+
+## Serviços
+
+| Serviço     | Imagem                               | Porta(s) do Host               | Finalidade                                                             |
+| ----------- | ------------------------------------ | ------------------------------ | ---------------------------------------------------------------------- |
+| **app**     | built from `apps/app/Dockerfile`     | `3000`                         | Dashboard TanStack Start (UI do CMS)                                   |
+| **backend** | built from `apps/backend/Dockerfile` | `3100`                         | API REST Fastify (endpoint `/health`)                                  |
+| **mongo**   | `mongo:7`                            | internal                       | Conjunto de réplicas de nó único (`rs0`)                               |
+| **redis**   | `redis:7-alpine`                     | internal                       | Filas de trabalho (BullMQ) e cache (ioredis)                           |
+| **minio**   | `minio/minio`                        | `9000` (S3), `9001` (console)  | Armazenamento de objetos compatível com S3 para avatares e screenshots |
+| **mailpit** | `axllent/mailpit`                    | `1025` (SMTP), `8025` (web UI) | Sink local de e-mail transacional                                      |
+
+As portas internas (mongo, redis) não são expostas ao host por padrão.
+
+> A porta `9000` do MinIO deve ser acessível pelo navegador porque os ativos carregados (avatares, screenshots) são carregados diretamente de `S3_PUBLIC_URL=http://localhost:9000/intlayer`.
+
+---
+
+## Variáveis de ambiente
+
+O instalador gera um arquivo `.env` pronto para uso. A tabela abaixo descreve cada variável.
+
+### Obrigatórias (auto-geradas ou solicitadas)
+
+| Variável               | Exemplo                                         | Descrição                                                        |
+| ---------------------- | ----------------------------------------------- | ---------------------------------------------------------------- |
+| `NODE_ENV`             | `production`                                    | Ambiente de tempo de execução                                    |
+| `PORT`                 | `3100`                                          | Porta de escuta do backend                                       |
+| `BACKEND_URL`          | `http://localhost:3100`                         | URL pública da API do backend                                    |
+| `APP_URL`              | `http://localhost:3000`                         | URL pública do dashboard                                         |
+| `DOMAIN`               | `localhost`                                     | Domínio do cookie                                                |
+| `MONGODB_URI`          | `mongodb://mongo:27017/intlayer?replicaSet=rs0` | URI de conexão completa do MongoDB                               |
+| `REDIS_URL`            | `redis://redis:6379`                            | URL de conexão do Redis                                          |
+| `BETTER_AUTH_SECRET`   | _(generated)_                                   | Segredo de 32 bytes para assinatura de sessão                    |
+| `MAIL_PROVIDER`        | `smtp`                                          | Transporte de e-mail: `smtp` ou `resend`                         |
+| `MAIL_SMTP_HOST`       | `mailpit`                                       | Nome de host SMTP (nome do container Mailpit)                    |
+| `MAIL_SMTP_PORT`       | `1025`                                          | Porta SMTP                                                       |
+| `MAIL_FROM`            | `Intlayer <no-reply@localhost>`                 | Endereço do remetente                                            |
+| `S3_ENDPOINT`          | `http://minio:9000`                             | Endpoint compatível com S3                                       |
+| `S3_PUBLIC_URL`        | `http://localhost:9000/intlayer`                | URL pública para carregamento de ativos no navegador             |
+| `S3_BUCKET_NAME`       | `intlayer`                                      | Nome do bucket                                                   |
+| `S3_ACCESS_KEY_ID`     | _(generated)_                                   | Chave de acesso do MinIO                                         |
+| `S3_SECRET_ACCESS_KEY` | _(generated)_                                   | Chave secreta do MinIO                                           |
+| `VITE_BACKEND_URL`     | `http://localhost:3100`                         | URL do backend incorporada ao dashboard no momento da compilação |
+| `VITE_DOMAIN`          | `localhost`                                     | Domínio incorporado ao dashboard no momento da compilação        |
+
+### Opcionais (recursos são degradados graciosamente quando ausentes)
+
+| Variável                                                 | Recurso                                                              |
+| -------------------------------------------------------- | -------------------------------------------------------------------- |
+| `OPENAI_API_KEY`                                         | Tradução assistida por IA e auditoria de conteúdo                    |
+| `STRIPE_SECRET_KEY`, `STRIPE_WEBHOOK_SECRET`, `STRIPE_*` | Gerenciamento de faturamento e assinaturas                           |
+| `RESEND_API_KEY`                                         | E-mail transacional via Resend (sobrescreve Mailpit quando definido) |
+| `GITHUB_CLIENT_ID`, `GITHUB_CLIENT_SECRET`               | Login OAuth do GitHub                                                |
+| `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`               | Login OAuth do Google                                                |
+| `GITLAB_CLIENT_ID`, `GITLAB_CLIENT_SECRET`               | Login OAuth do GitLab                                                |
+| `MICROSOFT_CLIENT_ID`, `MICROSOFT_CLIENT_SECRET`         | Login OAuth da Microsoft                                             |
+| `LINKEDIN_CLIENT_ID`, `LINKEDIN_CLIENT_SECRET`           | Login OAuth do LinkedIn                                              |
+| `ATLASSIAN_CLIENT_ID`, `ATLASSIAN_CLIENT_SECRET`         | Login OAuth da Atlassian                                             |
+
+---
+
+## Conectando seu projeto Intlayer
+
+Uma vez que a stack esteja em execução, aponte seu projeto para o backend e dashboard auto-hospedados em vez de `intlayer.org`.
+
+### Configuração do projeto
+
+```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 do dashboard CMS auto-hospedado.
+     * Padrão: https://app.intlayer.org
+     */
+    cmsURL: process.env.INTLAYER_CMS_URL, // e.g. http://localhost:3000
+
+    /**
+     * URL da API do backend auto-hospedado.
+     * Padrão: https://back.intlayer.org
+     */
+    backendURL: process.env.INTLAYER_BACKEND_URL, // e.g. http://localhost:3100
+  },
+};
+
+export default config;
+```
+
+Defina as variáveis de ambiente no arquivo `.env` do seu projeto:
+
+```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>
+```
+
+Crie credenciais de acesso no seu dashboard auto-hospedado em **Projetos → Chaves de acesso** em `http://localhost:3000/projects`.
+
+### SDK `@intlayer/api`
+
+Ao usar o SDK `@intlayer/api` programaticamente, passe `backendURL` explicitamente:
+
+```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();
+```
+
+---
+
+## Atualizando
+
+Reexecutar o instalador em uma implantação existente realiza uma atualização contínua:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Isso baixa as imagens mais recentes e reinicia os containers com `docker compose pull && docker compose up -d`. Os volumes existentes (`mongo-data`, `redis-data`, `minio-data`) são preservados — sem perda de dados.
+
+Para atualizar manualmente de dentro do diretório `./intlayer/`:
+
+```sh
+docker compose pull
+docker compose up -d
+```
+
+---
+
+## Backup e restauração
+
+Todos os dados persistentes residem em três volumes Docker nomeados.
+
+### Backup
+
+```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
+```
+
+### Restauração
+
+```sh
+docker run --rm \
+  -v intlayer_mongo-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar xzf /backup/mongo-data.tar.gz -C /
+
+# Repita para redis-data e minio-data
+```
+
+---
+
+## Usando um proxy reverso (Nginx / Caddy)
+
+Para implantações em produção, coloque um proxy reverso na frente dos containers do aplicativo e do backend, em vez de expô-los diretamente.
+
+### Exemplo de 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;
+    }
+}
+```
+
+Atualize as seguintes variáveis `.env` para corresponder aos seus domínios públicos:
+
+```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
+```
+
+> As variáveis `VITE_*` são incorporadas à imagem do dashboard no momento da compilação. Se você as alterar após a imagem ser construída, precisará reconstruir a imagem do `app` (`docker compose build app`) ou usar a injeção de configuração em tempo de execução.
+
+---
+
+## Solução de problemas
+
+### Backend em loop de falha na primeira inicialização
+
+MongoDB e Redis devem estar saudáveis antes que o backend possa iniciar. O arquivo compose usa `depends_on` com `condition: service_healthy`. Se você notar reinícios repetidos do backend, verifique se os healthchecks do `mongo` e `redis` estão passando:
+
+```sh
+docker compose ps
+docker compose logs mongo
+docker compose logs redis
+```
+
+### Dashboard não consegue acessar a API
+
+Verifique se `VITE_BACKEND_URL` corresponde à URL onde o backend é acessível a partir do **navegador** (não da rede Docker). Se você alterou a porta do backend ou adicionou um proxy reverso, reconstrua a imagem do dashboard:
+
+```sh
+docker compose build app
+docker compose up -d app
+```
+
+### E-mail não está sendo enviado
+
+Por padrão, todos os e-mails de saída são capturados pelo Mailpit. Abra `http://localhost:8025` para ver as mensagens enviadas. Para enviar e-mails reais, defina `MAIL_PROVIDER=resend` e `RESEND_API_KEY=<sua-chave>` no `.env`, então reinicie o backend:
+
+```sh
+docker compose restart backend
+```
+
+### Bucket MinIO ausente
+
+Se o serviço `minio-init` de execução única não foi executado (ou executou antes que o MinIO estivesse pronto), crie o bucket manualmente:
+
+```sh
+docker compose run --rm minio-init
+```
+
+---
+
+## Links úteis
+
+- [Documentação do Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_CMS.md)
+- [Referência de configuração](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/configuration.md)
+- [SDK do CMS — `@intlayer/api`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/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/ru/bundle_optimization.md

@@ -231,6 +231,9 @@ Next.js требует использования плагина `@intlayer/swc`
 
 > Этот плагин не устанавливается по умолчанию, поскольку плагины SWC всё еще находятся на стадии эксперимента для Next.js. Это может измениться в будущем.
 
+<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>
+
 После установки Intlayer автоматически обнаружит и использует этот плагин.
 
 Для выполнения **удаления (purge) и минификации (minify)** (удаления полей и их переименования), установите `@intlayer/babel` параллельно с вышеуказанным и добавьте плагины Babel. Поскольку Next.js использует SWC для преобразований, но по-прежнему вычисляет (evaluates) `babel.config.js` для конфигурации плагинов, плагины Babel запускаются в качестве предварительного этапа до SWC.

package/docs/ru/cli/index.md

@@ -125,7 +125,7 @@ Intlayer принимает несколько форматов файлов к
 
 ### Аутентификация
 
-- **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/login.md)** - Аутентификация в Intlayer CMS и получение учетных данных для доступа
+- **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/login.md)** - Аутентификация в Intlayer CMS и получение учетных данных для доступа
 
 ### Основные команды
 

package/docs/ru/cli/scan.md

@@ -150,10 +150,10 @@ await scan("https://example.com", {
 });
 ```
 
-Для более низкоуровневого доступа функция `scanWebsite` из модуля `@intlayer/chokidar/scan` возвращает структурированный объект `ScanResult`:
+Для более низкоуровневого доступа функция `scanWebsite` из модуля `@intlayer/engine/scan` возвращает структурированный объект `ScanResult`:
 
 ```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);