@intlayer/docs 9.1.3 → 9.3.0

package/docs/pl/live-sync.md

@@ -13,6 +13,10 @@ keywords:
   - Intlayer
   - Next.js
   - Vite
+slugs:
+  - doc
+  - concept
+  - live-sync
 history:
   - version: 9.0.0
     date: 2026-07-08

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

@@ -49,26 +49,12 @@ Funkcja `getMultilingualUrls` generuje mapowanie wielojęzycznych URL-i, poprzed
 
 ## Parametry
 
-## Parametry
+### Wymagane parametry
 
 - `url: string`
-  - **Opis**: Oryginalny ciąg URL, który ma zostać poprzedzony prefiksami językowymi.
-  - **Typ**: `string`
-
-- `locales: Locales[]`
-  - **Opis**: Opcjonalna tablica obsługiwanych języków. Domyślnie używa skonfigurowanych języków w projekcie.
-  - **Typ**: `Locales[]`
-  - **Domyślnie**: `localesDefault`
-
-- `defaultLocale: Locales`
-  - **Opis**: Domyślny język aplikacji. Domyślnie używa skonfigurowanego domyślnego języka w projekcie.
-  - **Typ**: `Locales`
-  - **Domyślnie**: `defaultLocaleDefault`
-
-- `prefixDefault: boolean`
-  - **Opis**: Czy poprzedzać domyślny język prefiksem. Domyślnie używa skonfigurowanej wartości w projekcie.
-  - **Typ**: `boolean`
-  - **Domyślnie**: `prefixDefaultDefault`
+  - **Description**: Oryginalny ciąg URL do prefiksu z lokalizacjami.
+  - **Type**: `string`
+  - **Required**: Tak
 
 ### Parametry opcjonalne
 

package/docs/pl/packages/react-intlayer/useDictionary.md

@@ -24,26 +24,9 @@ history:
 author: aymericzip
 ---
 
-## Przykład użycia w React
+# Dokumentacja hooka useDictionary
 
-Poniżej znajduje się przykład, jak użyć hooka `useDictionary` w komponencie React:
-
-```tsx fileName="./ComponentExample.tsx" codeFormat={["typescript", "esm"]}
-import type { FC } from "react";
-import { useDictionary } from "react-intlayer";
-import componentContent from "./component.content";
-
-const ComponentExample: FC = () => {
-  const { title, content } = useDictionary(componentContent);
-
-  return (
-    <div>
-      <h1>{title}</h1>
-      <p>{content}</p>
-    </div>
-  );
-};
-```
+Hook `useDictionary` umożliwia przetwarzanie obiektu wyglądającego jak słownik (zawierającego klucze i zawartość) oraz obsługę tłumaczeń, enumeracji itp. w jego obrębie. W przeciwieństwie do `useIntlayer`, który jest przeznaczony do pracy z wygenerowanymi deklaracjami słownika, `useDictionary` jest bardziej elastyczny i może być używany z dowolnym obiektem, który następuje strukturę słownika.
 
 ## Integracja z serwerem
 

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

@@ -48,3 +48,18 @@ import "vite-intlayer";
 | `intlayerProxy`      | Wtyczka middleware do środowiska deweloperskiego obsługująca wykrywanie lokalizacji i routingu. | -                                                                                                                      |
 | `intlayerMiddleware` | (**Przestarzały**) Alias dla `intlayerProxy`.                                                   | -                                                                                                                      |
 | `intlayerPrune`      | Wtyczka do tree-shake i usuwania nieużywanych słowników podczas builda.                         | [intlayerPrune](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/vite-intlayer/intlayerPrune.md) |
+
+### Narzędzia
+
+| Export                       | Opis                                                                                                                | Powiązana dokumentacja                                                                                                 |
+| ---------------------------- | ------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
+| `createIntlayerProxyHandler` | Zwraca niezależne od framework'u oprogramowanie Node.js `(req, res, next)` middleware z logiką routowania locale'i. | [intlayerProxy](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/vite-intlayer/intlayerProxy.md) |
+
+### Typy
+
+| Export                       | Opis                                                                                                            |
+| ---------------------------- | --------------------------------------------------------------------------------------------------------------- |
+| `IntlayerPluginOptions`      | Opcje akceptowane przez `intlayer()`. Rozszerza `GetConfigurationOptions` o `compatCallers` i `proxy`.          |
+| `IntlayerProxyPluginOptions` | Opcje akceptowane przez `intlayerProxy()` i `createIntlayerProxyHandler()`. Zawiera `ignore` i `configOptions`. |
+| `IntlayerCompilerOptions`    | Opcje akceptowane przez `intlayerCompiler()`. Zawiera `configOptions` i `compilerConfig`.                       |
+| `CompatCallerConfig`         | Re-export z `@intlayer/babel`. Opisuje wzorzec compat-adapter caller do analizy użycia pól.                     |

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

@@ -39,11 +39,126 @@ export default defineConfig({
 });
 ```
 
-## Opis
+## Opcje
 
-Wtyczka wykonuje następujące zadania:
+```ts
+import type { IntlayerPluginOptions } from "vite-intlayer";
+```
+
+`IntlayerPluginOptions` rozszerza `GetConfigurationOptions` (zobacz `@intlayer/config`) o następujące dodatkowe pola:
+
+| Opcja           | Typ                             | Domyślnie   | Opis                                                                                                                                                        |
+| --------------- | ------------------------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `compatCallers` | `CompatCallerConfig[]`          | `[]`        | Dodatkowe wzorce callerów dla pakietów compat-adapter (np. `@intlayer/react-i18next`). Przekazywane do analizatora użycia pól w czasie budowania.           |
+| `proxy`         | `{ ignore?: (req) => boolean }` | `undefined` | Opcje przekazywane do wbudowanego proxy routingu lokalizacyjnego. Użyj `ignore` aby wykluczyć określone ścieżki (np. trasy API) z routingu lokalizacyjnego. |
+
+Wszystkie inne opcje (`override`, `configFile`, …) są przekazywane bezpośrednio do `getConfiguration()`.
+
+### Przykłady
+
+#### Ignoruj trasy API z routingu locale'a
+
+```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"),
+      },
+    }),
+  ],
+});
+```
+
+#### Ze spersonalizowaną ścieżką pliku konfiguracyjnego
+
+```ts
+export default defineConfig({
+  plugins: [
+    intlayer({
+      configFile: "./config/intlayer.config.ts",
+    }),
+  ],
+});
+```
+
+#### Z adapterami kompatybilności
+
+```ts
+import { intlayer } from "vite-intlayer";
+import { reactI18nextCallerConfig } from "@intlayer/react-i18next/plugin";
+
+export default defineConfig({
+  plugins: [
+    intlayer({
+      compatCallers: [reactI18nextCallerConfig],
+    }),
+  ],
+});
+```
+
+## Co robi wtyczka
+
+### 1. Przygotowanie słownika
+
+Przed rozpoczęciem buildu (i raz na godzinę w dev), `intlayer` wywołuje `prepareIntlayer` aby skompilować wszystkie pliki `.content.ts` do zoptymalizowanych słowników JSON przechowywanych w `.intlayer/`.
+
+### 2. Aliasy modułów
+
+Plugin dodaje aliasy resolve Vite'a, aby `import { myDict } from 'intlayer/dictionaries/my-dict'` rozwiązywał się do skompilowanego pliku JSON na dysku. Buildy SSR wykorzystują `ssr.noExternal`, aby zapewnić, że wszystkie pakiety `@intlayer/*` są spakowane z zastosowanymi aliasami.
+
+### 3. Dev-server watcher
+
+W trybie development uruchamiany jest watcher `chokidar`. Gdy plik `.content.ts` się zmieni, słowniki są rekompilowane, a HMR Vite'a propaguje aktualizację do przeglądarki.
+
+### 4. Wbudowany proxy do routowania locale (v9+)
+
+Od Intlayer v9 middleware `intlayerProxy` jest rejestrowany automatycznie wewnątrz `intlayer()`. Obsługuje:
+
+- Wykrywanie locale z prefiksu URL, cookies i nagłówka `Accept-Language`.
+- Przekierowania 301 gdy wykryte locale nie odpowiada bieżącemu URL.
+- Wewnętrzne przepisywanie URL-i tak aby framework widział prawidłowy parametr trasy `[locale]`.
+
+Proxy jest kontrolowane przez `routing.enableProxy` (domyślnie `true`) w konfiguracji Intlayer. Aby całkowicie je wyłączyć:
+
+```ts
+// intlayer.config.ts
+import { defineConfig } from "intlayer";
+
+export default defineConfig({
+  routing: { enableProxy: false },
+});
+```
+
+Aby dostosować zachowanie proxy bez osobnego wywołania `intlayerProxy()`, przekaż opcje `proxy` do głównego pluginu:
+
+```ts
+intlayer({ proxy: { ignore: (req) => req.url?.startsWith("/api") } });
+```
+
+Zapoznaj się z [dokumentacją intlayerProxy](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/vite-intlayer/intlayerProxy.md) aby poznać pełne referencje zachowania routowania.
+
+### 5. Bundled compiler (v9+)
+
+Gdy `compiler.enabled` jest `true` **oraz** `compiler.output` jest ustawiony w konfiguracji Intlayer, `intlayer()` rejestruje `intlayerCompiler` automatycznie. Compiler wyodrębnia deklaracje treści inline zapisane bezpośrednio w plikach komponentów i zapisuje je do słowników w czasie transformacji. Zobacz [dokumentację intlayerCompiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/vite-intlayer/intlayerCompiler.md).
+
+### 6. Optymalizacje budowania
+
+Podczas budowania w trybie produkcji plugin dodaje:
+
+- **intlayerOptimize** – transformacja Babel, która przepisuje `useIntlayer('key')` → `useDictionary(hash)` i wstrzykuje bezpośrednie importy JSON.
+- **intlayerPrune** – usuwa nieużywane pola zawartości z JSON słownika.
+- **intlayerMinify** – kompresuje JSON słownika i opcjonalnie zmienia nazwy pól.
+
+Te funkcje są nieaktywne w trybie rozwojowym.
+
+## Przestarzałe aliasy
 
-1. **Przygotowanie słowników**: kompiluje słowniki do zoptymalizowanych plików na początku procesu build lub w trybie deweloperskim.
-2. **Tryb nasłuchiwania**: w trybie deweloperskim obserwuje zmiany w plikach słowników i automatycznie je rekompiluje.
-3. **Aliasy**: udostępnia aliasy do dostępu do słowników w Twojej aplikacji.
-4. **Tree-shaking**: wspiera usuwanie nieużywanych tłumaczeń (tree-shaking) za pomocą pluginu `intlayerPrune`.
+| Przestarzały eksport | Zamiennik  |
+| -------------------- | ---------- |
+| `intlayerPlugin`     | `intlayer` |
+| `intLayerPlugin`     | `intlayer` |

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

@@ -30,16 +30,89 @@ Wtyczka Vite `intlayerPrune` służy do tree-shakingu i usuwania nieużywanych s
 
 ## Użycie
 
+### W ramach `intlayer()` (zalecane)
+
+Włącz pruning poprzez konfigurację Intlayer, a główny plugin zajmie się wszystkim:
+
+```ts
+// intlayer.config.ts
+import { defineConfig } from "intlayer";
+
+export default defineConfig({
+  build: {
+    optimize: true, // włącza zarówno prune, jak i minify
+  },
+});
+```
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+### Standalone
+
+Jeśli ręcznie komponujesz stos pluginów, `intlayerPrune` i `intlayerMinify` współdzielą obiekt `PruneContext`, który musi być utworzony raz i przekazany do obu:
+
 ```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), // opcjonalnie, odczytuje z tego samego kontekstu
+  ],
 });
 ```
 
-## Opis
+## Jak to działa
+
+### 1. Analiza użycia (buildStart)
+
+Podczas `buildStart`, plugin `intlayerOptimize` (również część `intlayer()`) skanuje każdy plik źródłowy komponentu wymieniony w `build.filesList`. Dla każdego wywołania `useIntlayer('key')` lub `getIntlayer('key')` rejestruje dokładnie, które pola są dostępne, np.:
+
+```ts
+const { title, description } = useIntlayer("myDict");
+// rejestruje: myDict → { title, description }
+```
+
+To buduje `pruneContext.fieldUsageMap` przed uruchomieniem jakichkolwiek wywołań `transform`.
+
+### 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. Przypadki szczególne
+
+Jeśli struktura zawartości słownika nie może być rozpoznana (np. niezwykły kształt zagnieżdżenia), jest dodawana do `pruneContext.dictionariesWithEdgeCases` i **pozostawiana bez zmian**. Rejestrowane jest ostrzeżenie. `intlayerMinify` również pomija te słowniki.
+
+### 4. Mapa zmian nazw pól
+
+Gdy przycinanie przebiegnie pomyślnie, `intlayerPrune` zapisuje również `pruneContext.dictionaryKeyToFieldRenameMap` — mapowanie z oryginalnych nazw pól na krótkie aliasy. `intlayerMinify` odczytuje tę mapę, aby zmienić nazwy pól w wyjściowym JSON, a przebieg zmiany nazwy Babel w `intlayerOptimize` aktualizuje dostępy do właściwości w plikach źródłowych odpowiednio.
+
+## Warunki aktywacji
+
+`intlayerPrune` jest aktywny **tylko** wtedy, gdy wszystkie poniższe warunki są spełnione:
+
+1. Polecenie Vite to `build`.
+2. `build.optimize` to `true` (lub `undefined`, które domyślnie przyjmuje wartość `true` dla kompilacji).
+3. `build.purge` to `true` w konfiguracji Intlayer.
 
-Wtyczka analizuje kod źródłowy, aby zidentyfikować, które klucze słowników są faktycznie używane. Następnie usuwa wszelkie nieużywane treści z zabundlowanych plików słowników. Jest to szczególnie przydatne w dużych projektach z wieloma słownikami, gdzie tylko podzbiór jest używany na określonych stronach lub w komponentach.
+Jest automatycznie **wyłączony** gdy `editor.enabled` to `true`, ponieważ edytor wymaga pełnej zawartości słownika.

package/docs/pl/releases/v9.md

@@ -373,21 +373,6 @@ curl -fsSL https://intlayer.org/install.sh | sh
 
 Instalator pobiera `docker-compose.yml` i `.env`, automatycznie generuje wymagane sekrety i uruchamia `docker compose up -d`. Wszystko — panel, API, baza danych, magazyn obiektów oraz transakcyjne wiadomości e-mail — działa lokalnie w kontenerach.
 
-### Uwzględnione serwisy
-
-| Serwis                                     | Przeznaczenie                                                                      |
-| ------------------------------------------ | ---------------------------------------------------------------------------------- |
-| **app** (TanStack Start)                   | Interfejs panelu na porcie `3000`                                                  |
-| **backend** (Fastify/Bun)                  | REST API na porcie `3100`                                                          |
-| **MongoDB 7** (jednowęzłowy zestaw replik) | Główna baza danych                                                                 |
-| **Redis 7**                                | Kolejki zadań i pamięć podręczna                                                   |
-| **MinIO**                                  | Magazyn obiektów zgodny z S3 (awatary, zrzuty ekranu)                              |
-| **Mailpit**                                | Lokalny odbiorca SMTP + interfejs webowy dla poczty transakcyjnej na porcie `8025` |
-
-Chromium (używany do generowania zrzutów ekranu przez Puppeteer) jest wbudowany w obraz backendu — żaden dodatkowy kontener nie jest potrzebny.
-
----
-
 ## Uwagi dotyczące migracji z wersji v8
 
 Jeśli aktualizujesz aplikację z wersji v8, pamiętaj, że wersja v9 nie zawiera zmian wprowadzających niekompatybilność wsteczną (breaking changes). Oto jednak kluczowe zmiany:

package/docs/pl/self_hosting.md

@@ -64,6 +64,32 @@ Chromium (używany do generowania zrzutów ekranu przez Puppeteer) jest dołącz
 
 ## Szybki start
 
+Pobierz i uruchom opublikowany obraz, podając swoje poświadczenia i sekrety MongoDB Atlas:
+
+```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
+```
+
+Następnie otwórz **http://localhost:3000**.
+
+> Dashboard jest obsługiwany na `localhost`. Zapoznaj się z [Ograniczeniami](#limitations) — domeny niestandardowe nie są obsługiwane przez opublikowany obraz.
+
+---
+
+## Szybki start
+
 ```sh
 curl -fsSL https://intlayer.org/install.sh | sh
 ```
@@ -99,7 +125,16 @@ Wewnętrzne porty (mongo, redis) nie są domyślnie udostępniane na hoście.
 
 ## Zmienne środowiskowe
 
-Instalator generuje gotowy do użycia plik `.env`. Poniższa tabela opisuje każdą zmienną.
+### Wymagane
+
+| Variable               | Example                      | Description                                                                                                                                                                   |
+| ---------------------- | ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `DB_ID`                | `intlayer`                   | Użytkownik MongoDB Atlas                                                                                                                                                      |
+| `DB_MDP`               | _(your password)_            | Hasło MongoDB Atlas                                                                                                                                                           |
+| `DB_CLUSTER`           | `cluster0.xxxxx.mongodb.net` | Host klastra MongoDB Atlas (używany w URI `mongodb+srv://`)                                                                                                                   |
+| `BETTER_AUTH_SECRET`   | _(generated)_                | 32-bajtowy secret do podpisywania sesji                                                                                                                                       |
+| `S3_SECRET_ACCESS_KEY` | _(generated)_                | Secret dla wbudowanego MinIO                                                                                                                                                  |
+| `RESEND_API_KEY`       | _(your key)_                 | Transakcyjne e-maile via Resend. Wymagane dla konfiguracji przy pierwszym uruchomieniu, chyba że skonfigurujesz globalny mailer SMTP (zobacz [Global mailer](#global-mailer)) |
 
 ### Wymagane (generowane automatycznie lub monitowane)
 
@@ -141,6 +176,26 @@ Instalator generuje gotowy do użycia plik `.env`. Poniższa tabela opisuje każ
 
 ---
 
+### Globalny dostawca poczty
+
+Domyślnie wszystkie transakcyjne wiadomości e-mail są wysyłane za pośrednictwem Resend przy użyciu `RESEND_API_KEY`. Wdrożenia self-hosted mogą zamiast tego kierować **każdy** e-mail — w tym e-maile niezwiązane z organizacją, takie jak resetowanie hasła i linki magiczne — za pośrednictwem globalnego dostawcy poczty skonfigurowanego zmiennymi środowiskowymi.
+
+Ustaw `MAIL_PROVIDER`, aby go aktywować. Jeśli nie jest ustawiony, używany jest domyślny dostawca Resend.
+
+| Zmienna              | Przykład                       | Opis                                                                              |
+| -------------------- | ------------------------------ | --------------------------------------------------------------------------------- |
+| `MAIL_PROVIDER`      | `smtp`                         | Transport globalny: `smtp` lub `resend`. Pozostaw puste, aby użyć domyślnych      |
+| `MAIL_FROM`          | `Intlayer <no-reply@acme.com>` | Nagłówek nadawcy. Akceptuje zwykły adres lub format `Nazwa <email>`               |
+| `MAIL_SMTP_HOST`     | `smtp.acme.com`                | Host SMTP (wymagany, gdy `MAIL_PROVIDER=smtp`)                                    |
+| `MAIL_SMTP_PORT`     | `587`                          | Port SMTP (domyślnie `587`)                                                       |
+| `MAIL_SMTP_SECURE`   | `false`                        | Niejawny TLS. Ustaw `true` dla portu `465`                                        |
+| `MAIL_SMTP_USER`     | _(twoja nazwa użytkownika)_    | Nazwa użytkownika SMTP (opcjonalnie; pomiń dla nieuwierzytelnionych przekaźników) |
+| `MAIL_SMTP_PASSWORD` | _(twoje hasło)_                | Hasło SMTP                                                                        |
+
+> Priorytet: własny dostawca poczty organizacji (skonfigurowany z pulpitu **Organizacji**) ma priorytet nad globalnym dostawcą poczty, który z kolei ma priorytet nad domyślnym kluczem Resend.
+
+---
+
 ## Łączenie Twojego projektu Intlayer
 
 Po uruchomieniu stosu, skieruj swój projekt na samodzielnie hostowany backend i pulpit nawigacyjny zamiast na `intlayer.org`.
@@ -259,47 +314,11 @@ docker run --rm \
 
 ---
 
-## Używanie reverse proxy (Nginx / Caddy)
-
-W przypadku wdrożeń produkcyjnych, umieść reverse proxy przed kontenerami aplikacji i backendu, zamiast udostępniać je bezpośrednio.
-
-### Przykład 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;
-    }
-}
+## Ograniczenia
 
-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;
-    }
-}
-```
-
-Zaktualizuj poniższe zmienne `.env`, aby odpowiadały Twoim publicznym domenom:
-
-```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
-```
-
-> Zmienne `VITE_*` są wbudowywane w obraz pulpitu nawigacyjnego podczas kompilacji. Jeśli zmienisz je po zbudowaniu obrazu, musisz ponownie zbudować obraz `app` (`docker compose build app`) lub użyć wstrzykiwania konfiguracji w czasie uruchomienia.
+- **MongoDB musi być zewnętrzna (Atlas).** Backend łączy się tylko przez `mongodb+srv://` (zbudowany z `DB_ID` / `DB_MDP` / `DB_CLUSTER`), więc zwykły `mongodb://host:27017` — w tym wbudowany `mongod` kontenera — nie może być używany. Zapewnij klaster MongoDB Atlas.
+- **Brak niestandardowej domeny.** Wszystkie adresy URL `VITE_*` dostępne w przeglądarce są wbudowywane w aplikację w czasie kompilacji, a opublikowany obraz zawiera wartości `localhost`. Dostęp do dashboardu musi być realizowany pod adresem `http://localhost:3000`; udostępnienie go w domenie publicznej wymagałoby przebudowania obrazu z docelowymi adresami URL wbakowanymi w kod i nie jest obsługiwane out of the box.
+- **Email wymaga działającego mailera.** Konfiguracja przy pierwszym uruchomieniu wymusza weryfikację email, więc musi być skonfigurowany `RESEND_API_KEY` lub [globalny mailer SMTP](#global-mailer) (`MAIL_PROVIDER=smtp` + `MAIL_SMTP_*`). Po zalogowaniu się pierwszego administratora każda organizacja może również skonfigurować swój własny mailer SMTP lub Resend z dashboardu.
 
 ---
 
@@ -324,14 +343,6 @@ docker compose build app
 docker compose up -d app
 ```
 
-### E-mail nie jest wysyłany
-
-Domyślnie wszystkie wychodzące wiadomości e-mail są przechwytywane przez Mailpit. Otwórz `http://localhost:8025`, aby zobaczyć wysłane wiadomości. Aby wysyłać prawdziwe wiadomości e-mail, ustaw `MAIL_PROVIDER=resend` i `RESEND_API_KEY=<your-key>` w `.env`, a następnie zrestartuj backend:
-
-```sh
-docker compose restart backend
-```
-
 ### Brak zasobnika MinIO
 
 Jeśli jednorazowa usługa `minio-init` nie uruchomiła się (lub uruchomiła się, zanim MinIO było gotowe), utwórz zasobnik ręcznie: