Workflow-Prozessmanager ↔

:information_source: Zusammenfassung Ein Plugin zur Prozessverwaltung für Discourse, das Aufgaben durch konfigurierbare Schritte mit Aktionen, Listenfiltern, Diagrammen, Swim-Lane-Ansichten und Kanban-Boards führt.
:hammer_and_wrench: Link zum Repository https://github.com/merefield/discourse-workflow
:open_book: Installationsanleitung So installiert man Plugins in Discourse

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

Zusammenfassung

discourse-workflow bietet einen sicheren Workflow-Rahmen 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, Nachvollziehbarkeit und automatisierungsfreundliches Verhalten, während es sich eng an die grundlegenden Discourse-Berechtigungen und UI-Muster hält.

Funktionen

  • Themenbasierte Workflow-Instanzen mit von Administratoren definierten Workflows, Schritten und Schrittoptionen
  • Basierend auf Kernkonzepten von Discourse: Kategorien, Gruppen und kategoriespezifische Berechtigungen – du kannst nur handeln, wenn du dazu berechtigt bist
  • Workflow-Entdeckung unter /workflow mit schnellen Filtern:
    • Meine Kategorien
    • Überfällig
    • Schritt = X
  • Auswahl der Entdeckungsansicht:
    • Liste
    • Kanban (nur für einzelne, Kanban-kompatible Workflow-Kontexte angezeigt)
    • Diagramm (nur für einzelne Workflow-Kontexte und für Diagrammberechtigte Benutzer angezeigt)
  • Kanban-Workflow-Board:
    • anklickbare Themenkarten
    • legale Drag/Drop-Übergänge
    • Tastaturübergänge (PfeilLinks / PfeilRechts), wenn erlaubt
  • Workflow-Themenbanner:
    • aktueller Workflow und Schritt
    • verfügbare Übergangsaktionen
    • Visualisierungslink
  • Überfällig-Modell mit Hierarchie:
    • globale Einstellung: workflow_overdue_days_default
    • Workflow-Überschreibung
    • Schritt-Überschreibung
    • 0 deaktiviert Überfällig auf dieser Ebene
    • Überfällig-Indikatoren in der Workflow-Liste und auf Kanban-Karten
  • Workflow-Burn-down-Diagramme:
    • Diagrammendpunkt + UI-Integration
    • Wochenbereichsauswahl (1–12)
    • volle Wochenfenster und schrittfarbige Serien
  • Übergangs-Audit-Trail über kleine Aktionsbeiträge
  • Ankunftsbenachrichtigungen für überwachte Kategorien (Ersten Beitrag beobachten)
  • Workflow-Visualisierung verfügbar aus Themen- und Entdeckungsansichten
  • Data Explorer-Integration mit standardmäßigen Workflow-Abfragen:
    • Burn-down/Burn-up-Statistiken
    • Audit-Protokoll
  • Optionale KI-gestützte Schrittverarbeitung

Einführungskonzepte

Swim Lanes

Jede Workflow-Spur ist eine Kategorie (oder Unterkategorie). Wenn sich ein Thema entwickelt, bewegt es sich gemäß konfigurierten Übergängen zwischen den Kategorien.

Workflow-Instanzen

  • Ein einzelnes Workflow-Element (z. B. ein Ticket) ist ein Thema.
  • Tags können für Metadaten wie Priorität hinzugefügt werden.
  • Die Kategorienbewegung wird durch Workflow-Aktionen gesteuert (sofern keine Überschreibung durch das Personal erfolgt).

Akteure

Benutzer, die Themen in einer Schritt-Kategorie erstellen können, können auf Workflow-Elemente in diesem Schritt einwirken. Benutzer mit Antwortzugriff können weiterhin normal kommentieren.

Aktionen über Optionen

Schrittoptionen definieren die verfügbaren Aktionen in jedem Schritt. Jede Option wird als Themenaktionsbutton angezeigt und kann das Thema in einen Zielschritt verschieben.

Dashboard

Verwende den /workflow-Navigationsfilter, um auf Workflow-Themen zugreifen zu können, die du einsehen kannst, filtere sie dann oder wechsle zu Kanban für eine boardartige Flussverwaltung.

Audit-Trail

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

Visualisierung

Die Workflow-Visualisierung ist verfügbar über:

  • Themenbanner-Links
  • Workflow-Felder in der Entdeckungsliste

Hauptunterschiede zum Standard-Discourse

  • Du kannst kein neues Thema direkt in Kategorien jenseits des ersten Schritts eines Workflows erstellen.
  • Du kannst die Kategorie eines Workflow-Themas nicht manuell ändern, es sei denn, du bist Teil des Personals.
  • Nur Benutzer mit Kategorien-Erstellungsrechten können Workflow-Übergänge ausführen.

Erste Schritte

  1. Aktiviere das Plugin mit workflow_enabled.
  2. Gehe zu Admin → Plugins → Discourse Workflow.
  3. Erstelle einen Workflow, speichere ihn, füge dann Schritte und Schrittoptionen hinzu.
  4. Konfiguriere die Kategorienberechtigungen so, dass Workflow-Akteure in den relevanten Schritt-Kategorien die Berechtigung zum Erstellen haben.
  5. Erstelle ein Thema in der ersten Schritt-Kategorie.
  6. Verschiebe es mithilfe von Themenaktionsbuttons oder Kanban-Interaktionen.
  7. Nutze /workflow für das operative Queue-Management.

KI-Aktionen

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

Voraussetzungen:

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

Beispiel-Prompt:

deine Optionen sind {{options}}. Wenn der folgende Text besagt, dass es köstlich ist, bitte akzeptieren, sonst ablehnen. {{topic}} antworte mit einem Wort aus diesen Optionen

Bekannte Probleme

Dieses Plugin entwickelt sich noch weiter. Bitte melde Probleme und Verbesserungsideen im Repository oder in diesem Meta-Thema.

26 „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.
5 „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.
3 „Gefällt mir“

Ich habe einen großen Leistungspass durchgeführt:

4 „Gefällt mir“