lordkevinmo/online_exercises

The aims of this project are to offer a way to make exam in a more practical way. This system is mainly for mathematical problems because the results can be automatically computed.

Description

The aim of this project is to offer a solution for teachers and student to have safer exercises online. The solution we are offering is for mathematical exercises (or exercises where the answer can be computed). For a same exercise all the student will get different input value, and the right answer will be automatically computed in the background, then compare to the user result, everything is then automatic and safe.

Installation

Instruction

This project is using Docker-Compose it allows us to run multi-container Docker application. In this repository the backend, frontend and the database will run in different containers.

First install docker installed on your machine: see instruction

After install docker-compose: see instruction

Then simply clone this repository, build and run it.

git clone https://github.com/axel0070/online_exercises
docker-compose up --build

In our case the FrontEnd is calling the server on the address localhost:8080 if you are using a VPS or something where the address of the server is not this one, you need to edit the file ./ui/.env and replace localhost:8080 by the server address.

Database

Default

In the docker-compose file, we are creating a container for a mongodb. Therefore there are no need to setup any external database. During the first start, the database will be created.

Manual

If you want to setup your own database for the backend, first you need to edit the docker-compose file and remove the mongo service and the dependency on it. Then you will need to edit the file located in ./api/src/connection.js and change the connection URL.

Features

You can see all of the feature and coming functionality in the FEATURES file.

License

Online Exercise is GNU AGPLv3 licensed.