108 lines
2.8 KiB
Markdown
108 lines
2.8 KiB
Markdown
# 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
|
||
|