@intlayer/docs 9.1.3 → 9.3.0

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

@@ -48,3 +48,18 @@ import "vite-intlayer";
 | `intlayerProxy`      | डेवलपमेंट मिडलवेयर प्लगइन जो locale detection और routing को संभालता है।       | -                                                                                                                      |
 | `intlayerMiddleware` | (**अप्रचलित**) `intlayerProxy` के लिए उपनाम।                                  | -                                                                                                                      |
 | `intlayerPrune`      | बिल्ड के दौरान अप्रयुक्त शब्दकोशों को tree-shake और prune करने के लिए प्लगइन। | [intlayerPrune](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/packages/vite-intlayer/intlayerPrune.md) |
+
+### उपयोगिताएँ
+
+| Export                       | Description                                                                                                | Related Doc                                                                                                            |
+| ---------------------------- | ---------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
+| `createIntlayerProxyHandler` | एक framework-agnostic Node.js `(req, res, next)` middleware को locale-routing logic के साथ return करता है। | [intlayerProxy](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/packages/vite-intlayer/intlayerProxy.md) |
+
+### Types
+
+| Export                       | Description                                                                                                           |
+| ---------------------------- | --------------------------------------------------------------------------------------------------------------------- |
+| `IntlayerPluginOptions`      | `intlayer()` द्वारा स्वीकृत विकल्प। `GetConfigurationOptions` को `compatCallers` और `proxy` के साथ विस्तारित करता है। |
+| `IntlayerProxyPluginOptions` | `intlayerProxy()` और `createIntlayerProxyHandler()` द्वारा स्वीकृत विकल्प। `ignore` और `configOptions` शामिल हैं।     |
+| `IntlayerCompilerOptions`    | `intlayerCompiler()` द्वारा स्वीकृत विकल्प। `configOptions` और `compilerConfig` शामिल हैं।                            |
+| `CompatCallerConfig`         | `@intlayer/babel` से पुनः निर्यात। फ़ील्ड-उपयोग विश्लेषण के लिए एक compat-adapter caller पैटर्न का वर्णन करता है।     |

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

@@ -39,11 +39,126 @@ export default defineConfig({
 });
 ```
 
-## विवरण
+## विकल्प
 
-यह प्लगइन निम्नलिखित कार्य करता है:
+```ts
+import type { IntlayerPluginOptions } from "vite-intlayer";
+```
+
+`IntlayerPluginOptions` `GetConfigurationOptions` को विस्तृत करता है (देखें `@intlayer/config`) निम्नलिखित अतिरिक्त फ़ील्ड के साथ:
+
+| विकल्प          | प्रकार                          | डिफ़ॉल्ट    | विवरण                                                                                                                                                     |
+| --------------- | ------------------------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `compatCallers` | `CompatCallerConfig[]`          | `[]`        | compat-adapter packages के लिए अतिरिक्त caller पैटर्न (उदाहरण के लिए `@intlayer/react-i18next`)। बिल्ड समय पर field-usage विश्लेषक को पास किया गया।       |
+| `proxy`         | `{ ignore?: (req) => boolean }` | `undefined` | bundled locale-routing proxy को आगे बढ़ाए गए विकल्प। विशिष्ट पाथ (उदाहरण के लिए API routes) को locale routing से बाहर करने के लिए `ignore` का उपयोग करें। |
+
+अन्य सभी विकल्प (`override`, `configFile`, …) सीधे `getConfiguration()` को आगे बढ़ाए जाते हैं।
+
+### उदाहरण
+
+#### locale routing से API routes को ignore करें
+
+```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"),
+      },
+    }),
+  ],
+});
+```
+
+#### कस्टम config फ़ाइल पथ के साथ
+
+```ts
+export default defineConfig({
+  plugins: [
+    intlayer({
+      configFile: "./config/intlayer.config.ts",
+    }),
+  ],
+});
+```
+
+#### compat-adapter callers के साथ
+
+```ts
+import { intlayer } from "vite-intlayer";
+import { reactI18nextCallerConfig } from "@intlayer/react-i18next/plugin";
+
+export default defineConfig({
+  plugins: [
+    intlayer({
+      compatCallers: [reactI18nextCallerConfig],
+    }),
+  ],
+});
+```
+
+## प्लगइन क्या करता है
+
+### 1. Dictionary preparation
+
+बिल्ड शुरू होने से पहले (और dev में एक घंटे में एक बार), `intlayer` सभी `.content.ts` फ़ाइलों को `.intlayer/` में संग्रहीत अनुकूलित JSON शब्दकोशों में संकलित करने के लिए `prepareIntlayer` को कॉल करता है।
+
+### 2. Module aliases
+
+प्लगइन Vite resolve aliases जोड़ता है ताकि `import { myDict } from 'intlayer/dictionaries/my-dict'` डिस्क पर compiled JSON फ़ाइल को resolve करे। SSR builds `ssr.noExternal` का उपयोग करते हैं ताकि सभी `@intlayer/*` packages को aliases के साथ bundled किया जाए।
+
+### 3. Dev-server watcher
+
+विकास मोड में एक `chokidar` watcher शुरू किया जाता है। जब कोई `.content.ts` फ़ाइल बदलती है तो dictionaries को फिर से compile किया जाता है और Vite का HMR browser को अपडेट प्रसारित करता है।
+
+### 4. Bundled locale-routing proxy (v9+)
+
+Intlayer v9 के बाद से `intlayerProxy` middleware को `intlayer()` के अंदर स्वचालित रूप से पंजीकृत किया जाता है। यह निम्नलिखित को संभालता है:
+
+- URL prefix, cookies, और `Accept-Language` header से locale detection।
+- 301 redirects जब detected locale वर्तमान URL से मेल नहीं खाता।
+- Internal URL rewrites ताकि framework को सही `[locale]` route parameter दिखे।
+
+Proxy को आपके Intlayer config में `routing.enableProxy` (डिफ़ॉल्ट `true`) द्वारा नियंत्रित किया जाता है। इसे पूरी तरह से अक्षम करने के लिए:
+
+```ts
+// intlayer.config.ts
+import { defineConfig } from "intlayer";
+
+export default defineConfig({
+  routing: { enableProxy: false },
+});
+```
+
+एक अलग `intlayerProxy()` कॉल के बिना proxy के व्यवहार को कस्टमाइज़ करने के लिए, मुख्य plugin को `proxy` विकल्प pass करें:
+
+```ts
+intlayer({ proxy: { ignore: (req) => req.url?.startsWith("/api") } });
+```
+
+पूर्ण routing व्यवहार reference के लिए [intlayerProxy documentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/packages/vite-intlayer/intlayerProxy.md) देखें।
+
+### 5. Bundled compiler (v9+)
+
+जब `compiler.enabled` `true` **और** `compiler.output` आपकी Intlayer कॉन्फ़िग में सेट हो, तो `intlayer()` स्वचालित रूप से `intlayerCompiler` को रजिस्टर करता है। कंपाइलर component फ़ाइलों के अंदर सीधे लिखी गई inline content declarations को निकालता है और transform time पर उन्हें dictionaries में लिखता है। [intlayerCompiler documentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/packages/vite-intlayer/intlayerCompiler.md) देखें।
+
+### 6. बिल्ड ऑप्टिमाइज़ेशन
+
+एक प्रोडक्शन बिल्ड के दौरान प्लगइन निम्नलिखित जोड़ता है:
+
+- **intlayerOptimize** – Babel transform जो `useIntlayer('key')` → `useDictionary(hash)` को फिर से लिखता है और सीधे JSON आयात को इंजेक्ट करता है।
+- **intlayerPrune** – डिक्शनरी JSON से अप्रयुक्त कंटेंट फील्ड को हटाता है।
+- **intlayerMinify** – डिक्शनरी JSON को कॉम्पैक्ट करता है और वैकल्पिक रूप से फील्ड नामों को बदलता है।
+
+ये डेवलपमेंट मोड में निष्क्रिय हैं।
+
+## Deprecated aliases
 
-1. **डिक्शनरी तैयार करना**: यह बिल्ड या डेव (dev) प्रक्रिया की शुरुआत में डिक्शनरीज़ को optimized फाइलों में संकलित करता है।
-2. **वॉच मोड**: डेवलपमेंट मोड में यह डिक्शनरी फाइलों में होने वाले परिवर्तनों पर नज़र रखता है और उन्हें स्वतः पुनः संकलित करता है।
-3. **ऐलियास**: यह आपके एप्लिकेशन में डिक्शनरीज़ तक पहुँचने के लिए ऐलियास प्रदान करता है।
-4. **ट्री-शेकिंग**: यह `intlayerPrune` प्लगइन के माध्यम से अप्रयुक्त अनुवादों की ट्री-शेकिंग का समर्थन करता है।
+| Deprecated export | Replacement |
+| ----------------- | ----------- |
+| `intlayerPlugin`  | `intlayer`  |
+| `intLayerPlugin`  | `intlayer`  |

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

@@ -30,16 +30,89 @@ author: aymericzip
 
 ## उपयोग
 
+### `intlayer()` के भाग के रूप में (अनुशंसित)
+
+अपने Intlayer कॉन्फ़िगरेशन के माध्यम से pruning सक्षम करें और मुख्य प्लगइन सब कुछ संभालता है:
+
+```ts
+// intlayer.config.ts
+import { defineConfig } from "intlayer";
+
+export default defineConfig({
+  build: {
+    optimize: true, // prune और minify दोनों को सक्षम करता है
+  },
+});
+```
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+### स्वतंत्र
+
+यदि आप प्लगइन स्टैक को मैन्युअल रूप से कंपोज़ कर रहे हैं, तो `intlayerPrune` और `intlayerMinify` एक `PruneContext` ऑब्जेक्ट साझा करते हैं जिसे एक बार बनाया जाना चाहिए और दोनों को पारित किया जाना चाहिए:
+
 ```ts
-// vite.config.ts (Vite कॉन्फ़िगरेशन फ़ाइल)
+// 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), // वैकल्पिक, समान संदर्भ से पढ़ता है
+  ],
 });
 ```
 
-## विवरण
+## यह कैसे काम करता है
+
+### 1. उपयोग विश्लेषण (buildStart)
+
+`buildStart` के दौरान, `intlayerOptimize` plugin (जो `intlayer()` का भी हिस्सा है) `build.filesList` में सूचीबद्ध प्रत्येक component source file को स्कैन करता है। प्रत्येक `useIntlayer('key')` या `getIntlayer('key')` कॉल के लिए, यह रिकॉर्ड करता है कि कौन से fields को exactly एक्सेस किया गया है, जैसे:
+
+```ts
+const { title, description } = useIntlayer("myDict");
+// records: myDict → { title, description }
+```
+
+यह किसी भी `transform` कॉल के चलने से पहले `pruneContext.fieldUsageMap` बनाता है।
+
+### 2. JSON pruning (transform, enforce: 'pre')
+
+जब Vite एक compiled dictionary JSON फ़ाइल को प्रोसेस करता है, तो `intlayerPrune` इसे Vite के built-in JSON → ESM conversion से पहले intercept करता है। यह `pruneContext` से field-usage map को पढ़ता है और किसी भी content field को हटाता है जो recorded usage set में नहीं है।
+
+दो content shapes समर्थित हैं:
+
+- **Static dictionaries** — `{ nodeType: "translation", translation: { en: {...}, fr: {...} } }`. Fields को `translation` के अंदर per-locale pruned किया जाता है।
+- **Dynamic (per-locale) dictionaries** — flat `{ fieldA: ..., fieldB: ... }`. Fields को top level पर pruned किया जाता है।
+
+### 3. Edge cases
+
+यदि किसी dictionary की content structure को पहचाना नहीं जा सकता (उदाहरण के लिए, एक असामान्य nested shape), तो इसे `pruneContext.dictionariesWithEdgeCases` में जोड़ा जाता है और **अछूता छोड़ दिया जाता है**। एक warning लॉग की जाती है। `intlayerMinify` भी इन dictionaries को छोड़ देता है।
+
+### 4. Field-rename map
+
+जब pruning सफल होता है, `intlayerPrune` `pruneContext.dictionaryKeyToFieldRenameMap` भी लिखता है — मूल field names से short aliases तक एक mapping। `intlayerMinify` इस map को output JSON में fields को rename करने के लिए पढ़ता है, और `intlayerOptimize` का Babel rename pass source files में property accesses को अपडेट करता है।
+
+## सक्रियण शर्तें
+
+`intlayerPrune` सक्रिय है **केवल** जब निम्नलिखित सभी सत्य हों:
+
+1. Vite कमांड `build` है।
+2. `build.optimize` `true` है (या `undefined`, जो builds के लिए डिफ़ॉल्ट रूप से `true` है)।
+3. `build.purge` आपके Intlayer config में `true` है।
 
-यह plugin आपके स्रोत कोड का विश्लेषण करता है ताकि यह पहचान किया जा सके कि कौन सी dictionary keys वास्तव में उपयोग की जा रही हैं। इसके बाद यह bundled dictionary files से किसी भी अप्रयुक्त सामग्री को हटा देता है। यह उन बड़े प्रोजेक्ट्स के लिए विशेष रूप से उपयोगी है जिनमें कई dictionaries हों और केवल उनका एक subset ही विशिष्ट पेजों या components में इस्तेमाल हो रहा हो।
+यह स्वचालित रूप से **अक्षम** हो जाता है जब `editor.enabled` `true` है क्योंकि संपादक को पूर्ण शब्दकोश सामग्री की आवश्यकता होती है।

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

@@ -245,14 +245,14 @@ syncJSON({
 
 आप विभिन्न JSON स्रोतों को सिंक्रनाइज़ करने के लिए कई `syncJSON` प्लगइन्स जोड़ सकते हैं। यह तब उपयोगी होता है जब आपके प्रोजेक्ट में कई i18n लाइब्रेरीज़ या विभिन्न JSON संरचनाएँ हों।
 
-### प्राथमिकता प्रणाली
+#### प्राथमिकता प्रणाली
 
-जब कई प्लगइन्स एक ही शब्दकोश कुंजी को लक्षित करते हैं, तो `priority` पैरामीटर यह निर्धारित करता है कि कौन सा प्लगइन प्राथमिकता प्राप्त करेगा:
+जब कई प्लगइन एक ही शब्दकोश कुंजी को लक्षित करते हैं, तो `priority` पैरामीटर यह निर्धारित करता है कि कौन सा प्लगइन प्राथमिकता लेता है:
 
-- उच्च प्राथमिकता संख्या निम्न प्राथमिकता वाले पर जीतती है
-- `.content` फ़ाइलों की डिफ़ॉल्ट प्राथमिकता `0` है
-- प्लगइन्स की सामग्री फ़ाइलों की डिफ़ॉल्ट प्राथमिकता `-1` है
-- समान प्राथमिकता वाले प्लगइन्स को कॉन्फ़िगरेशन में उनके प्रकट होने के क्रम में संसाधित किया जाता है
+- उच्च प्राथमिकता संख्या निम्न संख्याओं पर जीत जाते हैं
+- `.content` फाइलों की डिफ़ॉल्ट प्राथमिकता `0` है
+- प्लगइन की डिफ़ॉल्ट प्राथमिकता `0` है
+- समान प्राथमिकता वाले प्लगइन को कॉन्फ़िगरेशन में दिखाई देने के क्रम में संसाधित किया जाता है
 
 ```ts fileName="intlayer.config.ts"
 import { Locales, type IntlayerConfig } from "intlayer";
@@ -265,7 +265,7 @@ const config: IntlayerConfig = {
   },
 
   plugins: [
-    // प्राथमिक JSON स्रोत (सबसे उच्च प्राथमिकता)
+    // प्राथमिक JSON स्रोत (उच्चतम प्राथमिकता)
     syncJSON({
       format: "i18next",
       source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
@@ -273,7 +273,7 @@ const config: IntlayerConfig = {
       priority: 10,
     }),
 
-    // फॉलबैक JSON स्रोत (कम प्राथमिकता)
+    // फॉलबैक JSON स्रोत (निम्न प्राथमिकता)
     syncJSON({
       format: "i18next",
       source: ({ locale }) => `./fallback-locales/${locale}.json`,
@@ -281,7 +281,7 @@ const config: IntlayerConfig = {
       priority: 5,
     }),
 
-    // लेगेसी JSON स्रोत (सबसे कम प्राथमिकता)
+    // लीगेसी JSON स्रोत (सबसे कम प्राथमिकता)
     syncJSON({
       format: "i18next",
       source: ({ locale }) => `/my/other/app/legacy/${locale}/messages.json`,

package/docs/hi/releases/v9.md

@@ -374,21 +374,6 @@ curl -fsSL https://intlayer.org/install.sh | sh
 
 इंस्टॉलर एक `docker-compose.yml` और एक `.env` डाउनलोड करता है, आवश्यक सीक्रेट्स (secrets) को स्वचालित रूप से जनरेट करता है, और `docker compose up -d` चलाता है। सब कुछ — डैशबोर्ड, API, डेटाबेस, ऑब्जेक्ट स्टोरेज, और ट्रांजेक्शनल ईमेल — कंटेनर्स में स्थानीय रूप से चलता है।
 
-### शामिल सेवाएं
-
-| सेवा                                   | उद्देश्य                                                         |
-| -------------------------------------- | ---------------------------------------------------------------- |
-| **app** (TanStack Start)               | पोर्ट `3000` पर डैशबोर्ड UI                                      |
-| **backend** (Fastify/Bun)              | पोर्ट `3100` पर REST API                                         |
-| **MongoDB 7** (सिंगल-नोड रेप्लिका सेट) | प्राथमिक डेटाबेस                                                 |
-| **Redis 7**                            | जॉब क्यूज़ और कैशिंग                                             |
-| **MinIO**                              | S3-संगत ऑब्जेक्ट स्टोरेज (अवतार, स्क्रीनशॉट)                     |
-| **Mailpit**                            | लोकल SMTP सिंक + पोर्ट `8025` पर ट्रांजेक्शनल ईमेल के लिए वेब UI |
-
-Chromium (Puppeteer स्क्रीनशॉट जनरेशन के लिए उपयोग किया जाता है) बैकएंड इमेज के अंदर बंडल किया गया है — किसी अतिरिक्त कंटेनर की आवश्यकता नहीं है।
-
----
-
 ## v8 से माइग्रेशन नोट्स
 
 यदि आप v8 से अपग्रेड कर रहे हैं, तो ध्यान दें कि v9 में कोई ब्रेकिंग बदलाव (breaking changes) शामिल नहीं हैं। लेकिन यहाँ मुख्य बदलाव दिए गए हैं:

package/docs/hi/self_hosting.md

@@ -80,6 +80,18 @@ curl -fsSL https://intlayer.org/install.sh | sh
 
 ---
 
+## पहली बार सेटअप
+
+एक नए instance (खाली डेटाबेस) पर, डैशबोर्ड खोलने से आप **`/init`** पृष्ठ पर रीडायरेक्ट हो जाते हैं:
+
+1. पहला खाता बनाएँ। क्योंकि users collection खाली है, यह खाता स्वचालित रूप से **super admin** को प्रचारित किया जाता है।
+2. एक सत्यापन ईमेल भेजा जाता है (Resend के माध्यम से)। ईमेल सत्यापन **अनिवार्य** है — यही कारण है कि `RESEND_API_KEY` को शुरू करने से पहले सेट किया जाना चाहिए।
+3. ईमेल में लिंक पर क्लिक करें, फिर साइन इन करें।
+
+एक बार admin मौजूद हो जाने पर, `/init` मानक साइन-इन पृष्ठ पर रीडायरेक्ट करता है।
+
+---
+
 ## सेवाएँ
 
 | सर्विस      | इमेज                                 | होस्ट पोर्ट(s)                 | उद्देश्य                                            |
@@ -97,9 +109,18 @@ curl -fsSL https://intlayer.org/install.sh | sh
 
 ---
 
-## एनवायरनमेंट वेरिएबल
+## Environment variables
+
+### आवश्यक
 
-इंस्टॉलर एक तैयार-से-उपयोग `.env` जेनरेट करता है। नीचे दी गई तालिका प्रत्येक वेरिएबल का वर्णन करती है।
+| 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)) |
 
 ### आवश्यक (स्वतः जेनरेटेड या प्रॉम्प्टेड)
 
@@ -125,6 +146,17 @@ curl -fsSL https://intlayer.org/install.sh | sh
 | `VITE_BACKEND_URL`     | `http://localhost:3100`                         | बिल्ड टाइम पर डैशबोर्ड में बेक किया गया बैकएंड URL |
 | `VITE_DOMAIN`          | `localhost`                                     | बिल्ड टाइम पर डैशबोर्ड में बेक किया गया डोमेन      |
 
+### Optional (features degrade gracefully when absent)
+
+| Variable                                                 | Feature                                   |
+| -------------------------------------------------------- | ----------------------------------------- |
+| `OPENAI_API_KEY`                                         | AI-assisted translation and content audit |
+| `STRIPE_SECRET_KEY`, `STRIPE_WEBHOOK_SECRET`, `STRIPE_*` | Billing and subscription management       |
+| `GITHUB_CLIENT_ID`, `GITHUB_CLIENT_SECRET`               | GitHub OAuth login                        |
+| `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`               | Google OAuth login                        |
+| `GITLAB_CLIENT_ID`, `GITLAB_CLIENT_SECRET`               | GitLab OAuth login                        |
+| `MICROSOFT_CLIENT_ID`, `MICROSOFT_CLIENT_SECRET`         | Microsoft OAuth login                     |
+
 ### वैकल्पिक (अनुपस्थिति में फीचर धीरे-धीरे खराब हो जाते हैं)
 
 | वेरिएबल                                                  | फीचर                                                                          |
@@ -259,47 +291,11 @@ docker run --rm \
 
 ---
 
-## रिवर्स प्रॉक्सी (Nginx / Caddy) का उपयोग करना
-
-प्रोडक्शन डिप्लॉयमेंट के लिए, ऐप और बैकएंड कंटेनरों को सीधे एक्सपोज़ करने के बजाय उनके सामने एक रिवर्स प्रॉक्सी रखें।
-
-### 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 बाहरी (Atlas) होना चाहिए।** बैकएंड केवल `mongodb+srv://` पर कनेक्ट करता है (जो `DB_ID` / `DB_MDP` / `DB_CLUSTER` से बनाया गया है), इसलिए एक सादा `mongodb://host:27017` — कंटेनर के अपने बंडल किए गए `mongod` सहित — का उपयोग नहीं किया जा सकता है। एक MongoDB Atlas क्लस्टर प्रदान करें।
+- **कोई कस्टम डोमेन नहीं।** सभी ब्राउज़र-सामने वाले `VITE_*` URLs बिल्ड टाइम पर ऐप में इनलाइन किए जाते हैं, और प्रकाशित इमेज `localhost` मानों के साथ आती है। डैशबोर्ड को `http://localhost:3000` पर एक्सेस किया जाना चाहिए; इसे एक सार्वजनिक डोमेन पर सर्व करने के लिए इमेज को लक्ष्य URLs के साथत: फिर से बनाने की आवश्यकता होगी और इसे तुरंत समर्थित नहीं किया जाता है।
+- **ईमेल को एक काम करने वाले मेलर की आवश्यकता है।** पहली बार सेटअप ईमेल सत्यापन को लागू करता है, इसलिए या तो `RESEND_API_KEY` या एक [global SMTP mailer](#global-mailer) (`MAIL_PROVIDER=smtp` + `MAIL_SMTP_*`) को कॉन्फ़िगर किया जाना चाहिए। पहले एडमिन साइन इन करने के बाद, प्रत्येक संगठन डैशबोर्ड से अपना स्वयं का SMTP या Resend मेलर भी कॉन्फ़िगर कर सकता है।
 
 ---
 
@@ -315,15 +311,6 @@ docker compose logs mongo
 docker compose logs redis
 ```
 
-### डैशबोर्ड API तक नहीं पहुँच सकता
-
-सत्यापित करें कि `VITE_BACKEND_URL` उस URL से मेल खाता है जहाँ बैकएंड **ब्राउज़र** से (डॉकर नेटवर्क से नहीं) पहुँच योग्य है। यदि आपने बैकएंड पोर्ट बदला है या एक रिवर्स प्रॉक्सी जोड़ा है, तो डैशबोर्ड इमेज को फिर से बनाएँ:
-
-```sh
-docker compose build app
-docker compose up -d app
-```
-
 ### ईमेल नहीं भेजा जा रहा है
 
 डिफ़ॉल्ट रूप से, सभी आउटबाउंड ईमेल मेलपिट द्वारा कैप्चर किए जाते हैं। भेजे गए संदेशों को देखने के लिए `http://localhost:8025` खोलें। वास्तविक ईमेल भेजने के लिए, `.env` में `MAIL_PROVIDER=resend` और `RESEND_API_KEY=<your-key>` सेट करें, फिर बैकएंड को रीस्टार्ट करें: