> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bedolagam.ru/llms.txt
> Use this file to discover all available pages before exploring further.

# Админ-панель

> Управление ботом через Telegram

## Обзор

Админ-панель доступна в Telegram для пользователей, чьи Telegram ID указаны в `ADMIN_IDS`. Все разделы работают через инлайн-кнопки с пагинацией.

## Управление пользователями

### Поиск и фильтрация

| Фильтр | Описание |
| - | - |
| ID, username, имя | Текстовый поиск |
| Telegram ID | Прямой поиск по ID |
| По балансу | Выше/ниже порога |
| По тратам | Общая сумма покупок |
| По трафику | Использование трафика |
| По активности | Последняя активность |
| По кампании | Пользователи конкретной рекламной кампании |
| Готовы к продлению | Баланс >= `SUBSCRIPTION_RENEWAL_BALANCE_THRESHOLD_KOPEKS` |

> [!NOTE]
>
> С `v3.67.0` поиск по пользователям регистронезависим и для кириллицы. С `v4.1.0` список сортируется по ближайшему окончанию подписки; активные суточные тарифы из этой сортировки исключены — их дата окончания сдвигается при каждом списании, и они навсегда занимали бы верх списка.

### Действия с пользователем

| Действие | Описание |
| - | - |
| Изменить баланс | Начисление или списание |
| Изменить лимиты | Устройства, трафик, серверы |
| Сброс HWID | Сброс привязки устройств |
| Перегенерация подписки | Новые ключи подключения |
| Назначить промо-группу | Выбор из существующих |
| Назначить тариф | Привязка к тарифу |
| Купить подписку | Прямо из админки |
| Продлить/сократить | ±365 дней |
| Блокировка | С таймером, аудит действий |
| Ограничения | Блокировка функций (покупка, триал, пополнение) |
| Отправить сообщение | Прямое сообщение пользователю |
| Установить комиссию | Индивидуальный реферальный процент |

### Чёрный список

Управление заблокированными пользователями. Подробнее: [Чёрный список](https://docs.bedolagam.ru/bot/maintenance.md#чёрный-список).

## Платежи и транзакции

* Список всех транзакций с пагинацией
* Фильтрация по провайдеру, статусу, периоду
* Проверка статуса платежа в платёжной системе
* Статистика по провайдерам
* Тестовые платежи для каждого провайдера
* Управление вебхуками платёжных систем
* Причина отказа платежа прямо в карточке транзакции (`v3.62.0`) — не нужно идти в кабинет провайдера
* Платёжные провайдеры собраны в разделе «Платёжные системы» (`v3.65.0`)

## Подписки

* Активные подписки
* Просроченные подписки
* Ручное управление: продление, отключение
* Привязка к тарифу/промо-группе

## Рассылки

Массовые уведомления с расширенными фильтрами аудитории. Подробнее: [Уведомления и рассылки](https://docs.bedolagam.ru/bot/notifications.md).

* 15+ фильтров аудитории
* Поддержка текста, фото, видео, документов
* Инлайн-кнопки для быстрых действий
* Статистика доставки
* Закреплённые сообщения (при каждом `/start`)

## Промо и маркетинг

### Промокоды

Подробнее: [Промо-система](https://docs.bedolagam.ru/bot/promo-system.md).

* Генерация 5 типов промокодов
* Лимиты использования и срок действия
* Ограничение "только для первой покупки"
* Статистика активаций

### Промо-группы

Подробнее: [Промо-группы](https://docs.bedolagam.ru/bot/promo-system.md#промо-группы).

* CRUD: создание, редактирование, удаление
* Скидки на серверы, трафик, устройства, период
* Автоматическое назначение по тратам
* Просмотр участников

### Персональные предложения

Подробнее: [Персональные предложения](https://docs.bedolagam.ru/bot/promo-system.md#персональные-промо-предложения).

* Тестовый доступ к серверам
* Скидки на продление/покупку
* Отправка по сегментам или индивидуально

### Рекламные кампании

Подробнее: [Рекламные кампании](https://docs.bedolagam.ru/bot/campaigns.md).

* Создание deeplink-кампаний с 4 типами бонусов
* Аналитика: регистрации, конверсии, доход
* Привязка к партнёрам

## Реферальная программа

Подробнее: [Реферальная программа](https://docs.bedolagam.ru/bot/referral-program.md).

* Статистика: общая, по периодам, топ рефереров
* Управление заявками на вывод с анализом рисков
* Партнёрская система: заявки, одобрение, индивидуальные комиссии
* Диагностика потерянных рефералов
* Тестовый режим

## Конкурсы и игры

Подробнее: [Конкурсы и игры](https://docs.bedolagam.ru/bot/contests.md).

### Ежедневные игры

* 7 типов мини-игр, каждая переключается отдельно
* Управление расписанием, призами, победителями
* Ручной запуск раундов
* Массовые операции (закрыть все, сбросить попытки)

### Реферальные конкурсы

* Создание с настройкой периода и призов
* Виртуальные участники (призраки для конкуренции)
* Синхронизация с платежами
* Ежедневные сводки

## Поддержка

Подробнее: [Система поддержки](https://docs.bedolagam.ru/bot/support-system.md).

### Тикеты

* Открытые и закрытые тикеты с пагинацией
* Ответы, закрытие (единичное и массовое)
* Блокировка пользователей (временная и постоянная)
* Просмотр вложений

### Модераторы

* Добавление/удаление модераторов по Telegram ID
* Журнал аудита действий

### Настройки поддержки

* Режим: тикеты / контакт / оба
* SLA: включение, пороги, интервалы
* Уведомления: для админов и пользователей
* Текст описания поддержки (по языкам)

## Аналитика

### Дашборды

* Пользователи: всего, новые (сегодня/неделя/месяц), активные
* Подписки: активные, триальные, истёкшие, конверсии
* Платежи: по провайдерам, по суммам, по периодам
* Трафик: общий, по серверам, по пользователям

### Статистика продаж (Cabinet)

Расширенная аналитика доступна в **веб-панели Cabinet** — 6 вкладок с интерактивными графиками: сводка, триалы, продажи, продления, доп. услуги, пополнения. Подробнее: [Статистика продаж](https://docs.bedolagam.ru/cabinet/sales-stats.md).

### Отчёты

```env theme={null}
ADMIN_REPORTS_ENABLED=true
ADMIN_REPORTS_SEND_TIME=10:00
```

Ежедневные отчёты с ключевыми метриками в отдельный топик/чат.

## Remnawave

### Синхронизация

| Операция | Описание |
| - | - |
| Пользователи → панель | Синхронизация из бота в RemnaWave |
| Панель → бот | Синхронизация из RemnaWave в бота |
| Авто-синхронизация | По расписанию (`REMNAWAVE_AUTO_SYNC_TIMES`) |
| Серверы/Сквады | Синхронизация списка серверов |
| Миграция сквадов | Массовый перенос между серверами |

### Управление из бота

* Просмотр нод и сквадов
* Создание/редактирование сквадов
* Детальная статистика по нодам

## Обслуживание

Подробнее: [Обслуживание и безопасность](https://docs.bedolagam.ru/bot/maintenance.md).

### Бэкапы

* Панель бэкапов: создание, просмотр, восстановление
* Настройки: автобэкапы, сжатие, логи
* Отправка в Telegram (с шифрованием)

### Техработы

* Ручное включение/выключение
* Авто-режим с мониторингом RemnaWave API
* Управление мониторингом
* Ручные уведомления

### Безопасность

* Сканер заблокированных пользователей
* Массовый бан (до 1000 ID)
* Чёрный список (GitHub)
* Защита имён (banwords)

### Логи

* Просмотр системных логов
* Скачивание лог-файлов
* Принудительная ротация

## Новости

Подробнее: [Модуль новостей](https://docs.bedolagam.ru/bot/news-module.md).

* Создание и редактирование статей с WYSIWYG-редактором
* Управление категориями и тегами с цветовой маркировкой
* Загрузка медиа (изображения, видео) с автообработкой
* Публикация / снятие с публикации
* Избранная статья (автоматически одна)
* Статистика просмотров

## Настройки из бота

Многие настройки изменяются без перезапуска:

* Режим поддержки и SLA
* Уведомления (для админов и пользователей)
* Модераторы
* Настройки вывода (через Cabinet API)
* Партнёрская секция

## Уведомления в топики

Подробнее: [Топик-уведомления](https://docs.bedolagam.ru/bot/notifications.md#топик-уведомления-для-администраторов).

| Топик | Переменная | Содержимое |
| - | - | - |
| Общий | `ADMIN_NOTIFICATIONS_TOPIC_ID` | Покупки, триалы, промокоды, версии |
| Тикеты | `ADMIN_NOTIFICATIONS_TICKET_TOPIC_ID` | Тикеты поддержки и SLA |
| NaloGO | `ADMIN_NOTIFICATIONS_NALOG_TOPIC_ID` | Чеки и налоги |
| Трафик | `SUSPICIOUS_NOTIFICATIONS_TOPIC_ID` | Подозрительная активность |
| Вывод | `REFERRAL_WITHDRAWAL_NOTIFICATIONS_TOPIC_ID` | Заявки на вывод |
| Бэкапы | `BACKUP_SEND_TOPIC_ID` | Файлы бэкапов |
| Логи | `LOG_ROTATION_TOPIC_ID` | Архивы логов |
| Отчёты | `ADMIN_REPORTS_TOPIC_ID` | Ежедневные отчёты |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.