🛍️ ElShop - Интернет-магазин женской одежды

📋 Описание

ElShop - дипломная работа студента Ошского государственного университета (ОшГУ/ОшМуу). Полнофункциональный интернет-магазин женской одежды, построенный на Django и Python с использованием Firebase Firestore в качестве базы данных.

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

• 🛒 Каталог товаров с расширенной фильтрацией
• 🔍 Система поиска товаров
• 🌐 Двуязычный интерфейс (Русский / Кыргызский)
• 👨‍💼 Админ-панель для управления товарами
• 🎨 Современный адаптивный дизайн
• ☁️ Интеграция с Firebase Firestore
• 🎭 Анимированный фон и 3D логотип
• 📱 Мобильная адаптивность

🛠️ Технологический стек

Backend

• Python 3.11+ - язык программирования
• Django 4.2.7 - веб-фреймворк
• Firebase Firestore - облачная база данных
• Django Admin - административная панель

Frontend

• HTML5 / CSS3 - разметка и стилизация
• JavaScript - интерактивность
• Three.js - 3D графика для логотипа
• Адаптивный дизайн - для всех устройств

Дизайн

• 🎨 Современный UI/UX дизайн
• 🌈 Анимированный градиентный фон
• 💫 Плавные анимации и переходы
• 📐 Адаптивная верстка (Mobile First)

📁 Структура проекта

ElamanShop/
├── elshop/              # Основные настройки Django
│   ├── settings.py      # Конфигурация проекта
│   ├── urls.py          # URL маршрутизация
│   └── wsgi.py          # WSGI конфигурация
├── shop/                # Приложение магазина
│   ├── models.py        # Модели данных
│   ├── views.py         # Представления (views)
│   ├── admin.py         # Настройка админ-панели
│   └── urls.py          # URL маршруты приложения
├── templates/           # HTML шаблоны Django
│   ├── base.html        # Базовый шаблон
│   └── shop/            # Шаблоны магазина
├── static/              # Статические файлы
│   ├── css/             # Стили CSS
│   └── js/              # JavaScript файлы
├── locale/              # Файлы переводов (i18n)
├── manage.py            # Django management скрипт
└── requirements.txt     # Python зависимости

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

Требования

• Python 3.11 или выше
• pip (менеджер пакетов Python)
• Git

Шаги установки

1. Клонируйте репозиторий:

git clone https://github.com/Koloda55SA/ElShop.git
cd ElShop

2. Создайте виртуальное окружение:

python -m venv venv
source venv/bin/activate  # На Windows: venv\Scripts\activate

3. Установите зависимости:

pip install -r requirements.txt

4. Настройте Firebase:

   • Создайте проект в Firebase Console
   • Скачайте Service Account ключ (JSON файл)
   • Сохраните файл в корне проекта

5. Настройте переменные окружения:

   Создайте файл .env в корне проекта:

SECRET_KEY=your-secret-key-here
DEBUG=True
FIREBASE_PROJECT_ID=elamanshop
FIREBASE_CREDENTIALS=path/to/firebase-key.json

6. Примените миграции базы данных:

python manage.py migrate

7. Создайте суперпользователя:

python manage.py create_admin

Логин: Эламан123
Пароль: Elshop321

8. Запустите сервер разработки:

python manage.py runserver

9. Откройте в браузере:
   • Главная страница: http://127.0.0.1:8000/
   • Админ-панель: http://127.0.0.1:8000/admin/

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

Для пользователей

• ✅ Просмотр каталога товаров
• ✅ Поиск товаров по названию
• ✅ Фильтрация по категориям, цене, размеру, цвету
• ✅ Детальная информация о товаре
• ✅ Переключение языка интерфейса (RU/KY)
• ✅ Адаптивный дизайн для мобильных устройств

Для администраторов

• ✅ Управление категориями товаров
• ✅ Добавление/редактирование/удаление товаров
• ✅ Загрузка изображений товаров
• ✅ Управление ценами и наличием
• ✅ Автоматическая синхронизация с Firebase

🎨 Дизайн

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

• Цветовая схема: Розово-фиолетовая палитра с акцентами
• Типографика: Современные шрифты (Segoe UI)
• Анимации: Плавные переходы и градиентные эффекты
• Адаптивность: Полная поддержка мобильных устройств
• UX: Интуитивно понятный интерфейс

Особенности дизайна

• 🌈 Анимированный градиентный фон
• 💎 3D анимированный логотип (Three.js)
• 🎯 Карточки товаров с эффектом hover
• 📱 Адаптивная навигация
• 🎨 Современные формы и кнопки

🔥 Firebase интеграция

Проект использует Firebase Firestore для хранения данных:

• Коллекция products - информация о товарах
• Коллекция categories - категории товаров

Все данные автоматически синхронизируются между Django и Firebase через Django signals.

Project ID: elamanshop

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

• Руководство по установке
• Настройка Firebase
• Инструкции по деплою
• Деплой на GitHub

👤 Автор

Студент Ошского государственного университета (ОшГУ/ОшМуу)

📄 Лицензия

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

🙏 Благодарности

• Django Framework за отличный веб-фреймворк
• Firebase за облачную инфраструктуру
• Three.js за библиотеку 3D графики
• Сообщество разработчиков за поддержку

📞 Контакты

• Email: info@elshop.kg
• GitHub: Koloda55SA
• Репозиторий: https://github.com/Koloda55SA/ElShop.git

---

Все права защищены © 2025 ElShop

Дипломная работа студента ОшГУ (ОшМуу)