Attualmente, nel database, sono presenti dei vincoli di integrità solo per le tabelle dipartimento ed cds. Sarebbe opportuno aggiungerli anche ad insegnamento e schede_opis in modo da evitare record duplicati.

dipartimento

In the table dipartimento are missing different columns, a workaround to restore them is using the following SQL query, but I suggest to update the migrations/seeder of laravel scripts.

ALTER TABLE `dipartimento` ADD `tot_cds`          INT(11)          NOT NULL;
ALTER TABLE `dipartimento` ADD `tot_moduli`       INT(11)          NOT NULL;           -- tot. insegn/ moduli
ALTER TABLE `dipartimento` ADD `tot_valutati`     INT(11)          NOT NULL;           -- insegnamenti valutati almeno da 1 studente (scheda1 o scheda3)
ALTER TABLE `dipartimento` ADD `report`           INT(11)          DEFAULT NULL;       -- insegnamenti valutati almeno da 5 studenti (scheda1 o scheda3)
ALTER TABLE `dipartimento` ADD `tot_schedeF`      INT(11)          NOT NULL;           -- valutazioni degli studenti frequentanti
ALTER TABLE `dipartimento` ADD `tot_schedeNF`     INT(11)          NOT NULL;           -- valutazioni degli studenti non-frequentanti

corso_di_studi

ALTER TABLE `corso_di_studi` ADD `tot_moduli`        INT(11)         NOT NULL;       -- tot. insegn/ moduli
ALTER TABLE `corso_di_studi` ADD `tot_valutati`      INT(11)         NOT NULL;       -- insegnamenti valutati almeno da 1 studente (scheda1 o scheda3)
ALTER TABLE `corso_di_studi` ADD `report`            INT(11)         DEFAULT NULL;   -- insegnamenti valutati almeno da 5 studenti (scheda1 o scheda3)
ALTER TABLE `corso_di_studi` ADD `tot_schedeF`       INT(11)         NOT NULL;       -- valutazioni degli studenti frequentanti
ALTER TABLE `corso_di_studi` ADD `tot_schedeNF`      INT(11)         NOT NULL;       -- valutazioni degli studenti non-frequentanti

insegnamento

ALTER TABLE `insegnamento` ADD `tot_schedeF`  INT(11);
ALTER TABLE `insegnamento` ADD `tot_schedeNF` INT(11);

I am currently working on the scraper for the new opis website and I just found out that the cds IDs are now alpha-numerical.
Currently the id field is an integer, hence it should maybe be changed to a string(?).

Here are some references to the problem:

2019/2020

2018/2019

1. Dare la possibilità ad un utente amministratore di modificare i pesi delle singole domande. Bisogna quindi salvare i pesi delle domande sul database.
   1.1. Non è richiesto dalla commissione ma potrebbe essere utile dare la possibilità di modificare anche i pesi delle risposte
   1.2. Impedire di avere gruppi di pesi di domande a somma maggiore di 1
2. Dare la possibilità ad un utente amministratore di modificare il valore di scostamento, uno per la numerosità di schede e uno per la media della valutazione. Bisogna quindi salvare questa coppia sul database.
   2.1. Se non ho capito male questa coppia non è globale ma bisogna salvarne una per ogni CDS

1. Dato un CDS in input, dare in output tutte le schede opis di tutti gli insegnamenti del CDS di tutti gli anni accademici
2. Dato un insegnamento in input, dare in output tutte le schede opis di tutti gli anni accademici di quell'insegnamento

If at a certain academic year a teaching forks (e.g. the teaching was split into two channel A-L / M-Z), the schede before that academic year aren't provided by the insegnamento/with-id/<id>/schedeopis API.

Need a shortcut to TRUNCATE all tables removing all samples data.

This will be used to run the scraper.

For now, we can't use TRUNCATE table because several tables are strictly linked by foreign_keys to other table, a workaround for this is:

DELETE FROM `corso_di_studi`;
DELETE FROM `dipartimento`;
DELETE FROM `insegnamento`;
DELETE FROM `schede_opis`;

If you want to truncate also the tables related to authentication/users:

DELETE FROM `password_resets`;
DELETE FROM `users`;

Refactorare campi schede_opis:

• domande
• domande_nf
• motivo_nf
• sugg
• sugg_nf

Questi campi sono di tipo JSON, andrebbero migliorati e strutturati decentemente.
Attualmente domande e' un array di dimensione 11*4. ogni domanda e' rappresentata da valori a gruppi di 4.

Write a documentation about API for future use