سير عمل Discourse

:information_source: الملخص نظام سير عمل قائم على الموضوع لـ Discourse مع خطوات قابلة للتكوين، وإجراءات، وفلاتر قائمة سير العمل، وعرض كانبان (Kanban)
:hammer_and_wrench: رابط المستودع https://github.com/merefield/discourse-workflow
:open_book: دليل التثبيت كيفية تثبيت الإضافات في Discourse

هل تستمتع بهذه الإضافة؟ يرجى :star: على GitHub! :pray:

الملخص

يوفر discourse-workflow إطار عمل سير عمل آمن للمواضيع. يتكون كل سير عمل من خطوات وخيارات قابلة للتكوين، وتنتقل المواضيع عبر هذه الخطوات حتى تكتمل.

إنه يدعم التفرع والحلقات، وعرضات الاكتشاف القائمة على القائمة وكانبان، وقابلية التدقيق، والسلوك الصديق للأتمتة مع الحفاظ على قرب من أذونات Discourse الأساسية وأنماط واجهة المستخدم.

الميزات

  • مثيلات سير عمل قائمة على الموضوع مع سير عمل وخطوات وخيارات خطوات محددة من قبل المسؤول
  • مبني على مفاهيم Discourse الأساسية: الفئات، والمجموعات، والأذونات القائمة على الفئة - لا يمكنك التصرف إلا إذا كان مسموحًا لك بذلك
  • اكتشاف سير العمل على /workflow مع فلاتر سريعة:
    • فئاتي
    • متأخر
    • الخطوة = X
  • محدد عرض الاكتشاف:
    • قائمة
    • كانبان (يظهر فقط لسياق سير عمل واحد متوافق مع كانبان)
    • مخطط (يظهر فقط لسياق سير عمل واحد وللمستخدمين المسموح لهم بالمخطط)
  • لوحة سير عمل كانبان:
    • بطاقات مواضيع قابلة للنقر
    • انتقالات سحب/إفلات قانونية
    • انتقالات لوحة المفاتيح (ArrowLeft / ArrowRight) عند السماح بها
  • لافتة موضوع سير العمل:
    • سير العمل والخطوة الحالية
    • إجراءات الانتقال المتاحة
    • رابط التصور
  • نموذج التأخر مع التسلسل الهرمي:
    • إعداد عام: workflow_overdue_days_default
    • تجاوز سير العمل
    • تجاوز الخطوة
    • 0 يعطل التأخر في هذا النطاق
    • مؤشرات التأخر في قائمة سير العمل وبطاقات كانبان
  • تخطيط حرقان (Burn-down) لسير العمل:
    • نقطة نهاية المخطط + تكامل واجهة المستخدم
    • محدد نطاق الأسبوع (1-12)
    • نوافذ أسبوع كامل وسلسلة ملونة بالخطوات
  • سجل تدقيق الانتقال عبر منشورات الإجراءات الصغيرة
  • إشعارات الوصول للفئات المراقبة (مراقبة المنشور الأول)
  • تصور سير العمل متاح من عرض الموضوع وعرض الاكتشاف
  • تكامل مستكشف البيانات مع استعلامات سير العمل الافتراضية:
    • إحصائيات الحرقان/الصعود
    • سجل التدقيق
  • معالجة الخطوات بمساعدة الذكاء الاصطناعي اختياريًا

المفاهيم التمهيدية

مسارات السباحة (Swim Lanes)

كل مسار في سير العمل هو فئة (أو فئة فرعية). مع تقدم الموضوع، فإنه ينتقل بين الفئات وفقًا للانتقالات المكونة.

مثيلات سير العمل

  • عنصر سير عمل واحد (على سبيل المثال، تذكرة) هو موضوع.
  • يمكن إضافة علامات لبيانات وصفية مثل الأولوية.
  • يتم التحكم في حركة الفئة بواسطة إجراءات سير العمل (ما لم يكن هناك تجاوز من الموظفين).

الفاعلون (Actors)

يمكن للمستخدمين الذين يمكنهم إنشاء مواضيع في فئة الخطوة التصرف في عناصر سير العمل في تلك الخطوة. لا يزال بإمكان المستخدمين الذين لديهم إذن الرد التعليق كالمعتاد.

الإجراءات عبر الخيارات

تحدد خيارات الخطوة الإجراءات المتاحة في كل خطوة. يتم عرض كل خيار كزر إجراء موضوع ويمكن أن ينقل الموضوع إلى خطوة مستهدفة.

لوحة القيادة (Dashboard)

استخدم مرشح التنقل /workflow لرؤية مواضيع سير العمل التي يمكنك الوصول إليها، ثم قم بالتصفية أو التبديل إلى كانبان لإدارة التدفق بأسلوب اللوحة.

سجل التدقيق (Audit Trail)

يتم تسجيل الانتقالات كمنشورات إجراءات صغيرة على الموضوع. تدعم استعلامات مستكشف البيانات المجمعة التدقيق وإعداد التقارير التشغيلية.

التصور (Visualisation)

تصور سير العمل متاح من:

  • روابط لافتة الموضوع
  • حقول سير العمل في قائمة الاكتشاف

الاختلافات الرئيسية عن Discourse القياسي

  • لا يمكنك إنشاء موضوع جديد مباشرة في فئات تتجاوز الخطوة 1 من سير العمل.
  • لا يمكنك تغيير فئة موضوع سير العمل يدويًا ما لم تكن من الموظفين.
  • يمكن فقط للمستخدمين الذين لديهم حقوق إنشاء الفئة تنفيذ انتقالات سير العمل.

البدء

  1. قم بتمكين الإضافة باستخدام workflow_enabled.
  2. انتقل إلى المسؤول → الإضافات → سير عمل Discourse.
  3. أنشئ سير عمل، واحفظه، ثم أضف خطوات وخيارات خطوات.
  4. قم بتكوين أذونات الفئة بحيث يكون لدى فاعلي سير العمل إذن الإنشاء في فئات الخطوات ذات الصلة.
  5. أنشئ موضوعًا في فئة الخطوة الأولى.
  6. انتقله باستخدام أزرار إجراء الموضوع أو تفاعلات كانبان.
  7. استخدم /workflow لإدارة قائمة الانتظار التشغيلية.

إجراءات الذكاء الاصطناعي

يمكن للذكاء الاصطناعي اتخاذ إجراء بشأن خطوة عند تكوينه.

المتطلبات:

  • مفتاح واجهة برمجة تطبيقات OpenAI صالح (workflow_openai_api_key)
  • تمكين الذكاء الاصطناعي على الخطوة
  • يتضمن الموجه كلاً من {{options}} و {{topic}}

مثال على الموجه:

خياراتك هي {{options}}. إذا ذكر النص التالي أنه لذيذ، يرجى القبول، وإلا ارفض. {{topic}} أجب بكلمة واحدة من تلك الخيارات

المشكلات المعروفة

هذه الإضافة لا تزال تتطور. يرجى الإبلاغ عن المشكلات وأفكار التحسين على المستودع أو موضوع Meta هذا.

25 إعجابًا

يحصل على بعض الحب.

4 إعجابات

تم نشر بعض الإصلاحات:

إعجابَين (2)

يوفر عرضًا أكثر عملية على الهاتف المحمول:

  • تحسين: تعمل قائمة مواضيع سير العمل بشكل رائع على سطح المكتب، ولكنها على الهاتف المحمول واسعة جدًا، لذلك بدلاً من إضافة كل تلك الأعمدة على الهاتف المحمول، أضف شارة سير العمل إلى العنوان وقصر المجموعة الكاملة من الأعمدة على سطح المكتب.
إعجابَين (2)

بعض التعديلات الطفيفة ولكن المهمة.

إعجاب واحد (1)

مرحباً روبرت،
أنا ألعب بمكون سير العمل الإضافي، بدون ذكاء اصطناعي. هذا سير عمل بسيط مخصص للاستخدام كسلسلة دعم لمقهى لينكس يساعد الأشخاص على الانتقال من ويندوز. يتم إنشاء مواضيع جديدة عبر رسائل البريد الإلكتروني RFC 6233 مع العنونة الفرعية وتدخل في الفئة الفرعية الأولى (المستوى 1).

مشكلتان:

  1. معرفات خطوات سير العمل ليست فريدة. لدي ثلاث خطوات بنفس المعرف. ؟؟
  2. إجراء “بدء” على الموضوع الوارد ينشئ “422 محتوى غير قابل للمعالجة” ربما تكون هذه نتيجة لـ 1)
3 إعجابات

شكراً لصبرك وملاحظاتك. أقدر اهتمامك بالمكون الإضافي.

إنه تجريبي بعض الشيء وكما ترى لم يحصل على الكثير من الملاحظات حتى الآن، لذا لا بد أن تكون هناك مشاكل أولية.

سأحاول إعادة إنشاء سير عملك ومحاولة إعادة إنشاء المشكلة.

في هذه الأثناء، هل يمكنك التقاط لقطة شاشة لسير العمل في شاشة المسؤول ومشاركتها؟

@Thomas_Rother هل لديك تتبع خلفي لهذا؟

3 إعجابات

مرحباً روبرت،
لا تقلق، أنا على علم بأن هذا تجريبي. لذلك تم تثبيته فقط على نسخة اختبار مستضافة ذاتيًا. يمكنك التسجيل هناك ويمكنني منحك صلاحيات المسؤول:

https://forum2.netzwissen.de/login

إعجابَين (2)

حسنًا، من خلال شرح تفصيلي، إليك كيف سارت الأمور معي:

  • إعداد فئة تذاكر مقهى الإنترنت
  • إعداد جميع الخطوات كفئات فرعية، مما أدى إلى هذا:

حتى الآن كل شيء على ما يرام.

الآن دعنا ننشئ الخطوات:

حسنًا، يمكنني رؤية مشكلتين على الأقل! (لكن من المحتمل أن تكون إحداهما قد تسببت في الأخرى)

هذا غريب لأنني كنت متأكدًا من أن هذا كان يعمل من قبل. أنا ألقي نظرة الآن وإذا كان لدي وقت، سأصدر إصلاحًا قريبًا.

3 إعجابات

@Thomas_Rother جرب ذلك:

(قد تحتاج إلى حذف الخطوات المتأثرة وإعادة إنشائها)

إعجابَين (2)

ما هي حالات الاستخدام الأكثر شيوعًا لهذه الإضافة وهل تعمل مع Gemini flash 2.0؟

أي عملية تجارية (في حدود المعقول) تتكون من خطوات متعددة وأطراف فاعلة متعددة. قد تتطلب إضافة امتدادات لعمليات تكامل محددة.

وهي حاليًا مخصصة لـ OpenAI فقط، ولكن نرحب بطلبات السحب (تستخدم Chat Completions لذا فهي لا تتطلب الكثير من العمل).

إعجاب واحد (1)

أخبار رائعة: يمكنك الآن الحصول على الإحصائيات لإنشاء مخططات الاحتراق (burn-up/down charts):

  • يضيف وظيفة يومية لإنشاء إحصائيات عدد الحالات التي يمكنك استخدامها في مخططات الاحتراق (burndown/burnup charts).
  • يضيف وظيفة تتحقق من وجود أو تضيف استعلامين مفيدين لمستكشف البيانات (Data Explorer)
    • سجل التدقيق لجميع الانتقالات
    • عدد الحالات اليومية لمثيلات سير العمل في كل خطوة من خطوات سير العمل الخاصة بها، مما يسهل مخططات الاحتراق (burn-down/up charts) (فقط قم بتصدير النتائج).
    • يمكنك منح مجموعات معينة الوصول إلى هذه التقارير.

ملاحظة: Discourse Workflow متوافق حاليًا فقط مع الاختبارات الناجحة في الوقت الحالي بسبب التغييرات في طريقة التعامل مع تبعيات الجواهر (gem dependencies) كجزء من تجميع المكونات الإضافية الرئيسية. يجب أن يتغير هذا عند إصدار الإصدار المستقر التالي.

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: - إنه تحذير إهمال.

أتطلع إلى طلب السحب الخاص بك :slight_smile:

إعجاب واحد (1)

حسنًا، لا ينبغي أن يكون ذلك بسبب سير عمل Discourse (Discourse Workflow) حيث قمت بإغلاق العديد من مشكلات N+1 بما في ذلك تلك المتعلقة بقائمة المواضيع (Topic List) والتصور (Visualisation):

إلخ.

3 إعجابات

تحديث كبير مع العديد من الميزات الجديدة، بما في ذلك

  • مرشحات قائمة المواضيع الجديدة الخاصة بسير العمل
  • تمييز “متأخر”
  • معلومات وصفية أغنى لسير عمل المواضيع
إعجاب واحد (1)

تحديث ضخم للغاية:

عرض كانبان الجديد:

  • تمت إضافة وضع كانبان كامل إلى /workflow مع تبديل بين القائمة/كانبان، يظهر فقط عندما يكون سير عمل واحد متوافق مع كانبان ضمن النطاق.
    • تم تقديم تحقق صريح من توافق كانبان (بما في ذلك تعيين الحافة الحتمية) وعرض حالة التوافق في إدارة سير العمل.
  • جعل عناصر سير العمل قابلة للتنفيذ من كانبان: السحب والإفلات بين الخطوات القانونية، ونقل الخطوات باستخدام مفاتيح الأسهم، والنقر للانتقال لفتح المواضيع.
  • تحسين الموثوقية للتحديثات المتزامنة: عمليات الانتقال القديمة (stale) تُرجع الآن 409، وتُظهر رسالة حالة قديمة واضحة، وتُطلق تحديثًا لإعادة مزامنة حالة واجهة المستخدم.
  • سهولة استخدام اللوحة ووضوحها: علامات كانبان اختيارية على مستوى سير العمل، ودعم مؤشر التأخير على البطاقات، وتنسيق المسارات بما في ذلك حدود الأعمدة الملونة حسب الفئة.
4 إعجابات

تحديث كبير آخر - مخطط حرق/انخفاض (burn-up/down chart) عبر الإنترنت (كبديل لطيف لاستعلام مستكشف البيانات المضمن الحالي)

  • تمت إضافة عرض مخطط سير العمل الجديد في الاكتشاف (discovery) مع محدد عرض مشترك (قائمة / كانبان / مخطط) وعنصر تحكم في الفترة (من أسبوع إلى 12 أسبوعًا).
    • تم تنفيذ واجهة برمجة تطبيقات بيانات الحرق/الانخفاض (burn-down data API) على /discourse-workflow/charts.json بالإضافة إلى تكامل المسار /workflow/charts.
    • يتم تحديد الوصول إلى المخطط بشكل منفصل: المسؤولون والمجموعات المسموح لها بعرض مخططات سير العمل (workflow_charts_allowed_groups)؛ يتم إخفاء المخطط عن المستخدمين غير المصرح لهم.
    • تم تشديد حمولة المخطط (Chart payload) لتقتصر على سياق سير العمل المحدد فقط (selected_workflow_id, selected_workflow_name, series)، مما أدى إلى إزالة سطح كتالوج سير العمل غير المستخدم.
    • تمت إضافة تغطية الطلبات/النظام وتقوية تجربة المستخدم: نوافذ أسبوع كاملة، تسميات محاور آمنة للتاريخ المحلي، تسميات محدد عرض يمكن الوصول إليها، وفحوصات تراجع عرض/حالة المخطط.

يجب أن تكون ميزة المخططات متوافقة مع جميع سير العمل:

  • لا يتطلب المخطط التوافق مع كانبان (Kanban)، لذا فهو يعمل مع سير العمل غير المتوافق مع كانبان.
    • يظهر المخطط فقط عندما يتم تحديد قائمة سير العمل الحالية على سير عمل واحد بالضبط.
    • يجب أن يكون لدى المستخدم إذن الوصول إلى المخطط (مسؤول أو ضمن المجموعات المسموح لها بعرض مخططات سير العمل workflow_charts_allowed_groups).
    • إذا كان متوافقًا مع كانبان، يعرض القائمة المنسدلة القائمة/كانبان/المخطط.
    • إذا لم يكن متوافقًا مع كانبان، يمكن للقائمة المنسدلة أن تعرض القائمة/المخطط (عندما يتحقق الشرطان المذكوران أعلاه).
إعجاب واحد (1)