> ## 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` |

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

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

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

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

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

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

## Подписки

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

## Рассылки

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

## Поддержка

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

### Тикеты

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

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

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

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

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

## Аналитика

### Дашборды

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

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

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

### Отчёты

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

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

## Remnawave

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

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

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

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

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

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

### Бэкапы

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

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

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

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

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

### Логи

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

## Новости

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

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

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

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

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

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

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

| Топик  | Переменная                                   | Содержимое                         |
| ------ | -------------------------------------------- | ---------------------------------- |
| Общий  | `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`                     | Ежедневные отчёты                  |
