timadey / cbt

A user-friendly Computer-Based Test (CBT) application designed specifically for academic institutions to seamlessly conduct exams in a digital format.

Computer Based Test (CBT) Application

The application is live and accessible at: cbtim.onrender.com 🎉 Check USAGE.md on how to use the system

Table of Contents

• About
• Getting Started
• Deployment
• Usage

About

CBT is a user-friendly Computer-Based Test (CBT) application designed specifically for academic institutions to seamlessly conduct exams in a digital format. This application streamlines the process of exam administration, empowering educators to create, manage, and assess examinations efficiently.

Key Feature

• Exam Creation: Teachers can effortlessly create exams with detailed subject configurations.
• Subject Management: Easy association of subjects with question papers for better organization.
• Student Enrollment: Facilitates student profiles and eligibility settings for exam participation.
• Token Generation: Generates unique tokens for eligible students to take their exams securely.
• Automated Result Generation: Automatically generates exam results upon completion.

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

Prerequisites

What things you need to install the software and how to install them.

• Python (>=3.6)
• Pip
• Virtualenv (venv)
• Docker
• MySQL
• Node.js and npm

Installing

A step by step series of examples that tell you how to get a development env running.

1. Clone the repository

git clone https://github.com/timadey/cbt.git
cd cbt

2. Create and activate virtual environment. See deployment on how to use docker.

python3 -m venv myenv
source myenv/bin/activate

3. Install dependencies

pip install -r requirements.txt
cd app/static
npm install
cd ../..

4. Set up environment variable Import cbt.sql at the root directory into your mysql database to easily setup the db with prefilled demo data.

cp .env.example .env

Then edit .env with your database credentials

5. Start the application

flask run

6. Access the application on your local browser http://localhost:5000

 * Serving Flask app 'cbt.py'
 * Debug mode: on
WARNING: This is a development server. Do not use it in a production deployment. Use a production WSGI server instead.
 * Running on all addresses (0.0.0.0)
 * Running on http://127.0.0.1:5000
Press CTRL+C to quit
 * Restarting with stat
 * Debugger is active!

Deployment

The application is live and accessible at: cbtim.onrender.com 🎉 Check USAGE.md on how to use the system

It is advisable to use Docker for deployment. The Dockerfile is availabe at the root dir. Ensure to replace /etc/secrets/.env with your original path to .env. To deploy this app to a live server, run the following commands on your server

cd cbt/
docker build -t cbt .
docker run -p 5000:5000 cbt

Usage

Check USAGE.md on how to use the system

Contributions

Contributions are welcome! If you want to contribute to this project, please fork the repository, make your changes, and submit a pull request.

Author

• Timadey
  • LinkedIn