M4 · Dati di base (pacchetto IT 2026.2) #45

Closed
opened 2026-11-10 22:29:44 +01:00 by Alby96 · 4 comments
Owner

M4 — Tabelle, anagrafiche, articoli · Specifica: docs/SPEC.md §14 · Wiki: Dati-di-base-e-esempio

Passi

  • ISeeder, SeedRunner, SeedContext, versione del pacchetto dati in company_settings (seed.base.version)
  • Dati di base di §14 disponibili a questa milestone: paesi, valute, UM, codici IVA con nature, MP01–MP23, condizioni di pagamento, causali di magazzino, depositi, trasporti, categorie, numeratori, regime RF01, tipi documento, ruoli
  • Province, comuni (CAP, codice catastale) e ABI/CAB: in attesa del via dell'utente al download dei dataset
  • Verificare origine e licenza dei dataset (comuni, ABI/CAB) e annotarla in ADR 0026 (la regola di caricamento è già nell'ADR)
  • scripts/seed.sh --base e KHAEMHAT_SEED_BASE
  • Idempotenza: Aggiorna tabelle di base rieseguibile (aggiunge solo i codici mancanti)

Valgono sempre CLAUDE.md (emendamenti E1–E6), i vincoli di SPEC §1, le regole di codice di §19 e la Definition of Done di §20: stessa unità di lavoro per codice, test, wiki, docs/*.md e CHANGELOG.md.

**M4 — Tabelle, anagrafiche, articoli** · Specifica: `docs/SPEC.md` §14 · Wiki: [Dati-di-base-e-esempio](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/wiki/Dati-di-base-e-esempio) ### Passi - [x] `ISeeder`, `SeedRunner`, `SeedContext`, versione del pacchetto dati in `company_settings` (`seed.base.version`) - [x] Dati di base di §14 disponibili a questa milestone: paesi, valute, UM, codici IVA con nature, MP01–MP23, condizioni di pagamento, causali di magazzino, depositi, trasporti, categorie, numeratori, regime RF01, tipi documento, ruoli - [ ] Province, comuni (CAP, codice catastale) e ABI/CAB: in attesa del via dell'utente al download dei dataset - [ ] Verificare origine e licenza dei dataset (comuni, ABI/CAB) e annotarla in ADR 0026 (la regola di caricamento è già nell'ADR) - [x] `scripts/seed.sh --base` e `KHAEMHAT_SEED_BASE` - [x] Idempotenza: *Aggiorna tabelle di base* rieseguibile (aggiunge solo i codici mancanti) --- Valgono sempre `CLAUDE.md` (emendamenti E1–E6), i vincoli di SPEC §1, le regole di codice di §19 e la Definition of Done di §20: stessa unità di lavoro per codice, test, wiki, `docs/*.md` e `CHANGELOG.md`.
Alby96 added this to the M4 — Tabelle, anagrafiche, articoli · v0.4.0 milestone 2026-11-10 22:29:44 +01:00
Alby96 added the Area/DatiKind/Feature
Priority
Critical
Modulo/CORE
labels 2026-11-10 22:29:44 +01:00
Alby96 added this to the Khaemhat 1.0 — Sviluppo project 2026-11-10 22:29:49 +01:00
Alby96 moved this to Da fare in Khaemhat 1.0 — Sviluppo on 2026-11-11 21:02:10 +01:00
Alby96 added the
Status
In attesa utente
label 2026-11-11 23:15:54 +01:00
Author
Owner

Fatto in feat/37-tabelle-anagrafiche (commit 34e1964 e 9bcf8c1): seeder, versione dei dati, scripts/seed.sh --base [--company CODICE] anche nell'immagine, ADR 0026 (si aggiungono solo i codici mancanti).

Serve il via dell'utente per scaricare i dataset pubblici, da includere come file di dati con origine e licenza:

  • province e comuni con codice catastale: elenco ISTAT dei codici dei comuni (CSV, licenza CC BY 4.0);
  • CAP dei comuni: un elenco con licenza libera (ad esempio comuni-json, MIT), perché ISTAT non pubblica i CAP;
  • banche ABI/CAB: fonte con licenza da verificare (Banca d'Italia non pubblica un file aperto completo degli sportelli).

Fino ad allora le tabelle Province e Comuni si riempiono con l'import CSV. Il resto della milestone non è bloccato.

Fatto in `feat/37-tabelle-anagrafiche` (commit 34e1964 e 9bcf8c1): seeder, versione dei dati, `scripts/seed.sh --base [--company CODICE]` anche nell'immagine, ADR 0026 (si aggiungono solo i codici mancanti). **Serve il via dell'utente** per scaricare i dataset pubblici, da includere come file di dati con origine e licenza: - province e comuni con codice catastale: elenco ISTAT dei codici dei comuni (CSV, licenza CC BY 4.0); - CAP dei comuni: un elenco con licenza libera (ad esempio `comuni-json`, MIT), perché ISTAT non pubblica i CAP; - banche ABI/CAB: fonte con licenza da verificare (Banca d'Italia non pubblica un file aperto completo degli sportelli). Fino ad allora le tabelle *Province* e *Comuni* si riempiono con l'import CSV. Il resto della milestone non è bloccato.
Alby96 moved this to In corso in Khaemhat 1.0 — Sviluppo on 2026-11-11 23:16:02 +01:00
Author
Owner

Province e comuni sono nei dati di base (321aae7, ADR 0028, versione dati IT 2026.3): elenco ISTAT dei codici dei comuni al 26/02/2026 (xlsx; il CSV allo stesso indirizzo è fermo al 2024 e non ha il riordino delle province sarde), licenza CC BY 4.0. Sono 110 province e 7.894 comuni, con codice catastale, provincia, regione e codice ISTAT.

Restano fuori:

  • CAP: comuni-json non ha licenza per i CAP (lo dichiara l'autore in LICENSE.md) ed è fermo al 2020, quindi non entra nel repository. Candidato con licenza compatibile: GeoNames, codici postali per l'Italia (IT.zip, circa 250 KB, CC BY 4.0). Serve il via dell'utente al download.
  • Banche ABI/CAB: manca ancora una fonte aperta con licenza chiara.

L'etichetta In attesa utente resta per questi due punti.

Province e comuni sono nei dati di base (321aae7, ADR 0028, versione dati `IT 2026.3`): elenco ISTAT dei codici dei comuni al 26/02/2026 (xlsx; il CSV allo stesso indirizzo è fermo al 2024 e non ha il riordino delle province sarde), licenza CC BY 4.0. Sono 110 province e 7.894 comuni, con codice catastale, provincia, regione e codice ISTAT. Restano fuori: - **CAP**: comuni-json non ha licenza per i CAP (lo dichiara l'autore in LICENSE.md) ed è fermo al 2020, quindi non entra nel repository. Candidato con licenza compatibile: GeoNames, codici postali per l'Italia (`IT.zip`, circa 250 KB, CC BY 4.0). Serve il via dell'utente al download. - **Banche ABI/CAB**: manca ancora una fonte aperta con licenza chiara. L'etichetta *In attesa utente* resta per questi due punti.
Author
Owner

I CAP sono arrivati con a9eda51 (ADR 0028 aggiornato). La fonte è l'elenco dei codici postali italiani di GeoNames (IT.zip, CC BY 4.0).

  • Hanno il CAP 7.750 comuni su 7.894: un CAP, una lista o intervalli come 10121-10156.
  • Ai 144 restanti manca. Sono in gran parte comuni rinominati o nati da fusioni (per esempio Sanremo, che GeoNames chiama San Remo), e si completano a mano o con l'Importa CSV.
  • tools/Khaemhat.PlacesTool rigenera i due elenchi dal foglio ISTAT e da IT.zip.

Resta in attesa solo l'elenco delle banche ABI/CAB, per cui manca ancora una fonte aperta con licenza chiara.

I CAP sono arrivati con a9eda51 (ADR 0028 aggiornato). La fonte è l'elenco dei codici postali italiani di GeoNames (`IT.zip`, CC BY 4.0). - Hanno il CAP **7.750 comuni su 7.894**: un CAP, una lista o intervalli come `10121-10156`. - Ai 144 restanti manca. Sono in gran parte comuni rinominati o nati da fusioni (per esempio Sanremo, che GeoNames chiama *San Remo*), e si completano a mano o con l'Importa CSV. - `tools/Khaemhat.PlacesTool` rigenera i due elenchi dal foglio ISTAT e da `IT.zip`. Resta in attesa solo l'elenco delle **banche ABI/CAB**, per cui manca ancora una fonte aperta con licenza chiara.
Alby96 modified the milestone from M4 — Tabelle, anagrafiche, articoli · v0.4.0 to M13 — Consolidamento e rilascio · v0.13.0 2026-11-15 12:07:50 +01:00
Author
Owner

Decisione del titolare del 2026-11-16 (ADR 0044, PR #130): l'elenco delle banche ABI/CAB non sarà precaricato. Dall'IBAN si leggono sempre ABI e CAB. Nome della banca e BIC vengono da un conto dell'azienda presso la stessa banca, oppure si scrivono a mano. Se il titolare troverà una fonte con una licenza che permette di ridistribuirla, si aprirà una nuova issue per aggiungerla ai dati di base. L'issue si chiude con il merge della PR.

Decisione del titolare del 2026-11-16 (ADR 0044, PR #130): l'elenco delle banche ABI/CAB non sarà precaricato. Dall'IBAN si leggono sempre ABI e CAB. Nome della banca e BIC vengono da un conto dell'azienda presso la stessa banca, oppure si scrivono a mano. Se il titolare troverà una fonte con una licenza che permette di ridistribuirla, si aprirà una nuova issue per aggiungerla ai dati di base. L'issue si chiude con il merge della PR.
Alby96 removed the
Status
In attesa utente
label 2026-11-16 17:19:55 +01:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: BalboSoft/Khaemhat#45