Gestionnaire de processus ↔

:information_source: Résumé Un plugin de gestion de processus pour Discourse qui fait avancer le travail à travers des étapes configurables, avec des actions, des filtres de liste, des graphiques, des vues en couloirs (swim-lanes) et des tableaux Kanban.
:hammer_and_wrench: Lien vers le dépôt https://github.com/merefield/discourse-process-manager
:open_book: Guide d’installation Comment installer des plugins dans Discourse

Vous appréciez ce plugin ? S’il vous plaît, mettez-lui une :star: sur GitHub ! :pray:

Résumé

Process Manager offre un cadre sécurisé de gestion des processus pour Discourse. Chaque processus est composé d’étapes et d’options configurables, et les sujets avancent à travers ces étapes jusqu’à leur achèvement.

Un processus peut représenter un flux de travail, un flux d’approbation, une file d’attente de support, un pipeline de révision ou tout autre travail par étapes.

Il prend en charge les embranchements et les boucles, les vues de découverte en liste et Kanban, les pistes d’audit, les graphiques et un comportement compatible avec l’automatisation, tout en restant proche des permissions et des modèles d’interface utilisateur de base de Discourse.

Cela maintient la configuration et le paramétrage simples, et garantit que seules les bonnes personnes peuvent agir sur un élément de travail à un moment donné.

L’utilisation des sujets comme éléments de travail donne à chaque processus une base flexible et native de Discourse : chaque élément peut avoir un titre, une description détaillée, des pièces jointes, une discussion, des notifications, des tags et un historique complet dès la sortie de boîte.

Fonctionnalités

  • Flux de travail de gestion de processus utilisant les sujets Discourse comme éléments de travail

  • Flux de travail, étapes et options d’étape définis par l’administrateur

  • Éditeur de flux de travail visuel pour organiser les étapes, les couloirs et les connecteurs de transition

  • Basé sur les concepts fondamentaux de Discourse : catégories, groupes, tags, notifications et permissions basées sur les catégories

  • Les permissions d’action restent proches du comportement de Discourse : les utilisateurs ne peuvent agir que là où ils ont déjà les permissions de catégorie appropriées

  • Découverte des processus à /processes 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 compatible Kanban unique

    • Graphique, affiché uniquement pour un contexte de processus unique et pour les utilisateurs autorisés aux graphiques

    • Graphique, affiché uniquement pour un contexte de flux de travail unique et pour les utilisateurs autorisés aux graphiques

  • Tableau Kanban de flux de travail :

    • Cartes de sujets cliquables
    • Transitions de glisser-déposer légales
    • Transitions au clavier avec ArrowLeft / ArrowRight 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 : process_manager_overdue_days_default
    • Remplacement au niveau du processus
    • Remplacement au niveau de l’étape
    • 0 désactive le retard à ce niveau
    • Indicateurs de retard dans la liste des processus et sur les cartes Kanban
  • Graphiques de burn-down de flux de travail :

    • Point de terminaison de graphique et intégration de l’interface
    • Sélecteur de plage de semaines de 1 à 12 semaines
    • Fenêtres de semaine complète et séries colorées par étape
  • Piste d’audit des transitions via de petits messages d’action

  • Notifications d’arrivée pour les catégories surveillées en utilisant « Watch First Post »

  • Visualisation du flux de travail disponible depuis le sujet et les vues de découverte

  • Intégration avec Data Explorer et requêtes de flux de travail par défaut :

    • statistiques de burn-down/burn-up
    • 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 de préférence une Sous-catégorie, voir ci-dessous). Au fur et à mesure qu’un sujet progresse, il passe d’une catégorie à l’autre selon les transitions configurées.

Éléments de processus

  • Un seul élément de processus (par exemple, un ticket) est un Sujet.
  • Des tags peuvent être ajoutés pour les métadonnées telles que la priorité.
  • Le déplacement de catégorie est contrôlé par les actions du flux de travail (sauf si un membre du personnel intervient).

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 de cette étape. Les utilisateurs ayant un accès en 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 sous forme de bouton d’action sur le 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 avez accès, puis filtrez ou passez en mode Kanban pour une gestion de flux de style tableau.

Piste d’audit

Les transitions sont enregistrées sous forme de petits messages d’action sur le sujet. Les requêtes Data Explorer regroupées prennent en charge l’audit et les rapports opérationnels.

Visualisation

La visualisation du flux de travail est disponible depuis :

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

Différences majeures par rapport à Discourse standard

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

Pour commencer :

  1. Activez le plugin avec process_manager_enabled.
  2. Allez dans Admin -> Plugins -> Process Manager.
  3. Créez un processus, enregistrez-le, puis ajoutez des étapes et des options d’étape.
  4. Configurez les permissions de catégorie afin que les acteurs du processus aient le droit de créer des sujets dans les catégories d’étape concernées.
  5. Créez un sujet dans la catégorie de la première étape.
  6. Effectuez une transition en utilisant les boutons d’action du sujet ou les interactions Kanban.
  7. Utilisez /processes pour la gestion de la file d’attente opérationnelle.

Actions IA :

L’IA peut exécuter une étape en utilisant l’intégration directe d’OpenAI de Process Manager. Cela ne dépend pas de Discourse AI.

Prérequis :

  • une clé API process_manager_openai_api_key valide
  • l’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 que c'est délicieux, veuillez accepter, sinon rejeter. {{topic}} répondez par un seul mot parmi ces options

Problèmes connus

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

26 « 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.
5 « 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).
3 « J'aime »

J’ai effectué un passage majeur sur les performances :

4 « J'aime »