# Manuale CED HOUSE — Estrazione dati (Revisione Contabile)

## 1) Scopo
Questa guida descrive come estrarre e importare i dati da PDF CED HOUSE nella **Revisione Contabile** di Filament.

## 2) Requisiti
- PDF estratti conto CED HOUSE disponibili in cartella locale.
- `pdftotext` installato sul server.
- Accesso al pannello Filament (Revisione Contabile).

## 3) Percorsi utilizzati
- PDF estratti conto:
  - `Miki-Bug-workspace/Importazione/Andrea doria/Banca Intesa/Estrattoconto`
- TXT estratti:
  - `storage/app/reports/*.txt`

## 4) Flusso operativo (passo-passo)
### 4.1 Apri Revisione Contabile
1. Vai a: **Revisione Contabile → Dettaglio revisione**.
2. Apri il tab **Estratti conto**.

### 4.2 Estrai il TXT dal PDF
1. Nel tab **PDF** seleziona il file PDF.
2. Clicca **Estrai TXT**.
3. Il testo estratto viene salvato in `storage/app/reports/` e mostrato nel tab **Testo estratto**.

### 4.3 Collega PDF a Unità
1. Nella lista PDF, seleziona l’unità (nominativo) dalla colonna **Unità collegata**.
2. Il collegamento serve per mostrare nominativo e per confronti successivi.

### 4.4 Verifica sezioni riconosciute
Nel tab **Estratti conto** sono disponibili le sotto-sezioni:
- **Riepilogo Versamenti**
- **Gestione Ordinaria 2023**
- **Gestione Ordinaria 2024**
- **Gestione Straordinaria (LevelOn)**
- **Rate emesse**
- **Conguagli**

### 4.5 Importa righe
Usa i pulsanti **Importa righe** per inserire le righe in `revisione_precedente_movimento_banca`.

## 5) Regole sui segni degli importi
- Il segno **negativo** è valido solo se è **attaccato al simbolo dell’euro**: `-€`.
- Un trattino separatore (es. `-   -€`) **non** deve invertire il segno.

### Correzione post-import
Usa **Correggi negativi importati** per:
- allineare i segni corretti
- correggere eventuali errori storici

## 6) Conguagli
- Tab **Conguagli**: confronto automatico con `dett_tab` (Situazione Iniziale → Conguagli).
- Se il delta non è zero, è presente una squadratura.

## 7) Totali per nominativo
Nel tab **Ordinaria 2023**:
- la tabella “Totali per nominativo” calcola rate e versamenti dell’estratto selezionato.
- il totale è il riferimento per i confronti con il Bilancio.

## 8) Troubleshooting
- **PDF non estrae**: controlla presenza di `pdftotext` e permessi cartella.
- **File con apostrofi**: l’estrazione è gestita con parametri sicuri.
- **Totali a 0**: assicurati di avere selezionato un TXT estratto e di aver importato le righe.

---
Aggiornare questo manuale se cambiano:
- percorsi PDF/TXT
- regole di parsing
- sezioni disponibili