Welcome file

bot.md

Telegram VPN Bot

Бот для управления VPN-сервисом через Telegram. Позволяет пользователям получать VPN-ключи, управлять балансом и подпиской.

Основные функции

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

• 🔑 Получение VPN-ключей

• 💰 Пополнение баланса

• 📊 Просмотр личного кабинета

• 🤝 Реферальная система

• 📱 Поддержка различных устройств

• 📖 Гайды по настройке

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

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

• 💵 Модерация платежей

• 📢 Рассылка сообщений

• 🔄 Управление ключами

• 📊 Статистика и мониторинг

Технические особенности

База данных

• Используется SQLite для хранения данных пользователей

• Таблицы:

• users (информация о пользователях)

• referrals (реферальная система)

• payments (история платежей)

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

• Ежедневная проверка балансов в 12:00 по МСК

• Автоматическое отключение VPN при отрицательном балансе

• Уведомления о низком балансе (за 4 дня до отключения)

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

• Проверка платежей администратором

• Защита от дублирования ключей

• Логирование всех действий

Реферальная система

• Бонус 50 рублей рефереру за приглашенного пользователя

• Бонус 20 рублей приглашенному пользователю

• Уникальные реферальные ссылки

• Отслеживание реферальных связей

Команды бота

Основные команды

• /start - Начало работы с ботом

• /help - Справка по командам

• /admin - Панель администратора (только для админов)

Callback-кнопки

• Главное меню

• Пополнение баланса

• Получение ключей VPN

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

• Реферальная информация

• Поддержка

Особенности реализации

Обработка платежей

• Поддержка различных форматов чеков (PNG, JPG, PDF)

• Модерация платежей администратором

• Автоматическое начисление средств после подтверждения

Управление VPN

• Интеграция с Outline VPN API

• Автоматическая генерация ключей

• Возможность перегенерации ключей

• Поддержка нескольких локаций (пока только Финляндия)

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

• Уведомления о низком балансе

• Оповещения о подтверждении платежей

• Уведомления о новых рефералах

• Системные уведомления

Логирование

• Запись всех действий в файл bot.log

• Логирование ошибок и исключений

• Отслеживание пользовательских действий

• Мониторинг системных событий

Безопасность и конфиденциальность

• Защита персональных данных

• Безопасное хранение ключей

• Ограничение доступа к админ-панели

• Шифрование конфиденциальной информации

Поддержка

• Встроенная система поддержки

• Возможность отправки сообщений администратору

• Быстрое реагирование на проблемы

• Документация по устранению неполадок