Discourseのワークフロー

:information_source: 概要 設定可能なマルチステージプロセスを実装するトピック用のワークフローシステム
:hammer_and_wrench: リポジトリリンク \u003chttps://github.com/merefield/discourse-workflow\u003e
:open_book: インストールガイド Discourseにプラグインをインストールする方法

このプラグインをお楽しみいただけましたら、GitHub で:star:評価をお願いします!:pray:

概要

トピック用のセキュアなワークフローフレームワークを提供するプラグイン。ワークフローが完了するまで、カスタマイズ可能な一連のステップを通過します。一部の分岐とループがサポートされています。

承認プロセスや問題対応プロセスなど、お持ちのビジネスワークフローにご利用ください。

特徴

Discourse用のワークフローツール!

  • トピックベースのワークフロー
  • 既存のプラットフォームセキュリティ、カテゴリ、ユーザー、グループを活用します。
  • 新しいワークフロー、ステップ、ステップオプションを作成するための新しい管理者画面。
  • アクセス可能なすべてのワークフロー・トピックをリストする新しいワークフロー発見リスト。
  • ワークフロー・トピックのトピックバナーには以下が表示されます:
    • 現在のワークフロー
    • 現在のワークフローのステップ
    • オプションを選択してトピックをワークフローで進行させる権限を持つグループのメンバーであれば表示されるアクションボタン。
    • 可視化へのリンク(上記参照)。
  • ワークフローの可視化。以下から起動できます:
    • トピックバナー
    • 発見リスト
  • ワークフロー遷移のためのトピック投稿の小さなアクションにより、監査証跡を表示します。
  • ステップにトピックが到着したときの通知(例:監視しているカテゴリ)(最初の投稿)。
  • データエクスプローラーのサポート
    • 監査ログレポート
    • 毎日のインスタンスワークフロー/ステップ数(バーンダウン/バーンアップチャートを作成できます)。
  • AIを活用してワークフローのステップを自動的に処理できます。

注:これは初期段階のリリースであり、機能セットは進化する可能性があります。新しい機能や統合に資金を提供するビジネスからの関心をお待ちしています。

紹介コンセプト

Discourseプラットフォームを最大限に活用するために、プラットフォームの既存の多くの機能を使用したシンプルなフレームワークを作成しました。

スイムレーン

各ワークフローのスイムレーンはカテゴリ(またはサブカテゴリ)です。

ワークフローのインスタンスがその旅を続けるにつれて、カスタマイズ可能ですが事前に定義された旅の中でカテゴリ間を移動します。

ワークフローインスタンス

ワークフローの単一インスタンス(例:チケット)はトピックです。トピックにタグを追加して、優先度やその他のメタデータを強調表示できます。ワークフローアクションをトピックに対して実行しない限り、旅が始まってからカテゴリを変更することはできません(スタッフを除く)。

アクター

カテゴリへのトピック作成アクセス権を持つ任意のグループは、そのカテゴリのトピックを操作できます。

返信アクセス権を持つユーザーは、通常のトピックと同様にワークフローアイテムにコメントできます。

通常の通り、特定のグループからカテゴリ内のトピックを非表示にすることができます。

オプションによるアクション

これらは、ワークフローを設定する際に各ステップに対して定義されます。アクターは、各オプションがトピック上のボタンとして提示されるため、利用可能な任意のアクションを選択できます。

トピックに対するアクションは、ユーザーがトピックの旅を理解するのに役立つように、小さなアクション投稿にキャプチャされます。

ダッシュボード

ホームページの新しいトピック発見フィルター「ワークフロー」には、ワークフローインスタンス(特別なワークフロー・トピック)のリストが表示されます。

ワークフローカテゴリ、および理想的にはタグを区別して維持してください。これにより、既存のDiscourseカテゴリドロップダウンを使用して、特定のステージにある、または特定のタグを持つすべてのワークフローインスタンスをフィルタリングすることもできます。

監査証跡

トピックが新しいステップに移行するたびに、それを文書化するメモがトピックの小さなアクション投稿として追加されます。

バンドルされたデータエクスプローラークエリは、ワークフローインスタンスがたどった旅の基本的な監査レポートを提供します。

データエクスプローラークエリは管理者以外にも公開できるため、表示するユーザーを選択できます。

バーンアップ/バーンダウンチャート

COBごとのワークフロー状態を示すバンドルされたデータエクスプローラークエリがあり、Excelなどのツールでデータをエクスポートしてバーンアップ/ダウンチャートを作成できます。

可視化

各ワークフロー・トピックには、トピックがワークフローのどこにあるかを示す可視化を起動できるボタンがあります。

これは、ワークフロー発見ダッシュボードのワークフローフィールドからもアクセスできます。

標準からの主な動作の違い

  • ワークフローの最初のステップを超えるカテゴリに新しいトピックを作成することはできません。
  • ワークフロー内のトピックのカテゴリを変更することはできません(スタッフを除く)。
  • カテゴリの「作成者」のみがワークフロー内のトピックを操作できます。

開始方法

ワークフロープラグインにはワークフローがバンドルされていません。自分で作成する必要があります。

作成画面は、管理者 → プラグイン → Discourse Workflow にあります。

まずボタンをクリックして新しいワークフローを作成し、保存してから、ワークフローを編集してステップを追加します。各ステップは、作成後、定義済みのオプションのリストから選択して編集し、オプションを追加できます。

オプションのラベルは、管理者 → カスタマイズ → テキスト で変更できます。

システムには多くのオプションが用意されていますが、各オプションのテキストを変更したい場合は、自由に行ってください。

各ワークフローカテゴリでは、「アクター」が作成権限を持つように設定する必要があります。それ以外はすべて返信権限以下にする必要があります。

「アクター」は、責任を持つカテゴリを「最初の投稿を監視」を選択して追跡することもできます。新しいワークフロー・トピックが到着すると、リンクとともに通知されます。

ヒント

  • 特定のワークフローのすべてのワークフローステップを、単一のカテゴリ内のサブカテゴリにすることをお勧めします。これは必須ではありませんが、既存のDiscourseカテゴリドロップダウンを使用してそのカテゴリをフィルタリングするだけで、その特定のワークフローのすべてのワークフローインスタンスを表示できます。
  • 新しいワークフロー発見リストでは、ワークフロー名、位置、またはステップをクリックすると、そのインスタンスがパスのどこにあるかを確認できます。
  • ワークフローで使用されるトピックの構造化テンプレートを作成するために、公式の既存ツールを使用してください:
  • サイドバー(または任意の場所)にリンクを作成して、新しいワークフローアイテムを作成し、ワークフローを開始します:Creating a link to start a new topic with pre-filled information

AIアクション

AIを活用してステップを処理できます。ワークフロー設定に有効なOpen AIキーを追加する必要があります。ステップでAIを有効にする必要があります。また、AIにオプションがあることを知らせるために{{options}}を含み、コンテンツを含めるために{{topic}}を含むプロンプトを作成する必要があります。

例プロンプト:

「あなたのオプションは{{options}}です。以下のテキストがおいしいと述べている場合は受け入れてください。そうでない場合は拒否してください。{{topic}}これらのオプションのいずれか1つの単語で答えてください」

既知の問題:

まだ実験段階なので、問題が発生する可能性があります。それらを報告していただければ、対処されるまでここにリストします。

「いいね!」 25

愛されてるよ。

「いいね!」 4

いくつかの修正をデプロイしました。

「いいね!」 2

モバイルでの表示がより実用的になります。

  • 改善: Workflowトピックリストはデスクトップではうまく機能しますが、モバイルでは幅が広すぎるため、モバイルではすべての列を追加する代わりに、タイトルにワークフローバッジを追加し、列の完全なセットをデスクトップに限定します。
「いいね!」 2

マイナーですが重要な変更をいくつか追加しました。

「いいね!」 1

ロバート様

AIを使用せずにワークフロープラグインを試しています。これは、LinuxカフェがWindowsからの移行を支援するために使用されるシンプルなワークフローです。新しいトピックは、サブアドレッシングを使用したRFC 6233メールを通じて作成され、最初のサブカテゴリ(レベル1)に入ります。

2つの問題があります。

  1. ワークフローステップのIDが一意ではありません。同じIDを持つステップが3つあります。??
  2. 着信トピックの「開始」アクションが「422 unprocessable content」を生成します。これは1)の結果でしょうか?
「いいね!」 3

ご辛抱とフィードバックをいただきありがとうございます。プラグインにご関心をお寄せいただき感謝いたします。

これは少し実験的なものであり、ご覧のとおり、まだ多くのフィードバックを得られていないため、初期の問題は避けられません。

ワークフローを再現し、問題を再現しようと試みます。

それまでの間、管理画面でのワークフローのスクリーンショットを共有していただけますでしょうか?

@Thomas_Rother これに関するバックトレースはありますか?

「いいね!」 3

ロバート様

ご心配なく。これは実験的なものであることを承知しております。そのため、セルフホストされたテストインスタンスにのみインストールされています。そちらで登録していただければ、管理者権限を付与できます。

https://forum2.netzwissen.de/login

「いいね!」 2

説明のために、どのように進めたかを以下に示します。

  • インターネットカフェチケットのカテゴリを設定しました。
  • すべてのステップをサブカテゴリとして設定した結果、以下のようになりました。

ここまでは順調です。

次に、ステップを作成しましょう。

OK、少なくとも2つの問題が見えます。(ただし、おそらく一方が他方の原因でしょう)

これは奇妙です。以前はこれが機能していたと確信していました。現在確認しており、時間があればすぐに修正をリリースします。

「いいね!」 3

@Thomas_Rother これを試してみてください:

(影響を受けるステップを削除して再作成する必要がある場合があります)

「いいね!」 2

このプラグインの最も一般的なユースケースは何ですか?また、Gemini flash 2.0で動作しますか?

複数のステップとアクターを伴うあらゆるビジネスプロセス(合理的な範囲内で)。特定の統合のために拡張が必要になる場合があります。

現在は OpenAI のみですが、PR を歓迎します(Chat Completions を使用しているため、それほど多くの作業ではありません)。

「いいね!」 1

ビッグニュース:バーンダウン/バーンアップチャートを作成するための統計情報を取得できるようになりました。

  • バーンダウン/バーンアップチャートで使用できる状態カウント統計を作成するための日次ジョブを追加します。
  • 2つの便利なデータエクスプローラークエリの存在を確認するか、それらを追加するジョブを追加します。
    • すべてのトランジションの監査ログ
    • ワークフローインスタンスの各ステップでの日次カウント(エクスポートするだけでバーンダウン/バーンアップチャートが容易になります)。
    • これらのレポートへのアクセスを特定のグループに付与できます。

注:現在、Discourse Workflowは、メジャープラグインバンドリングの一部としてgem依存関係の処理方法が変更されたため、一時的にtests-passedとのみ互換性があります。これは、次の安定版リリース時に変更されるはずです。

「いいね!」 4

サイトが遅くなった理由を調べています…

非推奨の警告

[PLUGIN discourse-workflow] 非推奨通知: サイト初期化フェーズ中に site.mobileView または site.desktopView にアクセスすることは非推奨です。将来のアップデートでは、モバイルモードはビューポートサイズによって決定されるため、初期化中にこれらの値を使用すると、ブラウザウィンドウのサイズが変更されたときにエラーや不整合が発生する可能性があります。これらのチェックを、ページレンダリング中に実行されるコンポーネント、トランスフォーマー、またはAPIコールバックに移動してください。[deprecated since 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

これがあなたのサイトが遅くなる原因であるとは全く疑っていません!! :laughing: - それは非推奨の警告です。

あなたのPRを楽しみにしています :slight_smile:

「いいね!」 1

さて、トピックリストやビジュアライゼーションでのN+1の問題をいくつか修正したので、Discourse Workflowが原因であるはずがありません。

など。

「いいね!」 2