feat: aggiunta analisi v0 e dataset consolidato 2020-2024

[Lore222]

🚩Capacità Rinnovabile Terna (2020-2024)

🛠 Analisi Tecnica

• Fonte: Dataset ufficiale Terna (Capacità installata per fonte e territorio).
• Elaborazione: Pipeline toolkit (Raw -> Clean -> Mart) con consolidamento storico 2020-2024 via Notebook Python (Parquet).
• Granularità: Provinciale e Regionale.
• Metriche: Potenza lorda (MW) e crescita percentuale (Δ%).

📈 Insight Principali (The "Story")

• Top Performer: Il Lazio guida la crescita nazionale con un +91.3%, seguito da Liguria e Friuli-Venezia Giulia.
• Cluster di Ritardo: La Valle d'Aosta (+2.3%) e la Calabria (+14.5%) mostrano i tassi più bassi.
• Analisi Provinciale: Le "maglie nere" sono Aosta, Sondrio e Verbano-Cusio-Ossola (stallo post-idroelettrico).
• Mix Energetico: Dominio del Fotovoltaico per diffusione, Eolico molto polarizzato.

📦 Output Prodotti

• Dataset : terna_capacita_rinnovabile_provinciale_2020_2024.csv
• Notebook di analisi: analisi.ipynb
• Visualizzazioni incluse nel notebook.

Closes #44

[Gabrymi93]

Grazie, il filone e' interessante e il consolidato 2020-2024 e' utile come primo passo.

Pero' in dataset-incubator ci serve un candidate riproducibile, non solo un notebook con export finale. In questa PR vedo:

• il notebook di analisi
• il CSV consolidato finale

Manca ancora il contratto tecnico minimo del candidate, cioe' almeno:

• dataset.yml
• sorgente dichiarata
• passaggi chiari per ottenere il dato consolidato in modo ripetibile nel repo

Cosi' com'e', il risultato si capisce, ma non e' ancora facile da rigenerare o mantenere da altri.

Se vuoi, la direzione giusta per portarla a merge e':

1. aggiungere il dataset.yml
2. chiarire input e trasformazione che portano al consolidato 2020-2024
3. lasciare il notebook come analisi di supporto, non come unico punto di produzione del dataset

Se ti e' utile, possiamo anche aiutarti a riportarla nel formato standard dei candidate DI.

[Lore222]

Ciao @Gabrymi93, ho aggiornato il candidate per renderlo pienamente riproducibile:

Ho aggiunto il dataset.yml completo di sources e logica mart.

Ho incluso sql/mart.sql che definisce l'unione dei dati 2020-2024.

Il notebook rimane come documentazione dell'analisi esplorativa.

Nota: Il check validate-effective-root fallisce perché il toolkit cerca i file nella cartella /out/, ma essendo un candidate la struttura è corretta come confermato dal check validate-candidate-structure (verde).
Spero che ora sia tutto pronto per il merge!"

[Gabrymi93]

Per sbloccare il filone senza aggiungere altro rumore su questa PR ho ricostruito il candidate su un branch pulito, seguendo il flusso intake standard:

• branch: intake/terna-capacita-rinnovabile
• commit: 39dd87e

Dentro c'e il candidate minimale e coerente per 2023-2024, con:

• dataset.yml
• clean.sql
• mart.sql
• README.md
• notes.md
• notebook v0

Il run reale passa su entrambi gli anni e il notebook v0 gira sul mart 2024.

Se per te va bene, possiamo usarlo come base per chiudere il lavoro in uno di questi due modi:

• lo porti tu nel tuo branch / nella PR attuale
• oppure ce lo dici e apriamo noi una PR pulita da questo branch

Così evitiamo di continuare a rincorrere fix incrementali su un ramo che nel frattempo si era un po' complicato.

[Lore222]

Seguire il flusso intake standard sul nuovo branch mi sembra la soluzione migliore per evitare altro rumore.
Per me va benissimo se procedete voi ad aprire la PR pulita da intake/terna-capacita-rinnovabile.
Userò quel branch come riferimento per studiare la struttura corretta (specialmente il clean.sql e il notebook v0) così da allinearmi subito per i prossimi contributi.
Grazie ancora per la pazienza!"

[Gabrymi93]

Grazie, allora procediamo cosi'.

Abbiamo aperto la PR pulita dal branch intake/terna-capacita-rinnovabile, seguendo il flusso intake standard:

• intake: aggiungi candidate terna-capacita-rinnovabile #100

La usiamo come riferimento tecnico principale per chiudere bene il filone e per avere un candidate coerente con la struttura DI.

La tua PR resta comunque utile come passaggio che ha portato a chiarire il contratto corretto del candidate.