cortado

كورتادو

Cortado هي أداة تعدين عملياتية مخصصة لاكتشاف العمليات التفاعلية/التزايدية

نظرة عامة على الوظائف

• استيراد سجلات الأحداث .xes ونماذج العملية الأولية .ptml
• استكشف سجلات الأحداث بصريًا باستخدام مستكشف المتغيرات
• اكتشف نماذج العملية الأولية من سلوك العملية الذي حدده المستخدم
• قم بتوسيع نماذج العملية بشكل متزايد من خلال سلوك العملية الذي يحدده المستخدم
• قم بتحرير نماذج العملية قيد الإنشاء يدويًا في أي وقت
• تصدير نماذج العمليات المكتشفة كملفات .ptml أو .pnml
• تحليل الأداء الزمني، القائم على النموذج والمستقل عن النموذج

التنزيلات

تتوفر الإصدارات المستقلة لأنظمة التشغيل Windows 10/11 و Linux و macOS (Apple Silicon فقط) من صفحة إصدارات GitHub.

تجريبي

Cortado_Demo.mp4

هيكل المستودع

• src/ يحتوي على الكود المصدري لـ Cortado
  • يحتوي src/backend على الواجهة الخلفية المستندة إلى Python الخاصة بـ Cortado
  • يحتوي src/frontend على واجهة Cortado الأمامية التي تعتمد على تقنيات الويب، أي تطبيق ويب Angular مضمن في ملف قابل للتنفيذ باستخدام Electron
• يحتوي build_scripts/ على نصوص برمجية لإنشاء ملفات تنفيذية مستقلة لأنظمة التشغيل الرئيسية الثلاثة: Windows، وLinux، وmacOS. (يُرجى التأكد من اتباع تعليمات الإعداد بشكل صحيح قبل تنفيذ البرامج النصية للإنشاء.)
• LICENSE.txt
• README.md
• يحتوي CHANGELOG.md على تاريخ إصدارات Cortado

يثبت

تثبيت تبعيات الواجهة الأمامية

• تثبيت Node.js أحدث إصدار LTS: 18.13.0 (https://nodejs.org/en/download/)
• تثبيت كافة الحزم التي تتطلبها الواجهة الأمامية
  • انتقل إلى src/frontend/
  • تنفيذ npm install (يقوم هذا الأمر بتثبيت جميع التبعيات المدرجة في src/frontend/package.json )
    عند إنشاء Cortado كتطبيق مستقل، نريد التأكد من أن حزمة التطبيق تتضمن فقط التبعيات المطلوبة. نظرًا لأنه يتم تجميع تبعيات Angular عبر حزمة الويب، فإننا لا نريد تضمينها. ومن ثم، يجب تضمين التبعيات المستخدمة فقط في قاعدة التعليمات البرمجية Angular ضمن الكلمة الأساسية devDependencies في ملف package.json . يجب تضمين جميع التبعيات المستخدمة في قاعدة بيانات الإلكترون ضمن الكلمة الأساسية dependencies .)

تثبيت تبعيات الواجهة الخلفية

• قم بتثبيت Python 3.10.x (https://www.python.org/downloads/). تأكد من تثبيت إصدار 64 بت.
• اختياري (مستحسن): قم بتثبيت Graphviz (مطلوب بواسطة PM4Py) وأضفه إلى PATH الخاص بك، راجع https://graphviz.org/download/ وhttps://pm4py.fit.fraunhofer.de/static/assets/api/2.3 .0/install.html
• اختياري (مستحسن): قم بإنشاء بيئة افتراضية (https://docs.python.org/3/library/venv.html) وقم بتنشيطها
• تثبيت جميع الحزم التي تتطلبها الواجهة الخلفية
  • انتقل إلى src/backend/
  • تنفيذ pip install -r requirements.txt

تنفيذ كورتادو من الكود

ابدأ الواجهة الخلفية

• انتقل إلى src/backend/
• تنفيذ python main.py
• لإعادة التحميل الديناميكي لملفات التعليمات البرمجية المصدر، قم بتعيين متغير البيئة CORTADO_DEBUG إلى 1

ابدأ الواجهة الأمامية

• في متصفح الويب
  • انتقل إلى src/frontend/
  • نفذ npm start لإنشاء وتشغيل الواجهة الأمامية لـ Cortado
  • افتح متصفحك على http://localhost:4444/
• في نافذة مخصصة لنظام التشغيل الحالي
  • انتقل إلى src/frontend/
  • نفذ npm start لإنشاء وتشغيل الواجهة الأمامية لـ Cortado
  • قم بتنفيذ npm run electron-live-reload الذي يبدأ نافذة باستخدام Cortado

إنشاء Cortado—تطبيق مستقل

لإنشاء ملفات تنفيذية من الكود المصدري، يجب تحويل كل من الواجهة الخلفية والواجهة الأمامية. نستخدم PyInstaller (https://pyinstaller.org/) لتجميع جميع الملفات ذات الصلة بالواجهة الخلفية في ملف واحد قابل للتنفيذ. نستخدم Electron (https://www.electronjs.org/) لإنشاء ملف قابل للتنفيذ للواجهة الأمامية.

يوجد في build_scripts/ نصوص برمجية لكل نظام تشغيل رئيسي لإنشاء Cortado.

• Windows build_scripts/build_cortado_windows.ps1
• نظام التشغيل MacOS build_scripts/build_cortado_macos.sh
• Linux build_scripts/build_cortado_linux.sh

لاحظ أن نظام التشغيل يجب أن يتطابق مع البرنامج النصي، وإلا فسوف تفشل عملية الإنشاء. وبالتالي، إذا كنت تقوم بإنشاء Cortado لنظام التشغيل Windows، فيجب عليك تشغيل البرنامج النصي المقابل على جهاز يعمل بنظام Windows.

بعد التنفيذ الناجح لبرنامج البناء النصي، يقع البناء في src/frontend/

المساهمة

Linting وجودة الكود

للحفاظ على جودة التعليمات البرمجية والتنسيق المتسقين، قمنا بدمج مسارات عمل Github جنبًا إلى جنب مع البرامج النصية npm لإجراء الفحص والإصلاح اليدوي لأخطاء التنسيق.

سير عمل جيثب

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

البرامج النصية npm

بالإضافة إلى سير العمل الآلي، قمنا بإعداد نصوص برمجية npm تسهل التطوير المحلي والفحص اليدوي لأخطاء التنسيق.

• لإجراء فحص شامل عبر ملفات TypeScript وHTML وSASS، استخدم: npm run lint

• إذا تم اكتشاف مشكلات في الفحص، فيمكنك بدء إصلاحات تلقائية لملفات TypeScript وSASS باستخدام: npm run lint-scripts-fix و npm run lint-styles-fix

• بالنسبة لملفات HTML، يمكنك مراجعة المشكلات التي تم تحديدها بواسطة linter وإصلاحها يدويًا.

• نحن ندعم أيضًا عمليات التحقق من تنسيق كود Python باستخدام الأمر: black --check .

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

المنشورات ذات الصلة لكورتادو

النشر	المؤلفون	سنة
تحليل عمليات الرعاية الصحية من خلال اكتشاف العمليات الإضافية: رؤى عملية من تطبيق في العالم الحقيقي	شوستر، D.، بينيفينتو، E.، ألويني، D.، فان دير آلست، WMP	2024
تحديد وتصور متغيرات تنفيذ العملية من بيانات الأحداث المرتبة جزئيًا	شوستر، D.، زيرباتو، F.، فان زيلست، SJ، فان دير آلست، WMP	2024
الاكتشاف المتزايد لنماذج العمليات باستخدام أجزاء التتبع	شوستر، د.، فوكينج، ن.، فان زيلست، إس جيه، فان دير آلست، WMP	2023
استخراج أنماط Infix المتكررة من متغير تنفيذ العملية المتزامنة	مارتيني، إم، شوستر، دي، ويل إم بي فان دير آلست	2023
Cortado: أداة مخصصة لتعدين العمليات لاكتشاف العمليات التفاعلية	شوستر، D.، فان زيلست، SJ، فان دير آلست، WMP	2023
الاستعلام القائم على التحكم في التدفق لعمليات تنفيذ العمليات من بيانات الأحداث المرتبة جزئيًا	شوستر، د.، مارتيني، م.، فان زيلست، إس جيه، فان دير آلست، WMP	2022
التحقق من المطابقة لأجزاء التتبع باستخدام محاذاة Infix وPostfix	شوستر، د.، فوكينج، ن.، فان زيلست، إس جيه، فان دير آلست، WMP	2022
تحليل الأداء الزمني لنماذج العمليات المهيكلة في كورتادو	شوستر، D.، شايد، L.، فان زيلست، SJ، فان دير آلست، WMP	2022
إطار عمل عام لترتيب التتبع لاكتشاف العمليات التزايدية	شوستر، D.، دومنيتش، E.، فان زيلست، SJ، فان دير آلست، WMP	2022
تجميد النماذج الفرعية أثناء اكتشاف العمليات التزايدية	شوستر، D.، فان زيلست، SJ، فان دير آلست، WMP	2021
تصور متغيرات التتبع من بيانات الأحداث المرتبة جزئيًا	شوستر، D.، شايد، L.، فان زيلست، SJ، فان دير آلست، WMP	2021
Cortado—أداة تفاعلية لاكتشاف العمليات المبنية على البيانات ووضع نماذج لها	شوستر، D.، فان زيلست، SJ، فان دير آلست، WMP	2021
الاكتشاف المتزايد لنماذج العمليات الهرمية	شوستر، D.، فان زيلست، SJ، فان دير آلست، WMP	2020

نقلا عن كورتادو

إذا كنت تستخدم Cortado أو تشير إليه في العمل العلمي، فيرجى الاستشهاد بـ Cortado على النحو التالي.

شوستر، د.، فان زيلست، إس جيه، فان دير آلست، WMP (2023). Cortado: أداة مخصصة لتعدين العمليات لاكتشاف العمليات التفاعلية. سوفتويركس المجلد. 22. إلسفير. https://doi.org/10.1016/j.softx.2023.101373.

تنزيل الاقتباس https://www.sciencedirect.com/science/article/pii/S2352711023000699

DOI 10.1016/j.softx.2023.101373

اتصال

إذا كنت مهتمًا بـ Cortado، تواصل معنا إذا كان لديك أي أسئلة أو طلب مخصص عبر البريد - [email protected]