ВебКНБ (Web Rock Paper Scissors)

🏆 Этот проект был разработан в рамках хакатона DevHack #5 (26 февраля - 2 марта 2025)
Презентация проекта

DevHack #5 - юбилейный хакатон для начинающих IT-специалистов в возрасте от 13 до 18 лет, проходивший в Центре цифрового образования детей «IT-Куб» (Ростов-на-Дону). Мероприятие организовано при поддержке ЮФУ, РГЭУ (РИНХ), РГУПС и Сбербанка.

🛠 Технологии

Python 3.8+
Django 5.1.6
OpenCV
MediaPipe
HTML5
CSS3
JavaScript
Figma - Концепт дизайна

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

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

git clone https://github.com/GigaGitCoder/web_knb.git
cd web_knb

(Опционально) Создайте и активируйте виртуальное окружение:

python -m venv venv
source venv\Scripts\activate # Linux/MacOS
venv\Scripts\activate # Windows

Этот шаг рекомендуется для изоляции зависимостей проекта, но не является обязательным.

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

pip install -r requirements.txt

⚠️ ВАЖНО ДЛЯ ОРГАНИЗАТОРОВ ХАКАТОНА:
Создайте файл .env в папке web_knb со следующим содержимым:

SECRET_KEY = 'django-insecure-a5!l+qxdu4k)keesvrm!5=ro0glbduk3#q5hqmk)3i_@7x7a2w'

Либо:

echo SECRET_KEY = 'django-insecure-a5!l+qxdu4k)keesvrm!5=ro0glbduk3#q5hqmk)3i_@7x7a2w' >> web_knb/.env

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

Примените миграции:

python manage.py migrate

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

python manage.py runserver

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

Откройте браузер и перейдите по адресу http://localhost:8000
Зарегистрируйтесь или войдите в систему
Перейдите в раздел "Игра"
Разрешите доступ к камере
Покажите жест (камень/ножницы/бумага) перед камерой
Наслаждайтесь игрой!

🎮 Функционал

Система аккаунтов

Полноценная система авторизации и аутентификации пользователей с персональными профилями и статистикой.

Регистрация новых пользователей с уникальным логином и email
Безопасное хранение паролей с использованием хеширования
Авторизация существующих пользователей
Персональная статистика игр для каждого пользователя

Игровой процесс

Инновационный способ игры в "Камень-Ножницы-Бумага" с использованием компьютерного зрения для распознавания жестов.

Распознавание жестов через веб-камеру по истечению таймера
Автоматическое определение жеста игрока (камень/ножницы/бумага)
Случайный выбор жеста компьютером
Мгновенное определение победителя
Сохранение результатов в профиле игрока

Таблица лидеров

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

Отслеживание общей статистики всех игроков
Рейтинг по количеству побед
Отображение процента выигрышных партий
Общее количество сыгранных игр

👥 Команда разработчиков

Егор Холкин
_{Тимлид, Full-stack разработчик}

Вклад в проект:
• Backend/Frontend разработка
• Дизайн проекта
• Работа с базами данных
• Распознавание жестов