netgescon-day0/docs/000-FILAMENT/02-ARCHIVI-E-IMPORT.md

Archivi legacy e import (GESCON)

Archivi da prendere

1) Stabili.mdb

Percorso tipico:

• /mnt/gescon-archives/gescon/dbc/Stabili.mdb

Contiene:

• Anagrafica stabili
• Dati bancari/postali
• Dati catasto
• Scadenze rate ordinarie/riscaldamento
• Parametri FE e PEC

2) Fornitori.mdb

Percorso tipico:

• /mnt/gescon-archives/gescon/dbc/Fornitori.mdb

Contiene:

• Anagrafica fornitori

3) singolo_anno.mdb

Percorso tipico:

• /mnt/gescon-archives/gescon/<cod_stabile>//singolo_anno.mdb

Contiene:

• Unità immobiliari + nominativi (condomin)
• Comproprietari
• Tabelle millesimali (legacy: tabelle)
• Voci spesa
• Dett_tab
• Incassi
• Operazioni
• Straordinarie
• Preventivi straordinari (tabella prevent_straordinari)
• dett_pers (addebiti personalizzati, I05)
• Frazionamenti (fraz_gen / fraz_dett, Z01/Z02)

4) generale_stabile.mdb

Percorso tipico:

• /mnt/gescon-archives/gescon/<cod_stabile>/generale_stabile.mdb

Contiene:

• anni
• emes_gen / emes_det
• Fatture legacy
• Dati trasversali

Regola fondamentale anni

Nel legacy i dati sono replicati per ogni anno. Per ricostruire correttamente:

• Importare tutte le annualità per ogni stabile.
• Consolidare in staging con campi legacy_year/legacy_period/legacy_file.

Staging DB (anti-duplicazione)

• DB: gescon_import
• È la sorgente primaria per evitare doppie importazioni.
• Tabelle aggiunte: tabelle_millesimali, dett_pers, fraz_gen, fraz_dett, mdb_fornitori
• Tabelle straordinarie: straordinarie, prevent_straordinari

Componenti di import (codice)

UI Filament

• app/Filament/Pages/Gescon/ImportazioneArchivi.php
  • Modalità Linux: path diretto
  • Modalità Windows: upload file/zip + estrazione

Comandi staging

• gescon:load-mdb
• import:gescon-mdb
• import:gescon-fornitori
• import:gescon-fatture-legacy

Import movimenti banca (Intesa XLSX)

• Parser XLSX con descrizione estesa (colonna F)
• Salva descrizione_estesa + match_data + flag da_confermare
• Duplicati gestiti con row_hash

Import banca per istituto (regole)

Intesa (XLSX)

• Layout rilevato: A Data, B Valuta, C Descrizione, D Avere, E Dare, F Descrizione estesa
• Import in Casse/Banche → Movimenti

Intesa (CSV)

• Supporto CSV con parser dedicato

Unicredit (WRI)

• Import con parser WRI

Spese bancarie (parole chiave iniziali)

• commissione / commissioni
• spese tenuta conto / canone
• imposta di bollo
• competenze
• spese invio / notifiche
• interessi debitori
• costo bonifico

Nota: l’elenco va aggiornato per ogni banca con termini specifici presenti negli estratti.

Pipeline dominio

• gescon:import-full
• gescon:import-gestioni

Servizi

• app/Services/GesconImport/LegacyArchiveService.php
• app/Services/GesconImport/EssentialImportService.php
• app/Services/GesconImport/StabileEnrichmentService.php