Workflow RAS Target¶

Scopo¶

Definire il flusso RAS target da implementare in SafeOps per il tenant operativo.

Questo documento sostituisce le assunzioni informali e fissa:

attori;
stati;
documenti;
trigger;
punti gia coperti dal sistema;
punti da completare.

Flusso Target¶

l'amministratore con servizio RAS attivo apre la richiesta;
il modulo si auto-compila con i dati gia presenti;
l'amministratore completa solo i dati mancanti;
la richiesta viene inviata a:
commerciale di riferimento;
rete collegata all'amministratore;
il commerciale invia il modulo d'ordine con costo preso dal listino collegato all'amministratore;
l'amministratore conferma, firma e ricarica il modulo nel portale;
il commerciale conferma il modulo firmato;
la richiesta passa all'operativo;
l'operativo crea la conferma d'ordine e invia il flusso al gestionale di fatturazione;
il processo si biforca:
- A: lettera di incarico subito;
- B: lettera di incarico solo dopo pagamento;
il tecnico riceve la lettera di incarico;
il tecnico chiede appuntamento;
il tecnico esegue il lavoro;
il tecnico completa e verifica;
il tecnico scarica il documento, lo firma digitalmente e lo ricarica;
il documento finale viene consegnato;
la pratica passa in verifica finale e poi in chiusura.

Nota consuntivo:

la chiusura pratica deve lasciare aperto un aggancio per il consuntivo;
il consuntivo servira per la divisione dell'incasso tra tecnico, commerciale, IDS e altri attori;
le percentuali/importi saranno governati da listini o regole dedicate in un passaggio successivo.

Attori¶

Amministratore di condominio
Commerciale di riferimento
Rete commerciale / rete di gestione
Operatore operativo
Tecnico
Fatturazione come sistema/integrazione esterna

Prerequisiti¶

l'amministratore deve avere un contratto attivo che abilita RAS;
l'amministratore deve essere collegato ai condomini corretti;
il listino collegato all'amministratore deve esporre il servizio RAS corretto;
anagrafica amministratore e anagrafica condominio devono essere coerenti;
devono esistere i template:
modulo d'ordine;
conferma d'ordine;
lettera di incarico;
documento tecnico finale da firmare;
deve essere definita la regola tenant:
incarico subito;
oppure incarico dopo pagamento.

Stati Proposti¶

richiesta_bozza_admin
richiesta_inviata
in_carico_commerciale
modulo_ordine_generato
modulo_ordine_inviato
modulo_ordine_firmato_admin
modulo_ordine_confermato_commerciale
in_carico_operativo
conferma_ordine_generata
inviato_a_fatturazione
in_attesa_pagamento
pronto_per_lettera_incarico
lettera_incarico_emessa
tecnico_assegnato
appuntamento_da_fissare
intervento_in_esecuzione
intervento_completato
documento_tecnico_generato
documento_tecnico_firmato
documento_tecnico_ricaricato

Regola:

il ramo in_attesa_pagamento e opzionale;
se il tenant lavora con incarico immediato, si salta direttamente a pronto_per_lettera_incarico.

Macchina a Stati¶

1. Richiesta iniziale¶

Stato iniziale:

richiesta_bozza_admin

Attore:

amministratore

Azioni:

apertura richiesta dal portale;
precompilazione automatica con:
dati amministratore;
dati condominio;
dati anagrafica gia presenti;
compilazione dei soli campi mancanti.

Output:

payload richiesta completo;
eventuali allegati iniziali.

Transizione:

Invia richiesta -> richiesta_inviata

2. Presa in carico commerciale¶

Attori:

commerciale di riferimento;
rete collegata

Azioni:

presa in carico;
verifica listino e condizioni;
generazione modulo d'ordine con importo da listino amministratore.

Transizioni:

Prendi in carico -> in_carico_commerciale
Genera modulo d'ordine -> modulo_ordine_generato
Invia a portale -> modulo_ordine_inviato

3. Firma amministratore¶

Attore:

amministratore

Azioni:

scarica modulo d'ordine;
firma;
ricarica nel portale.

Transizione:

Upload modulo firmato -> modulo_ordine_firmato_admin

4. Conferma commerciale¶

Attore:

commerciale

Azioni:

verifica modulo firmato;
conferma validita del documento caricato.

Transizione:

Conferma modulo firmato -> modulo_ordine_confermato_commerciale

5. Passaggio all'operativo¶

Attore:

operatore operativo

Azioni:

genera conferma d'ordine;
invia dati al gestionale di fatturazione.

Transizioni:

Prendi in carico operativo -> in_carico_operativo
Genera conferma d'ordine -> conferma_ordine_generata
Invia a fatturazione -> inviato_a_fatturazione

6. Regola pagamento / incarico¶

Attore:

operativo / sistema

Configurazione tenant:

lettera_incarico_mode = immediate
lettera_incarico_mode = after_payment

Transizioni:

se immediate:
inviato_a_fatturazione -> pronto_per_lettera_incarico
se after_payment:
inviato_a_fatturazione -> in_attesa_pagamento
Pagamento confermato -> pronto_per_lettera_incarico

7. Lettera di incarico¶

Attori:

operativo
opzionalmente amministratore, se puo indicare il tecnico

Azioni:

selezione tecnico;
generazione lettera di incarico;
invio al tecnico.

Transizioni:

Genera lettera incarico -> lettera_incarico_emessa
Assegna tecnico -> tecnico_assegnato

8. Esecuzione tecnica¶

Attore:

tecnico

Azioni:

richiede appuntamento;
esegue il lavoro;
completa e verifica.

Transizioni:

Richiedi appuntamento -> appuntamento_da_fissare
Avvia intervento -> intervento_in_esecuzione
Completa intervento -> intervento_completato

9. Documento tecnico firmato¶

Attore:

tecnico

Azioni:

scarica documento da firmare;
firma digitalmente;
ricarica file firmato.

Transizioni:

Genera documento tecnico -> documento_tecnico_generato
Upload firmato digitale -> documento_tecnico_ricaricato

Documenti da Governare¶

Modulo d'ordine
generato dal commerciale
inviato all'amministratore
Modulo d'ordine firmato
caricato dall'amministratore
validato dal commerciale
Conferma d'ordine
generata dall'operativo
inviata a fatturazione
Lettera di incarico
generata da operativo
inviata al tecnico
Documento tecnico finale
generato/scaricato dal tecnico
firmato digitalmente
ricaricato nel sistema

Dati da Precompilare¶

Da anagrafica amministratore¶

studio / ragione sociale
email
PEC
telefono
partita IVA
codice fiscale
indirizzo

Da anagrafica condominio¶

nome condominio
codice fiscale
partita IVA
indirizzo
comune
provincia
CAP

Da contratto / listino¶

servizio RAS attivo
codice servizio
prezzo da listino
modalita prezzo:
redazione
riallineamento

Da input amministratore¶

campi non presenti in anagrafica
allegati
dati specifici richiesta

Trigger / Eventi Applicativi¶

Eventi minimi da supportare:

richiesta_ras_created
richiesta_ras_assigned_to_commerciale
ordine_module_generated
ordine_module_sent
ordine_module_uploaded_signed
ordine_module_confirmed
operativo_taken_over
conferma_ordine_generated
fatturazione_sync_sent
payment_confirmed
lettera_incarico_generated
tecnico_assigned
appointment_requested
intervento_completed
technical_document_uploaded_signed

Ogni evento deve lasciare audit con:

utente
ruolo
tenant
entita
timestamp
stato precedente
stato successivo

Mappatura con l'Esistente¶

Gia presente o quasi presente¶

richiesta RAS da portale/backoffice
collegamento amministratore -> condominio
commerciale di riferimento
listino RAS
richiesta servizio
trattativa / offerta RAS
ticket / operativo
documentale
assegnazione tecnico
compilazione tecnica / RAS

Da completare¶

macchina a stati unica del flusso target
modulo d'ordine generato dal listino amministratore
upload e validazione del modulo firmato
conferma d'ordine formale
integrazione fatturazione come step esplicito
regola tenant incarico subito / dopo pagamento
lettera di incarico governata a workflow
upload documento tecnico firmato digitale come stato formale

Strategia di Implementazione¶

Ordine consigliato:

consolidare stati e transizioni su Richiesta Servizio
introdurre il modulo d'ordine
introdurre upload e conferma del modulo firmato
introdurre il passaggio operativo/fatturazione
introdurre la regola dopo pagamento
introdurre la lettera di incarico
agganciare il documento tecnico firmato finale

Decisioni Aperte¶

Da confermare prima dell'implementazione:

username/ruolo che puo generare la lettera di incarico
chi seleziona il tecnico:
operativo
amministratore
entrambi con regole
quando considerare pagamento confermato
input manuale
integrazione gestionale
formato atteso dei file firmati:
PDF firmato
P7M
entrambi

Nota Finale¶

Questo documento descrive il flusso target desiderato.

Non implica che tutto sia gia implementato oggi nel runtime SafeOps.

Serve come riferimento unico per:

sviluppo;
configurazione;
QA;
collaudo operativo;
allineamento con i template documentali gia disponibili.