🚀 Changelog v2.5.0

🎯 Основные изменения

🔗 Глубокая интеграция с MiniApp

Представлен новый режим работы бота с плотной интеграцией Личного кабинета через MiniApp:

• Новый режим главного меню (MAIN_MENU_MODE)

  • Режим text — упрощённый интерфейс с фокусом на MiniApp
  • Режим default — классический полнофункциональный интерфейс бота
  • Настройка через .env с автоматической валидацией режимов

• Умное переключение кнопок

  • В режиме text все кнопки управления (покупка, продление, баланс, реферралы, промокоды) автоматически открывают MiniApp, а так скрываются в меню кнопки (Подписка, Баланс, Партнерка, Инфо)
  • Добавлена функция build_miniapp_or_callback_button для автоматического выбора типа кнопки
  • Реализован обработчик handle_profile_unavailable для случаев, когда MiniApp недоступен

📱 Обновлённый гайд по подключению

Полностью переработан интерфейс подключения устройств с поддержкой актуального формата app-config.json:

• Расширенный выбор приложений

  • Отображение рекомендуемого приложения и списка альтернатив
  • Кнопка "Другие приложения" для быстрого переключения
  • Поддержка deep-link с автоматическим base64-кодированием

• Улучшенные инструкции

  • Локализованные описания для каждого шага
  • Дополнительные секции «before»/«after» с кастомными описаниями
  • Обновлён второй шаг: вместо копирования ссылки — кнопка "Подключиться"

• Новые возможности

  • Поддержка платформы Apple TV
  • Гибкая конфигурация кнопок установки и дополнительных действий
  • Синхронизация с шаблоном index.html панели Remnawave

🔄 Синхронизация и стабильность

• Автоматическая синхронизация подписок

  • Синхронизация использования трафика при запросе деталей подписки
  • Автоматическое обновление traffic_used_gb и updated_at
  • Улучшенная обработка ошибок с логированием

• Повышенная надёжность

  • Fallback при неудачном обновлении данных пользователя
  • Централизованная обработка ошибок синхронизации
  • Улучшенная устойчивость к сбоям БД

⚙️ Технические улучшения

• Рефакторинг архитектуры

  • Унификация функций локализации и форматирования
  • Вынесены утилиты для работы с MiniApp кнопками
  • Улучшена типизация конфигурации приложений

• Обновления интерфейсов

  • Все клавиатуры и обработчики адаптированы под новый режим
  • Параметр force_text для отправки сообщений без фото-логотипа
  • Централизованное управление кнопками в уведомлениях и промо-акциях

• Локализация

  • Новые строки для режима MiniApp (RU/EN)
  • Обновлены инструкции по подключению устройств
  • Добавлены переводы для Apple TV

📋 Затронутые модули

• app/webapi/routes/miniapp.py
• app/handlers/admin/messages.py
• app/utils/miniapp_buttons.py (новый файл)
• app/handlers/menu.py
• app/handlers/subscription.py
• app/handlers/promo_offers.py
• app/handlers/start.py
• Сервисы платежей и мониторинга
• Конфигурация и локализации

🎨 Что это даёт

• Гибкость развёртывания — выбор между полнофункциональным ботом и лёгким интерфейсом с MiniApp
• Улучшенный UX — простой и понятный гайд по подключению с поддержкой множества приложений
• Стабильность — автоматическая синхронизация данных и улучшенная обработка ошибок
• Масштабируемость — готовность к интеграции с панелью Remnawave

Рекомендации по обновлению:

• Проверьте настройки MAIN_MENU_MODE в .env или Конфигурациях бота в админ панели
• Обновите app-config.json и miniapp/index.html у себя на сервере до актуального формата
• Протестируйте работу в обоих режимах меню

Совместимость: Полная обратная совместимость с предыдущими версиями при использовании режима default