docs: update docs and minimize env.example

2026-05-21 11:26:59 +03:00
parent 028f0680c6
commit 7fe53993aa
8 changed files with 628 additions and 591 deletions
@@ -11,10 +11,11 @@ Web App собирается в отдельный `frontend` image и отда
 - доступные тарифы, способы оплаты и платежный статус;
 - смену тарифа, обычную докупку трафика и докупку premium-трафика при настроенном каталоге тарифов;
 - раздел "Мои устройства" при `MY_DEVICES_SECTION_ENABLED=True`;
+- раздел "Поддержка" с тикетами и внешней ссылкой `SUPPORT_LINK` при включенном `SUPPORT_TICKETS_ENABLED`;
 - реферальную ссылку и статистику приглашений;
 - привязку email и Telegram к одному аккаунту.

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

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

@@ -45,12 +46,18 @@ SMTP_USERNAME=<smtp-login>
 SMTP_PASSWORD=<smtp-password-or-key>
 SMTP_FROM_EMAIL=no-reply@domain.com
 SMTP_FROM_NAME=Remnawave Minishop
+
+SUPPORT_LINK=https://t.me/your_support_link
+SUPPORT_TICKETS_ENABLED=True
+SUPPORT_TICKET_RATE_LIMIT_PER_HOUR=5
 ```

 Внешний вид настраивается в админке: раздел **Внешний вид** управляет логотипом, 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).
+
 ## Telegram-авторизация

 Внутри Telegram Mini App пользователь авторизуется через Telegram Mini Apps `initData`. При открытии страницы вне Telegram используется Telegram OAuth / OpenID Connect Authorization Code Flow с PKCE, callback `/auth/telegram/callback`, `nonce` и серверной проверкой `id_token` по JWKS Telegram.