Skip to content

Latest commit

 

History

History
121 lines (83 loc) · 2.64 KB

README.md

File metadata and controls

121 lines (83 loc) · 2.64 KB
Raw

Polling App

This project is a polling application that includes a frontend built with React and a backend developed using Django Rest Framework. The frontend and backend are connected via API and are hosted on separate domains.

Features

  • Create polls with multiple choices in a single API call.
  • Vote for choices in the latest poll.
  • Ensures each device can only vote once per poll by combining IP address and user-agent as a unique identifier.

Installation and Setup

Backend (Django Rest Framework)

  1. Clone the Repository:

    git clone https://github.com/kushal1o1/LivePoll.git
cd polling-app-backend

  2. Create and Activate a Virtual Environment:

    python -m venv venv
source venv/bin/activate  # On Windows use `venv\Scripts\activate`

  3. Install Dependencies:

    pip install -r requirements.txt

  4. Run Database Migrations:

    python manage.py migrate

  5. Create a Superuser:

    python manage.py createsuperuser

  6. Start the Development Server:

    python manage.py runserver

  7. Access the Admin Panel at http://127.0.0.1:8000/admin.

Frontend (React)

  1. Clone the Repository:

    git clone https://github.com/kushal1o1/LivePoll.git
cd polling-app-frontend

  2. Install Dependencies:

    npm install

  3. Start the Development Server:

    npm start

  4. Access the Frontend at http://localhost:3000.

API Endpoints

Create Poll with Choices

  • URL: /polls/
  • Method: POST
  • Body: 
    {
    "question": "What's your favorite color?",
    "choices": [
        {"choice_text": "Red"},
        {"choice_text": "Blue"},
        {"choice_text": "Green"}
    ]
}

Vote

  • URL: /polls/{poll_id}/vote/
  • Method: POST
  • Body: 
    {
    "choice_id": 1
}

Frontend and Backend Integration

  • Frontend (React): Communicates with the Django backend using AJAX requests to the API endpoints.
  • Backend (Django Rest Framework): Provides the API endpoints for creating polls, managing choices, and recording votes.

Deployment

Ensure that the frontend is configured to point to the backend API endpoint for proper functionality.

License

This project is licensed under the MIT License - see the LICENSE file for details.