netgescon-day0/docs/assicurazioni-roadmap.md

Assicurazioni Roadmap

Base gia presente nel codice:

• Ticket -> insuranceClaim() gia esiste.
• InsuranceClaim gestisce oggi il collegamento minimo ticket/sinistro.
• DocumentoCollegato supporta gia il tipo documento assicurazione e il collegamento allo stabile.
• Scadenza e ora disponibile per rinnovi polizza, pagamenti premio, richieste integrazione, riserve e liquidazioni.

Obiettivo prodotto

• Gestire la polizza dello stabile come dossier unico.
• Caricare documenti assicurativi da email e archiviarli nei documenti collegati dello stabile.
• Gestire quietanze di pagamento con ricevuta allegata e collegamento al movimento bancario.
• Aprire il sinistro da ticket e seguirlo fino a liquidazione, diniego o passaggio al legale.
• Generare scadenze operative e amministrative lungo tutto il ciclo.

Modello dati minimo consigliato

1. insurance_policies

• id
• stabile_id
• compagnia_rubrica_id
• broker_rubrica_id
• documento_collegato_id
• numero_polizza
• ramo
• descrizione_copertura
• massimale
• franchigia
• premio_annuo
• decorrenza
• scadenza
• rinnovo_tacito
• giorni_preavviso_disdetta
• stato
• metadata

1. insurance_policy_payments

• id
• insurance_policy_id
• movimento_bancario_id
• documento_collegato_id
• numero_quietanza
• data_pagamento
• competenza_dal
• competenza_al
• importo
• stato
• metadata

1. Estendere insurance_claims

• mantenere ticket_id
• aggiungere insurance_policy_id
• aggiungere documento_collegato_id
• aggiungere numero_pratica_compagnia
• aggiungere stato_workflow
• aggiungere data_evento
• aggiungere data_denuncia
• aggiungere data_apertura_compagnia
• aggiungere data_liquidazione
• aggiungere importo_riservato
• aggiungere importo_liquidato
• aggiungere passata_a_legale_at
• aggiungere legale_rubrica_id

1. insurance_claim_events

• timeline strutturata della pratica
• tipi evento: apertura, invio_documenti, integrazione, sopralluogo, riserva, liquidazione, diniego, passaggio_legale, mediazione, chiusura

Agganci applicativi

1. Email -> Documenti

• intercettare mail della compagnia/broker
• salvare EML e allegati
• creare o aggiornare DocumentoCollegato tipo assicurazione
• se il soggetto mittente e riconosciuto, collegare compagnia_rubrica_id o broker_rubrica_id

1. Documenti stabile

• nella tab documenti-collegati dello stabile filtrare ed evidenziare le polizze assicurative
• mostrare polizza attiva, prossima scadenza, ultima quietanza, ultimo sinistro aperto

1. Ticket -> Sinistro

• aggiungere in TicketGestione una action Apri pratica assicurativa
• precompilare riferimento polizza, data evento, descrizione danno, allegati ticket
• creare automaticamente almeno una Scadenza di follow-up

1. Banca -> Quietanze

• permettere collegamento manuale e poi semi-automatico tra quietanza e movimento_bancario
• usare causali bancarie che contengono polizza, assicurazione, quietanza, numero pratica o numero polizza

1. Scadenze

• rinnovo polizza
• termine disdetta
• richiesta integrazione documenti
• scadenza per denuncia
• follow-up con compagnia
• data prevista liquidazione
• termine per invio al legale/mediazione

Primo slice implementativo consigliato

1. Migrazione + model insurance_policies
2. Estensione insurance_claims
3. Action in ticket per aprire la pratica assicurativa con collegamento a polizza e allegati ticket
4. Vista riepilogo assicurazione nello stabile
5. Quietanza + collegamento movimento bancario
6. Automazione email in ingresso

Note operative

• Riutilizzare RubricaUniversale per compagnia, broker e legale.
• Riutilizzare DocumentoCollegato per il fascicolo documentale, senza creare un archivio parallelo.
• Riutilizzare Scadenza per tutte le attivita operative invece di introdurre una seconda agenda dedicata.