Отправить новое сообщение и удалить предыдущее. Это основная функция для чистого чата - она: 1. Удаляет предыдущее сообщение бота (если

Вернуться к меню редактирования параметров

Отобразить карточку тура с фотографиями. Args: message: Message объект для отправки state: FSMContext hotel: HotelCa

Вернуть default если value is None. В отличие от dict.get(key, default), эта функция проверяет само значение, а не наличие ключа в с

Форматированная цена

Звезды в текстовом формате

Получение информации о номерах в отеле. Args: request_id: ID поискового запроса hotel_id: ID отеля

Получить заголовки для запросов к API

Постановка поиска туров в очередь. Args: params: Параметры поиска (SearchParams) Returns:

Получение страницы отелей из результатов поиска. Args: request_id: ID поискового запроса search_params: Пара

Убирает дубликаты отелей, оставляя лучшее предложение для каждого. API Level.Travel возвращает несколько туров для одного отеля (разные

Показать список избранных туров

Запросить даты поездки

Создать клавиатуру для выбора удобств отеля. Args: selected_amenities: Список уже выбранных удобств (их коды) Returns:

Возвращает русское название города по английскому. ВАЖНО: API Level.Travel возвращает города на РУССКОМ языке! Эта функция используется

Ожидание завершения поиска с polling. Args: request_id: ID поискового запроса timeout: Максимальное

Резервный парсинг без AI

Анализ причины отсутствия результатов поиска. Args: data: Данные из state с параметрами поиска Returns: Tuple (

Запросить выбор страны - показываем inline-кнопки с популярными странами.

Создает клавиатуру выбора страны с пагинацией.

Генерировать партнерскую ссылку на бронирование. Args: tour_id: ID тура hotel_id: ID отеля request_id: ID поискового

Возвращает словарь городов для указанной страны. Args: country_code: ISO код страны (например, "TR", "EG") Returns: Сло

Получить максимальную допустимую дату вылета (через 365 дней). Returns: datetime объект с датой через год

Получить минимальную допустимую дату вылета (завтра). Returns: datetime объект с датой завтра (00:00:00)

Показать распознанные параметры для подтверждения

Запросить бюджет

Запросить выбор города назначения в выбранной стране.

Задать уточняющий вопрос по недостающему параметру

Создает клавиатуру для выбора города назначения в выбранной стране. Args: country_code: ISO код страны (например, "TR", "EG") R

Создать клавиатуру для выборочного редактирования параметров. Args: Все параметры поиска тура Returns: Inli

Удалить последнее сообщение бота из state. Используется когда нужно просто удалить последнее сообщение без отправки нового (например, пе

Форматирует название страны с учетом специальных правил.

Форматирует число с пробелами: 3622 → 3 622

Форматировать краткую сводку по параметрам. Args: params: Словарь с параметрами Returns: Отформатированная

Получить простое завершение от OpenAI для заданного промпта Args: prompt: Текст промпта для GPT-4 temperatur

Получить ответ от Navia с учетом контекста диалога

Получить все избранные туры пользователя. Args: user_id: ID пользователя Returns: Список словарей с данными избранных т

Получение истории заявок пользователя

Показать меню выборочного редактирования параметров

Показать все параметры для подтверждения

Обновить параметры тура с учетом контекста. Args: previous_params: Предыдущие распознанные параметры

Валидация даты вылета. Args: date_str: Дата в формате DD.MM.YYYY Returns: Tuple (валидна ли дата, сообщение об

Резервный ответ Navia на случай ошибки API

Резервные рекомендации на случай ошибки API

Маппинг удобств на фильтры API. Используется только в to_filter_params() для search/get_grouped_hotels. ВАЖНО: Boole

Настройка шрифтов с поддержкой кириллицы

Добавить тур в избранное. Args: user_id: ID пользователя Telegram hotel_id: ID отеля hotel_name: Название отеля

Анализ параметров тура через ChatGPT-4. Извлекает: страну, город назначения, даты, количество человек, бюджет, удобства. Ret

Запросить количество взрослых

Запросить выбор удобств у пользователя. Args: message: Message объект для отправки сообщения state: FSMContext

Запросить количество детей

Запросить возраста детей

Запросить количество ночей

Запросить минимальную звездность

Группировка удобств отеля по категориям. Args: facilities: Список названий удобств Returns: Словарь {категория:

Проверка статуса выполнения поискового запроса. Args: request_id: ID поискового запроса show_size: П

Удалить все избранные туры пользователя. Args: user_id: ID пользователя Returns: Количество удаленных записей

Клавиатура подтверждения очистки всего избранного

Создать клавиатуру со списком избранных туров. Args: favorites: Список избранных туров Returns: InlineKeyboardMarkup

Создать клавиатуру навигации по турам. Args: index: Текущий индекс total: Всего туров tour_id: ID тура hotel

Удалить список предыдущих сообщений. Args: bot: Bot instance chat_id: ID чата message_ids: Список ID сообщений для у

Конвертация ответа API в HotelCard. Args: api_data: Данные из Leveltravel API (один элемент массива hotels) Returns:

Форматирование параметров поиска для показа пользователю. Args: params: Параметры поиска Returns: Форматированн

Форматировать описание тура для отображения. Args: hotel: HotelCard index: Текущий индекс (локальный в загруженных турах)

Генерация подробного PDF с полной информацией о туре. Args: hotel_card: HotelCard с основной информацией

Генерировать краткое описание отеля (4-5 предложений). Args: hotel_data: {hotel_name, stars, rating, city, region, featu

Возвращает список альтернативных городов в той же стране. Используется когда туры в конкретный город закончились, чтобы предложить польз

Получить названия удобств по кодам

Получить лучшее доступное качество

Принимает пользовательский ввод, нормализует его и возвращает ISO код страны. Args: user_input: Название страны от пользователя (нап

Получить название страны по коду

Получить количество избранных туров пользователя. Args: user_id: ID пользователя Returns: Количество туров в избранном

Эмодзи для типа питания

Получить смешанные фото отеля и номеров. Args: hotel: HotelCard с данными отеля request_id: ID поискового запроса

Получить рекомендации по путешествиям от ChatGPT-4

Обработка ситуации когда закончились туры. Если был указан конкретный город, пробуем переключиться на другие города страны. Args:

Подготовить MediaGroup с фотографиями отеля для Telegram. Args: hotel: HotelCard с информацией об отеле add_caption: Доб

Удалить тур из избранного по ID записи. Args: user_id: ID пользователя favorite_id: ID записи в таблице favorites Retur

Восстановление контекста последней заявки пользователя

Сохранение заявки пользователя в Google Sheets

Конвертация в параметры для search/enqueue. Только базовые параметры поиска без фильтров.

Конвертация в параметры фильтрации для search/get_grouped_hotels. Только фильтры, без базовых параметров поиска.

Проверить валидность URL фотографии. Args: url: URL для проверки Returns: True если URL валиден

Парсинг ответа от AI

Завершение выбора удобств, переход к подтверждению параметров. MEAL FILTER DISABLED (2025-12-14): Пропускаем выбор типа питания, сразу п

Пропустить выбор удобств.

Анализ рейтинга отеля через ChatGPT-4

Вернуться к списку избранного

Возврат в главное меню

Отменить очистку

Отмена ввода города