🎉 Changelog — Версия 2.4.5

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

📢 Система персональных промо-предложений

• Индивидуальные промо-предложения для пользователей
  • Администраторы теперь могут отправлять персонализированные промо-предложения конкретным пользователям
  • Поиск пользователей по имени, username или ID
  • Просмотр детального профиля пользователя перед отправкой предложения
  • Отображение текущего статуса подписки, баланса и активных скидок

🔌 API для управления промо-предложениями

• Новый раздел /promo-offers в REST API
  • GET /promo-offers — получение списка предложений с фильтрацией и пагинацией
  • POST /promo-offers — создание персональных предложений
  • GET /promo-offers/{id} — детальная информация о предложении
  • GET /promo-offers/logs — полный журнал операций с предложениями
  • GET /promo-offers/templates — управление шаблонами предложений
  • PATCH /promo-offers/templates/{id} — редактирование шаблонов
• Поддержка фильтрации по пользователю, статусу, типу уведомления
• Встроенная документация в Swagger UI

📄 Управление информационными страницами

• Новый API-раздел /pages
  • Полноценный CRUD для публичных информационных страниц
  • Управление политикой конфиденциальности, офертой, FAQ и правилами
  • История изменений для всех типов документов
  • Возможность сортировки и управления статусом публикации

📚 Юридические и информационные разделы

• Политика конфиденциальности

  • Создание и редактирование через админ-панель
  • Многоязычная поддержка с автоматическим fallback
  • Автоматическая разбивка длинных текстов на страницы
  • Управление статусом отображения

• Публичная оферта

  • Аналогичный функционал как для политики конфиденциальности
  • Отображение в пользовательском меню при активации

• FAQ (Часто задаваемые вопросы)

  • Создание отдельных страниц с вопросами и ответами
  • Управление порядком отображения
  • Индивидуальная активация/деактивация страниц
  • Удобная навигация для пользователей

🔧 Улучшения

⚙️ Webhook-серверы

• Гибкая настройка адресов и портов
  • Новые параметры конфигурации: TRIBUTE_WEBHOOK_HOST и YOOKASSA_WEBHOOK_HOST
  • Возможность указать кастомный адрес вместо 0.0.0.0 по умолчанию
  • Улучшенное логирование с отображением актуального адреса и порта

🎨 Интерфейс администратора

• Новые разделы в админ-меню для управления контентом
• Детальная статистика по отправленным предложениям
• Превью текстов с отображением статуса (активен/отключен/пустой)
• Время последнего обновления для всех разделов

👥 Пользовательское меню

• Обновлённый раздел "Инфо" с динамическим отображением доступных разделов
• Кнопки FAQ, Политики и Оферты появляются только при наличии активного контента
• Улучшенная навигация между страницами

🗄️ База данных

Новые таблицы

• privacy_policies — хранение политики конфиденциальности
• public_offers — хранение публичной оферты
• faq_settings — настройки FAQ
• faq_pages — отдельные страницы FAQ

Обновления CRUD

• Расширены методы DiscountOffer: list_discount_offers и count_discount_offers
• Улучшена фильтрация в PromoOfferLog по пользователю, предложению, действию
• Добавлена загрузка связанных сущностей в get_offer_by_id

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

• Добавлено 60+ новых строк локализации (en/ru)
• Полная поддержка всех новых функций на английском и русском языках
• Многоязычные тексты для промо-предложений и информационных страниц
• Автоматический fallback на язык по умолчанию

🔐 Состояния FSM

Добавлены новые состояния для администраторов:

• selecting_promo_offer_user — выбор пользователя для промо-предложения
• searching_promo_offer_user — поиск пользователя
• Состояния для создания и редактирования FAQ
• Состояния для управления Privacy Policy и Public Offer

📖 Документация

• Обновлён docs/web-admin-integration.md с описанием новых эндпоинтов
• Расширен .env.example с новыми параметрами webhook-серверов
• Обновлён README.md с инструкциями по настройке

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

• Полная типизация новых модулей с использованием Pydantic схем
• Валидация входящих данных на уровне API
• Защита всех новых эндпоинтов проверкой API токена
• Улучшенная читаемость и структура кода
• Автоматические миграции для новых таблиц

Версия 2.4.5 значительно расширяет административные возможности бота, добавляя полноценную систему управления промо-предложениями и информационным контентом. Теперь администраторы имеют все необходимые инструменты для персонализированной работы с пользователями и управления юридической документацией прямо из интерфейса бота.

What's Changed

• w by @Fr1ngg in #806
• Фикс промо предложений by @Fr1ngg in #807
• Dev2 by @Fr1ngg in #811
• Расширения функционала отправки промо предложений / отправка конкретному юзеру by @Fr1ngg in #831
• FAQ, Политика Конф, Оферта by @Fr1ngg in #846
• Дополнительные методы API для работы со страницами из ИНФО + вынесение хостов в конфигурации для платежек by @Fr1ngg in #853

Full Changelog: v2.4.4...v2.4.5