netgescon-master/docs/02-architettura-laravel/01-stabili/ANALISI-STABILI.md

# NETGESCON - ANALISI GESTIONE STABILI

## 📋 OVERVIEW
La gestione degli stabili è il modulo fondamentale di NetGesCon, dal quale dipendono tutte le altre funzionalità del sistema. Ogni stabile rappresenta un condominio con le sue caratteristiche uniche.

## 🏢 STRUTTURA DATI STABILE

### Dati Identificativi Base
- **ID Stabile** (Primary Key, Auto-increment)
- **Codice Stabile** (Univoco, alfanumerico)
- **Denominazione** (es: "Condominio Milano Centro")
- **Indirizzo Completo**
  - Via/Piazza
  - Numero civico
  - CAP
  - Comune (linkato a DB comuni italiani)
  - Provincia
  - Regione

### Dati Catastali
- **Sezione Urbana**
- **Foglio**
- **Particella/Mappale**
- **Subalterno** (se applicabile)
- **Categoria Catastale**
- **Classe**
- **Consistenza**
- **Rendita Catastale**

### Struttura Fisica
- **Numero Palazzine** (default: 1)
- **Numero Scale per Palazzina**
- **Numero Piani** (incluso piano terra, escluso seminterrato)
- **Presenza Ascensore** (SI/NO per scala)
- **Numero Appartamenti per Piano**
- **Piano Seminterrato** (SI/NO)
- **Piano Sottotetto** (SI/NO)
- **Cortile/Giardino** (SI/NO + mq)

### Servizi e Utilities
- **Riscaldamento Centralizzato** (SI/NO)
- **Acqua Centralizzata** (SI/NO)
- **Gas Centralizzato** (SI/NO)
- **Energia Elettrica Parti Comuni**
- **Servizio Portineria** (SI/NO + orari)
- **Videocitofono** (SI/NO)
- **Antenna TV Centralizzata**
- **Internet Condominiale**
- **Altri Servizi** (campo memo)

### Dati Economici
- **Fondo di Riserva Minimo**
- **Importo Rata Standard**
- **Frequenza Rate** (mensile/bimestrale/trimestrale)
- **Giorno Scadenza Rate**
- **IBAN Condominio**
- **Codice Fiscale Condominio**

### Valori Millesimali
- **Millesimi Generali** (somma deve essere 1000)
- **Millesimi Riscaldamento** (se centralizzato)
- **Millesimi Acqua** (se centralizzato)
- **Millesimi Ascensore** (se presente)
- **Altri Millesimi Specifici**

## 🔧 FUNZIONALITÀ AUTOMATICHE

### Creazione Automatica Unità Immobiliari
Quando si crea uno stabile, il sistema deve:
1. Calcolare il numero totale di unità immobiliari
2. Generare automaticamente tutte le unità con nomenclatura standard:
   - Palazzina A/B/C (se multiple)
   - Scala 1/2/3 (se multiple)
   - Piano -1/0/1/2/3/etc
   - Interno 1/2/3/etc
3. Assegnare automaticamente i dati base (indirizzo, dati catastali comuni)
4. Lasciare vuoti i campi da personalizzare per ogni unità

### Calcoli Automatici
- **Calcolo millesimi automatico** (se tutti uguali o in base a mq)

## 🔑 GESTIONE CHIAVI DELLO STABILE

### Tipologie Chiavi
- **Portone Principale** (chiave master + duplicati)
- **Porte Secondarie** (servizio, emergenza)
- **Locali Tecnici**
  - Centrale termica
  - Locale contatori
  - Locale pompe
  - Locale autoclave
  - Locale ascensori
- **Spazi Comuni**
  - Giardino condominiale
  - Terrazza comune
  - Lavanderia comune
  - Locale biciclette
  - Sala comune/riunioni
- **Servizi**
  - WC condominiali
  - Spogliatoi portineria
  - Deposito attrezzi
- **Garage/Box Comuni**
- **Cantine Comuni**
- **Chiavi Speciali**
  - Quadri elettrici
  - Saracinesche
  - Cancelli automatici
  - Chiavi universali

### Archivio Descrizioni Chiavi
**Per ogni tipologia di chiave:**
- **ID Chiave** (univoco)
- **Codice Chiave** (es: "PORT-01", "CT-TERM", "ASC-01")
- **Denominazione** (es: "Portone Via Roma 15")
- **Descrizione Dettagliata** (cosa apre, dove si trova)
- **Tipologia** (categorizzazione)
- **Numero Copie Totali**
- **Numero Copie in Circolazione**
- **Note Aggiuntive**

### Sistema di Assegnazione
- **Assegnazione a Persone**
  - Amministratore
  - Portiere
  - Condomini (per necessità specifiche)
  - Ditte di manutenzione
  - Servizi di emergenza
- **Registro Consegne/Ritiri**
  - Data consegna
  - Data ritiro prevista
  - Data ritiro effettiva
  - Motivo assegnazione
  - Persona responsabile
  - Firma digitale/conferma

### Stampa Etichette e QR Code
- **Etichette Fisiche**
  - QR Code per identificazione rapida
  - Testo descrittivo
  - Codice chiave
  - Logo condominio
- **Database QR**
  - Collegamento a scheda dettagliata
  - Cronologia utilizzi
  - Stato chiave (attiva/persa/sostituita)
- **App Mobile** per lettura QR e gestione
- **Verifica somma millesimi** = 1000
- **Calcolo maggioranze assemblea** (millesimi + teste)
- **Distribuzione spese automatica**

## 📁 ARCHIVIO DOCUMENTI

### Cartelle Standard per Stabile
- **📋 Documenti Costitutivi**
  - Regolamento di condominio
  - Atto di costituzione
  - Planimetrie generali
  - Tabelle millesimali originali

- **🔧 Manutenzioni e Contratti**
  - Contratti di manutenzione
  - Certificazioni sicurezza
  - Garanzie e collaudi
  - Documenti assicurativi

- **💰 Documenti Contabili**
  - Bilanci consuntivi
  - Bilanci preventivi
  - Fatture fornitori
  - Documentazione fiscale

- **📊 Comunicazioni**
  - Verbali assemblea
  - Comunicazioni ai condomini
  - Corrispondenza varia

### Sistema di Scansione Intelligente
- **OCR automatico** per estrazione dati da:
  - Fatture (importo, scadenza, fornitore)
  - Contratti (scadenze, importi, ricorrenze)
  - Comunicazioni (date importanti)
- **Categorizzazione automatica** documenti
- **Alerting scadenze** automatico

## 👥 FIGURE DI RIFERIMENTO

### Fornitori e Manutentori
- **Nome/Ragione Sociale**
- **Tipologia Servizio** (elettricista, idraulico, giardiniere, etc)
- **Dati di Contatto** (tel, email, indirizzo)
- **Disponibilità Chiavi** (SI/NO + note)
- **Contratto Attivo** (SI/NO + scadenza)
- **Valutazione Servizio** (1-5 stelle)
- **Note Specifiche**

### Ruoli Condominiali
- **Amministratore**
- **Vice Amministratore**
- **Revisori dei Conti**
- **Rappresentanti Scala/Palazzina**

## 🚨 SISTEMA DI ALERTING INTELLIGENTE

### Monitoraggio Problemi Vicini
Se un condomino segnala un problema (es: infiltrazione acqua), il sistema:
1. **Identifica automaticamente** l'unità immobiliare sopra
2. **Invia notifica automatica** al condomino sovrastante
3. **Mantiene privacy** (no dati personali condivisi)
4. **Crea pre-ticket** per amministratore
5. **Traccia risoluzione** problema

### Algoritmo Identificazione Vicini
```
Appartamento con problema: Palazzina A, Scala 2, Piano 3, Interno 5
Appartamento sopra: Palazzina A, Scala 2, Piano 4, Interno 5
Appartamenti laterali: Palazzina A, Scala 2, Piano 3, Interni 4 e 6
```

## 💰 GESTIONE FONDI CONDOMINIALI

### Tipologie di Fondi
- **Fondo Ordinario**
  - Rate condominiali mensili/trimestrali
  - Spese ordinarie di gestione
  - Manutenzioni programmate
- **Fondo di Riserva**
  - Accantonamenti obbligatori per legge
  - Percentuale minima su spese ordinarie
  - Manutenzioni straordinarie impreviste
- **Fondi Specifici**
  - Accantonamento ascensore
  - Accantonamento riscaldamento
  - Accantonamento tetto/facciata
  - Altri fondi dedicati

### Depositi Cauzionali
- **Depositi Inquilini**
  - Importo (solitamente 2-3 mensilità)
  - Scadenza contratto
  - Interessi maturati
  - Svincolo automatico
- **Depositi Ditte**
  - Cauzione lavori
  - Fideiussioni bancarie
  - Polizze assicurative
- **Depositi Vari**
  - Utilizzo spazi comuni
  - Eventi privati
  - Traslochi

### TFR e Compensi
- **TFR Portiere/Dipendenti**
  - Calcolo automatico accantonamento
  - Rivalutazione ISTAT
  - Tassazione sostitutiva
  - Liquidazione automatica
- **Compensi Amministratore**
  - Fatturazione periodica
  - Ritenute fiscali
  - Rimborsi spese
- **Compensi Occasionali**
  - Piccole manutenzioni
  - Servizi straordinari

### Rendite da Affitti Spazi Comuni
- **Locali Commerciali di Proprietà**
  - Negozi piano terra
  - Uffici
  - Studi professionali
- **Spazi Temporanei**
  - Sala condominiale per eventi
  - Terrazza per feste
  - Parcheggi visitatori
- **Servizi a Pagamento**
  - Lavanderia comune
  - Deposito biciclette premium
  - Box auto temporanei

### Gestione Rendite e Divisione
- **Classificazione Entrate**
  - Rendite soggette a ripartizione
  - Entrate dedicate a specifici fondi
  - Rimborsi spese sostenute
- **Algoritmi di Ripartizione**
  - Per millesimi generali
  - Per utilizzo effettivo
  - Per quote fisse
  - Esclusioni specifiche
- **Distribuzione ai Condomini**
  - Accredito su conto rate
  - Bonifico diretto
  - Compensazione spese
  - Accantonamento obbligatorio

### Reporting Fiscale e Amministrativo
- **Dichiarazioni Fiscali**
  - 770 Sostituto d'imposta
  - Dichiarazione IRES (se dovuta)
  - IVA su servizi resi
- **Certificazioni Uniche**
  - CU dipendenti/collaboratori
  - Ritenute su prestazioni professionali
- **Bilanci Condominiali**
  - Consuntivo annuale
  - Preventivo anno successivo
  - Ripartizione per singolo condomino

## 🏗️ SCHEMA DATABASE (Preliminare)

```sql
-- Tabella principale stabili
CREATE TABLE stabili (
    id BIGINT PRIMARY KEY AUTO_INCREMENT,
    codice_stabile VARCHAR(20) UNIQUE NOT NULL,
    denominazione VARCHAR(255) NOT NULL,
    indirizzo VARCHAR(255) NOT NULL,
    civico VARCHAR(10),
    cap VARCHAR(5),
    comune_id INT, -- FK a tabella comuni
    
    -- Dati catastali
    sezione_urbana VARCHAR(10),
    foglio VARCHAR(20),
    particella VARCHAR(20),
    subalterno VARCHAR(20),
    
    -- Struttura fisica
    numero_palazzine TINYINT DEFAULT 1,
    numero_scale_per_palazzina TINYINT DEFAULT 1,
    numero_piani TINYINT NOT NULL,
    ha_ascensore BOOLEAN DEFAULT FALSE,
    appartamenti_per_piano TINYINT NOT NULL,
    ha_seminterrato BOOLEAN DEFAULT FALSE,
    ha_sottotetto BOOLEAN DEFAULT FALSE,
    
    -- Servizi
    riscaldamento_centralizzato BOOLEAN DEFAULT FALSE,
    acqua_centralizzata BOOLEAN DEFAULT FALSE,
    
    -- Dati economici
    fondo_riserva_minimo DECIMAL(10,2),
    importo_rata_standard DECIMAL(8,2),
    frequenza_rate ENUM('mensile','bimestrale','trimestrale'),
    
    -- Audit
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
    created_by INT, -- FK a users
    updated_by INT, -- FK a users
    
    -- Indici
    INDEX idx_comune (comune_id),
    INDEX idx_codice (codice_stabile)
);
```

## 📅 ROADMAP SVILUPPO

### Fase 1 - Setup Base (Sprint 1-2)
- [ ] Creazione struttura database
- [ ] Import database comuni italiani
- [ ] CRUD base stabili
- [ ] Validazioni codice fiscale/catastali

### Fase 2 - Automazioni (Sprint 3-4)
- [ ] Generazione automatica unità immobiliari
- [ ] Calcoli millesimali automatici
- [ ] Sistema di alerting vicini

### Fase 3 - Documenti (Sprint 5-6)
- [ ] Sistema gestione documenti
- [ ] OCR e categorizzazione automatica
- [ ] Scadenzario automatico

### Fase 4 - Integrazioni (Sprint 7-8)
- [ ] API aggiornamento dati catastali
- [ ] Integrazione con servizi comunali
- [ ] Sistema backup automatico

## 🔍 DA VERIFICARE NELL'ESISTENTE

Controllare nel codice Laravel esistente:
- [ ] Tabelle già create per stabili
- [ ] Modelli Eloquent esistenti
- [ ] Migration già presenti
- [ ] Controller e View già implementate
- [ ] Relazioni con altre tabelle

## 💡 IDEE INNOVATIVE

### Gestione Smart Condominio
- **QR Code per ogni unità** immobiliare
- **App mobile condomini** per segnalazioni
- **Dashboard real-time** problemi
- **Integrazione IoT** (sensori allagamento, temperatura)
- **Chatbot assistenza** prima risposta

### Conformità Normativa
- **Aggiornamento automatico** normative condominiali
- **Check-list conformità** automatiche
- **Alerting scadenze** certificazioni
- **Template documenti** sempre aggiornati

---

**Data Analisi:** 14/07/2025  
**Stato:** BOZZA - In Definizione  
**Prossimo Step:** Verifica esistente + Design Database finale