فعال‌سازی و تنظیمات شاهکار

> version: 2.3 | last_updated: 2026-09-20 | audience: admin

منو

**تنظیمات → تنظیمات اصلی → تب تنظیمات شاهکار**

مسیر: `/panel/main-settings/compliance-provider-configs`
(مسیر قدیمی `/panel/compliance-provider-configs` ریدایرکت می‌شود)

برای هر شرکت **فقط یک** صفحه تنظیمات وجود دارد (نه لیست چندتایی). اتصال و سیاست استعلام همگی از همین‌جا است.

مدل

| مدل | وضعیت |
|-----|--------|
| **اپراتوری** | فعال — نیاز به آدرس/IP، کد ۴رقمی، یوزر، پسورد |
| **NSCRA** | فقط انتخاب مدل؛ جزئیات اتصال و API بعداً |

اگر مدل NSCRA باشد و استعلام/service match برای یک trigger روشن باشد، ذخیره مشتری با پیام خطا بلاک می‌شود.

اتصال اپراتوری

`base_url` — مثلاً `http://45.9.252.67:9580`

`shahkar_code` — کد ۴رقمی

`username` / `password` — Basic Auth

دکمه **تست اتصال** → `POST …/rest/shahkar/hc`

**منبع واحد:** کارتابل (`{{shahkar_base_url}}` / `{{shahkar_authorization}}`) و گیت ثبت‌نام/ویرایش فقط از همین منو می‌خوانند.
شاهکار دیگر در **سرورهای بیرونی** قابل تعریف نیست.

وب‌سرویس‌ها روی ثبت‌نام / ویرایش

به تفکیک فعال می‌شوند؛ برای هر کدام زمان اجرا جداست:

ثبت‌نام از پنل ریسلر

ویرایش از پنل ریسلر

ثبت‌نام از پنل مشتری

ویرایش از پنل مشتری

| سرویس | متد | رفتار شکست |
|--------|------|------------|
| استعلام هویت | `estelaam` | اگر تیک فعال باشد و پاسخ ناموفق → **جلو ذخیره** |
| service match | `serviceID-matching` | همین‌طور؛ بدون `serviceNumber` هم بلاک با پیام واضح |

نتایج در **گزارش‌گیری → گزارش شاهکار** با `provider = gate.estelaam` / `gate.service_match` ثبت می‌شوند.

کارتابل (lifecycle)

متدهای `put` / `update` / `close` / … جدا هستند؛ نوع سرویس از `provisioning_config.shahkar_service_type` محصول می‌آید.
مستندات: [shahkar-workflow-actions.md](./shahkar-workflow-actions.md)