Vesadoc Task Policy Data 7 Maggio 2026 Versione 1.0 Stato Proposta

Policy Task e Permessi Operatori

Stato attuale delle autorizzazioni sui task in Vesadoc, problemi riscontrati, e proposta di modifica per allineare il software al flusso di lavoro reale degli operatori.

Flusso degli stati di un task

In attesa → Aperto → Da fatturare → Fatturato

Ogni task segue questo percorso lineare. Lo stato "Annullato" può essere impostato da qualsiasi punto del flusso (solo ufficio).

Ruoli e utenti

Ufficio

  • Alice Bonetti — Segreteria
  • Maurizio Bonetti — Direzione
  • Matteo — Amministrazione
  • Superadmin — Sistema

Operatori

  • Marco Catenazzi
  • Mauro
  • Davide Bartolomeo
  • Silvia
  • + altri operatori sul campo

Matrice permessi — stato attuale

Problema: Gli operatori non riescono a portare i task da "Aperto" a "Da fatturare" in alcuni casi. Il sistema restituisce errore 500 (Policy error). Il bug è presente da marzo 2026.
Transizione Operatore assegnato Assistente Ufficio Note
In attesa → Aperto SÌ SÌ SÌ Nessuna restrizione
Aperto → Da fatturare SÌ SÌ SÌ Funziona, ma con bug collaterale
Da fatturare → Fatturato NO NO SÌ Solo ufficio, corretto
Fatturato → Da fatturare NO NO NO Bloccato per tutti, nessun rollback
Da fatturare → Aperto NO NO NO Bloccato, nessuna riapertura
Qualsiasi → Annullato NO NO SÌ Solo ufficio

Bug riscontrati

Bug 1 — Salvataggio note/report (RISOLTO)

Fix applicato il 6 maggio 2026. Quando un operatore salvava un task (note, report, qualsiasi modifica), il sistema restituiva errore SQL "Column trainings not found". Causa: il framework Livewire settava dati di relazione come attributi del modello. Risolto con pulizia automatica prima del salvataggio.

Bug 2 — Chiusura task bloccata per Marco (DA RISOLVERE)

In analisi. Marco non riesce a chiudere alcuni task (errore "Policy error: can't change status from paid to closed"). Succede quando il task è già stato marcato come "Fatturato" e si tenta di riportarlo a "Da fatturare". Mauro e Davide non hanno lo stesso problema perché lavorano su task in stato "Aperto" oppure usano un percorso alternativo (passando dalla vista cliente).

Attuale vs. Proposta

Proposta di modifica per allineare i permessi al flusso operativo reale.

Oggi
  • Un task "Fatturato" non può tornare indietro per nessuno
  • Un task "Da fatturare" non può essere riaperto
  • Se l'ufficio segna "Fatturato" per errore, nessuno può correggere
  • Gli operatori devono aggirare il sistema passando dalla vista cliente
Proposta
  • L'ufficio può riportare un task da "Fatturato" a "Da fatturare"
  • L'ufficio può riaprire un task "Da fatturare" (riportarlo ad "Aperto")
  • Gli operatori continuano a poter chiudere solo i task "Aperti" a loro assegnati
  • Tutte le transizioni "all'indietro" richiedono ruolo Ufficio

Matrice permessi — proposta

Transizione Operatore assegnato Assistente Ufficio Direzione
In attesa → Aperto SÌ SÌ SÌ SÌ
Aperto → Da fatturare SÌ SÌ SÌ SÌ
Da fatturare → Fatturato NO NO SÌ SÌ
Fatturato → Da fatturare NO NO NUOVO NUOVO
Da fatturare → Aperto NO NO NUOVO NUOVO
Qualsiasi → Annullato NO NO SÌ SÌ
Principio: Avanti possono andare tutti (nei limiti del proprio ruolo). Indietro solo l'ufficio. Questo permette correzioni senza aprire la porta a errori degli operatori.

Cronologia

Settembre 2025
Ultimo deploy con la policy task attuale (release 20251001)
Novembre 2025
Riunione revisione: Marco segnala errore 500 sulla chiusura task. Giobi riconosce che l'autorizzazione è sbagliata. Bug trainings segnalato nella stessa sessione.
Marzo 2026
Migrazione da Cloudways a Tanuki (Hetzner). I bug permangono perché il codice è lo stesso.
6 Maggio 2026
Alice Bonetti segnala: operatori completamente bloccati. Bug trainings risolto. Bug policy ancora aperto.
7 Maggio 2026
Analisi completa, proposta nuova matrice permessi. In attesa approvazione.

Prossimi passi

Azione Chi Stato
Fix bug trainings (salvataggio note) Giobi Fatto
Approvazione nuova matrice permessi Maurizio / Alice In attesa
Implementazione nuove transizioni (paid→closed, closed→open) Giobi Dopo approvazione
Test su staging Giobi + Alice Dopo implementazione
Deploy in produzione Giobi Dopo test