netgescon-day0/docs/assicurazioni-roadmap.md

124 lines
3.8 KiB
Markdown

# 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.