Discourse Workflow

:information_source: Zusammenfassung Ein themenbasiertes Workflow-System für Discourse mit konfigurierbaren Schritten, Aktionen, Workflow-Listenfiltern und Kanban-Ansicht
:hammer_and_wrench: Repository-Link https://github.com/merefield/discourse-workflow
:open_book: Installationsanleitung Plugins in Discourse installieren

Gefällt Ihnen dieses Plugin? Bitte :star: Sie es auf GitHub! :pray:

Zusammenfassung

discourse-workflow bietet ein sicheres Workflow-Framework für Themen. Jeder Workflow besteht aus konfigurierbaren Schritten und Optionen, und Themen durchlaufen diese Schritte bis zum Abschluss.

Es unterstützt Verzweigungen und Schleifen, Listen- und Kanban-Entdeckungsansichten, Prüfbarkeit und automatisierungsfreundliches Verhalten, während es sich eng an die Kernberechtigungen und UI-Muster von Discourse hält.

Funktionen

  • Themenbasierte Workflow-Instanzen mit von Administratoren definierten Workflows, Schritten und Schrittoptionen
  • Basiert auf Kernkonzepten von Discourse: Kategorien, Gruppen und kategorienbasierte Berechtigungen – Sie können nur handeln, wenn Sie dazu berechtigt sind
  • Workflow-Entdeckung unter /workflow mit Schnellfiltern:
    • Meine Kategorien
    • Überfällig
    • Schritt = X
  • Ansichtsauswahl für die Entdeckung:
    • Liste
    • Kanban (nur für einen einzelnen, Kanban-kompatiblen Workflow-Kontext angezeigt)
    • Diagramm (nur für einen einzelnen Workflow-Kontext und Benutzer mit Diagramm-Berechtigung angezeigt)
  • Kanban-Workflow-Board:
    • anklickbare Themenkarten
    • legale Drag/Drop-Übergänge
    • Tastaturübergänge (Pfeil links / Pfeil rechts), wenn zulässig
  • Workflow-Themenbanner:
    • aktueller Workflow und Schritt
    • verfügbare Übergangsaktionen
    • Visualisierungslink
  • Überfälligkeitsmodell mit Hierarchie:
    • globale Einstellung: workflow_overdue_days_default
    • Workflow-Überschreibung
    • Schritt-Überschreibung
    • 0 deaktiviert Überfälligkeit in diesem Bereich
    • Überfälligkeitsanzeigen in der Workflow-Liste und auf Kanban-Karten
  • Workflow-Burn-Down-Diagrammerstellung:
    • Diagramm-Endpunkt + UI-Integration
    • Wochenspektrum-Auswahl (1–12)
    • Vollwochenfenster und schrittfarbige Reihen
  • Übergangs-Audit-Trail über kleine Aktionsbeiträge
  • Ankunftsbenachrichtigungen für beobachtete Kategorien (Ersten Beitrag beobachten)
  • Workflow-Visualisierung verfügbar über Themen- und Entdeckungsansichten
  • Data Explorer-Integration mit Standard-Workflow-Abfragen:
    • Burn-Down/Burn-Up-Statistiken
    • Audit-Protokoll
  • Optionale KI-gestützte Schrittbehandlung

Einführungskonzepte

Swimlanes (Schwimmbahnen)

Jede Workflow-Lane ist eine Kategorie (oder Unterkategorie). Während ein Thema voranschreitet, bewegt es sich gemäß den konfigurierten Übergängen zwischen den Kategorien.

Workflow-Instanzen

  • Ein einzelnes Workflow-Element (zum Beispiel ein Ticket) ist ein Thema.
  • Tags können für Metadaten wie Priorität hinzugefügt werden.
  • Die Kategoriebewegung wird durch Workflow-Aktionen gesteuert (sofern nicht von Mitarbeitern überschrieben).

Akteure

Benutzer, die Themen in einer Schrittkategorie erstellen können, können auf Workflow-Elemente in diesem Schritt zugreifen. Benutzer mit Antwortzugriff können weiterhin wie gewohnt kommentieren.

Aktionen über Optionen

Schrittoptionen definieren die verfügbaren Aktionen in jedem Schritt. Jede Option wird als Themenaktionsschaltfläche angezeigt und kann das Thema zu einem Zielschritt verschieben.

Dashboard

Verwenden Sie den Navigationsfilter /workflow, um auf Workflow-Themen zuzugreifen, auf die Sie zugreifen können, und filtern Sie dann oder wechseln Sie zu Kanban für die Board-basierte Flussverwaltung.

Audit-Trail

Übergänge werden als kleine Aktionsbeiträge zum Thema protokolliert. Gebündelte Data Explorer-Abfragen unterstützen die Prüfung und operative Berichterstattung.

Visualisierung

Die Workflow-Visualisierung ist verfügbar über:

  • Links im Themenbanner
  • Workflow-Felder in der Entdeckungsliste

Wesentliche Unterschiede zu Standard-Discourse

  • Sie können kein neues Thema direkt in Kategorien erstellen, die über Schritt 1 eines Workflows hinausgehen.
  • Sie können die Kategorie eines Workflow-Themas nicht manuell ändern, es sei denn, Sie sind Mitarbeiter.
  • Nur Benutzer mit Berechtigung zur Themen-Erstellung können Workflow-Übergänge ausführen.

Erste Schritte

  1. Aktivieren Sie das Plugin mit workflow_enabled.
  2. Gehen Sie zu Admin → Plugins → Discourse Workflow.
  3. Erstellen Sie einen Workflow, speichern Sie ihn und fügen Sie dann Schritte und Schrittoptionen hinzu.
  4. Konfigurieren Sie die Kategorieberechtigungen so, dass Workflow-Akteure in den relevanten Schrittkategorien „Erstellen“ haben.
  5. Erstellen Sie ein Thema in der ersten Schrittkategorie.
  6. Überführen Sie es mithilfe von Themenaktionsschaltflächen oder Kanban-Interaktionen.
  7. Verwenden Sie /workflow für die operative Warteschlangenverwaltung.

KI-Aktionen

KI kann einen Schritt ausführen, wenn dies konfiguriert ist.

Anforderungen:

  • gültiger workflow_openai_api_key
  • KI ist im Schritt aktiviert
  • Der Prompt enthält sowohl {{options}} als auch {{topic}}

Beispiel-Prompt:

Ihre Optionen sind {{options}}. Wenn der folgende Text besagt, dass es köstlich ist, akzeptieren Sie bitte, andernfalls lehnen Sie ab. {{topic}} Antworten Sie mit einem Wort aus diesen Optionen

Bekannte Probleme

Dieses Plugin wird noch weiterentwickelt. Bitte melden Sie Probleme und Verbesserungsvorschläge im Repository oder in diesem Meta-Thema.

25 „Gefällt mir“

Bekommt etwas Liebe.

4 „Gefällt mir“

Ein paar Korrekturen wurden bereitgestellt:

2 „Gefällt mir“

Ermöglicht eine praktischere Ansicht auf Mobilgeräten:

  • VERBESSERN: Die Workflow-Themenliste funktioniert auf dem Desktop hervorragend, aber auf Mobilgeräten ist sie zu breit. Anstatt also all diese Spalten auf Mobilgeräten hinzuzufügen, fügen Sie dem Titel ein Workflow-Abzeichen hinzu und beschränken Sie den vollständigen Satz von Spalten auf den Desktop.
2 „Gefällt mir“

einige kleinere, aber wichtige Anpassungen.

1 „Gefällt mir“

Hallo Robert,

Ich spiele mit dem Workflow-Plugin, ohne KI. Dies ist ein einfacher Workflow, der als Support-Kette für ein Linux-Café dienen soll, das Menschen bei der Migration von Windows unterstützt. Neue Themen werden über RFC 6233-E-Mails mit Subadressierung erstellt und kommen in die erste Unterkategorie (Level 1).

Zwei Probleme:

  1. IDs der Workflow-Schritte sind nicht eindeutig. Ich habe drei Schritte mit derselben ID. ??
  2. Eine “Start”-Aktion für das eingehende Thema erzeugt “422 unprocessable content”. Vielleicht ist das ein Ergebnis von 1)
3 „Gefällt mir“

Danke für deine Geduld und dein Feedback. Ich schätze dein Interesse an dem Plugin.

Es ist ein bisschen experimentell und wie du sehen kannst, hat es noch nicht viel Feedback erhalten, daher wird es wahrscheinlich noch Anfangsschwierigkeiten geben.

Ich werde versuchen, deinen Arbeitsablauf nachzuvollziehen und das Problem nachzustellen.

In der Zwischenzeit kannst du einen Screenshot des Arbeitsablaufs im Administrationsbildschirm machen und diesen teilen?

[Zitat=“Thomas_Rother, Beitrag:6, Thema:347110”]
Eine “Start”-Aktion im eingehenden Thema erzeugt “422 unprocessable content”. Vielleicht ist das eine Folge von 1)
[/Zitat]

@Thomas_Rother, hast du einen Backtrace dazu?

3 „Gefällt mir“

Hallo Robert,
keine Sorge, mir ist bewusst, dass dies experimentell ist. Daher ist es nur auf einer selbst gehosteten Testinstanz installiert. Sie können sich dort registrieren und ich könnte Ihnen Admin-Rechte geben:

https://forum2.netzwissen.de/login

2 „Gefällt mir“

OK, hier ist eine Schritt-für-Schritt-Anleitung, wie ich vorgegangen bin:

  • Internet-Café-Tickets-Kategorie einrichten
  • Alle Schritte als Unterkategorien einrichten, was zu Folgendem führt:

Bisher alles gut.

Nun erstellen wir die Schritte:

OK, ich sehe mindestens zwei Probleme! (Aber eines davon wurde wahrscheinlich durch das andere verursacht)

Das ist seltsam, da ich sicher war, dass dies vorher funktioniert hat. Ich schaue es mir jetzt an und wenn ich Zeit habe, werde ich bald eine Korrektur veröffentlichen.

3 „Gefällt mir“

@Thomas_Rother probier das mal aus:

(Möglicherweise musst du die betroffenen Schritte löschen und neu erstellen)

2 „Gefällt mir“

Welche sind die häufigsten Anwendungsfälle für dieses Plugin und funktioniert es mit Gemini Flash 2.0?

Jeder Geschäftsprozess (im Rahmen des Zumutbaren) mit mehreren Schritten und Akteuren. Kann eine Erweiterung für spezifische Integrationen erfordern.

Aktuell nur OpenAI, aber PRs sind willkommen (es verwendet Chat Completions, also kein riesiger Aufwand).

1 „Gefällt mir“

Großartige Neuigkeiten: Sie können jetzt die Statistiken für Burn-up/Burn-down-Diagramme abrufen:

  • Fügt einen täglichen Job hinzu, um Statusanzahlstatistiken zu erstellen, die Sie in Burn-down/Burn-up-Diagrammen verwenden können.
  • Fügt einen Job hinzu, der das Vorhandensein prüft oder zwei nützliche Data Explorer-Abfragen hinzufügt
    • Audit-Protokoll für alle Übergänge
    • Tägliche Zählungen für Workflow-Instanzen in jedem Schritt ihres Workflows, was Burn-down/Burn-up-Diagramme erleichtert (exportieren Sie einfach die Ergebnisse).
    • Sie können bestimmten Gruppen Zugriff auf diese Berichte gewähren.

Hinweis: Discourse Workflow ist derzeit nur mit Tests-bestanden kompatibel, da sich die Art und Weise, wie Gem-Abhängigkeiten im Rahmen der Bündelung von Haupt-Plugins gehandhabt werden, geändert hat. Dies wird sich mit der nächsten stabilen Veröffentlichung ändern.

4 „Gefällt mir“

Ich versuche herauszufinden, warum meine Website träge geworden ist…

Veraltet-Warnung

[PLUGIN discourse-workflow] Veraltet-Hinweis: Der Zugriff auf site.mobileView oder site.desktopView während der Initialisierungsphase der Website ist veraltet. In zukünftigen Updates wird der mobile Modus durch die Größe des Viewports bestimmt und folglich können die Verwendung dieser Werte während der Initialisierung zu Fehlern und Inkonsistenzen führen, wenn das Browserfenster neu dimensioniert wird. Bitte verschieben Sie diese Prüfungen in eine Komponente, einen Transformer oder einen API-Callback, der während des Renderns der Seite ausgeführt wird. [veraltet seit Discourse 3.5.0.beta9-dev] [deprecation id: discourse.static-viewport-initialization] [info: Designing for Different Devices (Viewport Size, Touch/Hover, etc.)] deprecated.js:62:13

Ich bezweifle sehr, dass dies dazu führt, dass Ihre Seite träge wird!! :laughing: - das ist eine Deprecation Warning.

Ich freue mich auf Ihren PR :slight_smile:

1 „Gefällt mir“

Nun, das sollte nicht auf Discourse Workflow zurückzuführen sein, da ich mehrere N+1-Probleme behoben habe, u. a. in der Themenliste und der Visualisierung:

usw.

3 „Gefällt mir“

Großes Update mit mehreren neuen Funktionen, darunter

  • Workflow-spezifische Themenlistenfilter
  • „Überfällig“-Kennzeichnung
  • Reichhaltigere Workflow-Metainformationen zu Themen
1 „Gefällt mir“

Absolut riesiges Update:

Neue Kanban-Ansicht:

  • Vollständiger Kanban-Modus zu /workflow hinzugefügt, mit einer Listen-/Kanban-Umschaltung, die nur angezeigt wird, wenn ein einzelner Kanban-kompatibler Workflow im Geltungsbereich liegt.
    • Explizite Kanban-Kompatibilitätsprüfung eingeführt (einschließlich deterministischer Ein-Kanten-Zuordnung) und Kompatibilitätsstatus in der Workflow-Administration angezeigt.
  • Workflow-Elemente aus Kanban heraus aktionsfähig gemacht: Drag & Drop zwischen zulässigen Schritten, Tastatur-Schrittwechsel mit den Pfeiltasten und Durchklicken zum Öffnen von Themen.
  • Zuverlässigkeit bei gleichzeitigen Aktualisierungen verbessert: Veraltete Übergänge geben jetzt 409 zurück, zeigen eine klare Meldung zum veralteten Zustand und lösen eine Aktualisierung aus, um den UI-Zustand neu zu synchronisieren.
  • Verbesserte Benutzerfreundlichkeit und Klarheit des Boards: optionale Kanban-Tags auf Workflow-Ebene, Unterstützung für Überfälligkeitsanzeige auf Karten und Spaltenformatierung einschließlich kategoriefarbiger Spaltenränder.
4 „Gefällt mir“

Ein weiteres großes Update – ein Online-Burn-up-/Burn-down-Diagramm (als schöne Alternative zur vorhandenen gebündelten Data Explorer-Abfrage)

  • Es wurde eine neue Workflow-Diagrammansicht in Discovery mit einer gemeinsamen Ansichtsauswahl (Liste / Kanban / Diagramm) und Periodensteuerung (1–12 Wochen) hinzugefügt.
    • Implementierung der Burn-down-Daten-API unter /discourse-workflow/charts.json plus Integration des /workflow/charts-Routen.
    • Der Diagrammzugriff wird separat berechtigt: Administratoren und workflow_charts_allowed_groups; das Diagramm wird vor nicht autorisierten Benutzern verborgen.
    • Die Diagrammnutzlast wurde auf den ausgewählten Workflow-Kontext beschränkt (selected_workflow_id, selected_workflow_name, series), wodurch die nicht verwendete Workflow-Katalogoberfläche entfernt wurde.
    • Hinzufügung von Anforderungs-/Systemabdeckung und UX-Härtung: Vollwochenfenster, lokal-datumssichere Achsenbeschriftungen, zugängliche Beschriftung der Ansichtsauswahl und Prüfungen auf Diagramm-Rendering-/Zustandsregressionen.

Die Diagrammfunktion sollte mit allen Workflows kompatibel sein:

  • Das Diagramm erfordert keine Kanban-Kompatibilität, sodass es für Workflows funktioniert, die nicht Kanban-kompatibel sind.
    • Das Diagramm wird nur angezeigt, wenn die aktuelle Workflow-Liste auf genau einen Workflow beschränkt ist.
    • Der Benutzer muss über die Diagrammberechtigung verfügen (Admin oder in workflow_charts_allowed_groups).
    • Wenn Kanban kompatibel ist, zeigt das Dropdown-Menü Liste/Kanban/Diagramm an.
    • Wenn Kanban nicht kompatibel ist, kann das Dropdown-Menü (wenn die beiden oben genannten Bedingungen erfüllt sind) trotzdem Liste/Diagramm anzeigen.
1 „Gefällt mir“