# Dizionario dei dati e modalità di lettura

Versione 1.0.0. Fonte: ambiente dimostrativo Findmii.

I file JSON sono array di oggetti; i CSV hanno intestazione, separatore virgola, codifica UTF-8 senza BOM e terminatori CRLF. I campi testuali contenenti virgole sono racchiusi tra virgolette. I valori numerici sono interi senza separatori delle migliaia. Non ci sono formule. Una cella vuota in codice_padre corrisponde alla stringa vuota nel JSON, non a un valore sconosciuto.

## OD01 - Classificazione merceologica Findmii

Gerarchia delle categorie effettivamente presenti nell’ambiente dimostrativo, con denominazioni italiane e relazioni padre-figlio.

Righe: 66. File: `01_classificazione_merceologica.csv` e `01_classificazione_merceologica.json`.

| Campo | Tipo JSON | Significato |
|---|---|---|
| codice_categoria | string | Codice tecnico della categoria, CAT_ seguito da 10 cifre esadecimali. Derivato soltanto dall’identificativo della categoria; non riguarda utenti o prodotti. |
| codice_padre | string | Codice della categoria padre. Stringa vuota per le macrocategorie. |
| livello | integer | 1 = macrocategoria; 2 = sottocategoria; 3 = microcategoria. |
| denominazione_it | string | Denominazione italiana presente nella fonte; spazi esterni rimossi. |

## OD02 - Catalogo dimostrativo per macrocategoria

Conteggio dei prodotti registrati nell’ambiente dimostrativo per macrocategoria, inclusi i prodotti nascosti e cancellati logicamente; i riferimenti non risolvibili sono mantenuti nel gruppo Non classificato.

Righe: 3. File: `02_catalogo_dimostrativo.csv` e `02_catalogo_dimostrativo.json`.

| Campo | Tipo JSON | Significato |
|---|---|---|
| codice_macrocategoria | string | Codice collegabile a OD01; NC identifica il gruppo tecnico Non classificato e non è una categoria della tassonomia. |
| macrocategoria | string | Denominazione della macrocategoria oppure Non classificato. |
| numero_prodotti | integer | Numero di documenti prodotto nel gruppo, intero non negativo; non è il numero di offerte pubbliche o di prodotti venduti. |

## OD03 - Profili dimostrativi per macro-ruolo

Conteggio dei profili presenti nell’ambiente dimostrativo per macro-ruolo; le varianti venditore sono accorpate e i ruoli mancanti sono distinti.

Righe: 3. File: `03_profili_dimostrativi.csv` e `03_profili_dimostrativi.json`.

| Campo | Tipo JSON | Significato |
|---|---|---|
| macro_ruolo | string | compratore, venditore o non_specificato. Unità osservata: documento profilo, non persona certificata. |
| numero_profili | integer | Numero di documenti profilo nel gruppo, intero non negativo. |

## Relazioni

OD01.codice_padre fa riferimento a OD01.codice_categoria; i nodi radice hanno padre vuoto. OD02.codice_macrocategoria fa riferimento a un nodo di livello 1 di OD01, tranne NC. OD03 non contiene chiavi collegabili a utenti o agli altri dataset.

I codici CAT_ sono stabili a parità di identificativo categoria sorgente; modificare un identificativo sorgente cambia il codice. Sono rilevate eventuali collisioni. Non si tratta di pseudonimizzazione di soggetti.

## Date

Data e intervallo di estrazione sono riportati in catalogo.json. I dataset sono pubblicati all'indirizzo https://spsistemi.net/findmii-open-data-b/. Nessuna data puntuale di profili o prodotti è presente negli export.