@intlayer/docs 9.0.0-canary.8 → 9.0.0

package/docs/ja/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の新機能をご覧ください。主要なi18nライブラリ向けのドロップイン互換性パッケージと、コレクション、バリアントのサポートを導入します。
 keywords:
@@ -9,9 +9,11 @@ keywords:
   - Migration
   - Collections
   - Variants
+  - CMS SDK
   - i18next
   - next-intl
   - vue-i18n
+youtubeVideo: https://www.youtube.com/watch?v=ia6JmVf-kkU
 slugs:
   - doc
   - releases
@@ -23,6 +25,14 @@ author: aymericzip
 
 Intlayer v9へようこそ！このメジャーリリースは、主要なi18nライブラリ（`react-i18next`、`next-intl`、`vue-i18n`など）向けの**互換アダプターパッケージ**により、Intlayerへの移行パスを簡素化し、**コレクション**、**バリアント**といったリッチなコンテンツ構造のサポートを追加することで、大きな節目となります。
 
+<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 +119,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",
+  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",
-  content: [
-    {
-      question: t({
-        ja: "Intlayerとは何ですか？",
-        en: "What is Intlayer?",
-        fr: "Qu'est-ce qu'Intlayer ?",
-      }),
-      answer: t({
-        ja: "i18nツールキットです。",
-        en: "An i18n toolkit.",
-        fr: "Une boîte àツール i18n.",
-      }),
-    },
-  ],
+  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
+// Fetch all items as an array
 const allFaqs = useIntlayer("faq"); // -> { question: string, answer: string }[]
 
-// Fetch single item by index
-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. バリアント
@@ -192,28 +206,52 @@ export default {
 ```ts
 // Fetches only the requested item dynamically (requires Suspense)
 const product = useIntlayer("product-copy", {
-  id: "prod_123",
-  category: "books",
+  variant: { id: "prod_123", category: "books" },
 });
 ```
 
 ---
 
-## 動的ロードとバンドルサイズの最適化
-
-バンドルを極めて小さく保つため、Intlayer v9は動的な遅延ロードをサポートしています。
-
-設定で、`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 **バリアント** が表示されたか。フラッシュ間隔内の同一ノードへの重複露出は 1 件に集約されます。
+- **決定論的な A/B 割り当て**: `getVariant(experimentKey, variants)` はサーバーへの往復なしでセッションにバリアントを割り当てるため、初回描画前のちらつきがありません。
+- **`useConversion()`**: セッションが見たバリアントに対して、ゴール（登録、クリック、購入など）を紐づけます。
+- **未インストール時のコストはゼロ**: `@intlayer/editor` と同じ tree-shakeable パターンを採用 — `try/catch` でラップした動的 `import()` に加え、ビルド時の環境変数（`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`の呼び出しをツリーシェイク可能なラッパー（`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 +334,34 @@ npm install intlayer react-native-intlayer
 
 ---
 
+## CMS SDK: Intlayer をヘッドレスコンテンツデータベースとして使う
+
+Intlayer v9 は、CMS をプログラムから操作するためのクリーンで自動認証される SDK を `@intlayer/api` に同梱しています。プロジェクトの取得、辞書の取得、そして自分のサーバー・スクリプト・CI からのプッシュや更新が可能です。認証（OAuth2 `client_credentials`）は自動的に処理・更新されます。
+
+SDK は **2 つの独立したインポート** に分かれており、実際に使用するドメインだけがバンドルに含まれます。
+
+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` をブラウザーに送らないでください。
+
+---
+
 ## v8からの移行に関する注意点
 
 v8からアップグレードする場合、v9には破壊的変更は含まれていません。ただし、主な変更点は次のとおりです。
@@ -310,4 +376,6 @@ v8からアップグレードする場合、v9には破壊的変更は含まれ
 
 - [互換アダプターパッケージガイド](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/compat/index.md)
 - [動的辞書 - コレクション、バリアント](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dynamic_dictionaries/index.md)
+- [Analytics（分析） - コンテンツ露出の計測とA/Bテスト](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md)
 - [設定リファレンス](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/configuration.md)
+- [CMS SDK - @intlayer/api によるプログラムからのアクセス](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_CMS.md)

package/docs/ja/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アカウントを必要とせず、独自のインフラストラクチャ上で完全に実行できます。単一のコマンドで、本番環境に対応したスタックを起動します。
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+インストーラーは `docker-compose.yml` と `.env` をダウンロードし、必要なシークレットを自動生成して、すべてのコンテナを `docker compose up -d` で起動します。
+
+## 目次
+
+<TOC/>
+
+---
+
+## アーキテクチャ
+
+```
+                ┌─────────────────────────────┐
+ browser ──────▶ │  app  (TanStack Start)  :3000│ ──┐
+                └─────────────────────────────┘   │ VITE_BACKEND_URL
+                ┌─────────────────────────────┐   │
+                │  backend (Fastify/Bun)  :3100│ ◀─┘
+                └──────────────┬──────────────┘
+          ┌──────────┬─────────┼──────────┬───────────┐
+          ▼          ▼         ▼          ▼           ▼
+     mongo:27017  redis:6379  minio:9000  mailpit:1025  Chromium
+     (1ノードRS)             (S3 API)     (SMTP)        (インイメージ)
+                             minio:9001   mailpit:8025
+                             (コンソール) (ウェブUI)
+```
+
+Chromium (Puppeteerのスクリーンショット生成に使用) はバックエンドイメージ内にバンドルされており、別のコンテナは必要ありません。
+
+---
+
+## 前提条件
+
+- **Docker** ≥ 24 および **Docker Compose** ≥ v2。いずれかが不足している場合、インストーラーはインストールリンクを表示して終了します。
+- ホスト上でポート `3000`、`3100`、`8025`、`9000`、`9001` が利用可能であること。
+- LinuxまたはmacOSホスト（またはWindows上のWSL2）。
+
+---
+
+## クイックスタート
+
+```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`、メールUI `:8025`、MinIOコンソール `:9001`。
+
+スタックが起動したら、**http://localhost:3000** を開き、最初のIntlayerアカウントを作成してください。
+
+---
+
+## サービス
+
+| サービス    | イメージ                             | ホストポート                     | 目的                                                         |
+| ----------- | ------------------------------------ | -------------------------------- | ------------------------------------------------------------ |
+| **app**     | `apps/app/Dockerfile` からビルド     | `3000`                           | TanStack Start ダッシュボード (CMS UI)                       |
+| **backend** | `apps/backend/Dockerfile` からビルド | `3100`                           | Fastify REST API (`/health` エンドポイント)                  |
+| **mongo**   | `mongo:7`                            | 内部                             | シングルノードレプリカセット (`rs0`)                         |
+| **redis**   | `redis:7-alpine`                     | 内部                             | ジョブキュー (BullMQ) とキャッシュ (ioredis)                 |
+| **minio**   | `minio/minio`                        | `9000` (S3), `9001` (コンソール) | アバターとスクリーンショット用のS3互換オブジェクトストレージ |
+| **mailpit** | `axllent/mailpit`                    | `1025` (SMTP), `8025` (ウェブUI) | ローカルトランザクションメールシンク                         |
+
+内部ポート (mongo, redis) は、デフォルトではホストに公開されません。
+
+> MinIOポート `9000` は、アップロードされたアセット (アバター、スクリーンショット) が `S3_PUBLIC_URL=http://localhost:9000/intlayer` から直接読み込まれるため、ブラウザから到達可能である必要があります。
+
+---
+
+## 環境変数
+
+インストーラーはすぐに使用できる `.env` を生成します。以下の表は、すべての変数について説明しています。
+
+### 必須 (自動生成またはプロンプトによる入力)
+
+| 変数                   | 例                                              | 説明                                                  |
+| ---------------------- | ----------------------------------------------- | ----------------------------------------------------- |
+| `NODE_ENV`             | `production`                                    | ランタイム環境                                        |
+| `PORT`                 | `3100`                                          | バックエンドのリスニングポート                        |
+| `BACKEND_URL`          | `http://localhost:3100`                         | バックエンドAPIの公開URL                              |
+| `APP_URL`              | `http://localhost:3000`                         | ダッシュボードの公開URL                               |
+| `DOMAIN`               | `localhost`                                     | クッキードメイン                                      |
+| `MONGODB_URI`          | `mongodb://mongo:27017/intlayer?replicaSet=rs0` | MongoDBの完全な接続URI                                |
+| `REDIS_URL`            | `redis://redis:6379`                            | Redisの接続URL                                        |
+| `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`                                         | AIアシストによる翻訳とコンテンツ監査                                       |
+| `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,
+
+    /**
+     * 自己ホスト型CMSダッシュボードのURL。
+     * デフォルト: https://app.intlayer.org
+     */
+    cmsURL: process.env.INTLAYER_CMS_URL, // 例: http://localhost:3000
+
+    /**
+     * 自己ホスト型バックエンドAPIのURL。
+     * デフォルト: https://back.intlayer.org
+     */
+    backendURL: process.env.INTLAYER_BACKEND_URL, // 例: 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>
+```
+
+自己ホスト型ダッシュボードの **Projects → Access keys** (`http://localhost:3000/projects`) でアクセス認証情報を作成します。
+
+### `@intlayer/api` SDK
+
+`@intlayer/api` SDKをプログラムで利用する場合は、`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
+```
+
+---
+
+## バックアップと復元
+
+すべての永続データは、3つの名前付き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)
+
+本番環境のデプロイでは、appコンテナとbackendコンテナを直接公開するのではなく、リバースプロキシをそれらの前に配置します。
+
+### 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`)、ランタイム設定インジェクションを使用する必要があります。
+
+---
+
+## トラブルシューティング
+
+### 最初の起動時にバックエンドがクラッシュループする
+
+バックエンドが起動する前に、MongoDBとRedisが正常である必要があります。composeファイルは `condition: service_healthy` とともに `depends_on` を使用しています。バックエンドの再起動が繰り返される場合は、`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` を開いてください。実際のメールを送信するには、`.env` で `MAIL_PROVIDER=resend` と `RESEND_API_KEY=<your-key>` を設定し、バックエンドを再起動します。
+
+```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/ja/intlayer_CMS.md)
+- [設定リファレンス](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/configuration.md)
+- [CMS SDK — `@intlayer/api`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/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/ko/bundle_optimization.md

@@ -231,6 +231,9 @@ Next.js는 빌드 시 SWC를 사용하므로 optimize(가져오기 재작성)
 
 > Next.js에서 SWC 플러그인이 아직 실험 단계이므로 이 플러그인은 기본적으로 설치되지 않습니다. 향후 변경될 수 있습니다.
 
+<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를 사용하지만 플러그인 구성을 위해 `babel.config.js`를 계속 평가하므로 Babel 플러그인은 SWC 이전의 사전 패스(pre-pass)로 실행됩니다.

package/docs/ko/cli/index.md

@@ -125,7 +125,7 @@ Intlayer는 여러 설정 파일 형식을 허용합니다:
 
 ### 인증
 
-- **[로그인](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/login.md)** - Intlayer CMS에 인증하고 액세스 자격 증명을 가져옵니다.
+- **[로그인](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/login.md)** - Intlayer CMS에 인증하고 액세스 자격 증명을 가져옵니다.
 
 ### 핵심 명령어
 

package/docs/ko/cli/scan.md

@@ -150,10 +150,10 @@ await scan("https://example.com", {
 });
 ```
 
-더 낮은 수준의 액세스를 위해 `@intlayer/chokidar/scan`의 `scanWebsite`는 구조화된 `ScanResult` 객체를 반환합니다:
+더 낮은 수준의 액세스를 위해 `@intlayer/engine/scan`의 `scanWebsite`는 구조화된 `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);