👨‍💻 Dynamic-Student-Assessment-Server Codaisseur 👩‍💻

This server has been developed for the Dynamic-Student-Assessment test applied by Codaisseur to candidates wishing to join the academy.

Project Overview:

The Dynamic-Student-Assessment is a project for Codaisseur. The aim is to improve the measurement of the level of knowledge of Javascript of future students prior to the bootcamp. By making the test adaptive, it provides a more accurate analysis of a students’ current level of Javascript. By adaptive we mean that the test is dynamic. The questions change, based on the answering behaviour of the student. The final results of the test will provide more precise and personal recommendations for preparing for the academy and consequently increase the graduation rate.

Related repos

Test Client: https://github.com/Official-Codaisseur-Graduate/Dynamic-Student-Assessment-Test-Client

That focuses on the applicant UI and contains the login page and admissions test.

Admin Client: https://github.com/Official-Codaisseur-Graduate/Dynamic-Student-Assessment-Admin-Client

Portal for the Codaisseur admissions team to manage applicants, scores and tests.

Server: https://github.com/Official-Codaisseur-Graduate/Dynamic-Student-Assessment-Server

Which contains the end points and database models. (you are here!)

For more information about the endpoints and routers. Check our API docs `apidocs.js` in the ./docs folder.

SET UP PROJECT:

Clone this repo

git clone https://github.com/Official-Codaisseur-Graduate/Dynamic-Student-Assessment-Server

In your terminal, run the following command to install all the dependencies

npm install

To start the terminal with nodemon, use the following command (assumes nodemon is installed globally)

nodemon index

To start the code without tracking saved changes, you can simply run:

node index

As a standard we are using port 4000 for this server.

TESTING:

To add some dummy data to your database, you can use our database import existent in the index.js.

As the password is bcrypted in the database, You can use email: middletonhicks@assistix.com and password: Brainclip for logging in on the Admin-Client.

If you are currently running nodemon with the command, mentioned above, nodemon index, the dummy data will be automatically added to your database, otherwise, you can simply run node index in your terminal.

IMPORTANT: ❗ In order not to execute any testings in the database, make sure to comment out the bulk creation in index.js, from line 22 up to line 792. Make sure that you have have set:

.sync({force: false})

In lines 22 in index.js and in line 12 of db.js.

Score:

The main score calculation is based on the correct answers divided by all the questions given. The category score is the same, but then per category.

Important note! ❗

When a student answers a question, the following happens in the backend:

A put request to /userAnswer/:id/:answerId is made (currently in the req.body we expect an answerId which we can use in the backend). The reason why we don’t do a post request, is because in the scenario where a student wants to go back to change their answer, we don’t want to make another post request. So the strategy is to always make a request to update a UserAnswer.
In the case of the first question of the test, obviously there is no UserAnswer yet to update. The logic behind the solution for this problem is that in this case we create an empty UserAnswer inside of the put endpoint. In this way we can later update the column ‘correct’ of that newly created UserAnswer to TRUE or FALSE.
After this, a GET request is made to a new question. It looks at the previousAnswer, which we just provided. It runs through the algorithm and returns a new question.

Adaptive-Question-Algorithm

Currently the algorithm takes a UserAnswer, checks if its related Answer is correct. If it is, the newLevel will be raised by 1. If not, it will output the initialLevel. The algorithm is currently only being used in the GET endpoint that responds with a new question (so the new question is based on the previous UserAnswer).