← بازگشت به راهنما
گزارش شاهکار
> version: 1.1 | last_updated: 2026-09-20 | audience: admin
منو
**گزارشگیری → گزارش شاهکار**
مسیر: `/panel/identity-verifications`
این صفحه لاگ کامل **تمام** ارسالیهای شاهکار را نشان میدهد — شامل احراز هویت مشتری و عملیات سرویسها.
انواع لاگ
۱. احراز هویت مشتری
منبع: **گیت ثبتنام** (پنل مشتری یا پنل ریسلر)
عملیات:
- **استعلام هویت** (`estelaam`) — تأیید کد ملی و موبایل
- **service match** (`serviceID-matching`) — تطابق شماره سرویس با کد ملی
زمان اجرا: هنگام ثبتنام یا ویرایش مشتری (اگر در تنظیمات شاهکار فعال باشد)
Provider: `gate.estelaam` یا `gate.service_match`
۲. لاگ سرویسها
منبع: **کارتابل فروش** (workflow actions)
عملیات: تمام متدهای شاهکار برای سرویسها
- `put` — ثبت سرویس جدید
- `update` — بهروزرسانی اطلاعات
- `close` — بستن سرویس
- `estelaam` — استعلام روی سرویس
- و دیگر متدهای V8.4
زمان اجرا: خودکار از وضعیتهای کارتابل (action_mode: `on_enter`) یا دستی از دکمه «اجرای عملیات»
Provider: `http.estelaam` یا `shahkar.*`
ستونهای جدول
| ستون | توضیح |
|------|-------|
| **شخص** | نام/نامخانوادگی مشتری |
| **کد ملی** | کد ملی مشتری (قابل جستجو) |
| **موبایل** | شماره موبایل ارسالی (قابل جستجو) |
| **وضعیت** | موفق (`verified`) یا ناموفق (`failed`) |
| **Provider** | نوع عملیات: استعلام، service match، یا شبیهساز |
| **دسته سرویس** | ADSL، اختصاصی، VPS، و … (خالی برای استعلام هویت محض) |
| **سفارش** | شماره سفارش مرتبط (اگر وجود داشته باشد) |
| **تاریخ** | زمان تأیید یا زمان ایجاد |
فیلترها
**وضعیت**: موفق / ناموفق / در حال بررسی / لغوشده
**نوع عملیات**: استعلام / service match / شبیهساز
**دسته سرویس**: اینترنت / ADSL / اختصاصی / VPS / Colocation
**شرکت** (فقط سوپرادمین): فیلتر بر اساس Tenant
صفحه جزئیات
کلیک روی هر ردیف → جزئیات کامل:
بخش اطلاعات مشتری
شخص
کد ملی
موبایل
شماره حساب مشتری
بخش اطلاعات عملیات
وضعیت (badge رنگی)
نوع عملیات (Provider)
دسته سرویس
Reference ID
زمان تأیید
زمان ایجاد
بخش سفارش / سرویس
(فقط اگر عملیات روی سفارش اجرا شده باشد)
شماره سفارش
وضعیت سفارش
بخش پیام و نتیجه
پیام کامل برگشتی از سرور شاهکار
Payload
**Request Payload**: دادههای ارسالی (collapsed)
**Response Payload**: پاسخ کامل JSON (collapsed)
نکات
**ثبت خودکار**: عملیات شاهکار کارتابل به صورت خودکار در `WorkflowCaseActionRunner` شناسایی و ثبت میشوند (بدون نیاز به تنظیم `record_shahkar`)
**منبع واحد**: تنظیمات اتصال فقط از **تنظیمات → تنظیمات اصلی → تب تنظیمات شاهکار** خوانده میشود؛ دیگر از سرورهای بیرونی نیست
**Payload کامل**: request و response برای عیبیابی ذخیره میشوند
**جستجو**: کد ملی، موبایل، و شماره سفارش قابل جستجو هستند
**اتصال به Party**: هر لاگ به `party_id` لینک دارد — اگر مشتری ادغام شود، لاگ به party جدید منتقل میشود
موارد استفاده
گزارشگیری
تعداد موفق/ناموفق شاهکار در بازه زمانی
عملیات برای یک مشتری خاص (فیلتر کد ملی)
service match برای یک سفارش خاص
عیبیابی
چرا استعلام مشتری شکست خورد؟ → Response Payload
شماره سرویس ارسالی به شاهکار چه بود؟ → Request Payload
آیا عملیات `put` برای این سرویس اجرا شده؟ → جستجوی شماره سفارش
Compliance
لاگ کامل تمام تماسهای شاهکار برای ممیزی و انطباق