Skip to content

README.md

Latest commit

 

History

History
94 lines (68 loc) · 4.21 KB

README.md

File metadata and controls

94 lines (68 loc) · 4.21 KB
Raw

File Dati

Questa cartella contiene i file dati che alimentano il sito https://ondata.github.io/referendum_iniziative_popolari/.

File Principali

source.json e source.jsonl

  • Fonte: API Ministero della Giustizia
  • Contenuto: elenco completo di tutte le iniziative in raccolta firme e chiuse
  • Formato:
    • source.json - JSON standard (uno per riga, struttura nidificata)
    • source.jsonl - JSON Lines (una riga = un'iniziativa, più efficiente)
  • Aggiornamento: 6 volte al giorno via GitHub Actions
  • Uso: base dati per pagina home, tabella, ricerca e filtri
  • Anagrafica: l'unico file che contiene i titoli e i metadati completi di ogni iniziativa

Struttura dati principali:

Campo Tipo Esempio
id numero 5400034
titolo stringa "Raccolta di almeno 500.000 firme per il referendum..."
descrizioneBreve stringa "La legge costituzionale oggetto della richiesta..."
sostenitori numero 220494
quorum numero 500000
dataApertura stringa (YYYY-MM-DD) 2025-12-22
idDecCatIniziativa.nome stringa DIRITTO
idDecStatoIniziativa.nome stringa IN RACCOLTA FIRME

Nota: oltre ai campi elencati, il file contiene molti altri dati disponibili come date di inizio/fine validità, descrizione completa, quesito, e metadati dell'oggetto categoria e dello stato. Consultare un record completo del file per l'elenco esaustivo di tutti i campi disponibili.

time_line.jsonl

È un file separato che contiene i dati storici giornalieri delle firme raccolte per ogni iniziativa:

  • Contenuto: timeline storica delle iniziative con data e numero di sostenitori nel tempo
  • Formato: JSON Lines (una riga per data/iniziativa)
  • Uso: grafici e statistiche nella pagina Numeri, timeline dei sostenitori nelle pagine di dettaglio
  • Disponibilità dati: dal 6 luglio 2025 in poi
  • Nota: contiene solo ID e dati numerici. Per ottenere titoli e metadati, fare un join con source.jsonl sull'id
  • Dati storici: include sia iniziative attive che chiuse. Rimane traccia degli ID vecchi (chiusi) che hanno avuto dati storici durante la raccolta firme

Struttura dati:

Campo Tipo Esempio
id numero 500022
data stringa (YYYY-MM-DD) 2025-07-06
sostenitori numero 11792

Link alle Iniziative

Per accedere alla pagina di dettaglio di un'iniziativa dato un ID, il permalink è:

https://ondata.github.io/referendum_iniziative_popolari/initiative/{id}/

Esempio: L'iniziativa con ID 4100009 è disponibile a:

https://ondata.github.io/referendum_iniziative_popolari/initiative/4100009/

Cartella quesiti/

  • Contenuto: testi ufficiali dei quesiti referendari (uno per iniziativa)
  • Formato: file Markdown individualmente nominati per ID iniziativa
  • Esempio: 4100009.md contiene il quesito dell'iniziativa con ID 4100009
  • Uso: visualizzati nelle pagine di dettaglio delle iniziative

Licenza e Attribuzione

Questi dati sono forniti con licenza CC-BY 4.0. I dati grezzi provengono dal Ministero della Giustizia italiano, mentre i file elaborati (come time_line.jsonl) sono processati da questo repository.

Per utilizzare questi dati, è necessario citare sia la fonte originale che questo progetto nel seguente formato:

Dati sui referendum e iniziative popolari italiane forniti dal Ministero della Giustizia
Fonte originale: https://firmereferendum.giustizia.it/ (CC-BY 4.0)
Elaborazione: https://ondata.github.io/referendum_iniziative_popolari
Licenza: CC-BY 4.0

Oppure in forma più compatta:

© Ministero della Giustizia & onData (CC-BY 4.0)
Fonte: https://firmereferendum.giustizia.it/ | Progetto: https://ondata.github.io/referendum_iniziative_popolari

Nota per file elaborati: Se utilizzi file come time_line.jsonl che contengono dati processati e aggregati, è particolarmente importante citare sia il Ministero (fonte originale) che questo progetto (elaborazione).

Questa attribuzione deve essere inclusa in qualsiasi progetto, analisi o pubblicazione che utilizzi questi dati.