HandyCafe Docs
owner cashier it-admin

واژه‌نامه

مرجع الفبایی اصطلاحات دامنه‌ای که در سراسر مستندات HandyCafe استفاده می‌شوند.


پنل مدیریت داشبورد اصلی پایش در HandyCafe Server. همه کلاینت‌های متصل، وضعیت آنها و نشست‌های فعال را نشان می‌دهد. همچنین روی هر کارت کلاینت دکمه‌های اقدام برای کنترل نشست و عملیات مدیریت از راه دور را فراهم می‌کند.

نرخ کمیسیون درصدی که برای بیان هزینه‌های پردازش پرداخت استفاده می‌شود. برای مثال، 1% یا 5%. در پیکربندی روش پرداخت برای تعریف هزینه پذیرش یک روش پرداخت خاص استفاده می‌شود.

پروتکل دودویی یک فرمت رمزگذاری فشرده که برای ارتباط TCP بین HandyCafe Server و کلاینت‌ها استفاده می‌شود. این فرمت به‌دلیل سرعت و اندازه کوچک پیام نسبت به قالب‌های متنی انتخاب شده است.

کلاینت یک رایانه روبه‌مشتری که نرم‌افزار HandyCafe Client را اجرا می‌کند. کلاینت‌ها از طریق شبکه محلی به سرور وصل می‌شوند، فرمان‌های نشست را دریافت می‌کنند و داده‌های وضعیت و استفاده را گزارش می‌دهند. هر کلاینت با آدرس MAC و hostname خود شناسایی می‌شود.

کلید اتصال یک راز مشترک که هنگام راه‌اندازی روی سرور و هر کلاینت پیکربندی می‌شود. از آن برای تولید tokenهای احراز هویت رمزنگاری‌شده برای ارتباط TCP استفاده می‌شود تا فقط دستگاه‌های مجاز بتوانند با سرور فرمان رد و بدل کنند.

کنسول یک دستگاه بازی مانند PlayStation یا Xbox که HandyCafe آن را مدیریت می‌کند. کنسول‌ها مانند PCهای کلاینت از نشست‌ها، قیمت‌گذاری و استفاده از عضو پشتیبانی می‌کنند، اما نرم‌افزار HandyCafe Client را اجرا نمی‌کنند. آنها با آدرس MAC ردیابی می‌شوند.

کافه‌تریا ماژول یکپارچه خدمات غذا و نوشیدنی در HandyCafe. این بخش شامل چیدمان بصری طبقات، مدیریت میزها، ویرایشگر منو با دسته‌بندی‌ها و محصولات، داشبورد زنده سفارش‌ها و منوی مشتری برندشده در handy.cafe/{slug} است. کافه‌تریا از مدل داده cloud-first استفاده می‌کند؛ پایگاه‌داده‌های محلی و ابری همگام می‌مانند.

کافه‌نت / cyber cafe کسب‌وکاری که دسترسی عمومی به رایانه‌ها و اینترنت را فراهم می‌کند و معمولاً هزینه را ساعتی دریافت می‌کند. به آن internet cafe هم گفته می‌شود. HandyCafe همه جنبه‌های عملیات کافه‌نت را از نشست‌ها و صورتحساب تا عضویت‌ها مدیریت می‌کند.

محدودیت دستگاه تنظیمی که مشخص می‌کند یک wallet credit، time credit یا قانون قیمت‌گذاری برای کدام نوع دستگاه اعمال می‌شود. مقادیر ممکن عبارت‌اند از: client (PCها)، console (کنسول‌های بازی)، PCs only، consoles only یا both (هر دستگاه).

سالن ورزش الکترونیک مکانی اختصاص‌داده‌شده به بازی رقابتی و رویدادهای esports که اغلب PCهای پرقدرت، بخش‌های برگزاری تورنمنت و جایگاه تماشاگران دارد. HandyCafe از سالن‌های ورزش الکترونیک با مدیریت نشست، ردیابی عضو و صورتحساب کنسول پشتیبانی می‌کند.

استحقاق ارزشی که عضو از خرید یک package دریافت می‌کند. این مقدار می‌تواند یک time credit (دقیقه‌های پیش‌پرداخت استفاده از نشست)، یک موجودی پولی کیف پول یا ترکیبی از هر دو باشد. entitlementها به‌صورت credit entry در کیف پول یا موجودی زمانی عضو ثبت می‌شوند.

نرخ FX نرخ تبدیل ارز خارجی که برای تبدیل ارز پایه به ارز نمایشی محلی استفاده می‌شود. این به کافه‌های مناطق با ارزهای متفاوت اجازه می‌دهد با حفظ یک مبنای حسابداری داخلی ثابت، قیمت را به ارز محلی خود نشان دهند.

مرکز بازی محیط تجاری‌ای که در آن مشتری‌ها برای استفاده از PC یا کنسول بازی پول می‌پردازند و معمولاً سخت‌افزار پرقدرت و فضای اجتماعی بازی ارائه می‌دهد. HandyCafe برای مدیریت عملیات مرکز بازی از صورتحساب نشست تا برنامه‌های عضویت ساخته شده است.

احراز هویت رمزنگاری‌شده مکانیزم تأیید پیام که برای تضمین یکپارچگی و اصالت پیام‌های TCP بین سرور و کلاینت‌ها استفاده می‌شود. هر دو طرف از Connection Key برای محاسبه و اعتبارسنجی کدهای احراز هویت استفاده می‌کنند.

اینترنت‌کافه کسب‌وکاری که دسترسی زمان‌دار به رایانه‌ها و خدمات اینترنتی را در اختیار مشتری‌ها می‌گذارد. اینترنت‌کافه‌ها اصلی‌ترین مورد استفاده HandyCafe هستند که مدیریت نشست، قیمت‌گذاری، برنامه‌های عضویت و عملیات نقطه‌فروش را بر عهده دارد.

بیکار وضعیت کلاینت وقتی که رایانه به سرور متصل است اما هیچ نشستی فعال نیست. در حالت بیکار، کلاینت صفحه قفل (IdlePage) را نمایش می‌دهد و منتظر شروع نشست، ورود عضو یا اقدام مدیریتی می‌ماند.

اعتبار کیف پول / اعتبار زمانی یک ورودی مجزا از موجودی کیف پول یا دقیقه‌های پیش‌پرداخت که با یک شارژ یا خرید package ایجاد می‌شود. هر credit منبع خود را ثبت می‌کند (شارژ نقدی، entitlement package، bonus کمپین)، ارزش باقی‌مانده و محدودیت دستگاه قابل‌اعمال را هم ذخیره می‌کند. creditها در زمان تسویه نشست به ترتیب مصرف می‌شوند.

آدرس MAC شناسه سخت‌افزاری‌ای که به یک رابط شبکه اختصاص داده می‌شود. HandyCafe از آدرس‌های MAC برای شناسایی یکتای کلاینت‌ها و کنسول‌ها استفاده می‌کند تا حتی اگر آدرس IP تغییر کند، دستگاه‌ها همچنان شناخته شوند.

mDNS (Multicast DNS) پروتکلی برای کشف خودکار سرویس در شبکه‌های محلی. کلاینت‌های HandyCafe حضور خود را از طریق mDNS اعلام می‌کنند و به سرور اجازه می‌دهند بدون پیکربندی دستی IP آنها را پیدا کند.

عضو مشتری ثبت‌شده‌ای که یک پروفایل در سیستم HandyCafe دارد. اعضا کیف پول، سطح tier و تاریخچه تراکنش دارند. آنها می‌توانند برای نشست‌های شخصی روی رایانه‌های کلاینت وارد شوند. اعضا ممکن است حساب‌های متصل به OAuth هم داشته باشند.

واحدهای خرد کوچک‌ترین واحد یک ارز که در محاسبات مالی داخلی استفاده می‌شود تا از خطای گرد کردن floating-point جلوگیری شود. برای مثال، USD از سنت استفاده می‌کند (1 dollar = 100 واحد خرد)، در حالی که JPY از خود ین استفاده می‌کند (1 yen = 1 واحد خرد).

ضریب عاملی که در یک slot برنامه قیمت‌گذاری روی نرخ پایه ساعتی اعمال می‌شود. ضریب 1.0 یعنی نرخ استاندارد اعمال می‌شود. ضریب 1.5 یعنی نرخ 50% بیشتر است (مثلاً ساعات اوج)، و 0.5 یعنی نصف قیمت (مثلاً تخفیف ساعات کم‌ترافیک).

PC bang یک کافه‌نت و مرکز بازی به سبک کره‌ای که مشتری‌ها برای دسترسی ساعتی به PC هزینه می‌پردازند. PC bangها به سخت‌افزار بازی پیشرفته و فرهنگ بازی رقابتی معروف‌اند. HandyCafe از عملیات PC bang با برنامه‌های قیمت‌گذاری انعطاف‌پذیر و مدیریت نشست پشتیبانی می‌کند.

آنلاین وضعیت کلاینت در طول یک نشست فعال. وقتی online است، کلاینت رابط دسکتاپ (OnlinePage) را نشان می‌دهد و به مشتری اجازه می‌دهد از برنامه‌ها استفاده کند، مرور کند و با منوی کلاینت تعامل داشته باشد.

پس‌پرداخت حالت صورتحساب نشست که در آن مشتری آزادانه از PC استفاده می‌کند و در پایان بر اساس مدت واقعی استفاده پرداخت می‌کند. هزینه نهایی هنگام بستن نشست با استفاده از segmentهای برنامه قیمت‌گذاری اعمال‌شده محاسبه می‌شود.

پیش‌پرداخت حالت صورتحساب نشست که در آن مشتری از قبل برای یک مدت مشخص پرداخت می‌کند. نشست به‌طور خودکار وقتی زمان خریداری‌شده تمام شود پایان می‌یابد، مگر اینکه تمدید شود.

بخش قیمت‌گذاری بخشی از یک نشست که در آن یک ضریب واحد قیمت‌گذاری اعمال می‌شود. مرزهای segment با رویدادهایی مثل شروع نشست، مکث، resume یا تغییر slot قیمت‌گذاری در برنامه ایجاد می‌شوند.

اسلات قیمت‌گذاری یک ناحیه رنگی در grid هفتگی برنامه قیمت‌گذاری. هر slot یک بازه زمانی و ضریبی را تعریف می‌کند که نرخ پایه ساعتی را تغییر می‌دهد. slotها می‌توانند ساعات مشخصی را در روزهای مشخص پوشش دهند و قیمت‌های متفاوتی برای دوره‌های اوج و کم‌ترافیک فعال کنند.

نقش مجموعه‌ای نام‌دار از مجوزها که به یک حساب صندوق‌دار اختصاص داده می‌شود. نقش‌ها تعیین می‌کنند یک صندوق‌دار چه اقدام‌هایی را می‌تواند انجام دهد (برای مثال شروع نشست‌ها، مدیریت اعضا، مشاهده گزارش‌ها). چند صندوق‌دار می‌توانند یک نقش مشترک داشته باشند و مجوزها در سراسر رابط اعمال می‌شوند.

کد امنیتی یک کد 6 رقمی که وقتی کارکنان مشتری را پشت یک میز کافه‌تریا می‌نشانند تولید می‌شود. مشتری بعد از اسکن QR میز آن را وارد می‌کند تا حضور فیزیکی خود را ثابت کند. کد سمت سرور hash می‌شود و با Close Table یا Settle Check منقضی می‌شود. Show Code متن ساده ذخیره‌شده را نشان می‌دهد؛ Rotate QR کد جدیدی می‌سازد و برچسب قبلی را نامعتبر می‌کند.

مرز segment رویدادی که باعث ایجاد یک segment قیمت‌گذاری جدید در یک نشست می‌شود. مرزها شامل شروع نشست، توقف نشست، مکث نشست، resume نشست و تغییر slot قیمت‌گذاری (وقتی ساعت از یک slot به slot دیگر می‌رود) هستند.

نشست یک بازه زمان‌دار استفاده از PC یا کنسول توسط مشتری. نشست‌ها زمان شروع، زمان پایان، مکث‌ها، segmentهای قیمت‌گذاری و مجموع مبلغ دریافت‌شده را دنبال می‌کنند. آنها می‌توانند پیش‌پرداخت یا پس‌پرداخت باشند.

تسویه محاسبه‌ای که هنگام پایان نشست انجام می‌شود تا هزینه نهایی تعیین شود. تسویه همه segmentهای قیمت‌گذاری را پردازش می‌کند، ضرایب مربوطه را اعمال می‌کند، هزینه راه‌اندازی و VAT را اضافه می‌کند، تخفیف‌های عضو را کم می‌کند و مبلغ نهایی را تولید می‌کند. در کافه‌تریا، تسویه همچنین یک عملیات با یک کلیک است که همه سفارش‌های باز روی یک میز را با یک روش پرداخت انتخابی می‌بندد و میز را به idle برمی‌گرداند.

STE (Smart/Turbo Edition) یک گونه پروتکل برای کلاینت‌های قدیمی. frameهای STE شامل یک prefix اطلاعات مجوز 70 بایتی هستند؛ اندازه frame 1337 بایت است. گونه دیگر Standard است (1267 بایت، بدون prefix). گونه را با نحوه ساخت سرور قدیمی خود هماهنگ کنید، وگرنه frameها رد یا اشتباه خوانده می‌شوند. گونه را در Settings > Legacy Clients تنظیم کنید.

شیفت دوره کاری یک صندوق‌دار از زمان ورود تا خروج. همه تراکنش‌ها، عملیات نشست و اقدام‌های مدیریتی انجام‌شده در طول یک شیفت به صندوق‌دار واردشده نسبت داده می‌شوند. داده‌های شیفت برای پاسخگویی و تحلیل عملکرد استفاده می‌شوند.

هزینه راه‌اندازی حداقل هزینه‌ای که بدون توجه به مدت برای هر نشست اعمال می‌شود. اگر هزینه محاسبه‌شده یک نشست (بر اساس زمان و قیمت‌گذاری) کمتر از هزینه راه‌اندازی باشد، به‌جای آن هزینه راه‌اندازی دریافت می‌شود. این کار درآمد پایه‌ای برای هر نشست تضمین می‌کند.

همگام‌سازی فرایند همگام‌سازی فایل از HandyCafe Server به رایانه‌های کلاینت. از مقایسه مبتنی بر manifest و انتقال chunk-based برای توزیع کارآمد فایل‌ها در شبکه استفاده می‌کند.

سطح یک سطح وفاداری در سیستم tier اعضا. tierها بر اساس آستانه امتیاز تعریف می‌شوند و نرخ تخفیف برای نشست‌ها و سفارش‌ها ارائه می‌دهند. با جمع‌کردن امتیاز از طریق خرج‌کردن، اعضا به tierهای بالاتر و مزایای بهتر می‌رسند.

تراکنش رکورد مالی یک پرداخت برای نشست، سفارش، شارژ کیف پول یا رویداد قابل‌صورتحساب دیگر. تراکنش‌ها مبلغ، روش پرداخت، عضو یا صندوق‌دار مرتبط و timestamp را ثبت می‌کنند.

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

کیف پول موجودی پولی پیش‌پرداخت یک عضو که در سیستم HandyCafe ذخیره می‌شود. کیف پول از یک یا چند credit entry تشکیل می‌شود و می‌توان از آن برای پرداخت نشست‌ها، سفارش‌ها و سایر خدمات استفاده کرد. شارژ می‌تواند از طریق نقدی، packageها یا کمپین‌ها انجام شود.