Update README.md

2026-01-08 04:37:18 +03:00
parent 28c953c5ae
commit 20315cf88f
1 changed files with 166 additions and 19 deletions
@@ -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 для внешних интеграций
+- 🎯 **Отображение тарифа** при режиме тарифов

 </td>
 <td width="50%" valign="top">
@@ -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) с автовыбором |