Каталог строительных материалов

Веб-приложение для строительного магазина "СтройМаг" с каталогом товаров, системой промокодов и мини-игрой "Собери стену из кирпичей".

Описание

Приложение создано для удобного просмотра и заказа строительных материалов через веб-интерфейс. Оно включает четыре основные страницы: главная, каталог, карточка товара и корзина. Навигация реализована через верхнее меню и интерактивные элементы.

• Главная страница: Показывает общую информацию о магазине, включая краткое описание, ссылки на каталог и корзину. Здесь пользователь может быстро перейти к нужному разделу.
• Каталог: Позволяет просматривать товары с фильтрацией по категориям, таким как лакокрасочные материалы, обои, плитка, клеи, полы и строительные смеси.
• Карточка товара: Содержит подробное описание продукта, его характеристики (например, размеры, материал, цена), изображение и кнопку для добавления в корзину.
• Корзина: Отображает выбранные товары, позволяет редактировать заказ или оформить покупку. Также здесь доступна мини-игра "Собери стену из кирпичей", где пользователи могут получить промокоды для скидок.

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

Участники

Проект разработан студентами Самарского национального исследовательского университета группы 6303-020302D:

• Красюк Артём Максимович ([email protected]) - ArtyomKrasyuk
• Сгибнев Владимир Сергеевич ([email protected]) - Zeredan
• Алексашин Алексей Сергеевич ([email protected]) - xHlpNw
• Архипова Дарья Андреевна ([email protected]) - DariaA-a
• Петрова Ульяна Алексеевна ([email protected]) - ulyananana8

Технологии

• Frontend: HTML, CSS
• Backend: Java (Spring Boot), Python
• Дизайн: Figma
• База данных: PostgreSQL

Установка

Инструкция для Linux, так как проект разрабатывался на этой ОС. Для других систем команды могут отличаться.

1. Убедитесь, что установлены Docker и Python 3.
2. Клонируйте репозиторий:

   git clone https://github.com/algorithm-ssau/catalog-of-building-materials.git
   cd catalog-of-building-materials

3. Перейдите в директорию backend:

   cd backend

4. Соберите Docker-образ:

   sudo docker build -t catalog .

5. Запустите контейнеры:

   sudo docker compose up -d

6. Перейдите в директорию python-api:

   cd ../python-api

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

   python3 -m venv venv

8. Активируйте окружение:

   source venv/bin/activate

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

   pip install -r requirements.txt

10. Перейдите в директорию app:

    cd app

11. Запустите FastAPI сервер:

    uvicorn main:app --host 0.0.0.0 --port 8000

12. Вернитесь в корневую директорию и откройте frontend:

    cd ../../frontend

13. Откройте файл zaglav.html в браузере — это главная страница сайта.

Использование

1. После выполнения шагов установки сервер (FastAPI) должен быть доступен по адресу http://localhost:8000.
2. Откройте frontend/zaglav.html в браузере для доступа к интерфейсу.
3. Переходите по страницам:
   • Главная: обзор магазина, ссылки на каталог и корзину.
   • Каталог: фильтры по категориям товаров.
   • Карточка товара: описание, характеристики, добавление в корзину.
   • Корзина: оформление заказа, доступ к мини-игре.
4. Для мини-игры: в корзине нажмите "Собери стену" и получите промокод.

Лицензия

Этот проект создан в рамках учебного проекта. Распространяется свободно.

Хостинг

Сайт размещен по адресу http://5.35.83.89:80

Контакты

• GitHub: algorithm-ssau
• Email: [email protected]