Exam-Portal

A complete Exam Portal System built using Django and Bootstrap

Explore the docs »
View Website · Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
   • Local
   • Deployment
4. TO-DO
5. Contributing
6. Acknowledgements

About The Project

A complete Exam Portal System built using Django and Bootstrap. Currently, the portal has login system(with authentication) for admin(the top level supervisor), professors and students with their respective homepage; MCQ questions, question papers, student groups and exams can be created/edited by professors; students can appear for exams allotted to them within the time constraints set by the professor and then view their marks and solutions after completing the exam.

Built With

Frameworks used to build the project:

• Django
• Bootstrap

Getting Started

To setup the project locally, follow the given steps:

Prerequisites

Following software needs to be setup in the system

• git
• python
• pip
• virtual environment
• github-cli (optional)

Installation

1. Clone the repo by

   git clone https://github.com/SubhradeepSS/Exam-Portal.git

   or (if github-cli is installed)

   gh repo clone SubhradeepSS/Exam-Portal

2. Open the project in any source code editor.
3. Activate python virtual environment.
4. Inside the virtual environment, run

   pip install -r requirements.txt

Usage

Local

For running the project, navigate to the project directory and follow the following instructions:

• Type the following in the command line(inside the virtual environment):

  python manage.py makemigrations
  python manage.py migrate
  python manage.py createsuperuser
  # this will ask for username, email(optional) and password. Enter some credentials to be used later for django admin functionality.
  python manage.py runserver

• Log on to django admin site using the superuser credentials

  • Click on Groups section and create 2 groups - Professor and Student
  • Click on Users section and create some users, and also make each user belong to one of the groups- Professor/Student as per role
  • Logout of the admin site and go to http://127.0.0.1:8000/ where the home page of the project will be rendered.

• Now any student/professor can login using their own credentials.

Deployment

View deployed site here.

Credentials:

User Type	Username	Password
admin	admin	admin
student	student_1	password_student_1
prof	prof_1	password_prof_1

The admin can create more users(professors/students) from the django admin panel and can add them to corresponding groups, after which they can login through the site.

TO-DO

Following features/enhancements are thought to be added later:

• frontend
• backend

Contributing

Any contributions made to the project are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Acknowledgements

• Best-README-template