Proposal Review

Pattern canonico per rendere comprensibile una proposta di modifica prima che l’utente decida come rispondere.

Prima il cambiamento, poi la decisione

Una proposal review non è una card amministrativa e non è ancora il passaggio di conferma finale. Deve permettere di capire che cosa viene proposto, quale confronto è affidabile e quali conseguenze sono state dichiarate prima di presentare le azioni disponibili.

Presentazione derivata dallo snapshot

Nel Workspace il presenter valida lo snapshot corrente e produce sintesi, confronti e dettagli leggibili. Gli importi usano il formatter condiviso del pattern Money; lo stato usa il presentation layer documentato in Status Presentation. Sirio usa gli stessi componenti e formatter generici, senza importare servizi o creare un secondo mapper di dominio.

Gerarchia della review

L’ordine di lettura resta stabile anche quando alcuni dati facoltativi non sono presenti.

  1. 1. Che cosa cambiaApri con una sintesi concreta della modifica e con la motivazione fornita dalla parte che la propone.
  2. 2. Rispetto a cosaMostra Prima e Proposto soltanto quando la proposta conserva una baseline affidabile nello stesso snapshot.
  3. 3. Conseguenze realiRendi leggibili impatto economico, tempi e condizioni presenti, senza dedurre effetti ulteriori.
  4. 4. Azioni disponibiliIndica chi deve intervenire e mostra soltanto le azioni realmente consentite sulla proposta corrente.

Specimen canonici

I contenuti sono dimostrativi ma rispettano i campi e i fallback del flusso proposte reale. Le azioni sono descritte come gerarchia informativa: il pattern generale di conferma finale resta separato.

Proposta con variazione economica

Proposta dell’Azienda
Proposta inviata

Che cosa cambia

Sostituire il rivestimento previsto con gres porcellanato.

Motivazione
Il materiale indicato inizialmente non è più disponibile.

Cosa cambia rispetto a prima

Importo
Prima

1.250,00 €

Proposto

1.500,00 €

Aumento proposto: +250,00 €

Conseguenze indicate

Condizioni proposte
La sostituzione riguarda soltanto il rivestimento indicato.

Azioni disponibili nella vista operativa

Azione principale
Accetta la proposta mostrata
Alternative
Rifiuta questa proposta · Prepara controproposta

Proposta con impatto sui tempi

Proposta dell’Azienda
Proposta inviata

Che cosa cambia

Posticipare la posa dei serramenti.

Motivazione
Il fornitore ha comunicato una nuova data di consegna.

Conseguenze indicate

Nuova conclusione prevista
15 ott 2026, 09:30
Impatto sui tempi
Conclusione prevista una settimana più tardi.
Variazione economica
Nessuna variazione economica proposta.

Azioni disponibili nella vista operativa

Azione principale
Accetta la proposta mostrata
Alternative
Rifiuta questa proposta · Prepara controproposta

Proposta con più campi modificati

Controproposta del Cliente
Controproposta presente

Che cosa cambia

Aggiornare materiali, importo indicativo e data prevista.

Motivazione
La soluzione aggiornata integra le modifiche richieste durante il sopralluogo.

Cosa cambia rispetto a prima

Importo
Prima

1.250,00 €

Proposto

1.400,00 € – 1.600,00 €

Conseguenze indicate

Nuova conclusione prevista
22 ott 2026, 17:00
Impatto sui tempi
La conclusione prevista si sposta alla settimana successiva.
Condizioni proposte
Il materiale sarà scelto tra le finiture già condivise dalle parti.

Azioni disponibili nella vista operativa

Azione principale
Accetta la proposta mostrata
Alternative
Rifiuta questa proposta · Prepara controproposta

Proposta senza baseline confrontabile

Proposta dell’Azienda
Proposta inviata

Che cosa cambia

Aggiungere una lavorazione non inclusa nel riepilogo precedente.

Motivazione
La lavorazione è emersa dopo l’apertura della parete.

Non è disponibile un importo precedente affidabile: viene mostrata soltanto la variazione proposta.

Conseguenze indicate

Variazione economica proposta
+250,00 €

Azioni disponibili nella vista operativa

Azione principale
Accetta la proposta mostrata
Alternative
Rifiuta questa proposta · Prepara controproposta

Confrontare solo ciò che è confrontabile

Nel flusso corrente la baseline economica può essere inclusa nella proposta. Solo in quel caso importo precedente e importo proposto formano un vero confronto Prima/Proposto.

Se la baseline manca, mostra la variazione o l’intervallo come valore proposto. Per tempi e condizioni mostra i nuovi dati dichiarati senza ricostruire uno stato precedente da fonti mutabili esterne allo snapshot.

Dati realmente supportati

Mostra tutti e soli i dati presenti che aiutano a comprendere la proposta corrente.

Sintesi e motivazione
Sono sempre richieste dal payload corrente e formano il nucleo della review.
Importo
Può essere nessuna variazione, una variazione fissa oppure un intervallo. La baseline economica è facoltativa.
Tempi
Possono includere una nuova conclusione prevista e una descrizione dell’impatto; oggi non esiste una baseline temporale confrontabile nello snapshot.
Condizioni
Compaiono solo quando sono presenti; non vengono sostituite da righe vuote o formule generiche.
Parte e data
La parte rappresentata e la data possono contestualizzare la proposta. Il nome della persona compare soltanto se è già risolto dalla sorgente.
Stato
Usa la label umana del presentation layer, separata dalla disponibilità delle azioni.

Gli step interessati e le persone coinvolte sono conservati come riferimenti nello snapshot, ma non vanno mostrati finché la sorgente della review non li risolve in nomi umani. Un riferimento interno non è copy.

Responsive e accessibilità

La review deve restare leggibile nello stesso ordine con tastiera, screen reader e viewport ridotti.

  • Mantieni un heading per ogni proposta e sottosezioni nell’ordine: modifica, confronto, conseguenze, azioni.
  • Usa liste descrittive per coppie Prima/Proposto, dettagli e metadati; non simulare tabelle con testo separato da spazi.
  • Lascia andare a capo valori, condizioni e date su viewport stretti; non troncare importi o focus ring delle azioni reali.
  • Il badge di stato conserva sempre una label testuale e non comunica significato soltanto con colore o icona.
  • Le azioni operative devono seguire il focus order della review e restare associate alla proposta mostrata.
  • Un aggiornamento obsoleto viene spiegato con testo umano; ID, numero di versione e dettagli tecnici restano interni.

Errori da evitare

Una review fedele non espone il modello dati e non amplia il significato della proposta.

  • Aprire con numero di versione, stato tecnico o identificatore invece che con il contenuto della modifica.
  • Inventare un valore Prima quando la baseline non appartiene allo snapshot della proposta.
  • Mostrare contemporaneamente campi invariati che non aiutano la decisione.
  • Renderizzare dati salvati, proprietà backend o importi nel formato interno.
  • Affidare aumento, riduzione o stato soltanto a verde, rosso o posizione visiva.
  • Presentare accettazione, rifiuto o controproposta come disponibili quando la sorgente non le consente.
  • Aggiungere conseguenze contrattuali, legali o economiche che il dominio non registra.