# 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>/<anno>/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