Django Voting Web Application

Overview

This is a simple Django-based web application that allows users to vote on various categories. Users can view available categories, vote for their favorite items in each category, and see the voting results in real-time.

Features

• User-friendly interface for voting on categories.
• Real-time updates of voting results.
• Secure user authentication and authorization.
• SQLite database for data storage.
• Responsive design for mobile and desktop.

Getting Started

Prerequisites

• Python (3.6 or higher)
• Django (3.0 or higher)

Installation

1. Clone this repository to your local machine.

   git clone https://github.com/your-username/voting-app.git

2. Navigate to the project directory.

   cd voting-app

3. Create a virtual environment (optional but recommended).

   python -m venv venv
   source venv/bin/activate

4. Install project dependencies.

   pip install -r requirements.txt

5. Apply database migrations.

   python manage.py migrate

6. Create a superuser account to access the Django admin panel.

   python manage.py createsuperuser

7. Start the development server.

   python manage.py runserver

8. Open your web browser and access the application at http://127.0.0.1:8000.

Usage

1. Browse the available categories on the homepage.
2. Click on a category to view its items and vote for your favorite.
3. Check real-time voting results on the results page.
4. Use the Django admin panel to manage categories and items.

Screenshots

1. Signup Page: New user Create a new Account.

   

2. Signin Page: Existing user login here.

   

3. Category Page: Browse categories and select one to vote.

4. Vote Page: Vote for your preferred category.

5. Result Page: View the voting results.

Contributing

Contributions are welcome! If you'd like to contribute to this project, please follow these guidelines:

1. Fork the repository.
2. Create a new branch for your feature: git checkout -b feature-name
3. Make your changes and commit them: git commit -m 'Add feature'
4. Push to the branch: git push origin feature-name
5. Create a pull request with a clear description of your changes.

License

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

Acknowledgments

• Thanks to the Django community for their excellent documentation and resources.