hesabixCore/webUI/src/views/acc/inquiry

پنل استعلامات

این بخش شامل قابلیت‌های مختلف استعلام و تبدیل اطلاعات است که بر اساس تنظیمات سیستم فعال یا غیرفعال می‌شوند.

قابلیت‌های موجود

1. تبدیل کد پستی به آدرس

• وضعیت: فعال/غیرفعال بر اساس تنظیمات سیستم
• کارمزد: قابل تنظیم در بخش مدیریت
• API Endpoint: /api/plugins/inquiry/postalcode-to-address
• عملکرد: تبدیل کد پستی 10 رقمی به آدرس کامل

2. تبدیل شماره کارت به شبا

• وضعیت: فعال/غیرفعال بر اساس تنظیمات سیستم
• کارمزد: قابل تنظیم در بخش مدیریت
• API Endpoint: /api/plugins/inquiry/card-to-sheba
• عملکرد: تبدیل شماره کارت 16 رقمی به شماره شبا (در حال توسعه)

3. تبدیل حساب به شبا

• وضعیت: فعال/غیرفعال بر اساس تنظیمات سیستم
• کارمزد: قابل تنظیم در بخش مدیریت
• API Endpoint: /api/plugins/inquiry/account-to-sheba
• عملکرد: تبدیل شماره حساب بانکی به شماره شبا (در حال توسعه)

ویژگی‌های رابط کاربری

نمایش سرویس‌های فعال

• نمایش کارت‌های رنگی برای هر سرویس فعال
• نمایش کارمزد هر سرویس
• نشان‌گذاری وضعیت فعال/غیرفعال

دیالوگ‌های استعلام

• فرم‌های اعتبارسنجی شده
• نمایش کارمزد قبل از استعلام
• نمایش نتیجه در قالب پیام‌های زیبا

مدیریت خطاها

• بررسی موجودی کافی
• نمایش پیام‌های خطای مناسب
• لاگ کردن عملیات‌ها

تنظیمات مورد نیاز

برای فعال‌سازی این قابلیت‌ها، مدیر سیستم باید در بخش تنظیمات سیستم موارد زیر را تنظیم کند:

1. فعال‌سازی پنل استعلامات: inquiryPanelEnable
2. انتخاب پنل: inquiryPanel (فعلاً فقط زحل)
3. کلید API پنل: inquiryZohalAPIKey
4. فعال‌سازی هر سرویس: enablePostalCodeToAddress, enableCardToSheba, enableAccountToSheba
5. تعیین کارمزد: postalCodeToAddressFee, cardToShebaFee, accountToShebaFee

نکات فنی

• تمام درخواست‌ها نیاز به احراز هویت دارند
• کارمزد از موجودی SMS کاربر کسر می‌شود
• نتایج در کش ذخیره می‌شوند تا از تکرار درخواست‌های مشابه جلوگیری شود
• تمام عملیات لاگ می‌شوند

توسعه آینده

• تکمیل سرویس‌های تبدیل کارت و حساب به شبا
• اضافه کردن سرویس‌های جدید
• بهبود رابط کاربری
• اضافه کردن گزارش‌گیری