diff --git a/README.md b/README.md index 6be821f6..6349766b 100644 --- a/README.md +++ b/README.md @@ -35,7 +35,7 @@ ### ⚡ **Полная автоматизация VPN бизнеса** - 🎯 **Готовое решение** - разверни за 5 минут, начни продавать сегодня -- 💰 **Многоканальные платежи** - Telegram Stars + Tribute + CryptoBot + Heleket + YooKassa (СБП + карты) + MulenPay + PayPalych (СБП + карты) + Platega (карты + СБП) + WATA +- 💰 **Многоканальные платежи** - Telegram Stars + Tribute + CryptoBot + Heleket + YooKassa (СБП + карты) + MulenPay + PayPalych (СБП + карты) + Platega (карты + СБП) + WATA + Freekassa (NSPK СБП + карты) - 🔄 **Автоматизация 99%** - от регистрации до продления подписок - 📱 **MiniApp лк** - личный кабинет с возможностью покупки/продления подписки - 📊 **Детальная аналитика** - полная картина вашего бизнеса @@ -45,6 +45,7 @@ - 🌐 **Умный выбор серверов** - автоматический пропуск при одном сервере, мультивыбор - 📱 **Управление устройствами** - от 1 до неограниченного количества - 📊 **Режимы продажи трафика** - фиксированный лимит или выбор пакетов +- 🎯 **Режим тарифов** - готовые тарифные планы с фиксированными параметрами - 🎁 **Промо-система** - коды на деньги, дни подписки, триал-периоды - 🔧 **Гибкие тарифы** - от 5GB до безлимита, от 14 дней до года - 🛒 **Умная корзина** - сохранение параметров подписки при недостатке баланса @@ -58,6 +59,10 @@ - 🗄️ **Бекапы/Восстановление** - автобекапы и восстановление бд прямо в боте с уведомлениями в топики - ✔️ **Проверка на подписку** - проверяет подписку на канал - 🔄 **Автосинхронизация** - фоновая синхронизация подписок и серверов(сквадов) с Remnawave по расписанию +- 📝 **Ротация логов** - автоматическая очистка и архивация старых логов +- 🚫 **Система ограничений** - блокировка пользователей по различным критериям +- 🎮 **Конкурсы и игры** - ежедневные игры с призами и реферальные конкурсы +- 📡 **Модем-подписки** - дополнительный функционал для устройств-модемов ### 📚 Поддерживаемые методы авторизации @@ -539,7 +544,17 @@ hooks.domain.com { } } } - + + handle /freekassa-webhook { + reverse_proxy remnawave_bot:8080 { + header_up Host {host} + header_up X-Real-IP {remote_host} + transport http { + read_buffer 0 + } + } + } + # app-config.json с CORS handle /app-config.json { header Access-Control-Allow-Origin "*" @@ -723,7 +738,19 @@ http { proxy_buffering off; proxy_request_buffering off; } - + + location = /freekassa-webhook { + proxy_pass http://remnawave_bot_unified; + 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; + proxy_read_timeout 120s; + proxy_send_timeout 120s; + proxy_buffering off; + proxy_request_buffering off; + } + # app-config.json с CORS location = /app-config.json { add_header Access-Control-Allow-Origin "*"; @@ -953,6 +980,26 @@ REMNAWAVE_SECRET_KEY=XXXXXXX:DDDDDDDD REMNAWAVE_SECRET_KEY=secret_key_name ``` +### 💳 Freekassa + +Платёжный провайдер [Freekassa](https://freekassa.ru) поддерживает NSPK СБП и банковские карты. + +```env +FREEKASSA_ENABLED=true +FREEKASSA_SHOP_ID=12345 +FREEKASSA_API_KEY=your_api_key +FREEKASSA_SECRET_WORD_1=secret1 +FREEKASSA_SECRET_WORD_2=secret2 +FREEKASSA_USE_API=true +FREEKASSA_PAYMENT_SYSTEM_ID=44 # 44 = NSPK СБП, 42 = обычный СБП +``` + +**Важно:** +- `FREEKASSA_USE_API=true` - использовать API для создания заказов (рекомендуется для NSPK) +- `FREEKASSA_USE_API=false` - редирект на платежную форму +- `FREEKASSA_PAYMENT_SYSTEM_ID=44` - для NSPK СБП (быстрее и надежнее) +- Настройте webhook на `https://your-domain.com/freekassa-webhook` + ### 💳 Platega.io Платёжный провайдер [Platega.io](https://platega.io) добавляет ещё один способ приёма оплат картой и по СБП. Включите его, если у вас есть кабинет мерчанта и доступ к API. @@ -994,6 +1041,24 @@ FIXED_TRAFFIC_LIMIT_GB=100 # 0 = безлимит TRAFFIC_PACKAGES_CONFIG="100:15000:true" ``` +### 🎯 Режим тарифов + +Альтернативный режим продаж с готовыми тарифными планами: + +```env +# Включение режима тарифов +SALES_MODE=tariffs # classic | tariffs + +# Тарифы настраиваются в админ-панели бота +# Каждый тариф содержит: название, период, трафик, устройства, серверы, цену +``` + +**Преимущества режима тарифов:** +- Готовые пакеты без сложного выбора параметров +- Упрощенный UX для пользователей +- Возможность создавать акционные тарифы +- Поддержка скидок промогрупп на тарифы + ### 💰 Система ценообразования Цена подписки рассчитывается по формуле: @@ -1075,6 +1140,53 @@ MONITORING_INTERVAL=60 REDIS_URL=redis://redis:6379/0 ``` +### 🎮 Конкурсы и игры + +```env +# Видимость кнопки конкурсов в главном меню +CONTEST_BUTTON_VISIBLE=true + +# Конкурсы и ежедневные игры настраиваются в админ-панели +# Типы призов: баланс, дни подписки, промогруппа +``` + +**Возможности системы конкурсов:** +- Реферальные конкурсы с рейтингами +- Ежедневные игры с гарантированными призами +- Детальная статистика участников +- Гибкая настройка призов (баланс, подписка, промогруппа) + +### 🚫 Система ограничений пользователей + +```env +# Управление ограничениями через админ-панель +# Типы ограничений: покупка, триал, пополнение баланса +``` + +Позволяет блокировать отдельные функции для пользователей без полной блокировки аккаунта. + +### 📝 Ротация логов + +```env +# Настройка ротации логов +LOG_ROTATION_ENABLED=true +LOG_ROTATION_MAX_SIZE_MB=100 +LOG_ROTATION_MAX_FILES=10 +``` + +### 👁️ Управление видимостью + +```env +# Скрытие кнопок пополнения баланса +HIDE_TOPUP_BUTTONS=false + +# Скрытие реферальной программы +REFERRAL_PROGRAM_VISIBLE=true + +# Видимость кнопки конкурсов +CONTEST_BUTTON_VISIBLE=true +``` + --- #### ⭐ Функционал @@ -1099,6 +1211,8 @@ REDIS_URL=redis://redis:6379/0 - 🧾 Динамический калькулятор стоимости - 💾 **Сквозная корзина** - сохранение параметров при недостатке баланса - ↩️ Быстрый возврат к оформлению после пополнения +- 🎯 **Режим тарифов** - готовые пакеты без сложного выбора +- 🛒 **Простая покупка** - упрощенный режим для быстрого оформления 🧪 **Тестовая подписка** - 🎁 Гибко настраиваемый триал и welcome-цепочка @@ -1106,6 +1220,7 @@ REDIS_URL=redis://redis:6379/0 - 💎 Автовыдача бонусов за кампании и инвайты - 🛡️ Контроль обязательной подписки на канал (отключает подписку при отписке) - 💎 Автовыдача сквада из пула выбранных +- 💳 **Платный триал** с выбором способа оплаты 💰 **Платежи и баланс** - ⭐ Telegram Stars @@ -1117,19 +1232,22 @@ REDIS_URL=redis://redis:6379/0 - 🦐 PayPalych/Pal24 (СБП + карты) - 💳 Platega (СБП + банковские карты) - 💳 **WATA** +- 💳 **Freekassa** (NSPK СБП + карты) - 🔥 Автогенерация счетов и webhook-уведомления -- 💼 История операций +- 💼 История операций - 🔄 Автоплатёж с настройкой дня списания - 🎁 Реферальные и промо-бонусы -- ⚡ **Быстрое пополнение** с кнопками выбора суммы +- ⚡ **Быстрое пополнение** с кнопками быстрых сумм +- 🔄 **Умная автоактивация** подписки после пополнения баланса 📱 **Управление подписками** -- 📈 Реальный трафик, устройства и серверы -- 🌐 Переключение серверов и стран +- 📈 Реальный трафик, устройства и серверы +- 🌐 Переключение серверов и стран - 📱 Сброс HWID - 🧩 Смена языка, промогруппы и параметров - 🧾 Просмотр активных услуг и статуса - 🔗 Получение ссылок подключения в один клик +- 📡 **Модем-режим** - дополнительные устройства для модемов 🛟 **Поддержка и самообслуживание** - 🎫 **Система тикетов** с вложениями @@ -1145,6 +1263,12 @@ REDIS_URL=redis://redis:6379/0 - 📊 Аналитика доходов и конверсии рефералов - 🔗 Генерация реферальных ссылок и QR кодов +🎮 **Конкурсы и игры** +- 🎲 **Ежедневные игры** с призами (баланс, подписка, промогруппа) +- 🏆 **Реферальные конкурсы** с рейтингами и наградами +- 📊 **Детальная статистика** участия в конкурсах +- 🎁 **Разнообразные призы** - баланс, дни подписки, промогруппы + 💎 **Промо-группы и скидки** - 🏷️ **Система промогрупп** с индивидуальными скидками с приоритетами - 💰 Скидки на серверы, трафик и устройства @@ -1162,6 +1286,7 @@ REDIS_URL=redis://redis:6379/0 - 📋 FAQ и юридические документы - 📥 Библиотека загрузочных ссылок для клиентов - 🛰️ Web API для внешних интеграций +- 🎯 **Отображение тарифа** при режиме тарифов @@ -1174,38 +1299,50 @@ REDIS_URL=redis://redis:6379/0 - 🧮 Продажи по тарифам, устройствам и странам - 📣 Эффективность кампаний, промокодов и UTM - 🎯 **Статистика по промо-группам** и скидочным уровням -- 📊 **Расширенная фильтрация** пользователей (баланс, траты, активность) +- 📊 **Расширенная фильтрация** пользователей (баланс, траты, активность, трафик) +- 🏆 **Топ рефереров** по периодам с детальной аналитикой +- 📡 **Мониторинг трафика** и выявление злоупотреблений 💥 **Управление пользователями** - 🔍 Поиск по ID, имени, юзернейму, Telegram ID и фильтры -- 💰 Ручное изменение баланса +- 💰 Ручное изменение баланса - 📱 Изменение лимитов устройств, трафика, серверов - 🔄 Сброс HWID и перегенерация подписки - 🎯 Назначение промогрупп и тарифов - 💳 **Покупка подписки пользователю** прямо из админки - ⏰ **Продление/сокращение срока** подписки (±365 дней) - 🚫 Блокировки с таймером и аудит действий -- 🛡️ **Защита от запрещенных никнеймов** с настраиваемым список банвордов (автоблокировка подозрительных имен) +- 🛡️ **Защита от запрещенных никнеймов** с настраиваемым список банвордов - 💰 **Установка индивидуального реферального процента юзеру** +- 💬 **Отправка сообщения** конкретному пользователю +- 🚫 **Система ограничений** - блокировка функций (покупка, триал, пополнение) +- 📊 **Расширенные фильтры** - по балансу, тратам, трафику, активности +- 🔄 **Готовы к продлению** - фильтр пользователей для продления +- 🗑️ **Черный список** пользователей с управлением 🎯 **Продажи, маркетинг и удержание** -- 🎫 Промокоды +- 🎫 Промокоды - 💳 Промо-группы со скидками - 🎁 **Персональные промо-предложения** с поиском получателей - 💸 **Тестовые серверы** - временная выдача доступа - 💰 **Автоматические скидки** при оплате -- 📣 **Рекламные кампании** с deeplink и бонусами (Автовыдача подписки / баланса при переходе) -- 📨 Рассылки по сегментам с медиа и кнопка -- 🎨 **Кастомные кнопки** для рассылок (подключение, подписка, поддержка, партнертка и тд) +- 📣 **Рекламные кампании** с deeplink и бонусами +- 📨 Рассылки по сегментам с медиа и кнопками +- 🎨 **Кастомные кнопки** для рассылок - 📘 Настройка главного меню и приветственных экранов +- 🎮 **Управление конкурсами** - создание и настройка призов +- 🎲 **Ежедневные игры** с настраиваемыми призами +- 📊 **Детальная статистика** реферальных конкурсов +- 👁️ **Видимость кнопок** - управление отображением конкурсов и реферальной программы 🛟 **Поддержка и модерация** - 🎫 **Центр тикетов** с приоритетами и статусами - ⏱️ **SLA таймеры** и автоуведомления -- 🧑‍⚖️ Роли модераторов с ограниченным доступом (без выдачи админ прав) +- 🧑‍⚖️ Роли модераторов с ограниченным доступом - 📊 Детальный журнал всех операций - 🚫 Блокировки нарушителей - 🧾 История диалогов и быстрые ответы +- 🔔 **Уведомления об ответах** на тикеты для админов 🔔 **Уведомления и коммуникации** - 📢 **Топики для событий** (покупки, триалы, техработы) @@ -1219,6 +1356,8 @@ REDIS_URL=redis://redis:6379/0 - 🔄 **Автосинхронизация Remnawave** по расписанию и при старте бота - ♻️ Проверка обновлений репозитория - 📊 **Мониторинг серверов** (интеграция с XrayChecker) +- 📝 **Ротация логов** - автоматическая очистка и архивация +- 🔄 **Массовая синхронизация** пользователей с Remnawave 🗄️ **Бекапы и восстановление** - 🗓️ **Умные автобекапы** с гибким расписанием @@ -1233,6 +1372,10 @@ REDIS_URL=redis://redis:6379/0 - 🧪 Тестовые платежи для каждого провайдера - 🪙 Управление вебхуками всех платёжных систем - ⚙️ **Управление настройками из бота** (с приоритетом в .env) +- 🎯 **Режим тарифов** - готовые планы с фиксированными параметрами +- 🛒 **Простая покупка подписки** - упрощенный режим без выбора параметров +- 👁️ **Скрытие кнопок** пополнения баланса +- 👁️ **Скрытие реферальной** программы ⚙️ **Remnawave** - Синхронизация юзеров из панели в бота (Ручная/автоматическая по таймеру) @@ -1265,14 +1408,17 @@ REDIS_URL=redis://redis:6379/0 - 📦 **Интеграция с Remnawave API** - автоматическое создание пользователей и синхронизация - 🔄 **Миграция сквадов** - массовый перенос пользователей между сквадами - 🧾 **История операций** - хранение всех транзакций и действий для аудита -- 💸 **Сервис автопрворки транзакций** - автоматическая проверка транзакций в статусе "В ожидании оплаты" за последние 24ч +- 💸 **Сервис автопроверки транзакций** - автоматическая проверка транзакций в статусе "В ожидании оплаты" за последние 24ч +- 🔄 **Умная автоактивация** - автоматическая активация подписки после пополнения баланса +- 📝 **Ротация логов** - автоматическая очистка и архивация старых логов +- 🎮 **Система конкурсов** - ежедневные игры и реферальные конкурсы с призами ### 🌐 Веб-API и мини-приложение - ⚙️ **FastAPI Web API** с эндпоинтами для управления всеми аспектами бота - 🔒 **Управление API-ключами** - выпуск, отзыв, реактивация токенов - 🛰️ **Mini App** - полноценный личный кабинет внутри Telegram -- 💳 **Интегрированные платежи** в Mini App (Stars, Pal24, YooKassa, WATA) +- 💳 **Интегрированные платежи** в Mini App (Stars, Pal24, YooKassa, WATA, Freekassa) - 🧭 **Единый стандартный app-config.json** - централизованная раздача ссылок на клиенты - 🪙 **Платёжные вебхуки** - встроенные серверы для всех платёжных систем - 📡 **Мониторинг серверов** - REST-эндпоинты для просмотра нод и статистики @@ -1326,6 +1472,7 @@ REDIS_URL=redis://redis:6379/0 - **PayPalych**: Укажи Result URL `https://your-domain.com/pal24-webhook` в кабинете Pal24 - **Platega**: Настрой webhook на `https://your-domain.com/platega-webhook` - **WATA**: Настрой webhook на `https://your-domain.com/wata-webhook` + - **Freekassa**: Настрой webhook на `https://your-domain.com/freekassa-webhook` 4. **🔄 Настройка автосинхронизации** (опционально) - В `.env` установи `REMNAWAVE_AUTO_SYNC_ENABLED=true` @@ -1649,12 +1796,12 @@ REMNAWAVE_SECRET_KEY=XXXXXXX:DDDDDDDD | Метрика | Значение | |---------|----------| -| 💳 **Платёжных систем** | 9 (Stars, YooKassa, Tribute, CryptoBot, Heleket, MulenPay, Pal24, Platega, WATA) | +| 💳 **Платёжных систем** | 10 (Stars, YooKassa, Tribute, CryptoBot, Heleket, MulenPay, Pal24, Platega, WATA, Freekassa) | | 🌍 **Языков интерфейса** | 2 (RU, EN) с возможностью расширения | | 📊 **Периодов подписки** | 6 (от 14 дней до года) | | 🎁 **Типов промо-акций** | 5 (коды, группы, предложения, скидки, кампании) | | 🔌 **REST API эндпоинтов** | 50+ для полного управления | -| 📱 **Режимов работы** | 2 (классический бот + MiniApp focus) | +| 📱 **Режимов работы** | 3 (классический + тарифы + MiniApp focus) | | 🛡️ **Методов авторизации** | 4 (API Key, Bearer, Basic Auth, eGames) | | 🗄️ **Способов хранения** | 2 (PostgreSQL, SQLite) с автовыбором |