11 KiB
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(oint): 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:
- Inibizione Scritture:
- I metodi di salvataggio in-place del controller
CatastoHub.php(applicaECorreggi,salvaQuotaProprietario) NON devono eseguire queryINSERT,UPDATEoDELETEsu tabelle del database di produzione.
- I metodi di salvataggio in-place del controller
- 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].jsonequote_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.
- 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: