Перейти к основному содержимому
Войти

Руководство для туристов

Полное руководство по использованию платформы Arkhyz Club для планирования и бронирования отдыха.

Регистрация и профиль​

Создание аккаунта​

  1. Зарегистрируйтесь через email или социальные сети
  2. Подтвердите email адрес
  3. Заполните базовую информацию профиля
  4. Добавьте фотографию (по желанию)

API endpoints:

  • GET /auth/me - получить текущий профиль
  • PUT /auth/profile - обновить профиль

Открыть в Swagger

Уведомления​

Получите все уведомления пользователя с возможностью фильтрации:

API endpoints:

  • GET /notifications - все уведомления
  • GET /notifications/unread - непрочитанные уведомления
  • PUT /notifications/{id}/read - отметить как прочитанное

Открыть в Swagger

Параметры фильтрации уведомлений:

  • object_type - тип объекта (tour_booking, transfer_booking, hotel_booking, restaurant_booking, instructor_booking)
  • limit - количество уведомлений (по умолчанию 20)
  • offset - смещение для пагинации
  • read - фильтр по статусу прочтения (true/false)

Примеры запросов с фильтрацией:

Получите только уведомления о турах:

GET /notifications?object_type=tour_booking

Получите непрочитанные уведомления о трансферах:

GET /notifications?object_type=transfer_booking&read=false

Получите последние 10 уведомлений:

GET /notifications?limit=10

Структура уведомления с мета-данными:

{
  "id": "uuid",
  "title": "Новое бронирование тура", 
  "message": "Ваше бронирование тура 'Поход к водопадам' создано",
  "type": "tour_booking_created",
  "object_type": "tour_booking",
  "object_id": "booking-uuid",
  "link": "/tourist/booking-history",
  "read": false,
  "meta": {
    "tour_name": "Поход к водопадам",
    "booking_date": "2024-03-15T10:00:00Z", 
    "participants_count": 2,
    "total_price": 3000
  },
  "created_at": "2024-03-01T12:00:00Z"
}

Типы уведомлений по объектам:

  • Туры: tour_booking_created, tour_booking_confirmed, tour_booking_cancelled
  • Трансферы: transfer_booking_created, transfer_booking_confirmed, transfer_booking_cancelled
  • Отели: hotel_booking_created, hotel_booking_confirmed, hotel_booking_cancelled
  • Рестораны: restaurant_booking_created, restaurant_booking_confirmed
  • Инструкторы: instructor_booking_created, instructor_booking_confirmed

Истории туристов​

Раздел историй позволяет туристам делиться своими впечатлениями о поездках, просматривать истории других путешественников и взаимодействовать с контентом через лайки и комментарии.

Просмотр и поиск историй​

API endpoints:

  • GET /stories - все истории туристов
  • GET /stories/{id} - детали конкретной истории

Открыть в Swagger

Создание и управление историями​

API endpoints:

  • POST /stories - создать новую историю
  • PUT /stories/{id} - редактировать историю
  • DELETE /stories/{id} - удалить историю

Взаимодействие с историями​

API endpoints:

  • POST /stories/{id}/like - поставить лайк
  • DELETE /stories/{id}/like - убрать лайк

Комментарии к историям​

API endpoints:

  • GET /stories/{id}/comments - комментарии к истории
  • POST /stories/{id}/comments - написать комментарий
  • PUT /comments/{id} - редактировать комментарий
  • DELETE /comments/{id} - удалить комментарий

Отзывы туристов​

API endpoints:

  • GET /reviews - отзывы туристов
  • POST /reviews - написать отзыв

Погода​

Раздел погоды предоставляет актуальную информацию о погодных условиях в горнолыжных курортах Архыза и Домбая. Туристы могут просматривать текущие данные и прогноз для планирования своих активностей.

Текущая погода​

Получите подробную информацию о текущих погодных условиях в выбранной локации:

Отображаемые данные:

  • Название локации - выбранный населенный пункт (Архыз, Домбай)
  • Температура - текущая температура (°C) и ощущается как
  • Облачность - процент облачного покрова (0-100%)
  • Ветер - скорость ветра (м/с) и направление (С, СВ, В, ЮВ, Ю, ЮЗ, З, СЗ)
  • Время восхода и захода солнца - точное время рассвета и заката
  • Дополнительная информация:
    • Влажность воздуха (%)
    • Атмосферное давление (гПа)
    • Видимость (км)
    • УФ-индекс (0-11)
    • Количество осадков (мм)

API endpoints:

  • GET /weather/current - текущая погода

Открыть в Swagger

Прогноз погоды​

Получите многодневный прогноз погоды для планирования поездки:

Информация по дням:

  • Дата - дата прогноза
  • Температура - минимальная и максимальная температура дня
  • Условия погоды - описание состояния погоды (ясно, облачно, снегопад)
  • Вероятность осадков - процент вероятности дождя или снега
  • Ветер - скорость ветра в течение дня
  • Облачность - процент облачного покрова
  • Влажность - влажность воздуха
  • Восход и заход солнца - время рассвета и заката

API endpoints:

  • GET /weather/forecast - прогноз погоды

Открыть в Swagger

Выбор локации​

API endpoints:

  • GET /weather/locations - доступные локации
Советы по использованию погодных данных
  • Проверяйте прогноз перед планированием походов в горы
  • Учитывайте направление и силу ветра для зимних видов спорта
  • Следите за УФ-индексом на больших высотах
  • Время восхода и захода солнца поможет спланировать фотосессии

Веб-камеры​

Раздел веб-камер предоставляет доступ к онлайн трансляциям с различных точек горнолыжных курортов Архыза и Домбая. Туристы могут в режиме реального времени наблюдать за погодными условиями, состоянием склонов и общей обстановкой на курортах.

Обзор функциональности​

Доступные типы веб-камер:

  • Панорамные камеры - обзор горных вершин и долин
  • Склоновые камеры - состояние горнолыжных трасс и подъемников
  • Погодные камеры - текущие погодные условия
  • Обзорные камеры - общий вид курортных зон

Список всех веб-камер​

Получите полный список активных веб-камер с возможностью фильтрации по локации:

Отображаемая информация:

  • Название веб-камеры - описательное название точки съемки
  • Локация - точное место установки камеры
  • Описание - что именно показывает данная камера
  • Превью изображение - текущий снимок с камеры
  • Расстояние от вас - если предоставлены ваши координаты
  • Статус активности - работает ли камера в данный момент

API endpoints:

  • GET /webcams - список всех веб-камер

Открыть в Swagger

Просмотр конкретной веб-камеры​

Получите детальную информацию о выбранной веб-камере и прямой доступ к трансляции:

Данные при переходе на видео:

  • Название - полное название веб-камеры и точки съемки
  • Дата и время - время последнего обновления трансляции
  • Ссылка для трансляции - прямая ссылка на видеопоток для просмотра
  • Координаты - точные географические координаты
  • Качество трансляции - разрешение и формат видео
  • Техническая информация - статус подключения и битрейт

Типы видеопотоков:

  • HLS потоки (.m3u8) - высококачественное адаптивное видео
  • YouTube трансляции - встроенные прямые трансляции
  • Обновляемые изображения - статичные фото с автообновлением
  • Панорамное видео - обзор 360° (где доступно)

API endpoints:

  • GET /webcams/{id} - детали веб-камеры

Поиск ближайших веб-камер​

Найдите веб-камеры в радиусе от вашего текущего местоположения:

Функциональность:

  • Поиск камер в заданном радиусе (по умолчанию 10 км)
  • Автоматическая сортировка по расстоянию
  • Отображение расстояния до каждой камеры
  • Фильтрация только активных камер

API endpoints:

  • GET /webcams/nearby - ближайшие веб-камеры

Поделиться веб-камерой​

Создайте ссылки для отправки друзьям интересных видов:

Возможности:

  • Генерация прямой ссылки на веб-камеру
  • Создание короткой ссылки для удобства
  • QR-код для быстрого доступа с мобильных устройств
  • Возможность отправить ссылку в мессенджерах

API endpoints:

  • GET /webcams/{id}/share - поделиться веб-камерой
Практические советы по использованию веб-камер
  • Перед поездкой: Проверьте состояние дорог и погодные условия
  • Планирование катания: Оцените состояние склонов и очереди на подъемники
  • Безопасность: Следите за изменениями погоды в горах
  • Фотосъемка: Выберите лучшее время для посещения конкретных локаций
  • Поделитесь: Отправьте друзьям красивые виды перед их приездом
Техническая информация
  • Большинство камер обновляются каждые 5-10 минут
  • Для просмотра видеопотоков рекомендуется стабильное интернет-соединение
  • На мобильных устройствах доступны адаптивные версии трансляций
  • В случае технических проблем с камерой отображается последний доступный снимок

Поддержка​

Платформа предоставляет несколько способов получения помощи: AI-чат для мгновенных ответов, система тикетов для детального решения проблем и живой чат с операторами для персональной поддержки.

Обзор системы поддержки​

Доступные способы получения помощи:

  • AI-чат поддержка - мгновенные ответы на часто задаваемые вопросы 24/7
  • Тикеты поддержки - детальное описание проблем с отслеживанием решения
  • Живой чат - персональное общение с операторами поддержки

Когда использовать каждый тип:

  • AI-чат: Общие вопросы, помощь с бронированием, информация о сервисах
  • Тикеты: Сложные технические проблемы, финансовые вопросы, жалобы
  • Живой чат: Срочные вопросы, персональная консультация, эскалация

AI-чат поддержка​

AI-помощник предоставляет мгновенные ответы на вопросы о бронировании, ски-пассах, турах и общих вопросах о платформе. При необходимости может направить к человеку-оператору.

Возможности AI-помощника:

  • Помощь с бронированием отелей и номеров
  • Информация о покупке ски-пассов
  • Консультации по турам и экскурсиям
  • Помощь с трансферами и транспортом
  • Общие вопросы о функциональности платформы
  • Эскалация сложных вопросов к живым операторам

AI-чат доступен через Edge Function ai-support-chat

Система тикетов поддержки​

Создавайте детальные обращения с возможностью отслеживания статуса и ведения переписки.

Создание тикета поддержки​

Создайте новый тикет с описанием проблемы и выбором приоритета:

Параметры тикета:

  • Тема - краткое описание проблемы
  • Приоритет - низкий, средний, высокий, критический
  • Описание - подробное изложение вопроса или проблемы
  • Статус - открытый (по умолчанию)

API endpoints:

  • POST /support/tickets - создать тикет поддержки

Управление тикетами​

Просмотрите все свои тикеты с возможностью фильтрации и поиска:

Возможности:

  • Фильтрация по статусу (открытый, в процессе, закрытый)
  • Фильтрация по приоритету
  • Сортировка по дате создания
  • Пагинация для удобного просмотра

API endpoints:

  • GET /support/tickets - мои тикеты поддержки

Работа с конкретным тикетом​

Получите полную информацию о тикете включая всю историю переписки:

Отображаемая информация:

  • Детали тикета (тема, статус, приоритет, даты)
  • Полная история сообщений
  • Информация о сотрудниках, работавших с тикетом
  • Временные метки всех действий

API endpoints:

  • GET /support/tickets/{id} - детали тикета
  • PUT /support/tickets/{id} - обновить тикет
  • POST /support/tickets/{id}/messages - добавить сообщение

Живой чат с операторами​

Общайтесь с операторами поддержки в режиме реального времени для получения персональной помощи.

Создание сессии чата​

Начните новый чат с оператором поддержки:

Параметры сессии:

  • Начальное сообщение (опционально)
  • Автоматическое определение доступных операторов
  • Уведомление о времени ожидания

API endpoints:

  • POST /chat/sessions - начать чат с оператором

Управление сессиями чата​

Просмотрите все ваши чаты (активные и завершенные):

Информация о сессиях:

  • Статус сессии (активная, ожидание, завершена)
  • Время начала и окончания
  • Информация об операторе
  • Количество сообщений

API endpoints:

  • GET /chat/sessions - мои чаты
  • GET /chat/sessions/{id} - детали чата
  • POST /chat/sessions/{id}/messages - отправить сообщение
  • GET /chat/sessions/{id}/messages - сообщения чата
  • PUT /chat/sessions/{id}/close - закрыть чат
  • GET /chat/stats - статистика чатов
Практические советы по работе с поддержкой

Для быстрого решения вопросов:

  • Начните с AI-чата для простых вопросов
  • Используйте тикеты для сложных проблем, требующих детального разбора
  • Живой чат подходит для срочных вопросов в рабочее время

При создании тикета:

  • Выберите правильный приоритет (критический только для блокирующих проблем)
  • Подробно опишите проблему и шаги для воспроизведения
  • Приложите скриншоты или файлы, если они помогут решению

Время работы поддержки:

  • AI-чат: 24/7
  • Тикеты: обработка в рабочие дни 9:00-18:00 МСК
  • Живой чат: рабочие дни 9:00-18:00 МСК
Эскалация и приоритеты

Уровни приоритета:

  • Низкий - общие вопросы, не влияющие на использование сервиса
  • Средний - проблемы, влияющие на удобство использования
  • Высокий - проблемы, существенно влияющие на работу с платформой
  • Критический - полная невозможность использования сервиса

Время отклика:

  • Критический: в течение 1 часа
  • Высокий: в течение 4 часов
  • Средний: в течение 24 часов
  • Низкий: в течение 48 часов

Основные возможности​

  • Поиск отелей - находите подходящие варианты размещения
  • Бронирование номеров - создавайте и управляйте бронированиями
  • Туры и экскурсии - бронируйте туры и активности
  • Трансферы - заказывайте транспорт

Поиск и бронирование отелей​

Поиск доступных отелей​

API endpoints:

  • GET /hotels - поиск отелей
  • GET /hotels/{id} - детали отеля
  • GET /availability/check - проверить доступность

Поиск отелей
Детали отеля

Рекомендации отелей​

API endpoints:

  • GET /hotels/recommended - рекомендуемые отели

Рекомендуемые отели

Бронирования​

Создание бронирования​

API endpoints:

  • POST /bookings - забронировать номер
  • GET /bookings/my - мои бронирования

Туры и экскурсии​

Поиск туров​

API endpoints:

  • GET /tours - найти туры
  • POST /tour-bookings - забронировать тур
  • GET /tours/popular - популярные туры

Трансферы​

Поиск трансферов​

API endpoints:

  • GET /transfers - найти трансферы

Карта активностей​

API endpoints:

  • GET /activities/map - активности на карте
  • GET /activities/search - поиск активностей

Избранное​

Туристы могут добавлять понравившиеся элементы в избранное для быстрого доступа.

Поддерживаемые типы​

Система избранного поддерживает следующие типы контента:

  • tour - туры и экскурсии
  • hotel - отели и гостиницы
  • restaurant - рестораны и кафе
  • instructor - инструкторы по ски/сноуборду
  • transfer - трансферы и перевозки

Управление избранным​

API endpoints:

  • POST /favorites - добавить в избранное
  • DELETE /favorites/{item_type}/{item_id} - удалить из избранного
  • GET /favorites - мой список избранного
  • GET /favorites/check/{item_type}/{item_id} - проверить статус избранного

Пример тела запроса:

{
  "item_type": "hotel",
  "item_id": "uuid-отеля"
}

Параметры запроса:

  • item_type (необязательный) - фильтр по типу (tour, hotel, restaurant, instructor, transfer)
  • limit (по умолчанию 50) - количество элементов на странице
  • offset (по умолчанию 0) - смещение для пагинации

Примеры использования:

  • /favorites - все избранные элементы
  • /favorites?item_type=hotel - только отели
  • /favorites?item_type=tour&limit=10 - первые 10 туров

Пример ответа проверки статуса:

{
  "is_favorite": true
}

Работа с разными типами контента​

Избранные отели​

{
  "item_type": "hotel",
  "item_id": "550e8400-e29b-41d4-a716-446655440000"
}

Избранные туры​

{
  "item_type": "tour", 
  "item_id": "123"
}

Избранные рестораны​

{
  "item_type": "restaurant",
  "item_id": "restaurant-uuid"
}

Избранные инструкторы​

{
  "item_type": "instructor",
  "item_id": "instructor-uuid"
}

Избранные трансферы​

{
  "item_type": "transfer",
  "item_id": "transfer-uuid"
}

Особенности использования​

  • Каждый пользователь может добавить в избранное любое количество элементов
  • Дублирование не допускается - один элемент может быть добавлен только один раз
  • Список избранного сортируется по дате добавления (новые сначала)
  • Поддерживается пагинация для больших списков избранного
  • Фильтрация по типу позволяет быстро найти нужные элементы

Интеграция с другими функциями​

Избранное интегрируется с другими функциями платформы:

  • Поиск - добавление результатов поиска в избранное
  • Рекомендации - сохранение рекомендованных элементов
  • Бронирования - быстрое бронирование из избранного
  • Отзывы - написание отзывов на избранные элементы

Полная API документация​

Все методы API доступны в Swagger UI. Используйте ссылки выше для быстрого доступа к конкретным операциям.

Советы для туристов
  • Бронируйте заранее для лучших цен
  • Проверяйте политику отмены перед бронированием
  • Сохраняйте подтверждения бронирований
  • Читайте отзывы других туристов
  • Используйте избранное для планирования поездки
  • Фильтруйте избранное по типу для удобства