🏠 LINK - Система управления недвижимостью

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

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

Для покупателей:

• 📋 Просмотр каталога недвижимости
• 🔍 Поиск и фильтрация объектов
• 🗺️ Интерактивная карта с объектами
• 🏠 3D туры по квартирам
• 📊 Аналитика просмотров
• 💳 Бронирование и покупка недвижимости
• 👤 Личный кабинет с бронированиями

Для застройщиков:

• 🏢 Управление жилыми комплексами
• 🏠 Добавление и редактирование квартир
• 📊 Детальная аналитика продаж
• 👥 Управление бронированиями
• 📈 Статистика по объектам
• 🎯 Отслеживание конверсии

🛠️ Технологии

Backend:

• FastAPI - современный веб-фреймворк
• SQLAlchemy - ORM для работы с базой данных
• PostgreSQL - основная база данных
• Pydantic - валидация данных
• Uvicorn - ASGI сервер

Frontend:

• Vue.js 3 - прогрессивный JavaScript фреймворк
• Vite - быстрый сборщик
• Axios - HTTP клиент
• CSS3 - современные стили

📦 Установка и запуск

Предварительные требования:

• Python 3.11+
• Node.js 18+
• PostgreSQL 12+
• Git

1. Клонирование репозитория:

git clone https://github.com/IvanZhutyaev/json-state-home.git
cd json-state-home

2. Настройка Backend:

# Переходим в папку backend
cd backend

# Создаем виртуальное окружение
python -m venv .venv

# Активируем виртуальное окружение
# Windows:
.venv\Scripts\activate
# Linux/Mac:
source .venv/bin/activate

# Устанавливаем зависимости
pip install -r ../requirements.txt

# Настраиваем базу данных
python final_fix.py

# Запускаем сервер
uvicorn main:app --reload

3. Настройка Frontend:

# Переходим в папку frontend
cd frontend

# Устанавливаем зависимости
npm install

# Запускаем сервер разработки
npm run dev

4. Настройка базы данных:

Создайте базу данных PostgreSQL и обновите настройки подключения в backend/Database/DB_connection.py:

DATABASE_URL = "postgresql://username:password@localhost:5432/database_name"

🔧 Исправленные проблемы

✅ Критические исправления:

• Ошибка с ценой: Исправлен тип поля price с Integer на BigInteger для поддержки больших значений
• Проблемы с бронированием: Исправлены связи между моделями и валидация данных
• Аналитика: Добавлена полная система отслеживания событий
• Связи ЖК: Исправлена связь между застройщиками, ЖК и квартирами

📁 Новые файлы:

• backend/Cruds/Analytics_crud.py - CRUD для аналитики
• backend/Routers/Analytics_router.py - роуты аналитики
• backend/Schemas/Analytics_schema.py - схемы аналитики
• backend/final_fix.py - скрипт исправления базы данных
• frontend/src/components/AnalyticsDashboard.vue - дашборд аналитики

📊 API Endpoints

Основные эндпоинты:

• GET /properties/ - список недвижимости
• POST /properties/ - создание недвижимости
• GET /zastroys/ - список застройщиков
• POST /api/track-event - отслеживание событий
• GET /api/analytics/summary - сводка аналитики

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

• Swagger UI: http://localhost:8000/docs
• ReDoc: http://localhost:8000/redoc

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

Аналитика:

• 📈 Отслеживание просмотров квартир
• 🕒 Время проведенное на странице
• 🎯 Конверсия (просмотр → бронирование)
• 📊 Статистика по застройщикам
• 🔍 Аналитика поиска и фильтров

Управление недвижимостью:

• 🏢 Создание и управление ЖК
• 🏠 Добавление квартир в ЖК
• 💰 Управление ценами
• 📸 Загрузка изображений
• 📍 Геолокация объектов

Бронирование:

• 📅 Система бронирования
• 💳 Процесс покупки
• 📧 Уведомления
• 📊 Статистика продаж

🤝 Вклад в проект

1. Форкните репозиторий
2. Создайте ветку для новой функции (git checkout -b feature/amazing-feature)
3. Зафиксируйте изменения (git commit -m 'Add amazing feature')
4. Отправьте в ветку (git push origin feature/amazing-feature)
5. Откройте Pull Request

📝 Лицензия

Этот проект лицензирован под MIT License - см. файл LICENSE для деталей.

📞 Поддержка

Если у вас есть вопросы или проблемы:

• Создайте Issue в GitHub
• Опишите проблему подробно
• Приложите логи ошибок

🚀 Развертывание

Production:

# Backend
pip install gunicorn
gunicorn main:app -w 4 -k uvicorn.workers.UvicornWorker

# Frontend
npm run build

---

DIMA - современная система управления недвижимостью для застройщиков и покупателей! 🏠✨