@intlayer/docs 9.1.3 → 9.2.0

package/docs/vi/packages/intlayer/getMultilingualUrls.md

@@ -50,26 +50,12 @@ getMultilingualUrls(
 
 ## Tham số
 
-## Tham số
+### Các Tham Số Bắt Buộc
 
 - `url: string`
-  - **Mô tả**: Chuỗi URL gốc sẽ được thêm tiền tố ngôn ngữ.
-  - **Kiểu**: `string`
-
-- `locales: Locales[]`
-  - **Mô tả**: Mảng tùy chọn các ngôn ngữ được hỗ trợ. Mặc định là các ngôn ngữ đã cấu hình trong dự án.
-  - **Kiểu**: `Locales[]`
-  - **Mặc định**: `localesDefault`
-
-- `defaultLocale: Locales`
-  - **Mô tả**: Ngôn ngữ mặc định cho ứng dụng. Mặc định là ngôn ngữ mặc định đã cấu hình trong dự án.
-  - **Kiểu**: `Locales`
-  - **Mặc định**: `defaultLocaleDefault`
-
-- `prefixDefault: boolean`
-  - **Mô tả**: Có thêm tiền tố cho ngôn ngữ mặc định hay không. Mặc định theo giá trị đã cấu hình trong dự án.
-  - **Kiểu**: `boolean`
-  - **Mặc định**: `prefixDefaultDefault`
+  - **Description**: Chuỗi URL gốc được thêm tiền tố với các locale.
+  - **Type**: `string`
+  - **Required**: Yes
 
 ### Tham số tùy chọn
 

package/docs/vi/packages/react-intlayer/useIntlayer.md

@@ -25,9 +25,9 @@ history:
 author: aymericzip
 ---
 
-## Từ điển
+# Tài liệu Hook useIntlayer
 
-Tất cả các khóa từ điển phải được khai báo trong các tệp khai báo nội dung để tăng tính an toàn kiểu và tránh lỗi. Bạn có thể tìm thấy [hướng dẫn thiết lập tại đây](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/content_file.md).
+Hook `useIntlayer` cho phép bạn truy xuất nội dung được bản địa hóa từ một từ điển bằng khóa của nó. Nó dựa trên `useDictionary` nhưng tự động đưa vào một phiên bản tối ưu hóa của từ điển từ các khai báo được tạo ra.
 
 ## Ví dụ sử dụng trong React
 

package/docs/vi/packages/vite-intlayer/exports.md

@@ -48,3 +48,18 @@ import "vite-intlayer";
 | `intlayerProxy`      | Plugin middleware cho môi trường phát triển để xử lý phát hiện locale và định tuyến. | -                                                                                                                      |
 | `intlayerMiddleware` | (**Không còn được khuyến nghị**) Bí danh cho `intlayerProxy`.                        | -                                                                                                                      |
 | `intlayerPrune`      | Plugin để tree-shake và loại bỏ các từ điển không dùng trong quá trình build.        | [intlayerPrune](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/packages/vite-intlayer/intlayerPrune.md) |
+
+### Tiện ích
+
+| Export                       | Mô tả                                                                                                | Tài liệu liên quan                                                                                                     |
+| ---------------------------- | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
+| `createIntlayerProxyHandler` | Trả về middleware Node.js `(req, res, next)` độc lập với framework với logic định tuyến theo locale. | [intlayerProxy](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/packages/vite-intlayer/intlayerProxy.md) |
+
+### Types
+
+| Export                       | Description                                                                                                               |
+| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
+| `IntlayerPluginOptions`      | Các tùy chọn được chấp nhận bởi `intlayer()`. Extends `GetConfigurationOptions` với `compatCallers` và `proxy`.           |
+| `IntlayerProxyPluginOptions` | Các tùy chọn được chấp nhận bởi `intlayerProxy()` và `createIntlayerProxyHandler()`. Bao gồm `ignore` và `configOptions`. |
+| `IntlayerCompilerOptions`    | Các tùy chọn được chấp nhận bởi `intlayerCompiler()`. Bao gồm `configOptions` và `compilerConfig`.                        |
+| `CompatCallerConfig`         | Re-export từ `@intlayer/babel`. Mô tả một compat-adapter caller pattern cho field-usage analysis.                         |

package/docs/vi/packages/vite-intlayer/intlayer.md

@@ -39,11 +39,126 @@ export default defineConfig({
 });
 ```
 
-## Mô tả
+## Tùy chọn
 
-Plugin thực hiện các nhiệm vụ sau:
+```ts
+import type { IntlayerPluginOptions } from "vite-intlayer";
+```
+
+`IntlayerPluginOptions` extends `GetConfigurationOptions` (see `@intlayer/config`) với các trường bổ sung sau:
+
+| Option          | Type                            | Default     | Description                                                                                                                                                                |
+| --------------- | ------------------------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `compatCallers` | `CompatCallerConfig[]`          | `[]`        | Các mẫu caller bổ sung cho các gói compat-adapter (ví dụ: `@intlayer/react-i18next`). Được truyền tới bộ phân tích field-usage tại thời điểm xây dựng.                     |
+| `proxy`         | `{ ignore?: (req) => boolean }` | `undefined` | Các tùy chọn được chuyển tiếp tới proxy định tuyến locale được đóng gói. Sử dụng `ignore` để loại trừ các đường dẫn cụ thể (ví dụ: các API routes) khỏi định tuyến locale. |
+
+Tất cả các tùy chọn khác (`override`, `configFile`, …) được chuyển tiếp trực tiếp tới `getConfiguration()`.
+
+### Ví dụ
+
+#### Bỏ qua các tuyến đường API khỏi định tuyến locale
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
+});
+```
+
+#### Với đường dẫn tệp cấu hình tùy chỉnh
+
+```ts
+export default defineConfig({
+  plugins: [
+    intlayer({
+      configFile: "./config/intlayer.config.ts",
+    }),
+  ],
+});
+```
+
+#### Với compat-adapter callers
+
+```ts
+import { intlayer } from "vite-intlayer";
+import { reactI18nextCallerConfig } from "@intlayer/react-i18next/plugin";
+
+export default defineConfig({
+  plugins: [
+    intlayer({
+      compatCallers: [reactI18nextCallerConfig],
+    }),
+  ],
+});
+```
+
+## Những gì plugin làm
+
+### 1. Chuẩn bị từ điển
+
+Trước khi build bắt đầu (và mỗi giờ một lần trong dev), `intlayer` gọi `prepareIntlayer` để biên dịch tất cả các tệp `.content.ts` thành các từ điển JSON được tối ưu hóa được lưu trữ trong `.intlayer/`.
+
+### 2. Module aliases
+
+Plugin thêm các Vite resolve aliases để `import { myDict } from 'intlayer/dictionaries/my-dict'` giải quyết thành file JSON được biên dịch trên đĩa. SSR builds sử dụng `ssr.noExternal` để đảm bảo tất cả các package `@intlayer/*` được bundle với aliases được áp dụng.
+
+### 3. Dev-server watcher
+
+Ở chế độ phát triển, một `chokidar` watcher được khởi động. Khi một file `.content.ts` thay đổi, các từ điển được biên dịch lại và HMR của Vite truyền bá cập nhật tới trình duyệt.
+
+### 4. Proxy định tuyến locale được đóng gói (v9+)
+
+Kể từ Intlayer v9, middleware `intlayerProxy` được đăng ký tự động bên trong `intlayer()`. Nó xử lý:
+
+- Phát hiện locale từ tiền tố URL, cookies và header `Accept-Language`.
+- Chuyển hướng 301 khi locale được phát hiện không khớp với URL hiện tại.
+- Viết lại URL nội bộ để framework nhìn thấy tham số route `[locale]` chính xác.
+
+Proxy được kiểm soát bởi `routing.enableProxy` (mặc định `true`) trong cấu hình Intlayer của bạn. Để tắt nó hoàn toàn:
+
+```ts
+// intlayer.config.ts
+import { defineConfig } from "intlayer";
+
+export default defineConfig({
+  routing: { enableProxy: false },
+});
+```
+
+Để tùy chỉnh hành vi proxy mà không cần gọi `intlayerProxy()` riêng biệt, hãy truyền các tùy chọn `proxy` cho plugin chính:
+
+```ts
+intlayer({ proxy: { ignore: (req) => req.url?.startsWith("/api") } });
+```
+
+Xem [tài liệu intlayerProxy](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/packages/vite-intlayer/intlayerProxy.md) để tham khảo đầy đủ về hành vi định tuyến.
+
+### 5. Trình biên dịch được đóng gói (v9+)
+
+Khi `compiler.enabled` là `true` **và** `compiler.output` được đặt trong cấu hình Intlayer của bạn, `intlayer()` sẽ tự động đăng ký `intlayerCompiler`. Trình biên dịch trích xuất các khai báo nội dung nội tuyến được viết trực tiếp bên trong các tệp thành phần và ghi chúng vào các từ điển tại thời điểm chuyển đổi. Xem [tài liệu intlayerCompiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/packages/vite-intlayer/intlayerCompiler.md).
+
+### 6. Tối ưu hóa Build
+
+Trong quá trình build production, plugin thêm:
+
+- **intlayerOptimize** – Babel transform viết lại `useIntlayer('key')` → `useDictionary(hash)` và inject các JSON imports trực tiếp.
+- **intlayerPrune** – loại bỏ các content fields không sử dụng từ dictionary JSON.
+- **intlayerMinify** – nén dictionary JSON và tùy chọn mangle tên các field.
+
+Những tính năng này không hoạt động trong chế độ development.
+
+## Các alias không được dùng nữa
 
-1. **Chuẩn bị Từ điển**: Nó biên dịch các từ điển thành các tệp tối ưu hóa khi bắt đầu quá trình build hoặc dev.
-2. **Chế độ theo dõi**: Ở chế độ phát triển, plugin theo dõi các thay đổi trong tệp từ điển và tự động biên dịch lại chúng.
-3. **Bí danh**: Nó cung cấp các bí danh để truy cập các từ điển trong ứng dụng của bạn.
-4. **Tree-shaking**: Nó hỗ trợ tree-shaking các bản dịch không được sử dụng thông qua plugin `intlayerPrune`.
+| Export không được dùng nữa | Thay thế   |
+| -------------------------- | ---------- |
+| `intlayerPlugin`           | `intlayer` |
+| `intLayerPlugin`           | `intlayer` |

package/docs/vi/packages/vite-intlayer/intlayerPrune.md

@@ -30,16 +30,89 @@ Plugin Vite `intlayerPrune` được sử dụng để thực hiện tree-shakin
 
 ## Cách sử dụng
 
+### Như một phần của `intlayer()` (được khuyến nghị)
+
+Bật pruning thông qua cấu hình Intlayer của bạn và plugin chính sẽ xử lý mọi thứ:
+
+```ts
+// intlayer.config.ts
+import { defineConfig } from "intlayer";
+
+export default defineConfig({
+  build: {
+    optimize: true, // kích hoạt cả prune và minify
+  },
+});
+```
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+### Độc lập
+
+Nếu bạn đang soạn stack plugin thủ công, `intlayerPrune` và `intlayerMinify` chia sẻ một object `PruneContext` phải được tạo một lần và truyền cho cả hai:
+
 ```ts
 // vite.config.ts
 import { defineConfig } from "vite";
-import { intlayer, intlayerPrune } from "vite-intlayer";
+import { intlayerPrune, intlayerMinify } from "vite-intlayer";
+import { createPruneContext } from "@intlayer/babel";
+import { getConfiguration } from "@intlayer/config/node";
+
+const intlayerConfig = getConfiguration();
+const pruneContext = createPruneContext();
 
 export default defineConfig({
-  plugins: [intlayer(), intlayerPrune()],
+  plugins: [
+    intlayerPrune(intlayerConfig, pruneContext),
+    intlayerMinify(intlayerConfig, pruneContext), // tuỳ chọn, đọc từ cùng một context
+  ],
 });
 ```
 
-## Mô tả
+## Cách thức hoạt động
+
+### 1. Phân tích cách sử dụng (buildStart)
+
+Trong `buildStart`, plugin `intlayerOptimize` (cũng là một phần của `intlayer()`) quét mọi tệp nguồn component được liệt kê trong `build.filesList`. Với mỗi lệnh gọi `useIntlayer('key')` hoặc `getIntlayer('key')`, nó ghi lại chính xác những trường nào được truy cập, ví dụ:
+
+```ts
+const { title, description } = useIntlayer("myDict");
+// records: myDict → { title, description }
+```
+
+Điều này xây dựng `pruneContext.fieldUsageMap` trước khi bất kỳ lệnh gọi `transform` nào chạy.
+
+### 2. JSON pruning (transform, enforce: 'pre')
+
+When Vite processes a compiled dictionary JSON file, `intlayerPrune` intercepts it before Vite's built-in JSON → ESM conversion. It reads the field-usage map from `pruneContext` and removes any content field that is not in the recorded usage set.
+
+Two content shapes are supported:
+
+- **Static dictionaries** — `{ nodeType: "translation", translation: { en: {...}, fr: {...} } }`. Fields are pruned per-locale inside `translation`.
+- **Dynamic (per-locale) dictionaries** — flat `{ fieldA: ..., fieldB: ... }`. Fields are pruned at the top level.
+
+### 3. Các trường hợp đặc biệt
+
+Nếu cấu trúc nội dung của một dictionary không thể được nhận dạng (ví dụ: một hình dạng lồng ghép không thông thường), nó sẽ được thêm vào `pruneContext.dictionariesWithEdgeCases` và **được để nguyên**. Một cảnh báo sẽ được ghi lại. `intlayerMinify` cũng bỏ qua những dictionary này.
+
+### 4. Field-rename map
+
+Khi pruning thành công, `intlayerPrune` cũng ghi `pruneContext.dictionaryKeyToFieldRenameMap` — một ánh xạ từ tên trường gốc sang các bí danh ngắn. `intlayerMinify` đọc bản đồ này để đổi tên các trường trong JSON đầu ra, và Babel rename pass của `intlayerOptimize` cập nhật các truy cập thuộc tính trong các tệp nguồn tương ứng.
+
+## Điều kiện kích hoạt
+
+`intlayerPrune` được kích hoạt **chỉ khi** tất cả các điều kiện sau đây đều đúng:
+
+1. Lệnh Vite là `build`.
+2. `build.optimize` là `true` (hoặc `undefined`, mặc định là `true` cho các bản build).
+3. `build.purge` là `true` trong cấu hình Intlayer của bạn.
 
-Plugin phân tích mã nguồn của bạn để xác định những khóa dictionary thực sự được sử dụng. Sau đó nó loại bỏ bất kỳ nội dung không được sử dụng khỏi các tệp dictionary đã được bundle. Điều này đặc biệt hữu ích cho các dự án lớn có nhiều dictionary mà chỉ một tập con được sử dụng trong các trang hoặc component cụ thể.
+Nó được tự động **vô hiệu hóa** khi `editor.enabled` là `true` vì trình chỉnh sửa cần toàn bộ nội dung từ điển.

package/docs/vi/plugins/sync-json.md

@@ -170,11 +170,11 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
-### Cách hoạt động
+#### Cách thức hoạt động
 
-- Đọc: plugin phát hiện các tệp JSON từ builder `source` của bạn và tải chúng như các từ điển Intlayer.
-- Ghi: sau khi build và điền, plugin ghi các tệp JSON đã được bản địa hóa trở lại cùng đường dẫn (với một dòng mới cuối cùng để tránh lỗi định dạng).
-- Tự động điền: plugin khai báo một đường dẫn `autoFill` cho mỗi từ điển. Chạy lệnh `intlayer fill` sẽ chỉ cập nhật các bản dịch còn thiếu trong các tệp JSON của bạn theo mặc định.
+- Read: plugin khám phá các tệp JSON từ builder `source` của bạn và tải chúng dưới dạng từ điển Intlayer.
+- Write: sau khi builds và fills, nó ghi JSON được localize trở lại cùng các đường dẫn (với một dòng mới cuối cùng để tránh vấn đề định dạng).
+- Auto‑fill: plugin khai báo đường dẫn `autoFill` cho mỗi từ điển. Chạy `intlayer fill` cập nhật chỉ các bản dịch bị thiếu trong các tệp JSON của bạn theo mặc định.
 
 API:
 
@@ -183,8 +183,8 @@ syncJSON({
   source: ({ key, locale }) => string, // bắt buộc
   location?: string, // nhãn tùy chọn, mặc định: "plugin"
   priority?: number, // ưu tiên tùy chọn để giải quyết xung đột, mặc định: 0
-  format?: 'intlayer' | 'icu' | 'i18next', // bộ định dạng tùy chọn, được sử dụng cho tương thích runtime Intlayer
-  splitKeys?: boolean, // tùy chọn, chia một tệp thành một từ điển cho mỗi khóa cấp cao nhất (tự động phát hiện)
+  format?: 'intlayer' | 'icu' | 'i18next', // formatter tùy chọn, được sử dụng cho tính tương thích runtime của intlayer
+  splitKeys?: boolean, // tùy chọn, chia một tệp duy nhất thành một từ điển cho mỗi khóa cấp cao nhất (tự động phát hiện)
 });
 ```
 

package/docs/vi/releases/v9.md

@@ -362,6 +362,18 @@ await dictionaryEndpoint(cms).pushDictionaries([myDictionary]);
 
 ---
 
+## Tự Hosting
+
+Intlayer v9 cung cấp hỗ trợ hạng nhất cho việc chạy instance Intlayer của riêng bạn với một lệnh duy nhất. Không cần tài khoản Intlayer Cloud.
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Trình cài đặt tải xuống `docker-compose.yml` và `.env`, tự động tạo các secrets cần thiết, và chạy `docker compose up -d`. Mọi thứ — dashboard, API, cơ sở dữ liệu, object storage, và email giao dịch — chạy cục bộ trong các container.
+
+---
+
 ## Lưu ý khi migration từ v8
 
 Nếu bạn đang nâng cấp từ v8, lưu ý rằng v9 không bao gồm các breaking change. Tuy nhiên, dưới đây là các thay đổi chính:

package/docs/vi/self_hosting.md

@@ -64,6 +64,32 @@ Chromium (được sử dụng để tạo ảnh chụp màn hình Puppeteer) đ
 
 ## Bắt đầu nhanh
 
+Pull và chạy image được công bố, cung cấp thông tin xác thực và bí mật MongoDB Atlas của bạn:
+
+```sh
+docker run -d --name intlayer \
+  -p 3000:3000 \
+  -p 3100:3100 \
+  -p 9000:9000 \
+  -p 9001:9001 \
+  -v intlayer-data:/data \
+  -e DB_ID="<atlas-user>" \
+  -e DB_MDP="<atlas-password>" \
+  -e DB_CLUSTER="<cluster>.xxxxx.mongodb.net" \
+  -e BETTER_AUTH_SECRET="$(openssl rand -hex 32)" \
+  -e S3_SECRET_ACCESS_KEY="$(openssl rand -hex 16)" \
+  -e RESEND_API_KEY="<your-resend-key>" \
+  aymericzip/intlayer-selfhost
+```
+
+Sau đó mở **http://localhost:3000**.
+
+> Dashboard được phục vụ trên `localhost`. Xem [Limitations](#limitations) — các miền tùy chỉnh không được hỗ trợ bởi image được công bố.
+
+---
+
+## Bắt đầu nhanh
+
 ```sh
 curl -fsSL https://intlayer.org/install.sh | sh
 ```
@@ -97,9 +123,18 @@ Các cổng nội bộ (mongo, redis) không được phơi bày ra host theo m
 
 ---
 
-## Các biến môi trường
+## Biến môi trường
+
+### Bắt buộc
 
-Trình cài đặt tạo ra một file `.env` sẵn sàng để sử dụng. Bảng dưới đây mô tả từng biến.
+| Variable               | Example                      | Description                                                                                                                                  |
+| ---------------------- | ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
+| `DB_ID`                | `intlayer`                   | MongoDB Atlas user                                                                                                                           |
+| `DB_MDP`               | _(your password)_            | MongoDB Atlas password                                                                                                                       |
+| `DB_CLUSTER`           | `cluster0.xxxxx.mongodb.net` | MongoDB Atlas cluster host (used in the `mongodb+srv://` URI)                                                                                |
+| `BETTER_AUTH_SECRET`   | _(generated)_                | 32-byte secret for session signing                                                                                                           |
+| `S3_SECRET_ACCESS_KEY` | _(generated)_                | Secret for the bundled MinIO                                                                                                                 |
+| `RESEND_API_KEY`       | _(your key)_                 | Transactional email via Resend. Required for first-run setup unless you configure a global SMTP mailer (see [Global mailer](#global-mailer)) |
 
 ### Bắt buộc (tự động tạo hoặc được nhắc nhở)
 
@@ -141,6 +176,26 @@ Trình cài đặt tạo ra một file `.env` sẵn sàng để sử dụng. B
 
 ---
 
+### Mailer toàn cầu
+
+Theo mặc định, tất cả các email giao dịch được gửi qua Resend sử dụng `RESEND_API_KEY`. Các triển khai tự lưu trữ có thể thay vào đó định tuyến **mọi** email — bao gồm các email không thuộc tổ chức như đặt lại mật khẩu và liên kết ma thuật — qua một mailer toàn cầu được định cấu hình bằng các biến môi trường.
+
+Đặt `MAIL_PROVIDER` để kích hoạt nó. Khi không được đặt, mailer Resend mặc định được sử dụng.
+
+| Variable             | Example                        | Description                                                                      |
+| -------------------- | ------------------------------ | -------------------------------------------------------------------------------- |
+| `MAIL_PROVIDER`      | `smtp`                         | Vận chuyển toàn cầu: `smtp` hoặc `resend`. Để không được đặt để sử dụng mặc định |
+| `MAIL_FROM`          | `Intlayer <no-reply@acme.com>` | Tiêu đề người gửi. Chấp nhận địa chỉ đơn thuần hoặc định dạng `Name <email>`     |
+| `MAIL_SMTP_HOST`     | `smtp.acme.com`                | SMTP host (bắt buộc khi `MAIL_PROVIDER=smtp`)                                    |
+| `MAIL_SMTP_PORT`     | `587`                          | SMTP port (mặc định là `587`)                                                    |
+| `MAIL_SMTP_SECURE`   | `false`                        | TLS ẩn. Đặt `true` cho cổng `465`                                                |
+| `MAIL_SMTP_USER`     | _(your user)_                  | Tên người dùng SMTP (tùy chọn; bỏ qua đối với relay không xác thực)              |
+| `MAIL_SMTP_PASSWORD` | _(your password)_              | Mật khẩu SMTP                                                                    |
+
+> Thứ tự ưu tiên: mailer riêng của một tổ chức (được định cấu hình từ bảng điều khiển **Organization**) có ưu tiên hơn mailer toàn cầu, cái này lần lượt có ưu tiên hơn khóa Resend mặc định.
+
+---
+
 ## Kết nối dự án Intlayer của bạn
 
 Khi stack đang chạy, hãy trỏ dự án của bạn đến backend và dashboard được tự host thay vì `intlayer.org`.
@@ -259,47 +314,11 @@ docker run --rm \
 
 ---
 
-## Sử dụng reverse proxy (Nginx / Caddy)
-
-Đối với các triển khai production, hãy đặt một reverse proxy phía trước các container app và backend thay vì phơi bày chúng trực tiếp.
-
-### Ví dụ 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;
-    }
-}
+## Hạn chế
 
-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;
-    }
-}
-```
-
-Cập nhật các biến `.env` sau để khớp với các miền công khai của bạn:
-
-```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
-```
-
-> Các biến `VITE_*` được tích hợp vào image dashboard tại thời điểm build. Nếu bạn thay đổi chúng sau khi image được build, bạn cần build lại image `app` (`docker compose build app`) hoặc sử dụng cấu hình runtime injection.
+- **MongoDB phải là external (Atlas).** Backend chỉ kết nối qua `mongodb+srv://` (được xây dựng từ `DB_ID` / `DB_MDP` / `DB_CLUSTER`), do đó `mongodb://host:27017` đơn giản — bao gồm cả `mongod` được bao gồm của container — không thể được sử dụng. Cung cấp một cluster MongoDB Atlas.
+- **Không có tên miền tùy chỉnh.** Tất cả các `VITE_*` URLs hướng tới trình duyệt được nhúng inline vào ứng dụng tại thời điểm xây dựng, và hình ảnh được xuất bản có các giá trị `localhost`. Dashboard phải được truy cập tại `http://localhost:3000`; phục vụ nó trên một tên miền công khai sẽ yêu cầu xây dựng lại hình ảnh với các URL mục tiêu được xây dựng sẵn và không được hỗ trợ ra khỏi hộp.
+- **Email yêu cầu một mailer hoạt động.** Thiết lập lần chạy đầu tiên thực thi xác minh email, do đó `RESEND_API_KEY` hoặc một [mailer SMTP toàn cục](#global-mailer) (`MAIL_PROVIDER=smtp` + `MAIL_SMTP_*`) phải được cấu hình. Sau khi admin đầu tiên đăng nhập, mỗi tổ chức cũng có thể cấu hình mailer SMTP hoặc Resend riêng của nó từ dashboard.
 
 ---
 
@@ -324,14 +343,6 @@ docker compose build app
 docker compose up -d app
 ```
 
-### Email không gửi được
-
-Theo mặc định, tất cả email gửi đi được Mailpit thu nhận. Mở `http://localhost:8025` để xem các tin nhắn đã gửi. Để gửi email thật, hãy đặt `MAIL_PROVIDER=resend` và `RESEND_API_KEY=<your-key>` trong `.env`, sau đó khởi động lại backend:
-
-```sh
-docker compose restart backend
-```
-
 ### Thiếu MinIO bucket
 
 Nếu dịch vụ một lần chạy `minio-init` không chạy (hoặc chạy trước khi MinIO sẵn sàng), hãy tạo bucket thủ công:

package/docs/zh/CI_CD.md

@@ -30,6 +30,10 @@ Intlayer 允许自动生成内容声明文件的翻译。根据您的工作流
 
 使用 Intlayer，你可以采用一种工作流程，其中只需在本地声明单一语言环境，而所有翻译都通过 CMS 远程管理。这允许内容和翻译与代码库完全分离，为内容编辑提供更多灵活性，并支持 Live Sync（无需重新构建应用程序即可应用更改）。
 
+## 使用 CMS
+
+使用 Intlayer，您可以采用一种工作流程，其中仅在本地声明单个语言环境，而所有翻译都通过 CMS 远程管理。这样可以使内容和翻译完全与代码库分离，为内容编辑人员提供更多灵活性，并支持实时同步（无需重建应用程序即可应用更改）。
+
 ### 示例配置
 
 ```ts fileName="intlayer.config.ts"