# Direttiva Operativa: Allineamento e Unicità delle Anagrafiche e dei Nominativi Condominiali

## Scopo

Questa direttiva sancisce la regola fondamentale per cui **tutte le interfacce, viste e blade di NetGescon (inclusa la scheda unità `unita-immobiliare`, il riepilogo `condomini/nominativi` e le maschere contabili) devono tassativamente attingere dagli stessi archivi relazionali canonici**, evitando divergenze tra schermate o sovrascritture arbitrarie da viste legacy temporanee.

---

## 1. Sorgente Dati Canonica Obbligatoria

1. **Unità Immobiliari**: `unita_immobiliari` con identificativo univoco, scala, piano, interno e `stabile_id`.
2. **Soggetti e Persone**: Tabella canonica `persone` (denominazione / ragione sociale o cognome + nome, codice fiscale, contatti telefonici ed email).
3. **Relazioni Titolarità Temporale**: Tabella `persone_unita_relazioni` con:
   - `tipo_relazione`: `'proprietario'`, `'comproprietario'`, `'nudo_proprietario'`, `'usufruttuario'`, `'condomino'` per i possessori; `'inquilino'`, `'conduttore'`, `'locatario'` per gli inquilini.
   - `quota_relazione` / `perc_diritto_reale`: percentuale di possesso o diritto reale (es. 50% / 50%).
   - `data_inizio` e `data_fine`: validità temporale legata all'anno di gestione attivo.
   - `attivo`: stato della relazione.

---

## 2. Regole di Visualizzazione e Normalizzazione

- **Gestione Anno Attivo (`AnnoGestioneContext`)**: I nominativi di proprietari e inquilini visualizzati devono sempre rispecchiare l'esercizio/anno di gestione attivo selezionato nel contesto di sessione.
- **Risoluzione Denominazione Persona/Azienda**:
  ```sql
  CASE 
    WHEN COALESCE(p.ragione_sociale, '') <> '' THEN p.ragione_sociale 
    ELSE TRIM(CONCAT(COALESCE(p.cognome, ''), ' ', COALESCE(p.nome, ''))) 
  END
  ```
  È vietata la concatenazione ridondante di cognome, nome e ragione sociale che produce duplicazioni testuali.
- **Distinzione Netta Condòmini vs Inquilini**: In tutte le viste le titolarità e i recapiti di proprietari e inquilini devono rimanere nettamente separati.

---

## 3. Conformità Multi-Blade

- **`UnitaImmobiliarePage` (`/admin-filament/unita-immobiliare`)** e **`NominativiStabile` (`/admin-filament/condomini/nominativi`)** utilizzano la medesima logica di query atomica relazionale, garantendo che lo stesso condòmino/inquilino appaia in modo identico in entrambe le pagine.