گزارش شاهکار

ورود / ثبت‌نام
← بازگشت به راهنما

گزارش شاهکار



> 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


  • لاگ کامل تمام تماس‌های شاهکار برای ممیزی و انطباق