HandyCafe Docs
owner it-admin cashier

مدیریت کافه تحت وب

مدیریت کافه تحت وب، محیط مدیریتی واکنش‌گرا در مرورگر است که روی handycafe.app قرار دارد. این محیط از طریق رله ابری امن به سرور HandyCafe وصل می‌شود، بنابراین مالکان و اپراتورهای مجاز می‌توانند کافه را بدون آنکه سرور محلی مستقیماً در معرض اینترنت قرار بگیرد زیر نظر بگیرند و اداره کنند.

کارهایی که می‌توانید انجام دهید

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

چیدمان صفحه شامل نوار پیمایش پایینی برای تلفن، کنترل‌های اندازه لمسی، کارت‌های واکنش‌گرا به جای جدول‌های عریض، حالت تیره و مدیریت ایمن تغییرات ناحیه دید (viewport) در موبایل است.

وضعیت اتصال

ناحیه وضعیت در پایین صفحه دو حالت مستقل را گزارش می‌کند:

  • کانال ابری اتصال مرورگر به ابر HandyCafe است.
  • سرور کافه رله فرمان زنده از ابر به سرور دسکتاپ است.

متصل بودن کانال ابری به معنای آنلاین بودن سرور کافه نیست. وقتی رله سرور کافه در دسترس نباشد، فرمان‌های از راه دور غیرفعال یا رد می‌شوند. داشبورد ممکن است آخرین وضعیت شناخته‌شده را همچنان نمایش دهد اما آن را به جای داده زنده با برچسب «کهنه» نشان می‌دهد.

امنیت و پایداری

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

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

پیش‌نیازها

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

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