# Affitti ISTAT e Contratti

## Stato Implementazione (06/03/2026)

- Gestione affitti: tabella elenco unica con filtro tipo locazione e stato contratto.
- Contratti obsoleti:
  - Campo `affitti_immobili.obsoleto` + `obsoleto_dal` + `motivo_obsolescenza`.
  - I contratti obsoleti sono nascosti dal filtro default `Solo attivi`.
  - Pulsanti UI: `Segna obsoleto` / `Riattiva contratto`.
- Anagrafica catastale estesa per immobile affittato:
  - Comune catastale (`comune_catastale_codice`, es. `H501`), sezione urbana, foglio/particella/subalterno.
  - Categoria/classe, consistenza, superficie, interno, piano.
  - Numero e data registrazione AdE/RLI.
- Emissione rate automatica:
  - Parte da `inizio_contratto`.
  - Giorno emissione configurabile (`giorno_emissione_canone`, default 5).
  - Stop a `data_fine_contratto`/`prossima_scadenza`/mese corrente.
  - Clausole periodiche applicate a canone (mensile/annuale/una tantum).
- Adempimenti fiscali annui dedicati:
  - Campi contratto `imposta_registro_annuale`, `quota_imposta_inquilino_percent`, `imposta_bollo_annuale`.
  - Pianificazione con `mese_adempimenti_annuali` + `giorno_adempimenti_annuali`.
  - In emissione canoni viene addebitata automaticamente la quota inquilino dell'imposta registro e il bollo annuo nel mese configurato.
- Avvisi operativi elenco:
  - Rinnovo contratto e registrazione AdE con soglie di prossimita.
  - Evidenza canoni scaduti non pagati in colonna `Avvisi`.

## ISTAT API - Base Tecnica

- Tabella indici mensili: `istat_indici_mensili`.
- Comandi:
  - `php artisan istat:sync-indici --url="<json-url>" --series=FOI`
  - `php artisan istat:set-indice 2026 1 121.3000 --series=FOI`
- Config:
  - `ISTAT_API_URL`
  - `ISTAT_SERIES` (default `FOI`)
  - `ISTAT_SOURCE` (default `ISTAT API`)
  - `ISTAT_TIMEOUT` (default `30`)
- Scheduler:
  - `istat:sync-indici` pianificato ogni mese alle `03:10`.

## Dati Necessari dal Feed ISTAT

Formato minimo per riga JSON:

- `anno` (es. `2026`)
- `mese` (1-12)
- `indice` (numero)

Formati alternativi supportati:

- `year`, `month`, `value`
- `periodo` nel formato `YYYY-MM` + `indice`

## Prossimo Step Operativo

- Collegare feed ufficiale scelto e validare per almeno 24 mesi storici.
- Aggiungere promemoria dashboard/notifiche per adempimenti annui in scadenza (oltre alla colonna elenco).
- Introdurre report annuale per quadratura: registro/bollo previsti vs addebitati vs incassati.