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

# Обзор бота

> Полный функционал Bedolaga Telegram Bot

## Что такое Bedolaga Bot

Bedolaga Bot — Telegram-бот для продажи и управления VPN-подписками через панель Remnawave. Включает полный цикл: от регистрации пользователя до аналитики и поддержки.

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

### Покупка и управление подпиской

* **Два режима продаж**: [конструктор и тарифы](/bot/subscriptions.md) — гибкий выбор или готовые планы
* **Выбор параметров**: период (14-360 дней), трафик (ГБ или безлимит), серверы, устройства
* **Динамический калькулятор** стоимости с учётом скидок
* **Сквозная корзина** — сохранение параметров при недостатке баланса
* **Простая покупка** — упрощённый режим для быстрого оформления
* **Автопродление** — автоматическое списание с баланса
* **Модем-режим** — дополнительные устройства для роутеров

### Платежи

[18 платёжных систем](/bot/payments.md): Telegram Stars, YooKassa, CryptoBot, Tribute, Heleket, MulenPay, Pal24, Platega, WATA, Freekassa, CloudPayments, Kassa AI, RioPay, SeverPay, PayPear, RollyPay, AuraPay, Overpay и ручная оплата. Быстрое пополнение с кнопками сумм.

### Тестовая подписка

* Настраиваемый триал с welcome-цепочкой
* Платный или бесплатный триал
* Автовыдача бонусов за кампании и инвайты
* Контроль подписки на обязательный канал

### Бонусы и скидки

* **[Промокоды](/bot/promo-system.md)** — 5 типов: деньги, дни, триал, промо-группа, скидка
* **[Промо-группы](/bot/promo-system.md#промо-группы)** — тарифные уровни с индивидуальными скидками
* **Система лояльности** — автоматическое повышение уровня при достижении порога трат
* **[Персональные предложения](/bot/promo-system.md#персональные-промо-предложения)** — адресные акции от администратора
* **Тестовый доступ к серверам** — временная выдача через промо-акции

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

[Полная партнёрская система](/bot/referral-program.md): персональные ссылки, QR-коды, комиссии с каждого пополнения и покупки, аналитика доходов, вывод средств.

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

[7 типов мини-игр](/bot/contests.md) с мгновенными призами и реферальные конкурсы с рейтингами.

### Поддержка

[Тикет-система](/bot/support-system.md) с вложениями, SLA-мониторингом и модераторами. FAQ, правила, оферта.

### Новости

[Модуль новостей](/bot/news-module.md) — публикация статей для пользователей через Cabinet. Категории, теги, медиа-загрузки, WYSIWYG-редактор, избранные статьи.

### Личный кабинет

Полноценный [Cabinet WebApp](/cabinet/overview.md) внутри Telegram: управление подпиской, платежи, промокоды, устройства, реферальная статистика, FAQ.

## Для администраторов

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

* Поиск по ID, имени, username, Telegram ID
* Изменение баланса, лимитов устройств, трафика, серверов
* Сброс HWID, перегенерация подписки
* Назначение промо-групп и тарифов
* Покупка подписки пользователю из админки
* Продление/сокращение срока (±365 дней)
* Блокировки с таймером, система ограничений
* Отправка сообщения конкретному пользователю
* Расширенные фильтры: баланс, траты, трафик, активность, кампания
* Чёрный список с управлением

### Аналитика

* Дашборды по пользователям, подпискам и трафику
* Детализация платежей по провайдерам
* Продажи по тарифам, устройствам и странам
* Эффективность кампаний, промокодов и UTM
* Статистика по промо-группам и уровням
* Топ рефереров с аналитикой
* Мониторинг подозрительного трафика

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

* **[Рекламные кампании](/bot/campaigns.md)** — deeplink-инвайты с 4 типами бонусов
* **[Промокоды](/bot/promo-system.md)** — генерация и управление
* **[Промо-группы](/bot/promo-system.md#промо-группы)** — скидочные уровни
* **[Персональные предложения](/bot/promo-system.md#персональные-промо-предложения)** — тестовый доступ и скидки
* **[Рассылки](/bot/notifications.md)** — по сегментам с медиа и кнопками
* **Кастомные кнопки** для рассылок
* **[Конкурсы](/bot/contests.md)** — ежедневные игры и реферальные конкурсы

### Поддержка и модерация

* **[Тикет-центр](/bot/support-system.md)** с SLA и приоритетами
* Роли модераторов с ограниченным доступом
* Журнал аудита всех действий
* Блокировки нарушителей с таймером

### Уведомления

* **[Топики для событий](/bot/notifications.md#топик-уведомления-для-администраторов)** (покупки, триалы, техработы)
* Ежедневные отчёты по расписанию
* Настройка уведомлений и расписаний
* Управление контентом (правила, оферта, FAQ)

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

* **[Бэкапы](/bot/maintenance.md#бэкапы)** — автоматические и ручные с отправкой в Telegram
* **[Режим техработ](/bot/maintenance.md#режим-техработ)** — ручной и автоматический
* **[Бан-система](/bot/maintenance.md#система-бан-интеграции-bedolagaban)** — интеграция с BedolagaBan
* **[Чёрный список](/bot/maintenance.md#чёрный-список)** — глобальный из GitHub
* **[Ротация логов](/bot/maintenance.md#ротация-логов)** — автоочистка и архивация
* Мониторинг серверов (XrayChecker)
* Автосинхронизация с Remnawave

### Биллинг и настройки

* Управление ценами без перезапуска
* Управление пакетами трафика
* Тестовые платежи для каждого провайдера
* Режим тарифов и простая покупка
* Управление настройками из бота

### Remnawave

* Синхронизация пользователей (ручная и автоматическая)
* Синхронизация сквадов/серверов
* Управление нодами/сквадами из бота
* Детальная статистика по нодам
* Миграция пользователей между сквадами

### REST API

**FastAPI Web API** с эндпоинтами для управления всеми аспектами бота:

* Управление API-ключами и токенами
* Подписки, пользователи, транзакции
* Промо-система и рассылки
* Контент и настройки

## Автоматизация

| Функция | Описание |
| - | - |
| Мониторинг Remnawave | Регулярная проверка API, автотехработы |
| Автосинхронизация серверов | Фоновая синхронизация по расписанию |
| Умная корзина | Сохранение параметров в Redis при недостатке баланса |
| Антифрод | Валидация подписки на канал |
| Защита от фишинга | Автоблокировка подозрительных никнеймов |
| Автопроверка транзакций | Проверка статусов "в ожидании" за 24ч |
| Ротация логов | Автоочистка и архивация |
| Волны возврата | Многоступенчатые скидки для истёкших подписок |

## Мультиязычность

Поддержка RU/EN с динамическим переключением языка интерфейса. Локализации в `locales/`.


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