Workflow RAS Pipeline Commerciale V1¶

Obiettivo: sostituire la lettura frammentata del flusso RAS con una vista unica, visiva e guidata che accompagni la pratica dalla richiesta fino alla consegna dell'incarico tecnico, mantenendo separati il perimetro commerciale/amministrativo e quello tecnico.

Perche serve¶

Oggi il flusso reale e distribuito tra piu viste e piu oggetti:

commerciale_richiesta_servizio
commerciale_trattativa
commerciale_offerta
documento offerta / preventivo / modulo ordine
documento firmato
ticket o oggetto operativo equivalente
incarico tecnico

Questo rende difficile capire:

in che fase si trova davvero la pratica
quale documento manca
quale azione e consentita adesso
quando la pratica puo essere consegnata al tecnico

La pipeline V1 deve risolvere questo problema con una UI semplice, sequenziale e leggibile.

Posizionamento¶

La pipeline non sostituisce il compila e non entra nel dettaglio tecnico di libretto, foto o finale.

La pipeline governa solo:

stato commerciale
stato amministrativo
documenti necessari ai passaggi
consegna dell'incarico tecnico

Nome Proposto¶

menu: Workflow RAS
route base proposta: /commerciale-ras-workflow
view class proposta: CommercialeRasWorkflowView

Target Utenti¶

extra: read-only
ids_extra: read/write

Regola:

extra puo leggere pratica, documenti, checklist e storico
ids_extra puo eseguire azioni di avanzamento, riallineamento e rollback guidato

Oggetto Pivot¶

Pivot principale della pratica:

commerciale_trattativa.id

Per ogni trattativa la vista deve risolvere:

richiesta RAS
offerta piu rilevante
preventivo / modulo ordine
firmato
ticket o riferimento operativo
incarico tecnico

Vista Principale¶

La vista principale deve essere una pipeline a step con forte leggibilita.

Step V1:

Richiesta
Offerta
Firma
Chiusura commerciale
Consegna incarico tecnico

Ogni step mostra:

titolo step
stato manca | pronto | completato | bloccato | da rivedere
ultima data evento
utente ultima azione
documento principale
unica azione successiva consigliata

Colori raccomandati:

grigio: non iniziato
blu: pronto
verde: completato
giallo: da rivedere
rosso: bloccato o incoerente

Testata Pratica¶

La testata deve mostrare solo dati essenziali:

condominio
amministratore
trattativa
offerta
richiesta RAS
stato aggregato
esito amministrativo

Modale Documenti¶

Ogni step deve aprire un modale dedicato, non un editor libero.

Il modale deve mostrare solo il necessario per quello step:

documenti attesi
documenti presenti
checklist breve
cronologia minima
azioni disponibili

Per ogni documento:

stato manca | presente | aggiornato
data caricamento
utente
bottoni Apri | Carica | Sostituisci

Documenti Per Step¶

1. Richiesta¶

Documenti:

richiesta RAS o modulo iniziale
eventuali allegati iniziali

Checklist minima:

cliente presente
amministratore presente
condominio presente
servizio RAS corretto

Azioni:

aggancia richiesta esistente
crea richiesta da configurazione
correggi collegamenti anagrafici

2. Offerta¶

Documenti:

PDF offerta
preventivo / modulo ordine

Checklist minima:

offerta creata
documento offerta apribile
preventivo agganciato alla trattativa
documento offerta allineato

Azioni:

genera PDF offerta
crea preventivo da offerta
riallinea documento offerta
invia amministratore

3. Firma¶

Documenti:

firmato commerciale

Checklist minima:

firmato ricevuto
firmato apribile
firmato collegato all'offerta corretta

Azioni:

carica firmato
sostituisci firmato
apri firmato

4. Chiusura Commerciale¶

Documenti:

preventivo
firmato
eventuali note amministrative di chiusura

Checklist minima:

offerta in accettata
trattativa in chiusa_vinta
riferimenti documentali coerenti

Azioni:

marca offerta accettata
chiudi commercialmente
aggancia richiesta RAS

5. Consegna Incarico Tecnico¶

Documenti:

lettera o documento di incarico
ticket o riferimento operativo

Checklist minima:

chiusura commerciale completa
oggetto operativo creato
incarico tecnico collegato alla pratica corretta

Azioni:

crea incarico tecnico
collega incarico esistente
apri dettaglio incarico

Checklist Semplificata¶

La checklist deve essere breve e comprensibile.

Campi V1:

richiesta agganciata
offerta presente
preventivo presente
firmato presente
chiusura commerciale fatta
incarico tecnico creato

Regola:

la checklist non sostituisce i dati
serve a rendere evidente il prossimo passo corretto

Azioni Guidate¶

Ogni step deve esporre una sola CTA primaria.

Esempi:

Completa richiesta
Prepara offerta
Carica firmato
Chiudi commercialmente
Consegna al tecnico

Azioni secondarie:

apri documenti
sostituisci documento
riallinea collegamenti

Rollback Guidato¶

La V1 include un rollback semplice per operatore, ma solo di step.

Non deve esistere un undo generico.

Regola Base¶

Pulsante:

Torna allo step precedente

Effetto:

riapre lo step precedente
marca lo step attuale come da rivedere
non cancella documenti
non elimina riferimenti in modo distruttivo

Rollback Consentiti¶

Offerta -> Richiesta
Firma -> Offerta
Chiusura commerciale -> Firma
Consegna incarico tecnico -> Chiusura commerciale

Campi Obbligatori¶

motivo rollback
utente
timestamp

Casi Bloccati¶

Il rollback diretto va bloccato se:

l'incarico tecnico e gia preso in carico
esistono attivita tecniche gia avviate
esistono esiti finali gia emessi

In questi casi:

mostrare Rollback non disponibile
suggerire Richiedi intervento amministrativo

Audit¶

Ogni azione mutativa deve scrivere audit strutturato:

pratica
trattativa
richiesta
offerta
azione
utente
motivo se presente
before
after

Riallineamento Offerte Produzione¶

La V1 deve nascere insieme a una pulizia controllata delle offerte RAS gia in produzione.

Obiettivo¶

Ridurre i casi incoerenti che oggi falsano la lettura del workflow:

firmato presente ma offerta non accettata
documento offerta non allineato
richiesta RAS mancante o non collegata
trattativa non chiusa nonostante firmato reale

Classi Di Riallineamento¶

chiudibili subito
firmato reale presente
preventivo presente
offerta da portare in accettata
trattativa da chiudere in chiusa_vinta
riallineamento documentale
trattativa con preventivo
offerta senza documento_id
aggancio richiesta
offerta presente
richiesta mancante o scollegata
casi sporchi da analisi
mancano piu oggetti
piu offerte sulla stessa trattativa
firmato presente senza catena coerente

Strategia Operativa¶

usare il Monitor RAS per classificare la coda
chiudere prima i casi chiudibili
riallineare poi i casi documentali
gestire uno a uno i casi con richiesta mancante
lasciare separati i casi anomali complessi

Vincolo¶

Nessun backfill massivo distruttivo senza backup e audit.

Piano Implementativo¶

Fase 1¶

specifica finale workflow
definizione stati step
definizione documenti per step
definizione permessi

Fase 2¶

backend resolver pratica pipeline
endpoint azioni guidate
endpoint rollback guidato
audit

Fase 3¶

UI pipeline
modali documenti
checklist semplificata

Fase 4¶

uso operativo su coda produzione
riallineamento offerte esistenti
affinamento testi e semafori

Decisione¶

La direzione corretta non e aggiungere altri bottoni sparsi alle viste esistenti.

La soluzione corretta e:

una pipeline unica
modali documenti per step
checklist breve
rollback guidato
coda di riallineamento produzione governata nella stessa logica