@intlayer/docs 9.1.3 → 9.2.0

package/docs/fr/packages/intlayer/getLocalizedUrl.md

@@ -59,36 +59,44 @@ getLocalizedUrl(
 
 ## Paramètres
 
-## Description
-
-La fonction `getLocalizedUrl` génère une URL localisée en préfixant l'URL donnée avec la locale spécifiée. Elle gère à la fois les URL absolues et relatives, en s'assurant que le préfixe de locale correct est appliqué selon la configuration.
-
----
-
-## Paramètres
+### Paramètres obligatoires
 
 - `url: string`
-  - **Description** : La chaîne URL originale à préfixer avec une locale.
-  - **Type** : `string`
+  - **Description**: La chaîne d'URL originale à préfixer avec une locale.
+  - **Type**: `string`
+  - **Required**: Yes
 
 - `currentLocale: Locales`
-  - **Description** : La locale actuelle pour laquelle l'URL est localisée.
-  - **Type** : `Locales`
-
-- `locales: Locales[]`
-  - **Description** : Tableau optionnel des locales supportées. Par défaut, les locales configurées dans le projet sont fournies.
-  - **Type** : `Locales[]`
-  - **Par défaut** : [`Configuration du projet`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/configuration.md#middleware)
-
-- `defaultLocale: Locales`
-  - **Description** : La locale par défaut de l'application. Par défaut, la locale par défaut configurée dans le projet est utilisée.
-  - **Type** : `Locales`
-  - **Par défaut** : [`Configuration du projet`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/configuration.md#middleware)
-
-- `prefixDefault: boolean`
-  - **Description** : Indique s'il faut préfixer l'URL pour la locale par défaut. Par défaut, la valeur configurée dans le projet est utilisée.
-  - **Type** : `boolean`
-  - **Par défaut** : [`Configuration du projet`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/configuration.md#middleware)
+  - **Description**: La locale actuelle pour laquelle l'URL est localisée.
+  - **Type**: `Locales`
+  - **Required**: Yes
+
+### Paramètres Optionnels
+
+- `options?: object`
+  - **Description**: Objet de configuration pour le comportement de localisation des URL.
+  - **Type**: `object`
+  - **Required**: Non (Optionnel)
+
+  - `options.locales?: Locales[]`
+    - **Description**: Tableau des locales supportées. Si non fourni, utilise les locales configurées dans la configuration de votre projet.
+    - **Type**: `Locales[]`
+    - **Default**: [`Project Configuration`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/configuration.md#middleware)
+
+  - `options.defaultLocale?: Locales`
+    - **Description**: La locale par défaut pour l'application. Si non fournie, utilise la locale par défaut configurée dans la configuration de votre projet.
+    - **Type**: `Locales`
+    - **Default**: [`Project Configuration`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/configuration.md#middleware)
+
+  - `options.mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'`
+    - **Description**: Le mode de routage des URL pour la gestion des locales. Si non fourni, utilise le mode configuré dans la configuration de votre projet.
+    - **Type**: `'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'`
+    - **Default**: [`Project Configuration`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/configuration.md#middleware)
+    - **Modes**:
+      - `prefix-no-default`: Aucun préfixe pour la locale par défaut, préfixe pour toutes les autres
+      - `prefix-all`: Préfixe pour toutes les locales, y compris la locale par défaut
+      - `no-prefix`: Aucun préfixe de locale dans l'URL
+      - `search-params`: Utiliser les paramètres de requête pour la locale (par ex., `?locale=fr`)
 
 ### Retour
 
@@ -114,7 +122,9 @@ getLocalizedUrl("/about", Locales.ENGLISH);
 // Output: "/about" ou "/en/about" (en fonction de votre paramètre de mode)
 ```
 
-## Exemple d'utilisation
+### Utilisation avancée (avec paramètres optionnels)
+
+Vous pouvez remplacer la configuration par défaut en fournissant le paramètre optionnel `options` :
 
 ### URLs relatives
 

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

@@ -49,26 +49,12 @@ La fonction `getMultilingualUrls` génère une correspondance d'URLs multilingue
 
 ## Paramètres
 
-## Paramètres
+### Paramètres obligatoires
 
 - `url: string`
-  - **Description** : La chaîne URL originale à préfixer avec les locales.
-  - **Type** : `string`
-
-- `locales: Locales[]`
-  - **Description** : Tableau optionnel des locales supportées. Par défaut, les locales configurées dans le projet.
-  - **Type** : `Locales[]`
-  - **Défaut** : `localesDefault`
-
-- `defaultLocale: Locales`
-  - **Description** : La locale par défaut pour l'application. Par défaut, la locale par défaut configurée dans le projet.
-  - **Type** : `Locales`
-  - **Défaut** : `defaultLocaleDefault`
-
-- `prefixDefault: boolean`
-  - **Description** : Indique s'il faut préfixer la locale par défaut. Par défaut, la valeur configurée dans le projet.
-  - **Type** : `boolean`
-  - **Défaut** : `prefixDefaultDefault`
+  - **Description**: La chaîne d'URL originale à préfixer avec les locales.
+  - **Type**: `string`
+  - **Required**: Yes
 
 ### Paramètres Optionnels
 
@@ -104,10 +90,22 @@ La fonction `getMultilingualUrls` génère une correspondance d'URLs multilingue
 
 ---
 
-## Utilisation d'exemple
-
 ## Exemple d'utilisation
 
+### Utilisation basique (Utilise la configuration du projet)
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getMultilingualUrls, Locales } from "intlayer";
+
+// Utilise la configuration de votre projet pour les locales, defaultLocale et mode
+getMultilingualUrls("/dashboard");
+// Sortie (en supposant que la configuration du projet a en, fr avec le mode 'prefix-no-default'):
+// {
+//   en: "/dashboard",
+//   fr: "/fr/dashboard"
+// }
+```
+
 ### URLs relatives
 
 ```typescript codeFormat={["typescript", "esm", "commonjs"]}

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

@@ -48,3 +48,18 @@ import "vite-intlayer";
 | `intlayerProxy`      | Plugin middleware de développement pour gérer la détection de la locale et le routage.       | -                                                                                                                      |
 | `intlayerMiddleware` | (**Déprécié**) Alias pour `intlayerProxy`.                                                   | -                                                                                                                      |
 | `intlayerPrune`      | Plugin pour effectuer du tree-shaking et élaguer les dictionnaires inutilisés lors du build. | [intlayerPrune](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/vite-intlayer/intlayerPrune.md) |
+
+### Utilities
+
+| Export                       | Description                                                                                                  | Related Doc                                                                                                            |
+| ---------------------------- | ------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------- |
+| `createIntlayerProxyHandler` | Retourne un middleware Node.js `(req, res, next)` agnostique du framework avec logique de routage de locale. | [intlayerProxy](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/vite-intlayer/intlayerProxy.md) |
+
+### Types
+
+| Export                       | Description                                                                                                               |
+| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
+| `IntlayerPluginOptions`      | Options acceptées par `intlayer()`. Étend `GetConfigurationOptions` avec `compatCallers` et `proxy`.                      |
+| `IntlayerProxyPluginOptions` | Options acceptées par `intlayerProxy()` et `createIntlayerProxyHandler()`. Inclut `ignore` et `configOptions`.            |
+| `IntlayerCompilerOptions`    | Options acceptées par `intlayerCompiler()`. Inclut `configOptions` et `compilerConfig`.                                   |
+| `CompatCallerConfig`         | Ré-export depuis `@intlayer/babel`. Décrit un motif d'appelant compat-adapter pour l'analyse de l'utilisation des champs. |

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

@@ -39,11 +39,126 @@ export default defineConfig({
 });
 ```
 
-## Description
+## Options
 
-Le plugin effectue les tâches suivantes :
+```ts
+import type { IntlayerPluginOptions } from "vite-intlayer";
+```
+
+`IntlayerPluginOptions` extends `GetConfigurationOptions` (voir `@intlayer/config`) avec les champs supplémentaires suivants :
+
+| Option          | Type                            | Default     | Description                                                                                                                                                                            |
+| --------------- | ------------------------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `compatCallers` | `CompatCallerConfig[]`          | `[]`        | Patterns d'appelants supplémentaires pour les packages compat-adapter (par ex. `@intlayer/react-i18next`). Transmis à l'analyseur d'utilisation de champs au moment de la compilation. |
+| `proxy`         | `{ ignore?: (req) => boolean }` | `undefined` | Options transmises au proxy de routage de locale inclus. Utilisez `ignore` pour exclure des chemins spécifiques (par ex. les routes API) du routage de locale.                         |
+
+Toutes les autres options (`override`, `configFile`, …) sont transmises directement à `getConfiguration()`.
+
+### Exemples
+
+#### Ignorer les routes API du routage des locales
+
+```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"),
+      },
+    }),
+  ],
+});
+```
+
+#### Avec un chemin de fichier de configuration personnalisé
+
+```ts
+export default defineConfig({
+  plugins: [
+    intlayer({
+      configFile: "./config/intlayer.config.ts",
+    }),
+  ],
+});
+```
+
+#### Avec les callers compat-adapter
+
+```ts
+import { intlayer } from "vite-intlayer";
+import { reactI18nextCallerConfig } from "@intlayer/react-i18next/plugin";
+
+export default defineConfig({
+  plugins: [
+    intlayer({
+      compatCallers: [reactI18nextCallerConfig],
+    }),
+  ],
+});
+```
+
+## Ce que fait le plugin
+
+### 1. Préparation du dictionnaire
+
+Avant le démarrage de la construction (et une fois par heure en dev), `intlayer` appelle `prepareIntlayer` pour compiler tous les fichiers `.content.ts` en dictionnaires JSON optimisés stockés dans `.intlayer/`.
+
+### 2. Alias de modules
+
+Le plugin ajoute des alias de résolution Vite afin que `import { myDict } from 'intlayer/dictionaries/my-dict'` soit résolu vers le fichier JSON compilé sur le disque. Les builds SSR utilisent `ssr.noExternal` pour s'assurer que tous les packages `@intlayer/*` sont regroupés avec les alias appliqués.
+
+### 3. Dev-server watcher
+
+En mode développement, un watcher `chokidar` est démarré. Quand un fichier `.content.ts` change, les dictionnaires sont recompilés et le HMR de Vite propage la mise à jour au navigateur.
+
+### 4. Proxy de routage des locales intégré (v9+)
+
+Depuis Intlayer v9, le middleware `intlayerProxy` est enregistré automatiquement à l'intérieur de `intlayer()`. Il gère :
+
+- La détection de la locale à partir du préfixe d'URL, des cookies et de l'en-tête `Accept-Language`.
+- Les redirections 301 lorsque la locale détectée ne correspond pas à l'URL actuelle.
+- Les réécritures d'URL internes afin que le framework voie le bon paramètre de route `[locale]`.
+
+Le proxy est contrôlé par `routing.enableProxy` (par défaut `true`) dans votre configuration Intlayer. Pour le désactiver complètement :
+
+```ts
+// intlayer.config.ts
+import { defineConfig } from "intlayer";
+
+export default defineConfig({
+  routing: { enableProxy: false },
+});
+```
+
+Pour personnaliser le comportement du proxy sans appel `intlayerProxy()` séparé, transmettez les options `proxy` au plugin principal :
+
+```ts
+intlayer({ proxy: { ignore: (req) => req.url?.startsWith("/api") } });
+```
+
+Consultez la [documentation intlayerProxy](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/vite-intlayer/intlayerProxy.md) pour la référence complète du comportement du routage.
+
+### 5. Compilateur fourni (v9+)
+
+Quand `compiler.enabled` est `true` **et** `compiler.output` est défini dans votre config Intlayer, `intlayer()` enregistre `intlayerCompiler` automatiquement. Le compilateur extrait les déclarations de contenu inline écrites directement dans les fichiers de composants et les écrit dans les dictionnaires au moment de la transformation. Voir la [documentation intlayerCompiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/vite-intlayer/intlayerCompiler.md).
+
+### 6. Optimisations de build
+
+Pendant un build de production, le plugin ajoute :
+
+- **intlayerOptimize** – transformation Babel qui réécrit `useIntlayer('key')` → `useDictionary(hash)` et injecte les imports JSON directs.
+- **intlayerPrune** – supprime les champs de contenu inutilisés du JSON du dictionnaire.
+- **intlayerMinify** – compacte le JSON du dictionnaire et optionnellement modifie les noms de champs.
+
+Ces derniers sont inactifs en mode développement.
+
+## Aliases dépréciés
 
-1. **Préparer les dictionnaires** : Il compile les dictionnaires en fichiers optimisés au démarrage du processus de build ou de développement.
-2. **Mode watch** : En mode développement, il surveille les modifications des fichiers de dictionnaire et les recompile automatiquement.
-3. **Alias** : Il fournit des alias pour accéder aux dictionnaires dans votre application.
-4. **Tree-shaking** : Il prend en charge le tree-shaking des traductions non utilisées via le plugin `intlayerPrune`.
+| Export déprécié  | Remplacement |
+| ---------------- | ------------ |
+| `intlayerPlugin` | `intlayer`   |
+| `intLayerPlugin` | `intlayer`   |

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

@@ -30,16 +30,89 @@ Le plugin Vite `intlayerPrune` permet d'effectuer du tree-shaking et de supprime
 
 ## Utilisation
 
+### Dans le cadre de `intlayer()` (recommandé)
+
+Activez le pruning via votre configuration Intlayer et le plugin principal gère tout :
+
+```ts
+// intlayer.config.ts
+import { defineConfig } from "intlayer";
+
+export default defineConfig({
+  build: {
+    optimize: true, // active à la fois le pruning et la minification
+  },
+});
+```
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+### Standalone
+
+Si vous composez manuellement la pile de plugins, `intlayerPrune` et `intlayerMinify` partagent un objet `PruneContext` qui doit être créé une seule fois et passé aux deux :
+
 ```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), // optionnel, lit depuis le même contexte
+  ],
 });
 ```
 
-## Description
+## Comment ça marche
+
+### 1. Analyse d'utilisation (buildStart)
+
+Durante `buildStart`, le plugin `intlayerOptimize` (également partie de `intlayer()`) analyse chaque fichier source de composant listé dans `build.filesList`. Pour chaque appel `useIntlayer('key')` ou `getIntlayer('key')`, il enregistre exactement quels champs sont accédés, par exemple :
+
+```ts
+const { title, description } = useIntlayer("myDict");
+// enregistre : myDict → { title, description }
+```
+
+Cela construit `pruneContext.fieldUsageMap` avant que les appels `transform` ne s'exécutent.
+
+### 2. Élagage JSON (transform, enforce: 'pre')
+
+Lorsque Vite traite un fichier JSON de dictionnaire compilé, `intlayerPrune` l'intercepte avant la conversion JSON → ESM intégrée de Vite. Il lit la carte d'utilisation des champs à partir de `pruneContext` et supprime tout champ de contenu qui ne figure pas dans l'ensemble d'utilisation enregistré.
+
+Deux formes de contenu sont supportées :
+
+- **Dictionnaires statiques** — `{ nodeType: "translation", translation: { en: {...}, fr: {...} } }`. Les champs sont élagués par locale à l'intérieur de `translation`.
+- **Dictionnaires dynamiques (par locale)** — flat `{ fieldA: ..., fieldB: ... }`. Les champs sont élagués au niveau supérieur.
+
+### 3. Cas limites
+
+Si la structure de contenu d'un dictionnaire ne peut pas être reconnue (par exemple, une forme imbriquée inhabituelle), il est ajouté à `pruneContext.dictionariesWithEdgeCases` et **laissé inchangé**. Un avertissement est enregistré. `intlayerMinify` ignore également ces dictionnaires.
+
+### 4. Field-rename map
+
+Lorsque l'élagage réussit, `intlayerPrune` écrit également `pruneContext.dictionaryKeyToFieldRenameMap` — un mapping entre les noms de champs originaux et leurs alias courts. `intlayerMinify` lit cette carte pour renommer les champs dans le JSON de sortie, et la passe de renommage Babel d'`intlayerOptimize` met à jour les accès aux propriétés dans les fichiers sources en conséquence.
+
+## Conditions d'activation
+
+`intlayerPrune` est actif **uniquement** quand toutes les conditions suivantes sont vraies :
+
+1. La commande Vite est `build`.
+2. `build.optimize` est `true` (ou `undefined`, qui est `true` par défaut pour les builds).
+3. `build.purge` est `true` dans votre configuration Intlayer.
 
-Le plugin analyse votre code source pour identifier quelles clés de dictionnaire sont réellement utilisées. Il supprime ensuite tout contenu inutilisé des fichiers de dictionnaire inclus dans le bundle. Cela est particulièrement utile pour les grands projets comportant de nombreux dictionnaires où seul un sous-ensemble est utilisé dans des pages ou composants spécifiques.
+Il est automatiquement **désactivé** quand `editor.enabled` est `true` car l'éditeur a besoin du contenu complet du dictionnaire.

package/docs/fr/releases/v9.md

@@ -370,21 +370,6 @@ curl -fsSL https://intlayer.org/install.sh | sh
 
 Le programme d'installation télécharge un `docker-compose.yml` et un `.env`, génère automatiquement les secrets requis et exécute `docker compose up -d`. Tout — le tableau de bord, l'API, la base de données, le stockage d'objets et les e-mails transactionnels — s'exécute localement dans des conteneurs.
 
-### Services inclus
-
-| Service                                 | Objectif                                                                             |
-| --------------------------------------- | ------------------------------------------------------------------------------------ |
-| **app** (TanStack Start)                | Interface du tableau de bord sur le port `3000`                                      |
-| **backend** (Fastify/Bun)               | API REST sur le port `3100`                                                          |
-| **MongoDB 7** (single-node replica set) | Base de données principale                                                           |
-| **Redis 7**                             | Files d'attente de tâches et mise en cache                                           |
-| **MinIO**                               | Stockage d'objets compatible S3 (avatars, captures d'écran)                          |
-| **Mailpit**                             | Puits SMTP local + interface web pour les e-mails transactionnels sur le port `8025` |
-
-Chromium (utilisé pour la génération de captures d'écran Puppeteer) est intégré dans l'image du backend — aucun conteneur supplémentaire n'est nécessaire.
-
----
-
 ## Notes de migration depuis la v8
 
 Si vous effectuez une mise à niveau depuis la v8, notez que la v9 n'inclut pas de changements majeurs (breaking changes). Voici cependant les changements clés :

package/docs/fr/self_hosting.md

@@ -80,6 +80,18 @@ Une fois la stack démarrée, ouvrez **http://localhost:3000** et créez votre p
 
 ---
 
+## Configuration initiale
+
+Sur une instance vierge (base de données vide), l'ouverture du dashboard vous redirige vers la page **`/init`** :
+
+1. Créez le premier compte. Comme la collection users est vide, ce compte est automatiquement promu **super admin**.
+2. Un email de vérification est envoyé (via Resend). La vérification d'email est **obligatoire** — c'est pourquoi `RESEND_API_KEY` doit être défini avant de commencer.
+3. Cliquez sur le lien dans l'email, puis connectez-vous.
+
+Une fois qu'un admin existe, `/init` redirige vers la page de connexion standard.
+
+---
+
 ## Services
 
 | Service     | Image                                           | Port(s) hôte                   | Objectif                                                                 |
@@ -99,7 +111,16 @@ Les ports internes (mongo, redis) ne sont pas exposés à l'hôte par défaut.
 
 ## Variables d'environnement
 
-L'installateur génère un fichier `.env` prêt à l'emploi. Le tableau ci-dessous décrit chaque variable.
+### Requis
+
+| Variable               | Exemple                      | Description                                                                                                                                                 |
+| ---------------------- | ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `DB_ID`                | `intlayer`                   | Utilisateur MongoDB Atlas                                                                                                                                   |
+| `DB_MDP`               | _(votre mot de passe)_       | Mot de passe MongoDB Atlas                                                                                                                                  |
+| `DB_CLUSTER`           | `cluster0.xxxxx.mongodb.net` | Hôte du cluster MongoDB Atlas (utilisé dans l'URI `mongodb+srv://`)                                                                                         |
+| `BETTER_AUTH_SECRET`   | _(généré)_                   | Secret de 32 octets pour la signature de session                                                                                                            |
+| `S3_SECRET_ACCESS_KEY` | _(généré)_                   | Secret pour le MinIO intégré                                                                                                                                |
+| `RESEND_API_KEY`       | _(votre clé)_                | Email transactionnel via Resend. Requis pour la première configuration sauf si vous configurez un mailer SMTP global (voir [Global mailer](#global-mailer)) |
 
 ### Requis (auto-généré ou demandé)
 
@@ -141,6 +162,26 @@ L'installateur génère un fichier `.env` prêt à l'emploi. Le tableau ci-desso
 
 ---
 
+### Mailer global
+
+Par défaut, tous les emails transactionnels sont envoyés via Resend en utilisant `RESEND_API_KEY`. Les déploiements auto-hébergés peuvent à la place router **tous** les emails — y compris les emails non-organisationnels tels que les réinitialisations de mot de passe et les liens magiques — via un mailer global configuré avec des variables d'environnement.
+
+Définissez `MAIL_PROVIDER` pour l'activer. S'il n'est pas défini, le mailer Resend par défaut est utilisé.
+
+| Variable             | Exemple                        | Description                                                                              |
+| -------------------- | ------------------------------ | ---------------------------------------------------------------------------------------- |
+| `MAIL_PROVIDER`      | `smtp`                         | Transport global : `smtp` ou `resend`. Laissez vide pour utiliser les valeurs par défaut |
+| `MAIL_FROM`          | `Intlayer <no-reply@acme.com>` | En-tête d'expéditeur. Accepte une adresse simple ou un format `Nom <email>`              |
+| `MAIL_SMTP_HOST`     | `smtp.acme.com`                | Hôte SMTP (requis quand `MAIL_PROVIDER=smtp`)                                            |
+| `MAIL_SMTP_PORT`     | `587`                          | Port SMTP (par défaut `587`)                                                             |
+| `MAIL_SMTP_SECURE`   | `false`                        | TLS implicite. Définissez `true` pour le port `465`                                      |
+| `MAIL_SMTP_USER`     | _(votre utilisateur)_          | Nom d'utilisateur SMTP (optionnel ; omettez pour les relais non authentifiés)            |
+| `MAIL_SMTP_PASSWORD` | _(votre mot de passe)_         | Mot de passe SMTP                                                                        |
+
+> Priorité : le mailer propre d'une organisation (configuré depuis le tableau de bord **Organization**) a priorité sur le mailer global, qui a lui-même priorité sur la clé Resend par défaut.
+
+---
+
 ## Connexion de votre projet Intlayer
 
 Une fois la stack en cours d'exécution, pointez votre projet vers le backend et le tableau de bord auto-hébergés au lieu de `intlayer.org`.
@@ -259,47 +300,11 @@ docker run --rm \
 
 ---
 
-## Utilisation d'un proxy inverse (Nginx / Caddy)
-
-Pour les déploiements de production, placez un proxy inverse devant les conteneurs de l'application et du backend au lieu de les exposer directement.
+## Limitations
 
-### Exemple 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;
-    }
-}
-```
-
-Mettez à jour les variables `.env` suivantes pour qu'elles correspondent à vos domaines publics :
-
-```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
-```
-
-> Les variables `VITE_*` sont intégrées à l'image du tableau de bord lors de la construction. Si vous les modifiez après la construction de l'image, vous devez reconstruire l'image `app` (`docker compose build app`) ou utiliser l'injection de configuration au moment de l'exécution.
+- **MongoDB must be external (Atlas).** The backend connects only over `mongodb+srv://` (built from `DB_ID` / `DB_MDP` / `DB_CLUSTER`), so a plain `mongodb://host:27017` — including the container's own bundled `mongod` — cannot be used. Provide a MongoDB Atlas cluster.
+- **No custom domain.** All browser-facing `VITE_*` URLs are inlined into the app at build time, and the published image ships with `localhost` values. The dashboard must be accessed at `http://localhost:3000`; serving it on a public domain would require rebuilding the image with the target URLs baked in and is not supported out of the box.
+- **Email requires a working mailer.** First-run setup enforces email verification, so either `RESEND_API_KEY` or a [global SMTP mailer](#global-mailer) (`MAIL_PROVIDER=smtp` + `MAIL_SMTP_*`) must be configured. After the first admin signs in, each organization can also configure its own SMTP or Resend mailer from the dashboard.
 
 ---
 
@@ -324,14 +329,6 @@ docker compose build app
 docker compose up -d app
 ```
 
-### Les e-mails ne sont pas envoyés
-
-Par défaut, tous les e-mails sortants sont capturés par Mailpit. Ouvrez `http://localhost:8025` pour voir les messages envoyés. Pour envoyer de vrais e-mails, définissez `MAIL_PROVIDER=resend` et `RESEND_API_KEY=<your-key>` dans `.env`, puis redémarrez le backend :
-
-```sh
-docker compose restart backend
-```
-
 ### Bucket MinIO manquant
 
 Si le service ponctuel `minio-init` n'a pas fonctionné (ou a fonctionné avant que MinIO ne soit prêt), créez le bucket manuellement :