مدير سير العمل ↔

[merefield (Robert)]

	ملخص	إضافة لإدارة العمليات في Discourse تنقل العمل عبر خطوات قابلة للتكوين مع إجراءات، وفلاتر قوائم، ورسوم بيانية، وعروض بمسارات سباحة، ولوحات كانبان.
	رابط المستودع	https://github.com/merefield/discourse-workflow
	دليل التثبيت	كيفية تثبيت الإضافات في Discourse

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

ملخص

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

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

الميزات

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

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

مسارات السباحة

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

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

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

الفاعلون

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

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

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

لوحة التحكم

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

سجل التدقيق

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

التصور

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

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

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

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

البدء

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

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

يمكن للذكاء الاصطناعي تنفيذ خطوة عند تكوينه.

المتطلبات:

• مفتاح API صحيح لـ workflow_openai_api_key
• تفعيل الذكاء الاصطناعي في الخطوة
• يتضمن الأمر {{options}} و {{topic}}

مثال على الأمر:

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

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

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

[merefield (Robert)]

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

IMPROVE: make visualisation responsive and work on mobile

[merefield (Robert)]

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

FIX: AI job error

COMPATIBILITY: fix issue when navigating to workflow admin

[merefield (Robert)]

IMPROVE: add workflow topic title link, restrict additional workflow list columns to desktop

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

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

[merefield (Robert)]

FIX: mobile display, localisation

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

[Thomas_Rother (Thommie Rother)]

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

مشكلتان:

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

[merefield (Robert)]

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

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

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

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

@Thomas_Rother

إنشاء إجراء “بدء” على الموضوع الوارد يؤدي إلى “422 محتوى غير قابل للمعالجة” ربما تكون نتيجة 1)

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

[Thomas_Rother (Thommie Rother)]

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

https://forum2.netzwissen.de/login

[merefield (Robert)]

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

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

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

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

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

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

[merefield (Robert)]

@Thomas_Rother جرب ذلك:

FIX: position was being incorrectly allocated to new step

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

[Olle11]

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

[merefield (Robert)]

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

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

[merefield (Robert)]

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

FEATURE: Add daily workflow stats

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

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

[hellekin]

أحاول معرفة سبب بطء موقعي…

تحذير إيقاف

[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

[merefield (Robert)]

@hellekin

موقعي أصبح بطيئًا…

أشك كثيرًا في أن هذا هو سبب بطء موقعك!! - إنه تحذير إهمال.

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

[merefield (Robert)]

@hellekin

موقعي أصبح بطيئًا…

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

IMPROVE: performance

إلخ.

[merefield (Robert)]

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

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

FEATURE: filters, overdue & indicators, richer UX, admin fixes, more specs (#15)

[merefield (Robert)]

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

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

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

FEATURE: Kanban view for compatible workflows (#16)

[merefield (Robert)]

تحديث كبير آخر - مخطط حرق/انخفاض (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).
  • إذا كان متوافقًا مع كانبان، يعرض القائمة المنسدلة القائمة/كانبان/المخطط.
  • إذا لم يكن متوافقًا مع كانبان، يمكن للقائمة المنسدلة أن تعرض القائمة/المخطط (عندما يتحقق الشرطان المذكوران أعلاه).

FEATURE: online workflow burndown/up chart (#18)

[merefield (Robert)]

لقد أجريت مراجعة أداء كبيرة:

IMPROVE: Performance pass (#19)