netgescon-day0/directives/sop_struttura_legacy_e_anagrafica_avanzata.md

11 KiB

📑 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.