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

[merefield (Robert)]

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

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

ملخص

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

يمكن أن تمثل العملية سير عمل، أو تدفق موافقات، أو قائمة انتظار للدعم، أو خط مراجعة، أو أي عمل مرحلي آخر.

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

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

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

الميزات

• سير عمل لإدارة العمليات باستخدام مواضيع Discourse كعناصر عمل

• سير عمل، وخطوات، وخيارات خطوات محددة من قبل المشرفين

• محرر سير عمل مرئي لترتيب الخطوات، ومسارات السباحة، وموصلات الانتقال

• 

• مبني على مفاهيم Discourse الأساسية: التصنيفات، والمجموعات، والوسوم، والإشعارات، والصلاحيات القائمة على التصنيفات

• تظل صلاحيات الإجراءات قريبة من سلوك Discourse: يمكن للمستخدمين التصرف فقط حيث يمتلكون بالفعل صلاحيات التصنيف الصحيحة

• اكتشاف العمليات في /processes مع مرشحات سريعة:

  • تصنيفاتي
  • متأخرة
  • الخطوة = X

• محدد عرض الاكتشاف:

  • قائمة

  • كانبان، يُعرض فقط لسياق سير عمل واحد متوافق مع كانبان

  • رسم بياني، يُعرض فقط لسياق عملية واحدة ولمستخدمين مُصرح لهم بالرسوم البيانية

    

  • رسم بياني، يُعرض فقط لسياق سير عمل واحد ولمستخدمين مُصرح لهم بالرسوم البيانية

    

• لوحة سير عمل كانبان:

  • بطاقات مواضيع قابلة للنقر
  • انتقالات سحب وإفلات قانونية
  • انتقالات عبر لوحة المفاتيح باستخدام ArrowLeft / ArrowRight حيث يكون ذلك قانونيًا

• شريط موضوع سير العمل:

  • سير العمل والخطوة الحالية
  • إجراءات الانتقال المتاحة
  • رابط التصور

• نموذج التأخر مع التسلسل الهرمي:

  • إعداد عام: process_manager_overdue_days_default
  • تجاوز العملية
  • تجاوز الخطوة
  • 0 يعطل التأخر في هذا النطاق
  • مؤشرات التأخر في قائمة العمليات وبطاقات كانبان

• رسم بياني لانخفاض سير العمل:

  • نقطة نهاية الرسم البياني وتكامل واجهة المستخدم
  • محدد نطاق أسبوعي من 1 إلى 12 أسبوعًا
  • نوافذ كاملة الأسبوع وسلاسل ملونة حسب الخطوة

• أثر تدقيق الانتقال عبر منشورات إجراءات صغيرة

• إشعارات الوصول للتصنيفات الخاضعة للمراقبة باستخدام «مراقبة المنشور الأول»

• تصور سير العمل متاح من الموضوع وعروض الاكتشاف

  ![تُظهر الصورة سير عمل للشراء يتضمن صياغة طلب شراء، وتقديمه للموافقة، ثم شراء العناصر المعتمدة. (وصفه الذكاء الاصطناعي)|628x499](upload://789sygIjVxX1igU6CzVUC0v6q5r.png)
  

• تكامل مع مستكشف البيانات مع استعلامات سير عمل افتراضية:
  - إحصائيات الانخفاض/الارتفاع
  - سجل التدقيق

• معالجة خطوة بمساعدة الذكاء الاصطناعي كخيار

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

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

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

عناصر العملية

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

الفاعلون

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

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

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

لوحة المعلومات

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

أثر التدقيق

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

التصور

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

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

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

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

للبدء:

1. فعّل الإضافة باستخدام process_manager_enabled.
2. انتقل إلى Admin -> Plugins -> Process Manager.
3. أنشئ عملية، احفظها، ثم أضف خطوات وخيارات خطوات.
4. قم بتكوين صلاحيات التصنيف بحيث يمتلك فاعلو العمليات صلاحية إنشاء مواضيع في تصنيفات الخطوات ذات الصلة.
5. أنشئ موضوعًا في تصنيف الخطوة الأولى.
6. انتقل إليه باستخدام أزرار إجراء الموضوع أو تفاعلات كانبان.
7. استخدم /processes لإدارة قائمة العمليات التشغيلية.

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

يمكن للذكاء الاصطناعي تنفيذ خطوة باستخدام التكامل المباشر لـ OpenAI في Process Manager. لا يعتمد هذا على Discourse AI.

المتطلبات:

• مفتاح API صالح لـ process_manager_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)