# Mappa di migrazione fra due versioni del metodo.
#
# Serve a una cosa che il changelog da solo non puo' fare: dire se una colonna
# sparita e una comparsa sono la stessa domanda. Senza, un campo diviso in due
# sembra un campo cancellato piu' un campo nuovo, e le ricodifiche che ci stanno
# dentro spariscono fra le righe di schema.
#
# Non e' una tabella di conversione. Dove c'e' "ricodifica_dalla_fonte: si",
# nessun valore vecchio determina il valore nuovo: la distinzione non era
# ricavabile dal dato, solo dal documento, ed e' stata ricavata da li'.

da: "1.0"
a: "2.0"
data: 2026-09-23
motivo: >-
  La stesura del codebook ha mostrato che quattro categorie non erano definibili
  senza dire due cose insieme. Un vocabolario che non si riesce a definire e' un
  vocabolario che classifica male.

campi:

  # ---------------------------------------------------------------- invariati
  - campo: id
    tipo: unchanged
  - campo: nome
    tipo: unchanged
  - campo: regione
    tipo: unchanged
  - campo: citta
    tipo: unchanged
  - campo: tipo
    tipo: unchanged
  - campo: stato
    tipo: unchanged
  - campo: data_adozione
    tipo: unchanged
  - campo: ultima_verifica
    tipo: unchanged
  - campo: documento_titolo
    tipo: unchanged
  - campo: documento_url
    tipo: unchanged
  - campo: documento_livello
    tipo: unchanged
  - campo: documenti_tutti_titoli
    tipo: unchanged
  - campo: documenti_tutti_url
    tipo: unchanged
  - campo: autodichiarazione_ai
    tipo: unchanged
  - campo: dati_riservati_divieto
    tipo: unchanged
  - campo: eccezioni_dsa
    tipo: unchanged
  - campo: esami_uso_consentito
    tipo: unchanged
  - campo: strumenti_forniti
    tipo: unchanged
  - campo: tesi_dichiarazione_obbligatoria
    tipo: unchanged
    nota: >-
      Le categorie «raccomandata» e «facoltativa» sono state discusse e tenute
      distinte: nessun valore si e' mosso.
  - campo: tesi_uso_consentito
    tipo: unchanged
    nota: >-
      Discusse e tenute: «vietato_se_il_docente_tace», che vale per un ateneo
      solo, e la lettura dei divieti circoscritti alla stesura, che restano «no»
      perche' il documento sugli altri usi tace e il silenzio non e' un permesso.

  # -------------------------------------------------------------- scomposizioni
  - campo: formazione_offerta
    tipo: split
    destinazione: [formazione_stato, formazione_destinatari]
    # «formazione_destinatari» non e' meta' della vecchia domanda: e' una
    # domanda che prima non si faceva. Quello che ci compare e' informazione
    # nuova, non una riclassificazione.
    destinazione_nuova: [formazione_destinatari]
    descrizione: >-
      Il campo aveva due valori, «si» e «non_specificato», e quel «si» teneva
      insieme l'ateneo che si impegna a promuovere iniziative e l'ateneo che dice
      in che cosa la formazione consiste. Ora «formazione_stato» distingue le
      due cose e «formazione_destinatari» registra a chi il documento si rivolge,
      che prima non si poteva dire.
    ricodifica_dalla_fonte: si
    reversibile: no
    perche_non_reversibile: >-
      Da «impegno_generico» e «offerta_determinata» si torna a «si», ma da «si»
      non si torna indietro: l'informazione che distingue i due non stava nel
      dato.
    valori_origine: [si, non_specificato]
    valori_destinazione:
      formazione_stato: [impegno_generico, offerta_determinata, non_specificato]
      formazione_destinatari: [studenti, docenti, ricercatori, personale, tutta_la_comunita]
    record_coinvolti: 26

  - campo: valutazione_automatica
    tipo: split
    destinazione: [valutazione_didattica, valutazione_scientifica]
    descrizione: >-
      Un campo solo chiedeva se una macchina possa valutare un esame e se possa
      valutare un articolo scientifico. Sono due domande, con due destinatari
      diversi, e un documento puo' rispondere a una e tacere sull'altra.
    ricodifica_dalla_fonte: si
    reversibile: no
    perche_non_reversibile: >-
      Il valore «vietata_nella_revisione_scientifica» del vecchio schema non ha
      un corrispondente unico: diceva insieme quale valutazione e con che forza.
    valori_origine: [vietata, vietata_nella_revisione_scientifica, solo_con_verifica_umana,
                     ammessa_solo_con_sistemi_autorizzati, non_specificato]
    valori_destinazione:
      valutazione_didattica: [vietata, solo_con_verifica_umana,
                              ammessa_solo_con_sistemi_autorizzati, non_specificato]
      valutazione_scientifica: [vietata, sconsigliata, solo_con_verifica_umana, non_specificato]
    record_coinvolti: 15
    nota: >-
      La rilettura ha trovato due record sbagliati gia' secondo il metodo 1.0:
      vedi «errori» in fondo a questo file.

  - campo: rilevatori_ai
    tipo: split
    destinazione: [rilevatori_disponibilita, rilevatori_valore_probatorio]
    descrizione: >-
      Chi mette a disposizione il rilevatore e che valore ha il suo esito erano
      la stessa casella, e un ateneo puo' affermare le due cose insieme: Camerino
      fornisce lo strumento e nello stesso documento scrive che sbaglia spesso.
      Con un campo solo, quel caso era inesprimibile.
    ricodifica_dalla_fonte: si
    reversibile: no
    perche_non_reversibile: >-
      Un ateneo che ora ha due valori, nel vecchio schema ne aveva uno: tornando
      indietro si dovrebbe scegliere quale buttare.
    valori_origine: [sconsigliati_come_prova_esclusiva, ammessi_con_verifica_umana,
                     ateneo_mette_a_disposizione_rilevatore, verifica_con_software_prevista,
                     non_specificato]
    valori_destinazione:
      rilevatori_disponibilita: [forniti_dall_ateneo, verifica_prevista_senza_strumento,
                                 non_specificato]
      rilevatori_valore_probatorio: [inaffidabili_non_prova, ammessi_con_verifica_umana,
                                     non_specificato]
    record_coinvolti: 12

  # ---------------------------------------------- vocabolario esteso o chiuso
  - campo: ricerca_autorialita
    tipo: unchanged
    vocabolario: esteso
    valori_aggiunti: [responsabilita_umana_sui_contenuti]
    descrizione: >-
      Il campo resta lo stesso; il vocabolario acquista la categoria che
      mancava. Undici schede stavano in «altro»: rilette, sette dicono che la
      responsabilita' dei contenuti resta della persona, ed era la regola piu'
      diffusa del campo senza un nome. Le altre quattro restano «altro» perche'
      dicono cose davvero diverse.
    ricodifica_dalla_fonte: si
    reversibile: si
    perche_reversibile: >-
      «responsabilita_umana_sui_contenuti» ricade in «altro» senza perdite: e'
      una specializzazione, non una ridefinizione.
    record_coinvolti: 7

  - campo: dichiarazione_contenuto
    tipo: unchanged
    vocabolario: chiuso
    descrizione: >-
      Vocabolario chiuso e normalizzato: «strumento» e «strumenti_utilizzati»
      convivevano come se fossero due cose, e «attivita_svolte» diceva quello che
      «modalita_impiego» dice gia'.
    ricodifica_dalla_fonte: no
    perche_no: >-
      Non nasce nessuna distinzione nuova: si toglie un doppione. La conversione
      e' deterministica ed e' stata fatta come tale.
    equivalenze:
      strumento: strumenti_utilizzati
      attivita_svolte: modalita_impiego
    reversibile: no
    perche_non_reversibile: >-
      Fuse due etichette in una, non si sa piu' quale delle due usava la scheda.
    record_coinvolti: 3

  # ----------------------------------------------------------------- aggiunto
  - campo: sanzioni_tipologia
    tipo: added
    origine: sanzioni_previste
    descrizione: >-
      «sanzioni_previste» dice che qualcosa succede; questo dice che cosa. Il
      campo di partenza resta identico e nessuno dei suoi valori si e' mosso.
    ricodifica_dalla_fonte: si
    reversibile: non_applicabile
    valori_destinazione:
      sanzioni_tipologia: [annullamento_prova, esclusione_esame, ripetizione_prova,
                           penalizzazione_voto, sospensione, procedimento_disciplinare,
                           segnalazione_agli_organi, rilievo_penale, rinvio_ad_altre_norme]
    record_coinvolti: 26

  - campo: sanzioni_previste
    tipo: unchanged
    nota: Resta com'era; il dettaglio sta nel campo nuovo «sanzioni_tipologia».

  # ------------------------------------------------------------------ tolto
  - campo: ambito_dichiarato
    tipo: removed
    descrizione: >-
      Usato da una scheda sola, la IULM, e in gran parte sovrapposto a
      «policy.ambito», che esiste per tutti. L'informazione non si perde:
      «valutazione», che mancava, e' entrata nell'ambito della policy, e
      l'osservazione sul proctoring e sul plagiarism detection e' rimasta nella
      scheda come nota.
    trasferito_a: [policy.ambito, nota di scheda]
    ricodifica_dalla_fonte: no
    reversibile: si
    perche_reversibile: >-
      Il contenuto e' ancora nella scheda: si potrebbe ricostruire il campo.
    record_coinvolti: 1

# Due record non erano classificati male secondo il metodo nuovo: erano
# classificati male e basta, gia' secondo il metodo 1.0. La migrazione li ha
# fatti emergere ma non li ha causati, e nel changelog non devono somigliare a
# una riclassificazione.
errori:
  - ateneo: univda
    campo_1_0: valutazione_automatica
    valore_1_0: solo_con_verifica_umana
    campo_2_0: null
    valore_2_0: null
    cosa: >-
      La frase su cui poggiava il valore parla di decisioni amministrative, non
      di esami ne' di revisione scientifica. Riletto il documento, non contiene
      nulla sulla valutazione automatica degli studenti: il campo e' stato tolto.
    invisibile_ai_controlli: >-
      La citazione corrisponde alla fonte parola per parola. Nessuna verifica
      automatica si accorge che risponde a un'altra domanda.

  - ateneo: uniroma1
    campo_1_0: valutazione_automatica
    valore_1_0: vietata_nella_revisione_scientifica
    campo_2_0: valutazione_scientifica
    valore_2_0: sconsigliata
    cosa: >-
      Il documento scrive che i ricercatori «dovrebbero astenersi»: e' una
      raccomandazione, e il valore la dava per divieto.
    invisibile_ai_controlli: >-
      Come sopra: la citazione e' esatta, la lettura no.
