Gestore del processo di workflow ↔

:information_source: Riepilogo Un plugin di gestione dei processi per Discourse che sposta il lavoro attraverso passaggi configurabili con azioni, filtri di elenco, grafici, visualizzazioni a corsie e board Kanban.
:hammer_and_wrench: Link al repository https://github.com/merefield/discourse-workflow
:open_book: Guida all’installazione Come installare i plugin in Discourse

Ti piace questo plugin? Per favore :star: su GitHub! :pray:

Riepilogo

discourse-workflow fornisce un framework di flusso di lavoro sicuro per gli argomenti. Ogni flusso di lavoro è composto da passaggi e opzioni configurabili, e gli argomenti si spostano attraverso questi passaggi fino al completamento.

Supporta ramificazioni e loop, visualizzazioni di scoperta a elenco e Kanban, auditabilità e comportamenti adatti all’automazione, rimanendo vicino alle autorizzazioni e ai pattern UI di base di Discourse.

Funzionalità

  • Istanze di flusso di lavoro basate su argomenti con Flussi di lavoro, Passaggi e Opzioni di passaggio definiti dagli amministratori
  • Basato sui concetti fondamentali di Discourse: Categorie, Gruppi e autorizzazioni basate sulle categorie: puoi agire solo se ne hai il permesso
  • Scoperta del flusso di lavoro in /workflow con filtri rapidi:
    • Le mie categorie
    • Scaduti
    • Passaggio = X
  • Selettore di visualizzazione di scoperta:
    • Elenco
    • Kanban (visualizzato solo per un contesto di flusso di lavoro singolo compatibile con Kanban)
    • Grafico (visualizzato solo per contesto di flusso di lavoro singolo e utenti autorizzati ai grafici)
  • Board Kanban del flusso di lavoro:
    • card di argomento cliccabili
    • transizioni di trascinamento/rimozione legali
    • transizioni da tastiera (ArrowLeft / ArrowRight) quando legali
  • Banner dell’argomento del flusso di lavoro:
    • flusso di lavoro e passaggio attuali
    • azioni di transizione disponibili
    • link di visualizzazione
  • Modello di scadenza con gerarchia:
    • impostazione globale: workflow_overdue_days_default
    • override del flusso di lavoro
    • override del passaggio
    • 0 disabilita la scadenza a quel livello
    • indicatori di scadenza nell’elenco del flusso di lavoro e nelle card Kanban
  • Grafici di burn-down del flusso di lavoro:
    • endpoint grafico + integrazione UI
    • selettore intervallo settimanale (1–12)
    • finestre settimanali complete e serie colorate per passaggio
  • Traccia di audit delle transizioni tramite piccoli post di azione
  • Notifiche di arrivo per le categorie seguite (Watch First Post)
  • Visualizzazione del flusso di lavoro disponibile da argomenti e visualizzazioni di scoperta
  • Integrazione con Data Explorer con query predefinite per flussi di lavoro:
    • statistiche burn-down/burn-up
    • registro di audit
  • Gestione dei passaggi assistita da AI opzionale

Concetti introduttivi

Corsie

Ogni corsia del flusso di lavoro è una Categoria (o Sottocategoria). Mentre un argomento progredisce, si sposta tra le categorie in base alle transizioni configurate.

Istanze di flusso di lavoro

  • Un singolo elemento del flusso di lavoro (ad esempio, un ticket) è un Argomento.
  • I tag possono essere aggiunti per metadati come la priorità.
  • Il movimento tra le categorie è controllato dalle azioni del flusso di lavoro (a meno che non vi sia un intervento del personale).

Attori

Gli utenti che possono creare argomenti in una categoria di passaggio possono agire sugli elementi del flusso di lavoro in quel passaggio. Gli utenti con accesso alla risposta possono comunque commentare normalmente.

Azioni tramite Opzioni

Le Opzioni di passaggio definiscono le azioni disponibili in ogni passaggio. Ogni opzione è visualizzata come un pulsante di azione sull’argomento e può spostare l’argomento a un passaggio di destinazione.

Dashboard

Usa il filtro di navigazione /workflow per vedere gli argomenti del flusso di lavoro a cui hai accesso, quindi filtra o passa a Kanban per una gestione del flusso in stile board.

Traccia di audit

Le transizioni vengono registrate come piccoli post di azione sull’argomento. Le query Data Explorer incluse supportano l’audit e i report operativi.

Visualizzazione

La visualizzazione del flusso di lavoro è disponibile da:

  • link del banner dell’argomento
  • campi del flusso di lavoro nell’elenco di scoperta

Differenze principali rispetto a Discourse standard

  • Non puoi creare un nuovo argomento direttamente nelle categorie oltre il primo passaggio di un flusso di lavoro.
  • Non puoi modificare manualmente la categoria di un argomento del flusso di lavoro a meno che tu non sia personale.
  • Solo gli utenti con diritti di creazione nella categoria possono eseguire le transizioni del flusso di lavoro.

Per iniziare

  1. Abilita il plugin con workflow_enabled.
  2. Vai su Admin → Plugins → Discourse Workflow.
  3. Crea un Flusso di lavoro, salvalo, poi aggiungi Passaggi e Opzioni di passaggio.
  4. Configura le autorizzazioni delle categorie in modo che gli attori del flusso di lavoro abbiano il diritto di Creare nelle categorie di passaggio pertinenti.
  5. Crea un argomento nella prima categoria di passaggio.
  6. Trasformalo usando i pulsanti di azione sull’argomento o le interazioni Kanban.
  7. Usa /workflow per la gestione della coda operativa.

Azioni AI

L’AI può eseguire un passaggio quando configurato.

Requisiti:

  • workflow_openai_api_key valido
  • AI abilitata sul passaggio
  • il prompt include sia {{options}} che {{topic}}

Esempio di prompt:

le tue opzioni sono {{options}}. se il testo seguente afferma che è delizioso, accetta, altrimenti rifiuta. {{topic}} rispondi con una parola tra quelle opzioni

Problemi noti

Questo plugin è ancora in evoluzione. Segnala problemi e idee di miglioramento sul repository o in questo argomento Meta.

26 Mi Piace

Riceve un po’ d’amore.

4 Mi Piace

Sono state distribuite alcune correzioni:

2 Mi Piace

Rende la visualizzazione più pratica su dispositivi mobili:

  • MIGLIORAMENTO: L’elenco argomenti Workflow funziona benissimo su desktop, ma su mobile è troppo largo, quindi invece di aggiungere tutte quelle colonne su mobile, aggiungi un badge Workflow al Titolo e limita l’intero set di colonne ai dispositivi desktop.
2 Mi Piace

alcune modifiche minori ma importanti.

1 Mi Piace

Ciao Robert,

Sto sperimentando con il plugin workflow, senza AI. Questo è un semplice workflow destinato ad essere utilizzato come catena di supporto per un linux cafe che aiuta le persone a migrare da Windows. Nuovi argomenti vengono creati tramite email RFC 6233 con subaddressing e arrivano nella prima sottocategoria (livello1).

Due problemi:

  1. Gli ID dei passaggi del workflow non sono univoci. Ho tre passaggi con lo stesso ID. ??
  2. Un’azione “start” sull’argomento in arrivo crea “422 contenuto non processabile”. Forse è un risultato di 1)
3 Mi Piace

Grazie per la pazienza e per il tuo feedback. Apprezzo il tuo interesse per il plugin.

È un po’ sperimentale e, come puoi vedere, non ha ancora ricevuto molti feedback, quindi ci saranno sicuramente dei problemi iniziali.

Cercherò di ricreare il tuo flusso di lavoro e di tentare di ricreare il problema.

Nel frattempo, puoi fare uno screenshot del flusso di lavoro nella schermata di amministrazione e condividerlo?

@Thomas_Rother hai una traccia dello stack per questo?

3 Mi Piace

Ciao Robert,
nessun problema, sono consapevole che si tratta di una versione sperimentale. Pertanto è installata solo su un’istanza di test self-hosted. Puoi registrarti lì e potrei darti i permessi di amministratore:

https://forum2.netzwissen.de/login

2 Mi Piace

OK, come esempio pratico, ecco come ho proceduto:

  • Impostazione della categoria Biglietti Internet Cafe
  • Impostazione di tutti i passaggi come Sottocategorie, con il seguente risultato:

Fin qui tutto bene.

Ora creiamo i passaggi:

OK, vedo almeno due problemi! (Ma uno dei due è probabilmente causato dall’altro)

È strano perché ero sicuro che prima funzionasse. Ci sto dando un’occhiata ora e, se avrò tempo, rilascerò presto una correzione.

3 Mi Piace

@Thomas_Rother prova questo:

(Potrebbe essere necessario eliminare e ricreare i passaggi interessati)

2 Mi Piace

Quali sono i casi d’uso più comuni per questo plugin e funziona con Gemini flash 2.0?

Qualsiasi processo aziendale (entro limiti ragionevoli) con più passaggi e attori. Potrebbe richiedere un’estensione per integrazioni specifiche.

Attualmente funziona solo con OpenAI, ma le PR sono ben accette (utilizza Chat Completions, quindi non è un lavoro enorme).

1 Mi Piace

Grandi novità: ora puoi ottenere le statistiche per creare grafici burn-up/down:

  • Aggiunge un processo giornaliero per creare statistiche sul conteggio degli stati che puoi utilizzare nei grafici burndown/burnup.
  • Aggiunge un processo che verifica la presenza o aggiunge due utili query Data Explorer
    • Registro di controllo per tutte le transizioni
    • Conteggi giornalieri per le istanze di workflow in ogni fase del loro workflow, facilitando i grafici burndown/up (basta esportare i risultati).
    • Puoi concedere a gruppi specifici l’accesso a questi report.

Nota: Discourse Workflow è ora compatibile solo con test superati per il momento a causa delle modifiche nel modo in cui vengono gestite le dipendenze delle gem come parte del principale raggruppamento di plugin. Questo dovrebbe cambiare al momento del prossimo rilascio stabile.

4 Mi Piace

Sto cercando di capire perché il mio sito è diventato lento…

Avviso di deprecazione

[PLUGIN discourse-workflow] Avviso di deprecazione: L’accesso a site.mobileView o site.desktopView durante la fase di inizializzazione del sito è deprecato. Nei futuri aggiornamenti, la modalità mobile sarà determinata dalle dimensioni della viewport e di conseguenza l’utilizzo di questi valori durante l’inizializzazione può portare a errori e incongruenze quando la finestra del browser viene ridimensionata. Si prega di spostare questi controlli in un componente, transformer o callback API che viene eseguito durante il rendering della pagina. [deprecato da Discourse 3.5.0.beta9-dev] [id deprecazione: discourse.static-viewport-initialization] [info: Designing for Different Devices (Viewport Size, Touch/Hover, etc.)] deprecated.js:62:13

Dubito molto che questo stia causando il rallentamento del tuo sito!! :laughing: - è un avviso di deprecazione.

attendo con ansia il tuo PR :slight_smile:

1 Mi Piace

Beh, non dovrebbe essere dovuto a Discourse Workflow poiché ho risolto diversi problemi N+1, inclusi quelli nella Lista Argomenti e nella Visualizzazione:

ecc.

3 Mi Piace

Grande aggiornamento con diverse nuove funzionalità, tra cui

  • Nuovi filtri per l’elenco degli argomenti specifici del flusso di lavoro
  • Segnalazione “In ritardo”
  • Metainformazioni più ricche sul flusso di lavoro degli argomenti
1 Mi Piace

Aggiornamento enorme:

Nuova vista Kanban:

  • Aggiunta una modalità Kanban completa in /workflow con un interruttore Elenco/Kanban, visualizzato solo quando è nell’ambito un singolo flusso di lavoro compatibile con Kanban.
    • Introdotta la convalida esplicita della compatibilità Kanban (inclusa la mappatura deterministica a un bordo) e visualizzato lo stato di compatibilità nell’amministrazione del flusso di lavoro.
  • Resi gli elementi del flusso di lavoro azionabili da Kanban: trascinamento della selezione tra passaggi legali, spostamenti di passaggio tramite tastiera con i tasti freccia e clic per aprire gli argomenti.
  • Migliorata l’affidabilità per gli aggiornamenti concorrenti: le transizioni obsolete ora restituiscono 409, mostrano un messaggio di stato obsoleto chiaro e attivano l’aggiornamento per risincronizzare lo stato dell’interfaccia utente.
  • Usabilità e chiarezza della bacheca: tag Kanban opzionali a livello di flusso di lavoro, supporto per l’indicatore di scadenza sulle schede e stile delle corsie, inclusi i bordi delle colonne colorati per categoria.
5 Mi Piace

Un altro grande aggiornamento: grafico burn-up/down online (come gradevole alternativa alla query Data Explorer inclusa esistente)

  • Aggiunta una nuova visualizzazione Grafico del flusso di lavoro in discovery con un selettore di visualizzazione condiviso (Elenco / Kanban / Grafico) e controllo del periodo (da 1 a 12 settimane).
    • Implementata l’API dei dati burn-down a /discourse-workflow/charts.json più l’integrazione del percorso /workflow/charts.
    • L’accesso al grafico è autorizzato separatamente: amministratori e gruppi workflow_charts_allowed_groups; il grafico è nascosto agli utenti non autorizzati.
    • Il payload del grafico è stato ristretto solo al contesto del flusso di lavoro selezionato (selected_workflow_id, selected_workflow_name, series), rimuovendo la superficie del catalogo dei flussi di lavoro non utilizzata.
    • Aggiunta copertura di richiesta/sistema e rafforzamento dell’UX: finestre di settimana intera, etichette degli assi sicure per le date locali, etichettatura accessibile del selettore di visualizzazione e controlli di regressione del rendering/stato del grafico.

La funzionalità di creazione di grafici dovrebbe essere compatibile con tutti i flussi di lavoro:

  • Il grafico non richiede la compatibilità con Kanban, quindi funziona per i flussi di lavoro che non sono compatibili con Kanban.
    • Il grafico viene visualizzato solo quando l’elenco del flusso di lavoro corrente è limitato a un solo flusso di lavoro.
    • L’utente deve disporre dell’autorizzazione per il grafico (amministratore o nei gruppi workflow_charts_allowed_groups).
    • Se è compatibile con Kanban, il menu a discesa mostra Elenco/Kanban/Grafico.
    • Se non è compatibile con Kanban, il menu a discesa può comunque mostrare Elenco/Grafico (quando le due condizioni precedenti sono soddisfatte).
3 Mi Piace

Ho eseguito un’importante revisione delle prestazioni:

4 Mi Piace