5.5 KiB
میانبرهای دکمههای پرداخت فروش سریع
رفتار
دکمههای پرداخت همچنان در بخش پرداخت فروش سریع تعریف میشوند. هر دکمه در دو محیط، پروفایل مستقل دارد:
- برنامه ویندوز؛
- رابط وب.
برای هر محیط، ترتیب انتخاب میانبر مؤثر چنین است:
personal override > business default > no shortcut
میانبرها هنگام بارگذاری دکمهها یکبار از API دریافت و در حافظه نگهداری میشوند. فشردن کلید درخواست دیتابیس یا API ایجاد نمیکند.
محل تنظیمات و دسترسی
پیشفرضهای کسبوکار در صفحه «تنظیمات فروش سریع»، بخش «میانبرهای پیشفرض پرداخت» مدیریت میشوند. دکمه مدیریت پیشفرضها داخل نوار پرداخت نمایش داده نمیشود.
مجوز مستقل زیر در جدول کاربران و دسترسیها قرار دارد:
quick_sales.manage_default_payment_shortcuts
مالک و superadmin بهصورت ضمنی مجازند. کاربری که فقط این مجوز را دارد میتواند وارد صفحه تنظیمات فروش سریع شود، ولی سایر تنظیمات آن صفحه برای او نمایش داده نمیشود.
تنظیم شخصی از منوی هر دکمه پرداخت و گزینه «میانبرهای شخصی» انجام میشود. کاربر برای ویندوز و وب میتواند یکی از این سه حالت را انتخاب کند:
- استفاده از پیشفرض کسبوکار؛
- میانبر شخصی من؛
- بدون میانبر برای من.
ذخیرهسازی
پیشفرض ویندوز در quick_sales_payment_buttons.shortcut و پیشفرض وب در quick_sales_payment_buttons.web_shortcut نگهداری میشود. ستون وب با migration زیر اضافه شده است:
20261015_000001_quick_sales_web_shortcut
تنظیم شخصی در JSON جدول user_ui_preferences و به تفکیک کسبوکار و پلتفرم ذخیره میشود:
{
"quick_sales_payment_shortcuts": {
"4952": {
"windows": {
"17": "F12",
"22": "__DISABLED__"
},
"web": {
"17": "ALT+1"
}
}
}
}
__DISABLED__ یعنی میانبر همان دکمه فقط برای آن کاربر و آن محیط غیرفعال است. پیشفرض مالک برای کاربران کپی نمیشود؛ در نتیجه تغییر بعدی پیشفرض برای کاربرانی که override ندارند فوراً اعمال میشود.
API
فهرست دکمهها:
GET /api/v1/businesses/{business_id}/quick-sales/payment-buttons
هر دکمه shortcut_profiles دارد:
{
"shortcut_profiles": {
"windows": {
"default_shortcut": "F1",
"user_shortcut": "F8",
"effective_shortcut": "F8",
"shortcut_source": "user",
"shortcut_conflict": false,
"user_shortcut_disabled": false
},
"web": {
"default_shortcut": "ALT+1",
"user_shortcut": null,
"effective_shortcut": "ALT+1",
"shortcut_source": "business",
"shortcut_conflict": false,
"user_shortcut_disabled": false
}
}
}
فیلدهای سطح اول میانبر برای سازگاری با کلاینت قدیمی، نماینده پروفایل ویندوز هستند.
تنظیم شخصی:
PUT /api/v1/businesses/{business_id}/quick-sales/payment-buttons/{button_key}/shortcut
رابط جدید هر دو پروفایل را در یک درخواست و یک تراکنش ذخیره میکند:
{
"platforms": {
"windows": {"mode": "inherit", "shortcut": null},
"web": {"mode": "custom", "shortcut": "ALT+1"}
}
}
برای سازگاری، ارسال یک platform نیز پشتیبانی میشود. نام پلتفرم یکی از windows و web و mode یکی از inherit، custom و disabled است.
فهرست و ذخیره یکجای پیشفرضها:
GET /api/v1/businesses/{business_id}/quick-sales/payment-buttons/default-shortcuts
PUT /api/v1/businesses/{business_id}/quick-sales/payment-buttons/default-shortcuts
{
"shortcuts": [
{
"button_id": 17,
"shortcuts": {"windows": "F1", "web": "ALT+1"}
}
]
}
تمام ردیفها پیش از تغییر دیتابیس اعتبارسنجی میشوند. تکراریبودن میانبر بهصورت مستقل در هر پلتفرم بررسی میشود.
کلیدهای مجاز
در ویندوز:
F1تاF12؛- ترکیب
CTRL،ALTیاSHIFTبا حرف، عدد یا کلید تابع.
در وب:
- ترکیبی شامل
CTRLیاALTو یک حرف یا عدد، مانندALT+1یاCTRL+ALT+R؛ - کلیدهای تابع بهتنهایی پذیرفته نمیشوند؛
- ترکیبهای رزروشده مرورگر مانند
CTRL+L،CTRL+RوCTRL+Pپذیرفته نمیشوند.
هنگامی که فوکوس داخل فیلد متنی است، میانبر وب اجرا نمیشود. در هر محیط، نگاشت نهایی فقط از effective_shortcut ساخته میشود و یک کلید همزمان دو پرداخت را فعال نمیکند.