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 Nessuna restrizione
Aperto → Da fatturare Funziona, ma con bug collaterale
Da fatturare → Fatturato NO NO 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 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
Aperto → Da fatturare
Da fatturare → Fatturato NO NO
Fatturato → Da fatturare NO NO NUOVO NUOVO
Da fatturare → Aperto NO NO NUOVO NUOVO
Qualsiasi → Annullato NO NO
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