Workflow و گزارشگیری
> version: 1.23 | last_updated: 2026-09-26 | audience: admin
Workflow محصول (مسیر عملیاتی)
منوی اصلی: **تنظیمات → Workflow محصول**
گراف مسیر: در همان لیست، دکمهٔ **نمایش** کنار ویرایش (صفحهٔ جدا در منو نیست).
بخشها:
صفحهٔ گراف از دکمهٔ **نمایش** در لیست Workflow محصول باز میشود. روی **نمودار مسیر**: بزرگ/کوچکنمایی (ذرهبین)، **پرینت**، و **خروجی PDF**.
اتصال به دسته محصول
دو جا میتوان وصل کرد:
از خود Workflow محصول (تب / مرحله «اتصال به دسته»)
از دسته محصول (کارتابل عملیاتی)
در **کاتالوگ → دستهبندی محصول**، بخش کارتابل همان مقصد:
با ثبت سفارش / درخواست جمعآوری، کار در کارتابل همان Workflow ساخته میشود.
انتقال خودکار
روی وضعیت (مثلاً «پرداخت انجام شد»): دپارتمان بعدی + وضعیت بعدی.
اسکالیشن فقط داخل **همان Workflow محصول** مجاز است.
کارتابل فروش
**سفارش و اشتراک → کارتابل فروش** — صف کارهای فروش/فرایند (تغییر وضعیت، ارجاع، اسکالیشن، تاریخچه).
لیست کارتابل سه تب دارد (پیشفرض: **منتظر پاسخ**):
| تب | معنی |
|----|------|
| منتظر پاسخ | کارهای در صف بررسی / منتظر اقدام |
| فعال | کارهای در حال انجام |
| بسته شده | کارهای تمامشده |
نوع هر وضعیت هنگام تعریف در Workflow محصول (فیلد «نوع وضعیت در کارتابل»: فعال / منتظر پاسخ / بسته شده) مشخص میشود؛ `is_closed` از «بسته شده» همگام میماند.
با ثبت سفارش، کار در کارتابل فروش همان Workflow ساخته میشود.
لیست و خلاصه: دپارتمان با بج **بنفش**، وضعیت با بج **نارنجی** (همان قرارداد مسیر پشتیبانی / Workflow محصول).
در **مشاهده کار**:
| بخش | توضیح |
|-----|--------|
| موقعیت در Workflow | جمعشونده (**پیشفرض بسته**). داخلش دو باکس باز/بسته: موقعیت فعلی + نمودار Mermaid. همان ویو در کارتابل فروش نماینده هم هست |
| خلاصه | جمعشونده (**پیشفرض باز**); کارتهای مرتب + شرح مشتری + لینک جزئیات سرویس (`case-summary`) — Tenant و نماینده مشترک |
| تاریخچه | جمعشونده (**پیشفرض بسته**)؛ نوع رویداد و یادداشت فارسی؛ زمان شمسی |
> نکته فنی: `payload` آرایه است؛ قبل از رندر به JSON رشته میشود تا خطای «Array to string conversion» رخ ندهد.
> ویوی پیشرفت: `case-workflow-progress.blade.php` + `WorkflowGraphService::progressForCase()` (و روی سفارش: `order-workflow-progress.blade.php`).
موتور فروش خودکار (مخفی از منو)
مراحل `order.validate` / اشتراک و … از `workflow_definitions` در پسزمینه اجرا میشوند؛ از منو مخفیاند.
| Handler | کاربرد |
|---------|--------|
| order.validate | اعتبارسنجی سفارش |
| order.identity_check | شاهکار |
| order.create_subscription | ایجاد اشتراک |
| order.provision | Provisioning |
| order.complete | تکمیل سفارش |
تکرار مسیر ناموفق
اگر کار در کارتابل گیر کرد، از **کارتابل فروش → مشاهده کار** وضعیت/اسکالیشن را اصلاح کنید.
روی **مشاهده سفارش** و **مشاهده کار فروش** موقعیت فعلی را گرافیکی نشان میدهند.
گزارشها
Dashboard و گزارشگیری → گزارشها.