docs: refactor docs structure

2026-05-26 21:45:44 +03:00
parent 0c167c8f09
commit 0df52d0235
41 changed files with 455 additions and 669 deletions
@@ -42,14 +42,14 @@

 - общие параметры: язык, валюта, ссылки поддержки, документы, обязательный канал, Remnawave-доступы и поведение `/start`;
 - внешний вид и доступность Web App: название, цвет, логотип, emoji-логотип и `WEBAPP_ENABLED`;
- инструкции подключения: `SUBSCRIPTION_GUIDES_ENABLED`, `SUBSCRIPTION_GUIDES_BOT_MENU_ENABLED`, чтение конфига из Remnawave Panel, JSON-override и fallback-путь к файлу;
+- инструкции подключения: `SUBSCRIPTION_GUIDES_ENABLED`, `SUBSCRIPTION_GUIDES_BOT_MENU_ENABLED`, чтение конфига из Remnawave Panel, JSON-переопределение и резервный путь к файлу;
 - legacy-цены без JSON-каталога: периоды подписки, RUB/Stars цены и пакеты трафика;
 - платежные провайдеры: включение методов, порядок кнопок, публичные параметры и секреты YooKassa, FreeKassa, Platega, SeverPay, Wata, CryptoPay, Heleket и Stars, а также текст и иконки кнопок оплаты;
 - пробный период, реферальные бонусы, уведомления, логирование, поддержка, раздел устройств, лимит устройств и legacy-лимиты трафика.

 Секретные поля помечены как secret и не должны использоваться для произвольного просмотра старых значений. Настройки, которых нет в manifest, остаются только в `.env` или коде.

-Для каждого платежного метода в разделе провайдера доступны presentation-настройки `PAYMENT_<METHOD>_WEBAPP_LABEL_RU`, `PAYMENT_<METHOD>_WEBAPP_LABEL_EN`, `PAYMENT_<METHOD>_WEBAPP_ICON`, `PAYMENT_<METHOD>_TELEGRAM_LABEL_RU`, `PAYMENT_<METHOD>_TELEGRAM_LABEL_EN` и `PAYMENT_<METHOD>_TELEGRAM_EMOJI`. Пустое значение возвращает мультиязычный дефолт из модуля платежного провайдера. Иконка Web App выбирается из уже подключённых lucide-иконок (`frontend/src/lib/components/ui/icons.js`) через модалку в админке.
+Для каждого платежного метода в разделе провайдера доступны настройки отображения `PAYMENT_<METHOD>_WEBAPP_LABEL_RU`, `PAYMENT_<METHOD>_WEBAPP_LABEL_EN`, `PAYMENT_<METHOD>_WEBAPP_ICON`, `PAYMENT_<METHOD>_TELEGRAM_LABEL_RU`, `PAYMENT_<METHOD>_TELEGRAM_LABEL_EN` и `PAYMENT_<METHOD>_TELEGRAM_EMOJI`. Пустое значение возвращает мультиязычное значение по умолчанию из модуля платежного провайдера. Иконка Web App выбирается из уже подключенных lucide-иконок (`frontend/src/lib/components/ui/icons.js`) через модалку в админке.

 ## Переводы

@@ -76,9 +76,9 @@

 Секция **Система -> Настройки -> Инструкции подключения** управляет встроенным экраном установки. `SUBSCRIPTION_GUIDES_ENABLED` включает `/install` в личном кабинете, а `SUBSCRIPTION_GUIDES_BOT_MENU_ENABLED` заставляет кнопки подключения в Telegram-боте открывать Mini App вместо финальной Remnawave Subscription Page. Оба переключателя включены по умолчанию.

-По умолчанию Minishop читает Remnawave Subscription Page config из панели (`SUBSCRIPTION_PAGE_CONFIG_PANEL_ENABLED=True`). Это основной режим, потому что один и тот же конфиг используется и в панели, и во встроенной инструкции. JSON-поле `SUBSCRIPTION_PAGE_CONFIG_JSON` применяется только когда явно включен `SUBSCRIPTION_PAGE_CONFIG_JSON_OVERRIDE_ENABLED`; иначе оно может храниться в админке, но не влияет на пользователей. `SUBSCRIPTION_PAGE_CONFIG_PATH` остается fallback-путем к локальному v1 JSON-файлу, если конфиг панели отключен или недоступен.
+По умолчанию Minishop читает конфиг Remnawave Subscription Page из панели (`SUBSCRIPTION_PAGE_CONFIG_PANEL_ENABLED=True`). Это основной режим, потому что один и тот же конфиг используется и в панели, и во встроенной инструкции. JSON-поле `SUBSCRIPTION_PAGE_CONFIG_JSON` применяется только когда явно включен `SUBSCRIPTION_PAGE_CONFIG_JSON_OVERRIDE_ENABLED`; иначе оно может храниться в админке, но не влияет на пользователей. `SUBSCRIPTION_PAGE_CONFIG_PATH` остается резервным путем к локальному v1 JSON-файлу, если конфиг панели отключен или недоступен.

-При сохранении backend валидирует JSON-override как Remnawave Subscription Page v1 config. Ошибки показываются как обычные validation errors настроек, а если рабочий конфиг недоступен, пользовательская кнопка подключения откатывается к старой финальной ссылке подписки.
+При сохранении backend валидирует JSON-переопределение как конфиг Remnawave Subscription Page v1. Ошибки показываются как обычные ошибки валидации настроек, а если рабочий конфиг недоступен, пользовательская кнопка подключения откатывается к старой финальной ссылке подписки.

 ## Поддержка

@@ -86,7 +86,7 @@

 В карточке тикета администратор видит диалог, пользовательский контекст и действия: ответить пользователю, оставить внутреннюю заметку, изменить статус, приоритет, категорию или исполнителя, закрыть тикет и перейти в карточку пользователя. Внутренние заметки не показываются пользователю.

-Счетчик непрочитанных обращений отображается в навигации админки. Уведомления о новых тикетах и ответах пользователя настраиваются через `LOG_SUPPORT`, `LOG_SUPPORT_THREAD_ID` и параметры `SUPPORT_*`. Подробности: [support.md](support.md).
+Счетчик непрочитанных обращений отображается в навигации админки. Уведомления о новых тикетах и ответах пользователя настраиваются через `LOG_SUPPORT`, `LOG_SUPPORT_THREAD_ID` и параметры `SUPPORT_*`. Подробности: [поддержка пользователей / тикеты](support.md).

 ## Внешний вид

@@ -19,4 +19,4 @@ Minishop закрывает путь от регистрации пользов
 - Ручная синхронизация с Remnawave Panel.
 - Редактор JSON-каталога тарифов.

-Подробности: [админ-панель](admin-panel.md), [Mini App](web-app.md) и [поддержка](support.md).
+Подробности: [админ-панель](admin-panel.md), [Mini App](web-app.md) и [поддержка пользователей / тикеты](support.md).
@@ -1,28 +1,152 @@
 # Платежи

-Платежные методы включаются настройками и отображаются пользователю как кнопки оплаты в Mini App и Telegram-сценариях.
-
-## Поддерживаемые провайдеры
-
- [YooKassa](../payments/yookassa.md)
- [FreeKassa](../payments/freekassa.md)
- [Platega](../payments/platega.md)
- [SeverPay](../payments/severpay.md)
- [Wata](../payments/wata.md)
- [CryptoPay](../payments/cryptopay.md)
- [Heleket](../payments/heleket.md)
- [Telegram Stars](../payments/telegram-stars.md)
+Платежные методы включаются настройками и отображаются пользователю как кнопки оплаты в Mini App и Telegram-сценариях. Настройки можно задавать через `.env` или через админку, если параметр есть в allowlist настроек.

 ## Типовой порядок настройки

 1. Включите нужный провайдер в админке или через `.env`.
-2. Заполните публичные параметры и секреты.
-3. Настройте webhook URL у провайдера, если это требуется.
-4. Проверьте порядок и подписи кнопок оплаты.
-5. Выполните тестовый платеж и проверьте логи backend.
+2. Заполните публичные параметры, секреты и URL возврата.
+3. Настройте URL вебхука у провайдера, если это требуется.
+4. Проверьте порядок методов в `PAYMENT_METHODS_ORDER`.
+5. Проверьте подписи и иконки кнопок оплаты.
+6. Выполните тестовый платеж и проверьте логи `backend`.

-## Где смотреть параметры
+Общие ссылки:

 - [Справочник `.env`](../configuration/env-vars.md) содержит все ключи провайдеров.
 - [Админ-панель](admin-panel.md) описывает UI-настройки платежей.
- [Тарифы](tariffs.md) описывают цены, Stars и сценарии покупки.
+- [Тарифы](tariffs.md) описывают цены, Telegram Stars и сценарии покупки.
+- [Логи](../troubleshooting/logs.md) помогают проверить webhook и создание платежных ссылок.
+
+## YooKassa
+
+YooKassa используется для рублевых оплат и может участвовать в сценариях автопродления period-подписок.
+
+Что настроить:
+
+- включение провайдера: `YOOKASSA_ENABLED`;
+- идентификаторы и секреты магазина;
+- URL вебхука на backend-домен;
+- отображение кнопки оплаты и порядок платежных методов.
+
+Справочник переменных: [YooKassa](../configuration/env-vars.md#yookassa).
+
+## FreeKassa
+
+FreeKassa подключается как отдельный платежный метод и обрабатывает входящие webhook-события через `backend`.
+
+Что настроить:
+
+- включение провайдера: `FREEKASSA_ENABLED`;
+- ID магазина, API/secret-ключи и настройки подписи;
+- список доверенных IP, если используется;
+- публичный URL вебхука на `WEBHOOK_BASE_URL`.
+
+Справочник переменных: [FreeKassa](../configuration/env-vars.md#freekassa).
+
+## Platega
+
+Platega подключается как отдельный платежный провайдер, но внутри Minishop может дать несколько кнопок: основную устаревшую кнопку, СБП/карту и крипто-кнопку. Общие параметры мерчанта задаются один раз, а ID методов оплаты и подписи кнопок настраиваются отдельно.
+
+Что включить:
+
+- `PLATEGA_ENABLED` - общий флаг провайдера;
+- `PLATEGA_SBP_ENABLED` - отдельная кнопка СБП/карта;
+- `PLATEGA_CRYPTO_ENABLED` - отдельная crypto-кнопка Platega;
+- `PLATEGA_PAYMENT_METHOD` - устаревший/резервный ID метода оплаты для старых callback-запросов и старых установок.
+
+Что настроить:
+
+1. Укажите `PLATEGA_BASE_URL`, `PLATEGA_MERCHANT_ID` и `PLATEGA_SECRET`.
+2. Заполните `PLATEGA_SBP_METHOD` и/или `PLATEGA_CRYPTO_METHOD`, если используете отдельные кнопки.
+3. Проверьте `PLATEGA_RETURN_URL` и `PLATEGA_FAILED_URL`.
+4. Настройте тексты и иконки кнопок через `PAYMENT_PLATEGA_SBP_*` и `PAYMENT_PLATEGA_CRYPTO_*`.
+5. Добавьте нужные методы в `PAYMENT_METHODS_ORDER`.
+
+Справочник переменных: [Platega](../configuration/env-vars.md#platega).
+
+## SeverPay
+
+SeverPay подключается как отдельный платежный метод с собственным MID, token и сроком жизни платежной ссылки.
+
+Что настроить:
+
+1. Включите `SEVERPAY_ENABLED`.
+2. Укажите `SEVERPAY_BASE_URL`.
+3. Заполните `SEVERPAY_MID` и `SEVERPAY_TOKEN`.
+4. Настройте `SEVERPAY_RETURN_URL`.
+5. При необходимости задайте `SEVERPAY_LIFETIME_MINUTES`.
+6. Добавьте `severpay` в `PAYMENT_METHODS_ORDER`.
+
+Справочник переменных: [SeverPay](../configuration/env-vars.md#severpay).
+
+## Wata
+
+Wata подключается как отдельный провайдер с bearer token, платежными ссылками и опциональной проверкой подписи webhook.
+
+Что настроить:
+
+1. Включите `WATA_ENABLED`.
+2. Укажите `WATA_BASE_URL` и `WATA_API_TOKEN`.
+3. Проверьте `WATA_RETURN_URL` и `WATA_FAILED_URL`.
+4. Настройте `WATA_LINK_TTL_MINUTES`: минимум 15 минут, максимум 43200.
+5. Если включаете проверку подписи, задайте `WATA_WEBHOOK_VERIFY_SIGNATURE` и при необходимости `WATA_PUBLIC_KEY`.
+6. Для дополнительной защиты заполните `WATA_TRUSTED_IPS`.
+7. Добавьте `wata` в `PAYMENT_METHODS_ORDER`.
+
+Справочник переменных: [Wata](../configuration/env-vars.md#wata).
+
+## CryptoPay
+
+CryptoPay используется для криптовалютных платежей через отдельный токен и сеть Crypto Bot API.
+
+Что настроить:
+
+1. Включите `CRYPTOPAY_ENABLED`.
+2. Укажите `CRYPTOPAY_TOKEN`.
+3. Выберите `CRYPTOPAY_NETWORK`: `mainnet` или `testnet`.
+4. Задайте `CRYPTOPAY_CURRENCY_TYPE`: `fiat` или `crypto`.
+5. Проверьте `CRYPTOPAY_ASSET`, например `RUB`, `USDT` или `BTC`.
+6. Добавьте `cryptopay` в `PAYMENT_METHODS_ORDER`.
+
+Для тестов используйте соответствующую сеть: testnet-токен не должен попадать в mainnet-настройки. Если сумма или asset выглядят неверно, проверьте сочетание `CRYPTOPAY_CURRENCY_TYPE` и `CRYPTOPAY_ASSET`.
+
+Справочник переменных: [CryptoPay](../configuration/env-vars.md#cryptopay).
+
+## Heleket
+
+Heleket используется для крипто-инвойсов с отдельными merchant ID, ключом платежного API, валютой инвойса и настройками проверки webhook.
+
+Что настроить:
+
+1. Включите `HELEKET_ENABLED`.
+2. Укажите `HELEKET_BASE_URL`, `HELEKET_MERCHANT_ID` и `HELEKET_API_KEY`.
+3. Настройте `HELEKET_CURRENCY`.
+4. При необходимости задайте `HELEKET_TO_CURRENCY` и `HELEKET_NETWORK`.
+5. Проверьте `HELEKET_RETURN_URL` и `HELEKET_SUCCESS_URL`.
+6. Настройте `HELEKET_LIFETIME_SECONDS`: допустимый диапазон 300..43200.
+7. Если включаете проверку webhook, задайте `HELEKET_VERIFY_WEBHOOK_SIGNATURE`.
+8. Для IP-фильтрации заполните `HELEKET_TRUSTED_IPS`.
+9. Добавьте `heleket` в `PAYMENT_METHODS_ORDER`.
+
+Справочник переменных: [Heleket](../configuration/env-vars.md#heleket).
+
+## Telegram Stars
+
+Telegram Stars используются напрямую и поддерживаются в legacy-ценах и JSON-каталоге тарифов.
+
+Где применяются Stars:
+
+- цены периодов подписки;
+- пакеты трафика;
+- premium-докупки;
+- HWID-докупки, если они включены в каталоге тарифов.
+
+Что проверить:
+
+- `STARS_ENABLED`;
+- Stars-цены в legacy-настройках или JSON-каталоге;
+- корректное округление цены до целого количества Stars;
+- сценарии смены тарифа: XTR/Stars-докупки не конвертируются без явного курса.
+
+См. также [переменные платежей](../configuration/env-vars.md#платежи) и [тарифы](tariffs.md).
@@ -1,4 +1,4 @@
-# Поддержка
+# Поддержка пользователей / тикеты

 В проекте есть два канала поддержки:

@@ -22,8 +22,8 @@ JSON-каталог может содержать несколько тариф
 - добавление, редактирование и удаление тарифов;
 - включение и выключение тарифа на витрине;
 - выбор тарифа по умолчанию;
- настройка `period`-тарифов: месячный лимит, периоды, RUB/Stars цены, пакеты докупки трафика;
- настройка `traffic`-тарифов: пакеты GB, RUB/Stars цены, курс конвертации;
+- настройка тарифов на срок (`period`): месячный лимит, периоды, RUB/Stars цены, пакеты докупки трафика;
+- настройка тарифов по трафику (`traffic`): пакеты GB, RUB/Stars цены, курс конвертации;
 - настройка базовых Internal Squads из списка Remnawave;
 - настройка premium-раздела: названия RU/EN, premium Internal Squads, месячный premium-лимит и RUB/Stars пакеты докупки premium-трафика;
 - настройка базового HWID-лимита и пакетов докупки устройств.
@@ -120,7 +120,7 @@ JSON-каталог может содержать несколько тариф

 Если у traffic-тарифа нет RUB-пакетов, `conversion_rate_rub_per_gb` обязателен.

-## Period-тарифы
+## Тарифы на срок (`period`)

 `period` продает доступ на срок с месячным лимитом трафика.

@@ -187,7 +187,7 @@ JSON-каталог может содержать несколько тариф

 В Web App админке premium-сквады можно выбрать из выпадающего списка на вкладке **Premium** в редакторе тарифа. Список берется из API Remnawave (`/api/admin/panel/internal-squads`), поэтому UUID обычно не нужно копировать вручную.

-## Traffic-тарифы
+## Тарифы по трафику (`traffic`)

 `traffic` продает объем трафика без пользовательского срока действия.

@@ -1,8 +1,8 @@
-# Web App / Mini App
+# Веб-приложение / Mini App

-Web App собирается в отдельный `frontend` image и отдается через nginx. Static/Mini App запросы идут в `frontend:80`; frontend nginx проксирует `/api/*`, `/auth/*` и theme/logo assets в backend WebApp server на `backend:8081`. Telegram, payment и panel webhook routes остаются на backend webhook server `backend:8080`.
+Веб-приложение собирается в отдельный образ `frontend` и отдается через nginx. Статические запросы Mini App идут в `frontend:80`; frontend nginx проксирует `/api/*`, `/auth/*` и ассеты тем/логотипов во внутренний WebApp-сервер backend на `backend:8081`. Telegram, платежные и панельные webhook-маршруты остаются на backend-сервере вебхуков `backend:8080`.

-## Что показывает Web App
+## Что показывает веб-приложение

 - текущую ссылку подключения;
 - статус и дату окончания подписки;
@@ -16,7 +16,7 @@ Web App собирается в отдельный `frontend` image и отда
 - реферальную ссылку и статистику приглашений;
 - привязку email и Telegram к одному аккаунту.

-Для администраторов из `ADMIN_IDS` Web App также показывает админ-панель: статистику, **пользователей** (поиск, фильтры, premium-трафик), поддержку, рассылки, промокоды, логи, настройки и редактор тарифов. Подробности: [админ-панель](admin-panel.md).
+Для администраторов из `ADMIN_IDS` веб-приложение также показывает админ-панель: статистику, **пользователей** (поиск, фильтры, premium-трафик), поддержку, рассылки, промокоды, логи, настройки и редактор тарифов. Подробности: [админ-панель](admin-panel.md).

 ## Настройки `.env`

@@ -57,7 +57,7 @@ SUPPORT_TICKETS_ENABLED=True
 SUPPORT_TICKET_RATE_LIMIT_PER_HOUR=5
 ```

-`SUBSCRIPTION_MINI_APP_URL` - это публичный HTTPS URL именно frontend/Mini App, обычно отдельный домен вроде `https://app.domain.com/`. Его указывают в BotFather в Mini Apps, а бот использует его для кнопок личного кабинета, referral-ссылок и email-входа. Не добавляйте в него `/api`, `/webhook` или путь конкретной страницы.
+`SUBSCRIPTION_MINI_APP_URL` - это публичный HTTPS URL именно frontend/Mini App, обычно отдельный домен вроде `https://app.domain.com/`. Его указывают в BotFather в Mini Apps, а бот использует его для кнопок личного кабинета, реферальных ссылок и входа по email. Не добавляйте в него `/api`, `/webhook` или путь конкретной страницы.

 ## Инструкции установки

@@ -75,17 +75,17 @@ SUPPORT_TICKET_RATE_LIMIT_PER_HOUR=5

 Личный экран показывает QR-код финальной ссылки подписки, кнопку копирования и кнопку **Поделиться**. Для передачи инструкции генерируется публичная ссылка `/s/<token>`: она открывает тот же интерфейс инструкций без авторизации и нижней навигации, но без QR-блока. Публичный payload отдается через `/api/subscription-guides/public/{share_token}` только для активной локальной подписки с валидным share token.

-`SUBSCRIPTION_GUIDES_BOT_MENU_ENABLED=True` включает такое же поведение в Telegram-боте: кнопки подключения открывают Mini App `/install`, а после успешной оплаты, trial или промокода пользователь получает публичную ссылку `/s/<token>`. Если настройку выключить, бот снова отправляет пользователя на финальную Remnawave Subscription Page.
+`SUBSCRIPTION_GUIDES_BOT_MENU_ENABLED=True` включает такое же поведение в Telegram-боте: кнопки подключения открывают Mini App `/install`, а после успешной оплаты, пробного периода или промокода пользователь получает публичную ссылку `/s/<token>`. Если настройку выключить, бот снова отправляет пользователя на финальную Remnawave Subscription Page.

 Конфиг совместим с Remnawave Subscription Page v1 (`version`, `locales`, `brandingSettings`, `uiConfig`, `baseSettings`, `baseTranslations`, `svgLibrary`, `platforms`). Backend проверяет обязательные locale-строки, допустимые платформы и типы кнопок, ссылки на `svgIconKey`, а SVG из `svgLibrary` санитизирует перед отдачей в UI.

-Если `WEBAPP_ENABLED=False`, пользовательский Web App и админ-панель не регистрируются. Чтобы снова попасть в админку, включите `WEBAPP_ENABLED=True` в `.env` и перезапустите backend/frontend контейнеры.
+Если `WEBAPP_ENABLED=False`, пользовательское веб-приложение и админ-панель не регистрируются. Чтобы снова попасть в админку, включите `WEBAPP_ENABLED=True` в `.env` и перезапустите backend/frontend контейнеры.

 Внешний вид настраивается в админке: раздел **Внешний вид** управляет логотипом, emoji-логотипом, accent-цветом, выбранной темой и масштабом логотипа. Кастомные темы читаются из `WEBAPP_THEMES_DIR`, а `WEBAPP_DEFAULT_THEME` может принудительно выбрать тему по ключу. Подробный контракт `theme.json`, CSS/asset-роуты и пайплайн создания темы описаны в [webapp-themes.md](webapp-themes.md).

 Если SMTP-настройки не заполнены, вход по email скрывается.

-Тикеты поддержки включаются через `SUPPORT_TICKETS_ENABLED`; внешний резервный контакт задается `SUPPORT_LINK`. Полный сценарий пользователя, админа и уведомлений описан в [support.md](support.md).
+Тикеты поддержки включаются через `SUPPORT_TICKETS_ENABLED`; внешний резервный контакт задается `SUPPORT_LINK`. Полный сценарий пользователя, админа и уведомлений описан в разделе [поддержка пользователей / тикеты](support.md).

 ## Telegram-авторизация

@@ -97,7 +97,7 @@ SUPPORT_TICKET_RATE_LIMIT_PER_HOUR=5
 2. В `Bot Settings` -> `Domain` укажите домен Web App без протокола и пути, например `app.domain.com`.
 3. В `Bot Settings` -> `Mini Apps` укажите URL, например `https://app.domain.com/`.
 4. В `Bot Settings` -> `Web Login` включите OpenID Connect Login, если BotFather предлагает переключение.
-5. Скопируйте Client ID и Client Secret в `TELEGRAM_OAUTH_CLIENT_ID` и `TELEGRAM_OAUTH_CLIENT_SECRET`.
+5. Скопируйте идентификатор клиента и секрет клиента в `TELEGRAM_OAUTH_CLIENT_ID` и `TELEGRAM_OAUTH_CLIENT_SECRET`.
 6. В `Web Login` -> `Allowed URLs` добавьте:

 ```text
@@ -107,9 +107,9 @@ https://app.domain.com/auth/telegram/callback

 `TELEGRAM_OAUTH_REQUEST_ACCESS=write` разрешает боту написать пользователю после логина. Если дополнительные разрешения не нужны, оставьте переменную пустой.

-## Email-вход
+## Вход по email

-Email-вход работает через одноразовый код:
+Вход по email работает через одноразовый код:

 1. Пользователь вводит email.
 2. Бот отправляет код через SMTP.
@@ -118,25 +118,25 @@ Email-вход работает через одноразовый код:

 Для Brevo обычно подходит порт `587` с STARTTLS. Если основной порт недоступен, приложение пробует порты из `SMTP_FALLBACK_PORTS`; порт `465` используется через SSL.

-Полный список переменных, обязательные поля для включения email-входа и типичные ошибки подключения описаны в разделе **SMTP и вход по email** в [configuration.md](../configuration.md).
+Полный список переменных, обязательные поля для включения входа по email и типичные ошибки подключения описаны в разделе **SMTP и вход по email** в [configuration.md](../configuration.md).

 ## Проксирование

-Рекомендуемая production-схема - два публичных домена:
+Рекомендуемая продакшен-схема - два публичных домена:

 - `WEBHOOK_BASE_URL`, например `https://webhooks.domain.com`, целиком проксируется в `backend:8080`;
 - `SUBSCRIPTION_MINI_APP_URL`, например `https://app.domain.com/`, целиком проксируется в `frontend:80`.

 `frontend` уже сам проксирует `/api/*`, `/auth/*`, `/webapp-logo` и ассеты тем/логотипов во внутренний
-WebApp API на `backend:8081`, поэтому внешний reverse proxy обычно не должен отправлять эти пути в
+WebApp API на `backend:8081`, поэтому внешний обратный прокси обычно не должен отправлять эти пути в
 `backend:8081` напрямую.

-Готовые варианты описаны в [Deploy examples](../deploy-examples/index.md):
+Готовые варианты описаны в разделе [Развертывание](../deployment.md#готовые-папки-запуска):

- [Caddy](../deploy-examples/caddy.md) - автоматический HTTPS;
- [Nginx](../deploy-examples/nginx.md) - сертификаты в соседней папке `ssl/`;
- [Pangolin/Newt](../deploy-examples/newt.md) - публикация без входящих портов на сервере приложения;
- [No proxy](../deploy-examples/no-proxy.md) - прямая публикация портов для проверки или внешней TLS-платформы.
+- [Caddy](../deployment.md#caddy-рекомендуемый-вариант) - автоматический HTTPS;
+- [Nginx](../deployment.md#nginx) - сертификаты в соседней папке `ssl/`;
+- [Pangolin/Newt](../deployment.md#pangolin--newt) - публикация без входящих портов на сервере приложения;
+- [без обратного прокси](../deployment.md#без-обратного-прокси) - прямая публикация портов для проверки или внешней TLS-платформы.

 В default `docker-compose.yml` наружу публикуются `frontend` и webhook/backend port, а внутри Docker
 network сервисы доступны друг другу по service DNS names:
@@ -158,6 +158,6 @@ services:
 - Telegram deep-link: `https://t.me/<bot>?start=ref_u<code>`;
 - Web App ссылка: `https://app.domain.com/?ref=u<code>`.

-Web App учитывает `ref`, `start`, `start_param` и Telegram Mini Apps `start_param`, сохраняет найденный параметр до авторизации и передает его в Telegram OAuth или email-вход.
+Веб-приложение учитывает `ref`, `start`, `start_param` и Telegram Mini Apps `start_param`, сохраняет найденный параметр до авторизации и передает его в Telegram OAuth или вход по email.

 Для email-регистраций пользователь в Remnawave создается с username вида `em_<referral_code>`. Email добавляется в описание пользователя панели и, если API панели принимает поле `email`, передается отдельным полем. Для Telegram-регистраций используется username `tg_<telegram_id>`.