PollTracker

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

Основные функции

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

Расширенные возможности

• Проведение конкурсов типа "Брейн-ринг" по Wi-Fi, позволяет участникам использовать планшеты для ответа на вопросы в реальном времени.
• API для интеграции с внешними устройствами, предоставляет конкурсную информацию в формате JSON для динамичного отображения.

Подходит для

• Телевизионных и школьных талант-шоу
• Спортивных мероприятий и турниров
• Конференций и научных конкурсов
• Корпоративных состязаний и тимбилдингов

Алгоритм работы с приложением

1. Запуск админ панели:
   • Создание участников, судей и структуры конкурса.
2. Регистрация конкурса:
   • Запуск команды создания оценок со значением по умолчанию.
3. Пользовательский интерфейс судьи:
   • Судьи получают ссылку на страницу голосования.
   • Выполняют голосование на каждом этапе, выбирая оценки из выпадающего списка по критериям для каждого участника.
   • Переходят к следующему этапу, когда голосование текущего этапа окончено.
4. Отображение результатов:
   • В конце конкурса, результаты голосования отображаются на странице в порядке убывания.

Пользовательские роли

• Судья (judge): Может работать с интерфейсом приложения и влиять на результаты голосования путем выставления оценок участникам конкурса.
• Участник (contestant): Не взаимодействует с интерфейсом приложения на прямую. Использует интерфейс планшета в этапах "Брейн-ринг".
• Администратор (admin): Обладает полными правами на управление всем контентом проекта. Может создавать и удалять конкурсы, регистрировать участников и назначать роли пользователям.

Основные url приложения

• reg/ - главная страница приложения
• admin/ - админка приложения
• brainring/ - страница для планшетов
• api/ - API приложения

Стек технологий

• Python 3.7
• Django 3.2
• REST API
• HTML, CSS
• JavaScript
• PostgreSQL
• Nginx
• gunicorn

Запуск проекта

1. Требования перед установкой:

   • Установите Python 3.7 на вашей системе.
   • Установите Django 3.2, используя следующую команду:

   pip install Django==3.2

   • Установите PostgreSQL и настройте его.

2. Установка и запуск серверной части:

   • Склонируйте репозиторий проекта.
   • Перейдите в папку проекта.
   • Установите все зависимости, выполнив следующую команду:

   pip install -r requirements.txt

   • Создайте базу данных PostgreSQL и настройте файл settings.py, указав параметры подключения к вашей базе данных.
   • Выполните миграции, используя команды:

   python manage.py makemigrations

   python manage.py migrate

   • Запустите серверную часть, выполнив следующую команду:

   python manage.py runserver

3. Откройте веб-браузер и перейдите по адресу http://localhost:8000, чтобы начать работу с приложением.

Лицензия

Данный проект распространяется под лицензией MIT. См. файл LICENSE для дополнительной информации.