🚀 Remnawave Bedolaga Bot 2.0.0

🤖 Современный Telegram-бот для управления VPN подписками через Remnawave API

Полнофункциональное решение с управлением пользователями, платежами и администрированием

🚀 Быстрый старт • 📖 Функционал • 🐳 Docker • 💬 Поддержка

---

🌟 Почему выбрать Bedolaga Bot?

⚡ Полная автоматизация VPN бизнеса

• 🎯 Готовое решение - разверни за 5 минут, начни продавать сегодня
• 💰 Многоканальные платежи - Telegram Stars + Tribute + планы на ЮKassa
• 🔄 Автоматизация 99% - от регистрации до продления подписок
• 📊 Детальная аналитика

🎛️ Гибкость конфигурации

• 🌍 Выбор стран - пользователи сами выбирают нужные локации
• 📱 Управление устройствами - от 1 до неограниченного количества
• 📊 Гибкие тарифы - от 5GB до безлимита, от 14 дней до года
• 🎁 Промо-система - коды на деньги, дни подписки, триал-периоды

💪 Enterprise готовность

• 🏗️ Современная архитектура - AsyncIO, PostgreSQL, Redis
• 🔒 Безопасность - шифрование, валидация, rate limiting
• 📈 Масштабируемость
• 🔧 Мониторинг - Prometheus, Grafana, health checks

---

🚀 Быстрый старт

🐳 Один Docker команда - и ты в бизнесе

# 1. Скачай репозиторий
git clone https://github.com/Fr1ngg/remnawave-bedolaga-telegram-bot.git
cd remnawave-bedolaga-telegram-bot

# 2. Настрой конфиг
cp .env.example .env
nano .env  # Заполни токены и настройки

# 3. Создай необходимые директории
mkdir -p volumes/{postgres,redis} logs data backups

# 4. Запусти всё разом
docker compose up -d

# 5. Проверь статус
docker compose logs -f bot

⚙️ Минимальная настройка (2 минуты)

Настройка	Где взять	Пример
🤖 BOT_TOKEN	@BotFather	1234567890:AABBCCdd...
🔑 REMNAWAVE_API_KEY	Твоя Remnawave панель	eyJhbGciOiJIUzI1...
🌐 REMNAWAVE_API_URL	URL твоей панели	https://panel.example.com
👑 ADMIN_IDS	Твой Telegram ID	123456789,987654321

🔧 Полная конфигурация .env

# 🏷️ Основные настройки
NODE_ENV=production
DEBUG=false
LOG_LEVEL=INFO

# 🗄️ База данных
POSTGRES_DB=bedolaga_bot
POSTGRES_USER=bedolaga_user
POSTGRES_PASSWORD=secure_password_123
POSTGRES_PORT=5432
DATABASE_URL=postgresql+asyncpg://bedolaga_user:secure_password_123@postgres:5432/bedolaga_bot

# ⚡ Redis кеш
REDIS_PASSWORD=redis_password_123
REDIS_PORT=6379
REDIS_URL=redis://:redis_password_123@redis:6379/0

# 🤖 Telegram Bot
BOT_TOKEN=your_bot_token_here
ADMIN_IDS=123456789,987654321
SUPPORT_USERNAME=@your_support

# 🔗 Remnawave API
REMNAWAVE_API_URL=https://your-panel.com
REMNAWAVE_API_KEY=your_jwt_token_here

# 🌐 Webhook настройки
WEBHOOK_DOMAIN=your-domain.com
WEBHOOK_PORT=8081
WEBHOOK_URL=https://your-domain.com
WEBHOOK_PATH=/webhook

# ⭐ Telegram Stars
TELEGRAM_STARS_ENABLED=true

# 💳 Tribute платежи
TRIBUTE_ENABLED=true
TRIBUTE_API_KEY=your_tribute_api_key
TRIBUTE_DONATE_LINK=https://t.me/tribute/app?startapp=XXXX
TRIBUTE_WEBHOOK_PATH=/tribute-webhook
TRIBUTE_WEBHOOK_PORT=8081
TRIBUTE_WEBHOOK_SECRET=your_webhook_secret

# 🚀 Режим работы кнопки "Подключиться"
# guide - открывает гайд подключения c настройками и парамтерами из app-config.json (режим 1)
# miniapp_subscription - открывает ссылку подписки в мини-приложении (режим 2)
# miniapp_custom - открывает заданную ссылку в мини-приложении (режим 3)
CONNECT_BUTTON_MODE=miniapp_subscription
# URL для режима miniapp_custom (обязателен при CONNECT_BUTTON_MODE=miniapp_custom)
# MINIAPP_CUSTOM_URL=

# 🎁 Триал настройки
TRIAL_ENABLED=true
TRIAL_DURATION_DAYS=3
TRIAL_TRAFFIC_LIMIT_GB=10
TRIAL_DEVICE_LIMIT=2
TRIAL_SQUAD_UUID=your_trial_squad_uuid

# 💰 Ценообразование (в копейках)
BASE_SUBSCRIPTION_PRICE=50000
PRICE_14_DAYS=5000
PRICE_30_DAYS=9900
PRICE_60_DAYS=18900
PRICE_90_DAYS=26900
PRICE_180_DAYS=49900
PRICE_360_DAYS=89900

PRICE_TRAFFIC_5GB=2000
PRICE_TRAFFIC_10GB=4000
PRICE_TRAFFIC_25GB=6000
PRICE_TRAFFIC_50GB=10000
PRICE_TRAFFIC_100GB=15000
PRICE_TRAFFIC_250GB=20000
PRICE_TRAFFIC_UNLIMITED=25000

PRICE_PER_DEVICE=5000

# 🤝 Реферальная система
REFERRAL_REGISTRATION_REWARD=5000
REFERRED_USER_REWARD=2500
REFERRAL_COMMISSION_PERCENT=10

# 🔍 Мониторинг
MONITORING_INTERVAL=60
ENABLE_NOTIFICATIONS=true
AUTOPAY_WARNING_DAYS=3,1
MONITORING_LOGS_RETENTION_DAYS=30
INACTIVE_USER_DELETE_MONTHS=3

# 📊 Опционально для мониторинга
GRAFANA_USER=admin
GRAFANA_PASSWORD=admin123

---

⭐ Функционал

👤 Для пользователей 🛒 Умная покупка подписок 📅 Выбор периода (14-360 дней) 📊 Настройка трафика (5GB - безлимит) 🌍 Выбор стран через сквады 📱 Количество устройств (1-10) 💰 Удобные платежи ⭐ Telegram Stars 💳 Tribute (автопополнение) 🎁 Реферальные бонусы 📱 Управление подписками 📈 Просмотр статистики использования 🔄 Автопродление с баланса 🔄 Сброс/увеличение трафика 🌍 Смена стран на лету 🎁 Бонусная система 🎫 Промокоды на деньги/дни 👥 Реферальная программа 🆓 Бесплатный триал 🔔 Ежедневные уведомления

⚙️ Для администраторов 📊 Мощная аналитика 👥 Детальная статистика пользователей 💰 Анализ подписок и платежей 🖥️ Мониторинг серверов Remnawave 📈 Финансовые отчеты 👥 Управление пользователями 🔍 Поиск и редактирование профилей 💰 Управление балансами 🚫 Блокировка/разблокировка 📋 Массовые операции 🎫 Промо-система 🎁 Создание промокодов (деньги/дни) 📊 Статистика использования 🔄 Массовая генерация ⚙️ Гибкие условия активации 🖥️ Мониторинг системы 💚 Состояние Remnawave панели 🔄 Синхронизация данных 🌐 Управление сквадами 📋 Логи и диагностика 📨 Коммуникации 📢 Рассылки по сегментам 🔔 Автоуведомления о продлении 💬 Система поддержки 📝 Настройка правил сервиса

---

🏗️ Архитектура

💪 Современный стек технологий

• 🐍 Python 3.11+ с AsyncIO - максимальная производительность
• 🗄️ PostgreSQL 15+ - надежное хранение данных
• ⚡ Redis - быстрое кеширование и сессии
• 🐳 Docker - простое развертывание в любой среде
• 🔗 SQLAlchemy ORM - безопасная работа с БД
• 🚀 aiogram 3 - современная Telegram Bot API

📁 Структура проекта

bedolaga_bot/
├── 🎯 main.py                     # Точка входа
├── 📦 requirements.txt            # Зависимости
├── ⚙️ .env.example               # Конфиг
├── ⚙️ app-config.json              # Информация для гайда в боте по подключению(Приложения, текста)
│
├── 📱 app/
│   ├── 🤖 bot.py                 # Инициализация бота
│   ├── ⚙️ config.py              # Настройки
│   ├── 🎛️ states.py              # FSM состояния
│   │
│   ├── 🎮 handlers/              # Обработчики событий
│   │   ├── 🏠 start.py           # Регистрация и старт
│   │   ├── 🛒 subscription.py    # Подписки
│   │   ├── 💰 balance.py         # Баланс и платежи
│   │   ├── 🎁 promocode.py       # Промокоды
│   │   ├── 👥 referral.py        # Реферальная система
│   │   ├── 💬 support.py         # Техподдержка
│   │   └── 👑 admin/             # Админ панель
│   │       ├── 📊 statistics.py  # Статистика
│   │       ├── 👥 users.py       # Управление юзерами
│   │       ├── 🎫 promocodes.py  # Управление промокодами
│   │       ├── 📨 messages.py    # Рассылки
│   │       ├── 🔍 monitoring.py  # Мониторинг
│   │       └── 🔗 remnawave.py   # Система RemnaWave
│   │
│   ├── ⌨️ keyboards/             # Интерфейсы
│   │   ├── 🔲 inline.py          # Inline клавиатуры
│   │   ├── 📋 reply.py           # Reply клавиатуры
│   │   └── 👑 admin.py           # Админские клавиатуры
│   │
│   ├── 🗄️ database/             # База данных
│   │   ├── 📊 models.py          # Модели SQLAlchemy
│   │   ├── 🔗 database.py        # Подключение к БД
│   │   └── 📝 crud/              # CRUD операции
│   │
│   ├── 🔧 services/             # Бизнес-логика
│   │   ├── 👤 user_service.py             # Сервис пользователей
│   │   ├── 📋 subscription_service.py     # Сервис подписок
│   │   ├── 💰 payment_service.py          # Платежи
│   │   ├── 🎁 promocode_service.py        # Промокоды
│   │   ├── 👥 referral_service.py         # Рефералы
│   │   ├── 🔍 monitoring_service.py       # Мониторинг
│   │   ├── 💳 tribute_service.py          # Tribute платежи
│   │   └── 🌐 remnawave_service.py       # Интеграция с Remnawave
│   │
│   ├── 🛠️ utils/                # Утилиты
│   │   ├── 🎨 decorators.py      # Декораторы
│   │   ├── 📄 formatters.py      # Форматирование данных
│   │   ├── ✅ validators.py      # Валидация
│   │   ├── 📚 pagination.py      # Пагинация
│   │   ├── 👤 user_utils.py      # Утилиты пользователей
│   │   └── 💾 cache.py           # Кеширование
│   │
│   ├── 🛡️ middlewares/           # Middleware
│   │   ├── 🔐 auth.py           # Авторизация
│   │   ├── 📋 logging.py        # Логирование
│   │   └── 🚦 throttling.py     # Ограничение запросов
│   │
│   ├── 🌐 localization/          # Локализация
│   │   ├── 📝 texts.py          # Тексты интерфейса
│   │   └── 🌍 languages/        # Языковые пакеты
│   │
│   └── 🔌 external/              # Внешние API
│       ├── 🌐 remnawave_api.py   # API Remnawave
│       ├── ⭐ telegram_stars.py  # Telegram Stars
│       └── 💳 tribute.py         # Tribute платежи
│
├── 🔄 migrations/                # Миграции БД
│   └── alembic/
│
└── 📋 logs/                      # Логи системы

---

🐳 Docker развертывание

📁 Docker Compose файлы

project/
├── docker-compose.yml              # 🚀 Продакшн
├── docker-compose.local.yml        # 🏠 Разработка
├── .env                           # ⚙️ Конфиг
└── .env.example                   # 📝 Пример

🚀 Продакшн (docker-compose.yml)

📄 Показать полный docker-compose.yml

version: '3.8'

services:
  # 🗄️ PostgreSQL Database
  postgres:
    image: postgres:15-alpine
    container_name: bedolaga_postgres
    restart: unless-stopped
    environment:
      POSTGRES_DB: ${POSTGRES_DB:-bedolaga_bot}
      POSTGRES_USER: ${POSTGRES_USER:-bedolaga_user}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-secure_password_123}
      POSTGRES_INITDB_ARGS: "--encoding=UTF8 --lc-collate=C --lc-ctype=C"
    volumes:
      - postgres_data:/var/lib/postgresql/data
      - ./init-scripts:/docker-entrypoint-initdb.d:ro
    ports:
      - "${POSTGRES_PORT:-5432}:5432"
    networks:
      - bedolaga_network
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-bedolaga_user} -d ${POSTGRES_DB:-bedolaga_bot}"]
      interval: 10s
      timeout: 5s
      retries: 5
      start_period: 30s
    logging:
      driver: "json-file"
      options:
        max-size: "10m"
        max-file: "3"

  # ⚡ Redis Cache
  redis:
    image: redis:7-alpine
    container_name: bedolaga_redis
    restart: unless-stopped
    command: redis-server --appendonly yes --requirepass ${REDIS_PASSWORD:-redis_password_123}
    volumes:
      - redis_data:/data
    ports:
      - "${REDIS_PORT:-6379}:6379"
    networks:
      - bedolaga_network
    healthcheck:
      test: ["CMD", "redis-cli", "--no-auth-warning", "-a", "${REDIS_PASSWORD:-redis_password_123}", "ping"]
      interval: 10s
      timeout: 5s
      retries: 3
      start_period: 10s
    logging:
      driver: "json-file"
      options:
        max-size: "5m"
        max-file: "3"

  # 🤖 Telegram Bot
  bot:
    image: fr1ngg/remnawave-bedolaga-telegram-bot:latest
    container_name: bedolaga_bot
    restart: unless-stopped
    depends_on:
      postgres:
        condition: service_healthy
      redis:
        condition: service_healthy
    env_file:
      - .env
    environment:
      DATABASE_URL: postgresql+asyncpg://${POSTGRES_USER:-bedolaga_user}:${POSTGRES_PASSWORD:-secure_password_123}@postgres:5432/${POSTGRES_DB:-bedolaga_bot}
      REDIS_URL: redis://:${REDIS_PASSWORD:-redis_password_123}@redis:6379/0
      LOG_LEVEL: ${LOG_LEVEL:-INFO}
      DEBUG: ${DEBUG:-false}
      HEALTH_CHECK_ENABLED: "true"
    volumes:
      - ./logs:/app/logs
      - ./data:/app/data
      - ./backups:/app/backups
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro
    ports:
      - "${WEBHOOK_PORT:-8081}:8081"
    networks:
      - bedolaga_network
    healthcheck:
      test: ["CMD", "python", "-c", "import requests; requests.get('http://localhost:8081/health', timeout=5)"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 60s
    logging:
      driver: "json-file"
      options:
        max-size: "50m"
        max-file: "5"
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.bedolaga-webhook.rule=Host(`${WEBHOOK_DOMAIN:-localhost}`) && PathPrefix(`/tribute-webhook`)"
      - "traefik.http.services.bedolaga-webhook.loadbalancer.server.port=8081"

  # 📊 Monitoring (опционально)
  prometheus:
    image: prom/prometheus:latest
    container_name: bedolaga_prometheus
    restart: unless-stopped
    command:
      - '--config.file=/etc/prometheus/prometheus.yml'
      - '--storage.tsdb.path=/prometheus'
      - '--web.console.libraries=/etc/prometheus/console_libraries'
      - '--web.console.templates=/etc/prometheus/consoles'
      - '--storage.tsdb.retention.time=200h'
      - '--web.enable-lifecycle'
    volumes:
      - ./monitoring/prometheus.yml:/etc/prometheus/prometheus.yml
      - prometheus_data:/prometheus
    ports:
      - "9090:9090"
    networks:
      - bedolaga_network
    profiles:
      - monitoring

  # 📈 Grafana (опционально)
  grafana:
    image: grafana/grafana:latest
    container_name: bedolaga_grafana
    restart: unless-stopped
    environment:
      GF_SECURITY_ADMIN_USER: ${GRAFANA_USER:-admin}
      GF_SECURITY_ADMIN_PASSWORD: ${GRAFANA_PASSWORD:-admin123}
    volumes:
      - grafana_data:/var/lib/grafana
      - ./monitoring/grafana/dashboards:/etc/grafana/provisioning/dashboards
      - ./monitoring/grafana/datasources:/etc/grafana/provisioning/datasources
    ports:
      - "3000:3000"
    networks:
      - bedolaga_network
    profiles:
      - monitoring

# 📦 Volumes
volumes:
  postgres_data:
    driver: local
    driver_opts:
      type: none
      o: bind
      device: ./volumes/postgres
  redis_data:
    driver: local
    driver_opts:
      type: none
      o: bind
      device: ./volumes/redis
  prometheus_data:
    driver: local
  grafana_data:
    driver: local

# 🌐 Networks
networks:
  bedolaga_network:
    driver: bridge
    ipam:
      driver: default
      config:
        - subnet: 172.20.0.0/16
          gateway: 172.20.0.1
    driver_opts:
      com.docker.network.bridge.name: br-bedolaga

🏠 Разработка (docker-compose.local.yml)

📄 Показать dev конфигурацию

version: '3.8'

services:
  # 🗄️ PostgreSQL для разработки
  postgres-dev:
    image: postgres:15-alpine
    container_name: bedolaga_postgres_dev
    restart: unless-stopped
    environment:
      POSTGRES_DB: bedolaga_bot_dev
      POSTGRES_USER: dev_user
      POSTGRES_PASSWORD: dev_password
    volumes:
      - postgres_dev_data:/var/lib/postgresql/data
    ports:
      - "5433:5432"
    networks:
      - bedolaga_dev_network

  # ⚡ Redis для разработки
  redis-dev:
    image: redis:7-alpine
    container_name: bedolaga_redis_dev
    restart: unless-stopped
    volumes:
      - redis_dev_data:/data
    ports:
      - "6380:6379"
    networks:
      - bedolaga_dev_network

  # 🤖 Bot для разработки
  bot-dev:
    build:
      context: .
      dockerfile: Dockerfile.dev
      args:
        - PYTHON_VERSION=3.11
    container_name: bedolaga_bot_dev
    restart: unless-stopped
    depends_on:
      - postgres-dev
      - redis-dev
    env_file:
      - .env.local
    environment:
      DATABASE_URL: postgresql+asyncpg://dev_user:dev_password@postgres-dev:5432/bedolaga_bot_dev
      REDIS_URL: redis://redis-dev:6379/0
      DEBUG: "true"
      LOG_LEVEL: DEBUG
    volumes:
      - .:/app
      - ./logs:/app/logs
    ports:
      - "8082:8081"
    networks:
      - bedolaga_dev_network
    command: python -m app.main --reload

  # 🔍 Adminer для управления БД
  adminer:
    image: adminer:latest
    container_name: bedolaga_adminer
    restart: unless-stopped
    ports:
      - "8080:8080"
    networks:
      - bedolaga_dev_network
    environment:
      ADMINER_DEFAULT_SERVER: postgres-dev

volumes:
  postgres_dev_data:
  redis_dev_data:

networks:
  bedolaga_dev_network:
    driver: bridge

🚀 Команды управления

# ⚡ Быстрый старт
docker compose up -d

# 📊 С мониторингом
docker compose --profile monitoring up -d

# 🏠 Разработка
docker compose -f docker-compose.local.yml up -d

# 📋 Статус сервисов
docker compose ps

# 📄 Логи
docker compose logs -f bot

# 🔄 Перезапуск
docker compose restart bot

# 🛑 Остановка
docker compose down

# 🧹 Полная очистка
docker compose down -v --remove-orphans

🔧 Управление данными

# 💾 Бэкап БД
docker compose exec postgres pg_dump -U bedolaga_user bedolaga_bot > backup_$(date +%Y%m%d_%H%M%S).sql

# 🔄 Восстановление БД
docker compose exec -T postgres psql -U bedolaga_user bedolaga_bot < backup.sql

# 📊 Размер данных
docker system df
docker compose exec postgres du -sh /var/lib/postgresql/data

# 🧹 Очистка логов
docker compose exec bot find /app/logs -name "*.log" -type f -mtime +7 -delete

# 📈 Мониторинг ресурсов
docker stats bedolaga_bot bedolaga_postgres bedolaga_redis

---

🚀 Производительность

Пользователей	Память	CPU	Диск	Описание
1,000	512MB	1 vCPU	10GB	✅ Стартап
10,000	2GB	2 vCPU	50GB	✅ Малый бизнес
50,000	4GB	4 vCPU	100GB	✅ Средний бизнес
100,000+	8GB+	8+ vCPU	200GB+	🚀 Enterprise

⚡ Оптимизации производительности

• 🔄 Асинхронная архитектура - обработка тысяч запросов параллельно
• ⚡ Redis кеширование - молниеносные ответы на частые запросы
• 🔗 Пул соединений БД - эффективное использование ресурсов
• 📦 Пагинация - быстрая загрузка больших списков
• 🛡️ Rate limiting - защита от злоупотреблений
• 🔄 Graceful shutdown - безопасные перезагрузки без потери данных

---

💎 Продвинутые возможности

🎯 Реальные примеры кода

🔄 Автопродление подписок:

# Из monitoring_service.py - реальная логика автопродления
if user.balance_kopeks >= renewal_cost:
    success = await subtract_user_balance(
        db, user, renewal_cost,
        "Автопродление подписки"
    )
    
    if success:
        await extend_subscription(db, subscription, 30)
        await subscription_service.update_remnawave_user(db, subscription)
        
        if self.bot:
            await self._send_autopay_success_notification(user, renewal_cost, 30)
        
        logger.info(f"💳 Автопродление подписки пользователя {user.telegram_id} успешно")

💰 Реферальные бонусы:

# Из referral_service.py - начисление комиссии
commission_amount = int(purchase_amount_kopeks * settings.REFERRAL_COMMISSION_PERCENT / 100)

if commission_amount > 0:
    await add_user_balance(
        db, referrer, commission_amount,
        f"Комиссия {settings.REFERRAL_COMMISSION_PERCENT}% с покупки {user.full_name}"
    )
    
    await create_referral_earning(
        db=db,
        user_id=referrer.id,
        referral_id=user_id,
        amount_kopeks=commission_amount,
        reason="referral_commission"
    )

📊 Расчет стоимости подписки:

# Из subscription_service.py - умный расчет цен
async def calculate_subscription_price(
    self,
    period_days: int,
    traffic_gb: int,
    server_squad_ids: List[int], 
    devices: int,
    db: AsyncSession 
) -> Tuple[int, List[int]]:

    base_price = PERIOD_PRICES.get(period_days, 0)
    traffic_price = TRAFFIC_PRICES.get(traffic_gb, 0)
    
    total_servers_price = 0
    for server_id in server_squad_ids:
        server = await get_server_squad_by_id(db, server_id)
        if server and server.is_available and not server.is_full:
            total_servers_price += server.price_kopeks
    
    devices_price = max(0, devices - 1) * settings.PRICE_PER_DEVICE
    total_price = base_price + traffic_price + total_servers_price + devices_price
    
    logger.info(f"💰 Расчет стоимости новой подписки: {total_price/100}₽")
    return total_price, server_prices

🔔 Система уведомлений:

# Из monitoring_service.py - умные уведомления
async def _send_trial_ending_notification(self, user: User, subscription: Subscription):
    message = f"""
🎁 <b>Тестовая подписка скоро закончится!</b>

Ваша тестовая подписка истекает через 2 часа.

💎 <b>Не хотите остаться без VPN?</b>
Переходите на полную подписку со скидкой!

🔥 <b>Специальное предложение:</b>
• 30 дней всего за {settings.format_price(settings.PRICE_30_DAYS)}
• Безлимитный трафик
• Все серверы доступны
• Поддержка до 3 устройств
"""
    
    keyboard = InlineKeyboardMarkup(inline_keyboard=[
        [InlineKeyboardButton(text="💎 Купить подписку", callback_data="buy_subscription")],
        [InlineKeyboardButton(text="💰 Пополнить баланс", callback_data="balance_top_up")]
    ])
    
    await self.bot.send_message(user.telegram_id, message, parse_mode="HTML", reply_markup=keyboard)

💳 Платежная система:

# Из payment_service.py - Telegram Stars
async def create_stars_invoice(self, amount_kopeks: int, description: str) -> str:
    try:
        stars_amount = max(1, amount_kopeks // 100)
        
        invoice_link = await self.bot.create_invoice_link(
            title="Пополнение баланса VPN",
            description=description,
            payload=f"balance_topup_{amount_kopeks}",
            provider_token="", 
            currency="XTR", 
            prices=[LabeledPrice(label="Пополнение", amount=stars_amount)]
        )
        
        logger.info(f"Создан Stars invoice на {stars_amount} звезд")
        return invoice_link
        
    except Exception as e:
        logger.error(f"Ошибка создания Stars invoice: {e}")
        raise

🔧 Первичная настройка в боте

После запуска необходимо:

1. 📡 Синхронизация серверов (обязательно!)

   • Зайди в бот → Админ панель → Подписки → Управление серверами
   • Нажми Синхронизация и дождись завершения
   • Без этого пользователи не смогут выбирать страны!

2. 👥 Синхронизация пользователей (если есть база)

   • Админ панель → Remnawave → Синхронизация
   • Синхронизировать всех → дождись импорта

💳 Настройка Telegram Tribute

🔧 Пошаговая настройка Tribute

1. 📝 Регистрация

   • Зарегистрируйся в Tribute
   • Пройди верификацию

2. 🔗 Создание донат-ссылки

   • Создай донат ссылку в Tribute
   • Скопируй и вставь в TRIBUTE_DONATE_LINK

3. 🌐 Настройка прокси

   Caddy:

   https://your-domain.com {
       handle /tribute-webhook* {
           reverse_proxy localhost:8081 {
               header_up Host {host}
               header_up X-Real-IP {remote_host}
           }
       }
   
       handle /webhook-health {
           reverse_proxy localhost:8081/health
       }
   }
   

   Nginx:

   server {
       listen 80;
       server_name your-domain.com;
   
       location /tribute-webhook {
           proxy_pass http://127.0.0.1:8081;
           proxy_set_header Host $host;
           proxy_set_header X-Real-IP $remote_addr;
           proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
           proxy_set_header X-Forwarded-Proto $scheme;
       }
   
       location /webhook-health {
           proxy_pass http://127.0.0.1:8081/health;
       }
   }
   

4. ⚙️ Настройка webhook

   • В настройках Tribute укажи: https://your-domain.com/tribute-webhook
   • Создай API ключ и вставь в TRIBUTE_API_KEY
   • Сделай тест в Tribute панели

5. ✅ Проверка

   • Тестируй пополнение через бота
   • Проверь логи: docker compose logs -f bot

---

💡 Использование

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

1. 🚀 Старт → Найди бота и нажми /start
2. 📋 Правила → Прими правила сервиса
3. 💰 Баланс → "💰 Баланс" → пополни через Stars/Tribute
4. 🛒 Подписка → "🛒 Купить подписку" → выбор тарифа → оплата
5. 📱 Управление → "📋 Мои подписки" → конфигурация → получение ссылки
6. 👥 Рефералы → "👥 Рефералы" → поделись ссылкой

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

Доступ через "⚙️ Админ панель":

• 📦 Подписки → настройка серверов, цен, синхронизация
• 👥 Пользователи → поиск, редактирование, блокировка
• 🎁 Промокоды → создание бонусов, статистика
• 📨 Рассылки → уведомления по сегментам
• 🖥 Remnawave → мониторинг панели, синхронизация
• 📊 Статистика → детальная аналитика бизнеса

---

🛡️ Безопасность

🔒 Защита данных

• 🔐 Все пароли и ключи в переменных окружения
• 🛡️ SQL Injection защита через SQLAlchemy ORM
• ✅ Валидация всех пользовательских данных
• 🚦 Middleware авторизации и rate limiting
• 📋 Детальное логирование всех операций

📊 Мониторинг безопасности

• 🔍 Системы алертов при подозрительной активности
• 💾 Автоматическое резервное копирование
• 🏥 Health checks для всех сервисов
• 📈 Мониторинг производительности

---

🚀 Roadmap

✅ 2.0.0 (Текущая версия)

• 🏗️ Полное переписывание архитектуры с нуля
• 🎛️ Единая конфигурируемая подписка вместо мультиподписок
• 💳 Интеграция Telegram Stars + Tribute
• 🔄 Продвинутая синхронизация с Remnawave
• 📊 Детальная система мониторинга

🎯 Планы развития

Версия	Функция	Статус	ETA	Приоритет
2.1.0	💳 ЮKassa интеграция	🔄 В работе	Q1 2025	🔴 High
2.2.0	🌐 Web админ-панель	📋 Планируется	Q2 2025	🟡 Medium
2.3.0	🌍 Мультиязычность	💭 Исследование	Q3 2025	🟡 Medium
2.4.0	🔗 Открытое API	💭 Исследование	Q4 2025	🟢 Low
2.5.0	📱 Мобильное приложение	💭 Концепция	2026	🟢 Low

💡 Идеи для будущих версий

• 🎨 Кастомизируемые темы интерфейса
• 🤖 AI-помощник для поддержки
• 📈 Продвинутая аналитика с ML
• 🔔 Push-уведомления
• 💼 Корпоративные тарифы
• 🌐 Мультипанельная поддержка

---

🐛 Устранение неполадок

❓ Частые проблемы

🤖 Бот не отвечает

Проверь:

• ✅ Правильность BOT_TOKEN в .env
• ✅ Интернет соединение сервера
• ✅ Статус контейнеров: docker compose ps

Диагностика:

# Проверка логов
docker compose logs -f bot

# Проверка переменных
docker exec bedolaga_bot env | grep BOT_TOKEN

# Перезапуск
docker compose restart bot

🗄️ Ошибки базы данных

Симптомы:

• SQL ошибки в логах
• Бот не сохраняет данные
• Подключение отклонено

Решение:

# Проверка PostgreSQL
docker compose logs postgres

# Проверка подключения
docker exec bedolaga_bot pg_isready -h postgres -p 5432

# Пересоздание БД
docker compose down
docker volume rm project_postgres_data
docker compose up -d

🔌 Проблемы с Remnawave API

Проверь:

• ✅ Доступность REMNAWAVE_API_URL
• ✅ Валидность REMNAWAVE_API_KEY
• ✅ Сетевое подключение

Диагностика:

# Проверка доступности API
curl -I https://your-panel.com

# Тест из контейнера
docker exec bedolaga_bot curl -H "Authorization: Bearer YOUR_TOKEN" https://your-panel.com/api/health

# Проверка синхронизации
docker compose exec bot python -c "
from app.services.remnawave_service import RemnaWaveService
import asyncio
asyncio.run(RemnaWaveService().check_connection())
"

💳 Проблемы с Tribute платежами

Проверь:

• ✅ Webhook доступен: https://your-domain.com/tribute-webhook
• ✅ API ключ корректен
• ✅ Настройки прокси (Nginx/Caddy)

Диагностика:

# Проверка webhook
curl -X POST https://your-domain.com/tribute-webhook

# Проверка в Tribute панели
# Logs -> Webhook logs -> посмотри статус доставки

# Тест локально
docker exec bedolaga_bot curl http://localhost:8081/health

🔧 Профилактика

# 📊 Мониторинг места
df -h
docker system df

# 🧹 Очистка старых логов
find ./logs -name "*.log" -mtime +30 -delete

# 💾 Регулярные бэкапы
0 2 * * * docker compose exec postgres pg_dump -U bedolaga_user bedolaga_bot > /backups/db_$(date +\%Y\%m\%d).sql

# 📈 Мониторинг ресурсов
docker stats --no-stream

---

🤝 Как помочь проекту

💻 Для разработчиков

1. 🍴 Fork репозитория

   git clone https://github.com/YOUR_USERNAME/remnawave-bedolaga-telegram-bot.git
   cd remnawave-bedolaga-telegram-bot
   

2. 🌿 Создай feature branch

   git checkout -b feature/amazing-feature
   

3. 💻 Разрабатывай

   # Используй dev окружение
   docker compose -f docker-compose.local.yml up -d
   
   # Твои изменения...
   
   # Тестируй
   python -m pytest tests/
   

4. 📤 Commit и Push

   git add .
   git commit -m "feat: add amazing feature"
   git push origin feature/amazing-feature
   

5. 🔄 Создай Pull Request

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

• 🔍 Сообщай о багах с подробным описанием
• 💡 Предлагай идеи для улучшения
• ⭐ Ставь звезды проекту - это мотивирует!
• 📢 Рассказывай друзьям о проекте
• 📝 Улучшай документацию - исправляй опечатки, добавляй примеры

💰 Для спонсоров

• 🎯 Заказывай приоритетные функции - ускори разработку нужного
• 🏢 Получи корпоративную поддержку - персональная помощь
• 💝 Поддержи разработку - помоги проекту расти

---

💬 Поддержка и сообщество

📞 Контакты

• 💬 Telegram: @fringg - вопросы по разработке (только по делу!)
• 💬 Telegram Group: Bedolaga Chat - Для общения, вопросов, предложений, багов
• 🐛 Issues: GitHub Issues - баги и предложения

📚 Полезные ресурсы

• 📖 Remnawave Docs - документация панели
• 🤖 Telegram Bot API - API ботов
• 🐳 Docker Guide - обучение Docker
• 🐘 PostgreSQL Docs - документация БД

💬 Правила общения

• 🤝 Будь вежлив и конструктивен
• 🔍 Используй поиск перед созданием issue
• 📝 Предоставляй подробную информацию о проблемах
• 🏷️ Используй правильные теги для issues

---

🏆 Статистика и признание

📈 Рост проекта

📊 Статистика GitHub

🏅 Достижения проекта

• 🌟 40+ Stars на GitHub

---

💝 Благодарности

🌟 Топ спонсоры проекта

🥇 Место	👤 Спонсор	💰 Сумма	💬 От себя благодарю
🥇	Илья (@ispanec_nn)	$15	За веру в проект с самого начала
🥈	@pilot_737800	₽1,250	За активное тестирование и фидбек
🥉	@Legacyyy777	₽1,000	За ценные предложения по улучшению

🤝 Contributors

Огромная благодарность всем, кто делает проект лучше:

• 🐛 Тестировщикам - находят баги до пользователей
• 💻 Разработчикам - присылают Pull Request'ы
• 💡 Идейным вдохновителям - предлагают новые функции

🌟 Особая благодарность

• Remnawave Team - за отличную панель и API

---

📄 Лицензия

Проект распространяется под лицензией MIT

MIT License

Copyright (c) 2024 Fr1ngg

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

---

🚀 Заключение

Bedolaga Bot 2.0.0 - это не просто бот, это готовое решение для VPN бизнеса.

• ⚡ 5 минут до запуска - быстрее некуда
• 💰 Автоматизация 99% - деньги идут сами
• 🔧 Легкая настройка - справится даже новичок
• 🆓 Open Source - код открыт, развитие прозрачно

💪 Начни свой VPN бизнес уже сегодня!

git clone https://github.com/Fr1ngg/remnawave-bedolaga-telegram-bot.git
cd remnawave-bedolaga-telegram-bot
cp .env.example .env
# Настрой .env
docker compose up -d
# Profit! 💰

---

💝 Создано с любовью для Remnawave сообщества

Автор: @fringg - соло-разработчик

Если проект помог тебе - поставь ⭐, это очень мотивирует!

---

⬆️ Наверх