netgescon-day0/directives/sop_struttura_legacy_e_anagrafica_avanzata.md

# 📑 SOP - STRUTTURA DIZIONARIO LEGACY E ANAGRAFICA AVANZATA

> **Documento di Livello 1 (SOP Esecutiva / Dizionario Dati)**
> Tracciato record di confronto e dizionario dei campi raw estratti dal database di staging per la validazione catastale ed anagrafica avanzata.

---

## 1. Mappatura Campi Raw 'condomin' (Legacy)

I campi esportati dall'archivio `.mdb` originario costituiscono la sorgente immutabile di riscontro a schermo per l'operatore. Il sistema presenta in sola lettura questo set strutturato nel pannello di riscontro.

### A. Dati Unità Fissa
- `id_cond`: Chiave primaria originaria del condomino.
- `cod_cond`: Codice sequenziale interno all'anno.
- `scala`: Scala di appartenenza dell'unità.
- `interno` (o `int`): Numero identificativo dell'interno.
- `tipo_pr`: Tipologia di proprietà/ruolo (es: Proprietario, Inquilino, ATER).

### B. Catasto & Diritti Core
- `catasto_sez_urbana`: Sezione urbana catastale dell'immobile.
- `catasto_foglio`: Numero del foglio catastale.
- `catasto_particella`: Numero della particella catastale.
- `catasto_sub`: Subalterno dell'unità immobiliare.
- `catasto_zona`: Zona censuaria di appartenenza.
- `catasto_categoria`: Categoria catastale (es. A/2, C/6).
- `catasto_classe`: Classe di rendimento catastale.
- `catasto_consistenza`: Consistenza (es. vani, mq).
- `catasto_superfice`: Superficie catastale dichiarata.
- `catasto_rendita`: Rendita catastale.
- `diritto_reale`: Codifica del diritto reale (es: P per Proprietà, U per Usufrutto).
- `diritto_godimento`: Eventuale diritto di godimento (es. Locazione).
- `catasto_tu`: Tipologia d'uso catastale.
- `catasto_particella2`: Eventuale particella secondaria per catasto tavolare.
- `perc_diritto_reale`: Quota/Percentuale del diritto reale posseduto (es. 100%, 50%).

### C. Pertinenze
- `pertinenze_box`: Flag/Dettaglio box auto associato.
- `pertinenze_cant`: Flag/Dettaglio cantina associata.
- `pertinenze_pauto`: Flag/Dettaglio posto auto assegnato.
- `pertinenze_altro`: Altre pertinenze collegate.

### D. Fisco, Sicurezza & Detrazioni
- `sicur1_ui_a_norma`...`sicur5_opere_impegno`: Stato di conformità impianti e opere.
- `perc_detrazione`: Quota percentuale di detrazione fiscale spettante.
- `detraz_sit_part`: Situazioni particolari per le detrazioni.
- `disponib_dati_catastali`: Flag disponibilità coordinate catastali.
- `domandaaccatast_n` / `data` / `pr`: Estremi della domanda di accatastamento.
- `detraz_cess_cred`: Stato della cessione del credito fiscale.
- `detraz_cess_cf`: Codice fiscale del cessionario del credito.
- `detraz_cess_nome`: Nome/Denominazione del cessionario.
- `detraz_cess_protoc`: Protocollo telematico di cessione.

### E. Anagrafica Condomino (Ruolo C - Proprietario)
- `nom_cond`: Cognome e Nome / Denominazione del condomino.
- `presso`: Recapito presso terzi.
- `ind`: Indirizzo di residenza.
- `cap`: Codice di Avviamento Postale.
- `citta`: Città di residenza.
- `pr`: Provincia di residenza.
- `inquil`: Flag/Collegamento ad eventuale inquilino.
- `tel1` / `tel2` / `cell_cond` / `fax_cond`: Recapiti telefonici e telefax.
- `note_cond`: Note descrittive libere associate all'anagrafica.
- `titolo_cond`: Titolo formale (es. Egr. Sig., Dott.).
- `e_mail_condomino`: Indirizzo email ordinario del condomino.
- `pec_condomino`: Indirizzo PEC.
- `cond_cod_fisc`: Codice Fiscale del condomino.
- `cond_dt_nasc` / `luogo_nasc` / `pr_nasc`: Dati di nascita del condomino.
- `cc_banca_cond` / `banca_cond`: Estremi bancari per rimborsi o addebiti.
- `mav_cond` / `bonifico_cond`: Preferenze di pagamento del condomino.

### F. Anagrafica Inquilino (Ruolo I - Inquilino)
- `inquil_nome`: Nominativo completo dell'inquilino.
- `inquil_presso` / `inquil_indir` / `inquil_cap` / `inquil_citta` / `inquil_pr`: Indirizzo dell'inquilino.
- `inquil_tel1` / `inquil_tel2` / `cell_inq` / `fax_inq`: Recapiti telefonici.
- `inquil_note`: Annotazioni specifiche sull'inquilino.
- `titolo_inq`: Titolo formale dell'inquilino.
- `e_mail_inquilino` / `pec_inquilino`: Indirizzi email e PEC.
- `cc_banca_inq` / `banca_inq`: Coordinate bancarie dell'inquilino.
- `mav_inq` / `bonifico_inq`: Canali di pagamento scelti dall'inquilino.
- `inquil_dal` / `inquil_al`: Periodo temporale di occupazione/locazione.
- `inquil_cod_fisc`: Codice Fiscale dell'inquilino.
- `inquil_contratto_dal`: Decorrenza formale del contratto registrato.

---

## 2. Tabelle Addizionali Core Legacy

### A. TABELLA [anni]
Contiene i periodi e le impostazioni degli anni contabili/gestione.
- `id_anno`: ID univoco progressivo dell'anno.
- `anno_o`: Anno di inizio gestione ordinaria.
- `anno_r`: Anno di inizio gestione riscaldamento.
- `nome_dir`: Nome della directory contenente i database e i file dell'anno.
- `Selez`: Flag per identificare l'anno correntemente selezionato/attivo.
- `descr_selez`: Descrizione testuale dello stato di selezione.
- `ordinarie_dal` / `ordinarie_al`: Periodo di validità delle spese ordinarie.
- `riscald_dal` / `riscald_al`: Periodo di validità delle spese di riscaldamento.

### B. TABELLA [Stabili]
Contiene le informazioni anagrafiche, fiscali e gestionali dello Stabile.
- `id_stabile`: Identificativo univoco dello stabile.
- `cod_stabile`: Codice legacy alfanumerico (es. `0021`).
- `denominazione`: Nome completo del condominio.
- `indirizzo`: Indirizzo dello stabile.
- `cap`: Codice Avviamento Postale.
- `citta`: Città di ubicazione.
- `pr`: Provincia di ubicazione.
- `codice_fisc`: Codice fiscale del condominio.
- `pos_inps`: Codice posizione INPS associata.
- `n_contribuente`: Numero contribuente dello stabile.
- `cf_amministratore`: Codice fiscale dell'amministratore dello stabile.
- `num_condomini`: Numero di condomini censiti nello stabile.
- `num_scale`: Numero di scale presenti.
- `note1`: Note aggiuntive generali.
- `nome_directory`: Nome della cartella dello stabile.

### C. SCADENZARI E BANCHE STABILE
- `ORD_RATA_1`...`12`: Date di scadenza per le 12 rate ordinarie.
- `RIS_RATA_1`...`12`: Date di scadenza per le 12 rate riscaldamento.
- `num_ccp`: Numero di conto corrente postale dello stabile.
- `intestaz_ccp`: Intestazione del conto corrente postale.
- `Autoriz_pptt`: Numero di autorizzazione delle Poste Italiane.
- `Banca`: Nome dell'istituto bancario di appoggio dello stabile.
- `Banca_num_cc`: Numero del conto corrente bancario.
- `Banca_intest_cc`: Intestazione del conto corrente bancario.
- `ABI` / `CAB`: Codici ABI e CAB della banca dello stabile.
- `SIA` / `CIN`: Codici SIA e CIN per le disposizioni interbancarie.
- `INPS_sede_F24`: Sede INPS di competenza per deleghe F24.
- `INPS_Matricola_F24`: Matricola INPS per F24.
- `INAIL_sede_F24`: Sede INAIL di competenza per deleghe F24.
- `INAIL_posiz_f24` / `INAIL_posiz2_f24`: Posizioni INAIL per F24.
- `IBAN_Banca`: Codice IBAN del conto corrente bancario.
- `IBAN_Posta`: Codice IBAN del conto corrente postale.

### D. CATASTO GLOBALE STABILE
- `AC_tu`: Destinazione d'uso globale catastale dello stabile.
- `AC_ip`: Identificatore provvisorio.
- `AC_urb_cat`: Codice sezione urbana globale.
- `AC_Foglio`: Foglio catastale globale dello stabile.
- `AC_partic1` / `AC_partic2`: Particelle catastali associate allo stabile.
- `AC_sub`: Subalterno globale.
- `AC_data_acc` / `AC_num_acc` / `AC_prov_acc`: Estremi dell'accatastamento.
- `PT_CIN` / `PT_SIA`: Credenziali postali dedicate.
- `F24_SIA`: Codice SIA per addebiti F24.
- `Catasto_comune`: Codice catastale del comune.
- `Catasto_PR`: Sigla provincia catastale.

### E. FATTURE & PEC STABILE
- `FE_denominazione`: Denominazione fiscale dello stabile per la fatturazione elettronica.
- `FE_Codice_destinatario`: Codice destinatario SDI dello stabile.
- `FE_pec`: Indirizzo PEC dello stabile.
- `Autoriz_pptt_pdf` / `Autoriz_pptt_pdf_2`: Riferimenti ai documenti autorizzativi.
- `CUC` / `CUC2` / `CUC3` / `CUC4`: Codici Univoci di Codifica.
- `Th_mail_mittente` / `Th_PEC_mittente`: Account mittente per comunicazioni.
- `FE_SN`: Numero di serie del servizio di fatturazione elettronica.
- `FE_attivo_fino_al`: Data di scadenza del servizio di fatturazione.
- `FE_ultima_richiesta_al`: Timestamp dell'ultima interrogazione SDI.

### F. TABELLA [Comproprietari]
Contiene l'anagrafica dei comproprietari o cointestatari dei diritti sulle unità.
- `Id_compr`: ID univoco del comproprietario.
- `id_cond`: Collegamento all'unità legacy (`condomin.id`).
- `Diritto_reale`: Tipo di diritto reale (es: P, U).
- `Descriz`: Descrizione testuale del diritto (es. Comproprietario, Usufruttuario).
- `titolo_cond`: Titolo formale del comproprietario.
- `nom_cond`: Cognome e Nome o denominazione del comproprietario.
- `presso`: Recapito presso terzi.
- `ind`: Indirizzo di residenza.
- `cap` / `citta` / `pr`: Dati di recapito del comproprietario.
- `Cond_dt_nasc` / `Cond_Luogo_nasc` / `Cond_PR_Nasc`: Dati di nascita.
- `tel1` / `tel2` / `Cell_cond` / `Fax_cond`: Contatti del comproprietario.
- `E_mail_condomino` / `PEC_compr`: Email e PEC del comproprietario.
- `Cond_cod_fisc`: Codice Fiscale del comproprietario.
- `Perc_Diritto_reale`: Percentuale di possesso del diritto reale (es. 50.00).
- `cia`: Flag o nota interna.
- `Perc_Detrazione`: Percentuale di detrazione fiscale spettante al comproprietario.
- `Detraz_Sit_Part`: Situazioni particolari per le detrazioni.
- `Catasto_sez_Urbana` / `Catasto_foglio` / `Catasto_particella` / `Catasto_sub` / `Catasto_TU` / `Catasto_particella2`: Coordinate catastali dichiarate per il comproprietario.
- `DomandaAccatast_N` / `DomandaAccatast_data` / `DomandaAccatast_PR`: Domanda di accatastamento del comproprietario.
- `ex_cod_cond` / `ex_scala` / `ex_int`: Riferimenti storici di posizionamento dell'unità.
- `Detraz_cess_cred` / `Detraz_cess_CF` / `Detraz_cess_nome` / `Detraz_cess_protoc`: Dettagli sulla cessione del credito del comproprietario.
- `ex_tipo_pr`: Tipo proprietà storico.
- `Data_cessione_credito`: Decorrenza formale di cessione credito.

---

## 3. Blocco Sicurezza Sola Lettura Database

Per blindare la stabilità del database di produzione (`netgescon`) durante la fase di validazione umana:

1. **Inibizione Scritture**:
   - I metodi di salvataggio in-place del controller `CatastoHub.php` (`applicaECorreggi`, `salvaQuotaProprietario`) **NON** devono eseguire query `INSERT`, `UPDATE` o `DELETE` su tabelle del database di produzione.
2. **Storicizzazione in Cloud Drive (Anno Consolidato 0004)**:
   - I dati di riscontro confermati o modificati dall'operatore a schermo devono essere salvati in formato JSON all'interno di un file strutturato posizionato nella directory dell'anno 0004:
     `[Codice_Amministratore]/[Codice_Stabile]/catasto/anno_0004/validati_unita_[id_unita].json`
     e `quote_unita_[id_unita].json`.
   - All'apertura della scheda unità, il sistema carica e applica in overlay questi dati storicizzati, consentendo di visualizzarli ed alterarli in totale sicurezza senza alterare i record fisici di produzione.