Flux de travail Discourse

:information_source: Résumé Un système de flux de travail basé sur des sujets pour Discourse avec des étapes configurables, des actions, des filtres de liste de flux de travail et une vue Kanban
:hammer_and_wrench: Lien vers le dépôt https://github.com/merefield/discourse-workflow
:open_book: Guide d’installation Comment installer des plugins dans Discourse

Vous appréciez ce plugin ? Veuillez lui donner une :star: sur GitHub ! :pray:

Résumé

discourse-workflow fournit un cadre de flux de travail sécurisé pour les sujets. Chaque flux de travail est composé d’étapes et d’options configurables, et les sujets progressent dans ces étapes jusqu’à leur achèvement.

Il prend en charge la ramification et la boucle, les vues de découverte en liste et Kanban, l’auditabilité et un comportement convivial pour l’automatisation tout en restant proche des autorisations et des modèles d’interface utilisateur de base de Discourse.

Fonctionnalités

  • Instances de flux de travail basées sur des sujets avec des flux de travail, des étapes et des options d’étape définis par l’administrateur
  • Construit sur les concepts de base de Discourse : Catégories, Groupes et autorisations basées sur les catégories - vous ne pouvez agir que si vous y êtes autorisé
  • Découverte du flux de travail sur /workflow avec des filtres rapides :
    • Mes catégories
    • En retard
    • Étape = X
  • Sélecteur de vue de découverte :
    • Liste
    • Kanban (affiché uniquement pour un contexte de flux de travail unique compatible Kanban)
    • Graphique (affiché uniquement pour un contexte de flux de travail unique et les utilisateurs autorisés à voir le graphique)
  • Tableau de flux de travail Kanban :
    • cartes de sujet cliquables
    • transitions par glisser-déposer légales
    • transitions au clavier (FlècheGauche / FlècheDroite) lorsque c’est légal
  • Bannière de sujet de flux de travail :
    • flux de travail et étape actuels
    • actions de transition disponibles
    • lien de visualisation
  • Modèle de retard avec hiérarchie :
    • paramètre global : workflow_overdue_days_default
    • substitution de flux de travail
    • substitution d’étape
    • 0 désactive le retard à cette portée
    • indicateurs de retard dans la liste des flux de travail et les cartes Kanban
  • Graphique d’avancement du flux de travail :
    • point de terminaison du graphique + intégration de l’interface utilisateur
    • sélecteur de plage de semaines (1–12)
    • fenêtres d’une semaine complète et séries colorées par étape
  • Piste d’audit de transition via de petits messages d’action
  • Notifications d’arrivée pour les catégories surveillées (Surveiller le premier message)
  • Visualisation du flux de travail disponible à partir des vues de sujet et de découverte
  • Intégration de l’Explorateur de données avec des requêtes de flux de travail par défaut :
    • statistiques de progression/d’achèvement
    • journal d’audit
  • Gestion des étapes assistée par IA en option

Concepts introductifs

Couloirs (Swim Lanes)

Chaque couloir de flux de travail est une Catégorie (ou Sous-catégorie). Au fur et à mesure qu’un sujet progresse, il se déplace entre les catégories selon les transitions configurées.

Instances de flux de travail

  • Un seul élément de flux de travail (par exemple, un ticket) est un Sujet.
  • Des balises peuvent être ajoutées pour les métadonnées telles que la priorité.
  • Le mouvement de catégorie est contrôlé par les actions du flux de travail (sauf si le personnel passe outre).

Acteurs

Les utilisateurs qui peuvent créer des sujets dans une catégorie d’étape peuvent agir sur les éléments de flux de travail dans cette étape. Les utilisateurs ayant un accès de réponse peuvent toujours commenter normalement.

Actions via les options

Les options d’étape définissent les actions disponibles à chaque étape. Chaque option est affichée comme un bouton d’action de sujet et peut déplacer le sujet vers une étape cible.

Tableau de bord

Utilisez le filtre de navigation /workflow pour voir les sujets de flux de travail auxquels vous pouvez accéder, puis filtrez ou passez à Kanban pour une gestion du flux de style tableau.

Piste d’audit

Les transitions sont enregistrées comme de petits messages d’action sur le sujet. Les requêtes regroupées de l’Explorateur de données prennent en charge l’audit et le reporting opérationnel.

Visualisation

La visualisation du flux de travail est disponible à partir de :

  • liens dans la bannière du sujet
  • champs de flux de travail dans la liste de découverte

Différences majeures par rapport à Discourse standard

  • Vous ne pouvez pas créer un nouveau sujet directement dans des catégories au-delà de l’étape 1 d’un flux de travail.
  • Vous ne pouvez pas changer manuellement la catégorie d’un sujet de flux de travail, sauf si vous êtes membre du personnel.
  • Seuls les utilisateurs ayant des droits de création de catégorie peuvent exécuter des transitions de flux de travail.

Démarrage

  1. Activez le plugin avec workflow_enabled.
  2. Allez dans Administration → Plugins → Flux de travail Discourse.
  3. Créez un flux de travail, enregistrez-le, puis ajoutez des étapes et des options d’étape.
  4. Configurez les autorisations de catégorie afin que les acteurs du flux de travail aient la permission de Créer dans les catégories d’étape pertinentes.
  5. Créez un sujet dans la catégorie de première étape.
  6. Faites-le passer en transition à l’aide des boutons d’action du sujet ou des interactions Kanban.
  7. Utilisez /workflow pour la gestion de la file d’attente opérationnelle.

Actions IA

L’IA peut effectuer une action d’étape lorsqu’elle est configurée.

Prérequis :

  • workflow_openai_api_key valide
  • IA activée sur l’étape
  • l’invite inclut à la fois {{options}} et {{topic}}

Exemple d’invite :

vos options sont {{options}}. si le texte suivant indique qu'il est délicieux, veuillez accepter, sinon rejetez. {{topic}} répondez avec un seul mot parmi ces options

Problèmes connus

Ce plugin est toujours en évolution. Veuillez signaler les problèmes et les idées d’amélioration sur le dépôt ou ce sujet Meta.

25 « J'aime »

Reçoit de l’amour.

4 « J'aime »

Quelques correctifs ont été déployés :

2 « J'aime »

Offre une vue plus pratique sur mobile :

  • AMÉLIORER : La liste des sujets Workflow fonctionne très bien sur ordinateur, mais sur mobile elle est trop large. Ainsi, au lieu d’ajouter toutes ces colonnes sur mobile, ajoutez un badge Workflow au titre et limitez l’ensemble complet des colonnes aux ordinateurs de bureau.
2 « J'aime »

quelques ajustements mineurs mais importants.

1 « J'aime »

Salut Robert,
Je joue avec le plugin workflow, sans IA. Il s’agit d’un workflow simple destiné à être utilisé comme chaîne de support pour un café Linux qui aide les gens à migrer depuis Windows. De nouveaux sujets sont créés via des e-mails RFC 6233 avec sous-adressage et arrivent dans la première sous-catégorie (niveau 1).

Deux problèmes :

  1. Les identifiants des étapes du workflow ne sont pas uniques. J’ai trois étapes avec le même identifiant. ??
  2. Une action « start » sur le sujet entrant crée un contenu « 422 unprocessable content ». Peut-être que c’est le résultat de 1)
3 « J'aime »

Merci de votre patience et de vos commentaires. J’apprécie votre intérêt pour le plugin.

Il est un peu expérimental et, comme vous pouvez le constater, il n’a pas encore reçu beaucoup de commentaires, il y aura donc forcément des problèmes de jeunesse.

J’essaierai de recréer votre flux de travail et de tenter de reproduire le problème.

En attendant, pouvez-vous faire une capture d’écran du flux de travail dans l’écran d’administration et la partager ?

@Thomas_Rother avez-vous une trace de la pile sur cela ?

3 « J'aime »

Salut Robert,
ne t’inquiète pas, je suis conscient que c’est expérimental. Par conséquent, il n’est installé que sur une instance de test auto-hébergée. Tu peux t’y inscrire et je pourrais te donner des permissions d’administrateur :

https://forum2.netzwissen.de/login

2 « J'aime »

OK, voici un aperçu de la façon dont j’ai procédé :

  • Configuration de la catégorie de tickets « Café Internet »
  • Configuration de toutes les étapes comme sous-catégories, ce qui donne ceci :

Jusqu’ici tout va bien.

Créons maintenant les étapes :

OK, je vois au moins deux problèmes ! (Mais l’un d’eux est probablement causé par l’autre)

C’est étrange car j’étais sûr que cela fonctionnait auparavant. Je regarde ça maintenant et si j’ai le temps, je publierai un correctif sous peu.

3 « J'aime »

@Thomas_Rother essaie ça :

(Tu devras peut-être supprimer et recréer les étapes affectées)

2 « J'aime »

Quels sont les cas d’utilisation les plus courants de ce plugin et est-ce qu’il fonctionne avec Gemini flash 2.0 ?

Tout processus métier (dans des limites raisonnables) avec plusieurs étapes et acteurs. Peut nécessiter une extension pour des intégrations spécifiques.

Il est actuellement limité à OpenAI, mais les PR sont les bienvenues (il utilise Chat Completions donc ce n’est pas une quantité de travail énorme).

1 « J'aime »

Grandes nouvelles : vous pouvez désormais obtenir les statistiques pour créer des graphiques d’avancement/de régression :

  • Ajoute une tâche quotidienne pour créer des statistiques de nombre d’états que vous pouvez utiliser dans des graphiques de régression/d’avancement.
  • Ajoute une tâche qui vérifie la présence ou ajoute deux requêtes utiles pour l’explorateur de données
    • Journal d’audit pour toutes les transitions
    • Nombre quotidien d’instances de flux de travail à chaque étape de leur flux de travail, facilitant les graphiques de régression/d’avancement (il suffit d’exporter les résultats).
    • Vous pouvez accorder à des groupes spécifiques l’accès à ces rapports.

NB Discourse Workflow n’est désormais compatible qu’avec les tests réussis pour le moment en raison des changements dans la manière dont les dépendances des gems sont gérées dans le cadre du regroupement majeur de plugins. Cela devrait changer lors de la prochaine version stable.

4 « J'aime »

J’essaie de comprendre pourquoi mon site est devenu lent…

Avertissement de dépréciation

[PLUGIN discourse-workflow] Avis de dépréciation : L’accès à site.mobileView ou site.desktopView pendant la phase d’initialisation du site est déprécié. Dans les futures mises à jour, le mode mobile sera déterminé par la taille de la fenêtre d’affichage et, par conséquent, l’utilisation de ces valeurs pendant l’initialisation peut entraîner des erreurs et des incohérences lors du redimensionnement de la fenêtre du navigateur. Veuillez déplacer ces vérifications vers un composant, un transformateur ou un rappel d’API qui s’exécute pendant le rendu de la page. [déprécié depuis Discourse 3.5.0.beta9-dev] [id de dépréciation : discourse.static-viewport-initialization] [info : Designing for Different Devices (Viewport Size, Touch/Hover, etc.)] deprecated.js:62:13

Je doute fort que ce soit la cause de la lenteur de votre site !! :rire: - c’est un avertissement de dépréciation.

J’attends votre PR avec impatience :léger_sourire:

1 « J'aime »

Eh bien, cela ne devrait pas être dû à Discourse Workflow car j’ai corrigé plusieurs problèmes N+1, y compris sur la liste des sujets et la visualisation :

etc.

3 « J'aime »

Grande mise à jour avec plusieurs nouvelles fonctionnalités, notamment

  • Nouveaux filtres de liste de sujets spécifiques au flux de travail
  • Signalement « En retard »
  • Métadonnées de flux de travail de sujet plus riches
1 « J'aime »

Mise à jour énorme :

Nouvelle vue Kanban :

  • Ajout d’un mode Kanban complet à /workflow avec une bascule Liste/Kanban, affichée uniquement lorsqu’un seul flux de travail compatible Kanban est dans le périmètre.
    • Introduction d’une validation explicite de la compatibilité Kanban (y compris le mappage déterministe à une seule arête) et affichage de l’état de compatibilité dans l’administration du flux de travail.
  • Rendu des éléments du flux de travail actionnables depuis Kanban : glisser-déposer entre les étapes légales, déplacements d’étape au clavier avec les touches fléchées et clic pour ouvrir les sujets.
  • Amélioration de la fiabilité pour les mises à jour simultanées : les transitions obsolètes retournent maintenant 409, affichent un message d’état obsolète clair et déclenchent un rafraîchissement pour resynchroniser l’état de l’interface utilisateur.
  • Utilisabilité et clarté du tableau : balises Kanban facultatives au niveau du flux de travail, prise en charge de l’indicateur de retard sur les cartes et style de couloir incluant des bordures de colonne colorées par catégorie.
4 « J'aime »

Une autre mise à jour majeure - graphique de progression/réduction en ligne (comme une belle alternative à la requête Data Explorer groupée existante)

  • Ajout d’une nouvelle vue Graphique de flux de travail dans la découverte avec un sélecteur de vue partagé (Liste / Kanban / Graphique) et un contrôle de période (1 à 12 semaines).
    • Implémentation de l’API de données de progression/réduction à /discourse-workflow/charts.json plus l’intégration de la route /workflow/charts.
    • L’accès au graphique est autorisé séparément : administrateurs et groupes autorisés pour les graphiques de flux de travail (workflow_charts_allowed_groups) ; le graphique est masqué aux utilisateurs non autorisés.
    • La charge utile du graphique a été resserrée au seul contexte de flux de travail sélectionné ( selected_workflow_id, selected_workflow_name, series), supprimant la surface de catalogue de flux de travail inutilisée.
    • Ajout de la couverture des requêtes/système et du renforcement de l’expérience utilisateur : fenêtres d’une semaine complète, étiquettes d’axe sûres pour les dates locales, étiquetage accessible du sélecteur de vue et vérifications de régression du rendu/de l’état du graphique.

La fonctionnalité de graphique devrait être compatible avec tous les flux de travail :

  • Le graphique ne nécessite pas la compatibilité Kanban, il fonctionne donc pour les flux de travail qui ne sont pas compatibles Kanban.
    • Le graphique n’apparaît que lorsque la liste de flux de travail actuelle est limitée à un seul flux de travail.
    • L’utilisateur doit disposer de l’autorisation d’accès au graphique (administrateur ou dans les groupes autorisés pour les graphiques de flux de travail (workflow_charts_allowed_groups)).
    • Si la compatibilité Kanban est activée, le menu déroulant affiche Liste/Kanban/Graphique.
    • Si la compatibilité Kanban n’est pas activée, le menu déroulant peut toujours afficher Liste/Graphique (lorsque les deux conditions ci-dessus sont remplies).
1 « J'aime »