Flusso di lavoro Discourse

:information_source: Riepilogo Un sistema di flusso di lavoro basato su argomenti per Discourse con passaggi configurabili, azioni, filtri per l’elenco dei flussi di lavoro e visualizzazione 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, mettilo con una :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 attraversano tali passaggi fino al completamento.

Supporta ramificazioni e cicli, viste di scoperta tramite elenco e Kanban, verificabilità e comportamento adatto all’automazione pur rimanendo vicino alle autorizzazioni e ai modelli di interfaccia utente di base di Discourse.

Funzionalità

  • Istanze di flusso di lavoro basate su argomenti con Flussi di lavoro, Passaggi e Opzioni di passaggio definiti dall’amministratore
  • Costruito su concetti di base di Discourse: Categorie, Gruppi e autorizzazioni basate su categorie - puoi agire solo se sei autorizzato a farlo
  • Scoperta del flusso di lavoro su /workflow con filtri rapidi:
    • Le mie Categorie
    • In ritardo
    • Passaggio = X
  • Selettore di visualizzazione di scoperta:
    • Elenco
    • Kanban (mostrato solo per un singolo contesto di flusso di lavoro compatibile con Kanban)
    • Grafico (mostrato solo per un contesto di flusso di lavoro singolo e utenti autorizzati al grafico)
  • Bacheca del flusso di lavoro Kanban:
    • schede argomento cliccabili
    • transizioni drag/drop legali
    • transizioni da tastiera (FrecciaSinistra / FrecciaDestra) quando legali
  • Banner dell’argomento del flusso di lavoro:
    • flusso di lavoro e passaggio correnti
    • azioni di transizione disponibili
    • link di visualizzazione
  • Modello di ritardo con gerarchia:
    • impostazione globale: workflow_overdue_days_default
    • override del flusso di lavoro
    • override del passaggio
    • 0 disabilita il ritardo in tale ambito
    • indicatori di ritardo nell’elenco dei flussi di lavoro e nelle schede Kanban
  • Grafico di burn-down del flusso di lavoro:
    • endpoint del grafico + integrazione UI
    • selettore intervallo di settimane (1–12)
    • finestre settimanali complete e serie colorate per passaggio
  • Traccia di controllo delle transizioni tramite piccoli post di azione
  • Notifiche di arrivo per le categorie seguite (Segui Primo Post)
  • Visualizzazione del flusso di lavoro disponibile dalle viste argomento e di scoperta
  • Integrazione con Data Explorer con query predefinite per il flusso di lavoro:
    • statistiche di burn-down/burn-up
    • registro di controllo
  • Gestione dei passaggi assistita dall’IA opzionale

Concetti Introduttivi

Corsie di Scorrimento (Swim Lanes)

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

Istanze di Flusso di Lavoro

  • Un singolo elemento di flusso di lavoro (ad esempio, un ticket) è un Argomento.
  • È possibile aggiungere tag per metadati come la priorità.
  • Il movimento della categoria è controllato dalle azioni del flusso di lavoro (a meno che lo staff non esegua l’override).

Attori

Gli utenti che possono creare argomenti nella categoria di un 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 viene mostrata come un pulsante di azione dell’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 puoi accedere, quindi filtra o passa a Kanban per la gestione del flusso in stile bacheca.

Traccia di Controllo (Audit Trail)

Le transizioni vengono registrate come piccoli post di azione sull’argomento. Le query raggruppate di Data Explorer supportano la verifica e la reportistica operativa.

Visualizzazione

La visualizzazione del flusso di lavoro è disponibile da:

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

Principali Differenze rispetto a Discourse Standard

  • Non è possibile creare un nuovo argomento direttamente nelle categorie oltre il passaggio 1 di un flusso di lavoro.
  • Non è possibile modificare manualmente la categoria per un argomento di flusso di lavoro a meno che non si sia staff.
  • Solo gli utenti con diritti di creazione di categoria possono eseguire transizioni di flusso di lavoro.

Per Iniziare

  1. Abilita il plugin con workflow_enabled.
  2. Vai su Amministrazione → Plugin → Discourse Workflow.
  3. Crea un Flusso di lavoro, salvalo, quindi aggiungi Passaggi e Opzioni di Passaggio.
  4. Configura le autorizzazioni di categoria in modo che gli attori del flusso di lavoro abbiano la possibilità di Creare nelle categorie di passaggio pertinenti.
  5. Crea un argomento nella categoria del primo passaggio.
  6. Trasferiscilo utilizzando i pulsanti di azione dell’argomento o le interazioni Kanban.
  7. Usa /workflow per la gestione della coda operativa.

Azioni IA

L’IA può eseguire un passaggio quando configurata.

Requisiti:

  • workflow_openai_api_key valido
  • IA 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, per favore accetta, altrimenti rifiuta. {{topic}} rispondi con una sola parola da quelle opzioni

Problemi Noti

Questo plugin è ancora in evoluzione. Si prega di segnalare problemi e idee di miglioramento sul repository o su 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:

2 Mi Piace