Install

Python

apt install python3

Flask / SQLAlchemy

pip3 install Flask Flask-SQLAlchemy SQLAlchemy

numpy

pip3 install numpy

Run

python3 controller.py

Test

create database model: python3 controller.py
(kill python3 controller.py / CTLR+C)
preload activity / category / quiz schema data: python3 src/preload_quiz.py
load quiz answers example (category 0 only: data/test.sh)

curl -X POST localhost:5000/users -H 'Content-Type: application/json' -d '{"username": "andrea", "email": "andrea"}'
curl -X POST localhost:5000/users -H 'Content-Type: application/json' -d '{"username": "elias", "email": "elias"}'
curl -X POST localhost:5000/quiz/1 -H 'Content-Type: application/json' -d @risposte_andrea.json
curl -X POST localhost:5000/quiz/2 -H 'Content-Type: application/json' -d @risposte_elias.json
curl localhost:5000/distance

API

List users

Lists all users.

GET /users

List user

Lists single user specified by "id".

GET /users/<id>

Create user

Create new user with payload json data.

POST /users

Example json:
{ "username": "andrea", "email": "andrea"}

List activities

GET /activity

List categories

GET /category

List Quiz schema

GET /quiz

Create User Quiz

Create a new quiz answer for user specified by "id" with payload json data.

POST /quiz/<user_id>

Example json:
[ { "question": "Sono in grado di chiudere gli occhi e raffigurarmi oggetti, luoghi o avvenimenti", "risposta": "4", "id": "0" }, { "question": "Leggo più facilmente cartine, tabelle e diagrammi piuttosto che indicazioni scritte", "risposta": "4", "id": "1" } ]

Get nearest user

Return the top x "top" users nearest to the user specified by "id".

GET /distance/<user_id>/<top>

TODO

Testare nuovo preload

Feature

TODO2: Finire di inserire domande per le altre categorie

E poi inserire dati quiz vero per almeno 10 utenti e testare se le distanze per activity funzionano

Normalizzare distanze categoria

API per recuperare max e min answer value, in modo da poter validare le risposte (sia frontend che be)

Elenco di abitudini con immagini

Codice

Caso in cui si aggiungono soltanto 1+ risposte NUOVE?

Fare in modo che calcolo distanza per nuovo quiz parta solo quando ha finito di inserire il nuovo quiz

Spostare i calcoli in file a parte (non nel service)

Errori

TODO1: Se user compila solo parte del quiz, quando calcola le distanze cerca comunque tutte le categorie. Fare in modo che i calcoli distanza per categoria e distanza globale usino solo le categorie compilate

Cosi come succede per il calcolo distanze categoria, se un utente aggiorna quiz viene AGGIORNATA la distanza, va implementato anche per activityDistance: cioe se le distanze cambiano, deve poter aggiornare activityDistance se esiste gia, invece di "sovrascrivere" (cosa che non succederebbe perche' ci sarebbe primary key violation)

IcedGarion / just-match