feat: add business demography by size class NUTS3 (BD_SIZE_R3) (#37)

[matteocavo]

Type

• New dataset (adds a Eurostat dataflow to the registry)

Problem

Issue #37 — BD_SIZE_R3 (Business demography by size class and NUTS 3 region) era in lista planned ma non implementato.

Solution

• Aggiunto datasets/eurostat-business-demography-nuts3/ con dataset.yml, sql/clean.sql, sql/mart.sql
• 5 dimensioni: freq, indic_sb, sizeclas, nace_r2, geo
• Aggiunta update_sizeclas() in scripts/update_codelists.py e generato codelists/sizeclas.csv (32 codici via API ESTAT/SIZECLAS)
• clean.sql: LEFT JOIN su sizeclas.csv → colonna sizeclas_label_en; tutte le altre dims già coperte da codelist esistenti
• mart.sql: Italy NUTS3, tutte le label, ORDER BY su tutte le dimensioni rilevanti
• Valori sizeclas presenti in Italia NUTS3: 0, 1-9, GE10, TOTAL — tutti nel codelist
• Copertura temporale: 2008–2020 (fine serie storica per questo dataflow)
• Aggiornato docs/dataset-registry.md: riga Published + BD_SIZE_R3 in Planned

Test plan

• pytest tests/ -v passes (20/20)
• ruff check connectors/ tests/ scripts/ passes
• toolkit run full --config datasets/eurostat-business-demography-nuts3/dataset.yml --years 2020 passes (toolkit non installabile localmente su Python 3.14 — da verificare in CI)

Downstream impact

• None — internal refactor only

Closes

Closes #37

Checklist

• ruff check connectors/ tests/ passes
• docs/dataset-registry.md updated if adding a dataset
• docs/contributing.md template still accurate

[matteocavo]

Review/fix pass fatto dopo merge di DEMO_R_FIND3 su main.

Ho sistemato tre punti:

• risolto il conflitto con origin/main mantenendo sia eurostat-fertility-nuts3 sia eurostat-business-demography-nuts3 nel registry;
• aggiunti freq e freq_label_en nel mart.sql, in linea con le ultime PR Eurostat;
• ricontrollato il conteggio reale del mart Italy NUTS3: 120,955 righe, quindi ho aggiornato docs/dataset-registry.md.

Verifica locale fatta su BD_SIZE_R3:

• raw rows: 1,693,965
• mart rows: 120,955
• anni mart: 2008-2020
• freq: A / Annual
• label nulle su freq, indic_sb, sizeclas, nace_r2, geo: 0

Ora aspetterei solo i check GitHub della PR prima di merge/review finale.

[Gabrymi93]

Matteo ha già fixato freq e risolto i conflitti autonomamente. PR solida:

• sizeclas codelist via SDMX API ✅
• 5 dimensioni, tutti i JOIN ✅
• freq nel mart ✅
• 120.955 righe mart, 0 null label ✅

Verdetto: merge 🎉