Cluster - AI-powered Travel Platform

Интерактивная платформа для планирования путешествий с AI-персонализацией, 3D турами и B2B решениями для бизнеса.

🌟 Ключевые фичи

• 🎯 Вау-эффект: Интерактивные 3D туры по достопримечательностям (AVALIN)
• 🤖 AI персонализация: Умные рекомендации на основе предпочтений
• 💼 B2B ценность: Кабинет партнёра для управления местами и спецпредложениями
• 🗺️ Умные маршруты: Сезонные рекомендации и оптимизация путешествий
• 🔍 Семантический поиск: Поиск мест на естественном языке

🚀 Быстрый старт

Требования

• Docker Desktop (Windows/Mac) или Docker + Docker Compose (Linux)
• Свободные порты: 5432, 8000, 5173

Windows (рекомендовано)

.\setup_db.ps1

Linux/macOS

./server_app/scripts/setup_all.sh

🌐 Доступные сервисы

После запуска:

• Frontend: http://localhost:5173
• Backend API: http://localhost:8000
• API Документация: http://localhost:8000/docs
• PostgreSQL: localhost:5432

🏗️ Архитектура

Cluster/
├── client_app/          # Vue 3 + TypeScript фронтенд
├── server_app/          # FastAPI бэкенд
├── docker-compose.yml   # Docker конфигурация
└── scripts/            # Скрипты настройки

Frontend (client_app)

• Vue 3 с Composition API и <script setup>
• TypeScript для типизации
• Vite для быстрой сборки
• Leaflet для интерактивных карт
• AVALIN Viewer для 3D туров

Backend (server_app)

• FastAPI с автоматической документацией
• PostgreSQL с SQLAlchemy ORM
• Alembic для миграций
• Локальный TF-IDF для семантического поиска мест (встроенный, бесплатный)
• DeepSeek Chat API для будущих фич (опционально)
• OpenAI/другие embeddings как альтернатива (опционально)
• JWT аутентификация для партнёров

📊 Демо-данные

Проект включает 18 демо-мест с:

• ✅ 3D туры AVALIN
• ✅ Спецпредложения от бизнеса
• ✅ AI эмбеддинги для семантического поиска
• ✅ Фотографии и описания
• ✅ Геолокации и цены

🔧 Разработка

Запуск в режиме разработки

# Бэкенд
cd server_app
uvicorn main:app --reload --host 0.0.0.0 --port 8000

# Фронтенд
cd client_app
npm run dev

Структура API

• GET /places - Получение всех мест
• GET /places/{id} - Детальная информация о месте
• POST /places/search - Семантический поиск
• POST /route/generate - Генерация маршрута
• POST /partner/auth/* - Авторизация партнёров
• GET /partner/places - Места партнёра

База данных

Параметр	Значение
Host	localhost
Port	5432
Database	clusterdb
User	cluster_user
Password	password

Строка подключения: postgresql://cluster_user:password@localhost:5432/clusterdb

🎯 Для хакатона

Ключевые преимущества

1. Вау-эффект: 3D туры создают впечатляющий пользовательский опыт
2. B2B модель: Партнёры могут добавлять места и спецпредложения
3. AI инновации: Персонализация на основе эмбеддингов
4. Масштабируемость: Легко добавлять новые места и функции

Демонстрация жюри

1. Запустите проект через .\setup_db.ps1
2. Откройте http://localhost:5173
3. Попробуйте 3D туры (кнопки "3D тур" на карточках мест)
4. Сгенерируйте персональный маршрут
5. Зайдите в кабинет партнёра для B2B демонстрации

📝 Лицензия

Проект разработан для хакатона. MIT License.

🤝 Контрибьюторы

• Команда разработки Cluster Hackathon