Skip to content

The repository contains code for an Exam Scheduling Application that interacts with Africa's Talking USSD & SMS APIs to allow for seamless Exam Registration For College Students. The project utilizes Django framework for both front(Uses html templates, Bootstrap and CSS) and Back-end.

Notifications You must be signed in to change notification settings

john-thuo1/exam-schedular-system

Repository files navigation

Exam Scheduling System

Application Dashboard

The exam-schedular-system repository contains the code for an Exam Scheduling Application that seamlessly integrates with Africa's Talking SMS APIs. This application facilitates exam registration for college students. The project is built using the Django framework, utilizing HTML templates, Bootstrap, and CSS for the frontend, and Python for the backend.

Admin Dashboard

To manage courses, exams, students, teachers, and parents, the admin can log into the website and access the respective tabs within the dashboard.

Running Africa's Talking Simulator

Follow the steps below to run the Africa's Talking simulator:

  1. Create an account at Africa's Talking - africa's talking!.
  2. Navigate to the Africa's Talking sandbox and click 'Go To Sandbox App'.
  3. Launch the simulator and enter the phone number of the student.
  4. Repeat the same process to have two running simulators, and add the parent's phone number in the second simulator.
  5. Proceed to register a student for an exam. You should receive a text message about the registration on the simulators.

Quick Guide

Follow the steps below to set up and run the web app:

  1. Clone the repository:

    git clone https://github.com/john-thuo1/exam-schedular-system
  2. Change into the project directory:

    cd exam-schedular-system
  3. Create a virtual environment:

    python3 -m venv venv
  4. Activate the virtual environment:

    • Windows:
      venv\Scripts\activate
  5. Install the required dependencies:

    pip install -r requirements.txt
  6. Create the database:

    python manage.py makemigrations
  7. Apply database changes:

    python manage.py migrate
  8. Configure Africa's Talking SMS API and Africa's Talking API: Please refer to this link for detailed instructions: Integrating Africa's Talking APIs into the Hospital Management System

  9. Run the server:

    python manage.py runserver <port_number>

    For example:

    python manage.py runserver 3000
  10. Access the site on your localhost: Follow the instructions provided on the home page to start using the site.

About

The repository contains code for an Exam Scheduling Application that interacts with Africa's Talking USSD & SMS APIs to allow for seamless Exam Registration For College Students. The project utilizes Django framework for both front(Uses html templates, Bootstrap and CSS) and Back-end.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published