HandyCafe Docs
owner

چگونه کافی‌نت خود را از ابتدا راه‌اندازی کنید

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

آنچه نیاز خواهید داشت

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

فاز 1: نصب و پیکربندی سرور

  1. آخرین نسخه نصب‌کننده HandyCafe Server را از داشبورد HandyCafe خود دانلود کنید.
  2. نصب‌کننده را روی کامپیوتری که به عنوان سرور تعیین کرده‌اید اجرا کنید. دستورات روی صفحه را دنبال کرده و دایرکتوری نصب پیش‌فرض را بپذیرید.
  3. HandyCafe Server را اجرا کنید. جادوگر اولین راه‌اندازی به‌طور خودکار در اولین اجرا ظاهر می‌شود.
  4. کلید لایسنس بتای خود را وارد کنید. سرور کلید را به صورت آنلاین اعتبارسنجی کرده و نام کافی‌نت و محدودیت کامپیوتر شما را نمایش می‌دهد.
  5. حساب کاربری مدیر خود را ایجاد کنید. یک نام کاربری و یک رمز عبور قوی وارد کنید. این حساب به همه ویژگی‌ها دسترسی نامحدود دارد.
  6. نام کافی‌نت خود را تنظیم کنید. این نام در صفحه‌های بیکار کلاینت و در گزارش‌ها ظاهر خواهد شد.
  7. برای تکمیل جادوگر روی Finish کلیک کنید.

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


فاز 2: پیکربندی قیمت‌گذاری

  1. با کلیک روی آیکون چرخ‌دنده در نوار کناری سمت چپ، صفحه تنظیمات را باز کنید.
  2. به تب Pricing بروید.
  3. ارز پایه خود را تنظیم کنید. از منوی کشویی ارز انتخاب کنید. همه قیمت‌ها، تراکنش‌ها و گزارش‌ها از این ارز استفاده خواهند کرد.
  4. نرخ ساعتی خود را وارد کنید. این قیمت پایه به ازای هر ساعت برای جلسات پس‌پرداخت است. به عنوان مثال، برای ده واحد از ارز خود به ازای هر ساعت، 10.00 وارد کنید.
  5. نرخ مالیات بر ارزش افزوده (VAT) را تنظیم کنید. درصدی (0 تا 100) که به هزینه جلسات اعمال می‌شود را وارد کنید. اگر VAT اعمال نمی‌شود، 0 وارد کنید.
  6. هزینه شروع را تنظیم کنید. این حداقل هزینه به ازای هر جلسه بدون توجه به مدت زمان است. اگر نمی‌خواهید حداقل هزینه‌ای داشته باشید، 0 وارد کنید.
  7. پیش‌تنظیمات قیمت‌گذاری برای مدت‌های رایج ایجاد کنید. به بخش Presets بروید. روی Add Preset کلیک کنید. پیش‌تنظیماتی مانند:
    • "30 دقیقه" با مدت زمان 30 دقیقه.
    • "1 ساعت" با مدت زمان 60 دقیقه.
    • "2 ساعت" با مدت زمان 120 دقیقه.
  8. برای اعمال پیکربندی قیمت‌گذاری خود روی Save کلیک کنید.

نتیجه مورد انتظار: تب Pricing نرخ ساعتی، نرخ VAT، هزینه شروع و همه پیش‌تنظیمات را در زیر نشان می‌دهد. این پیش‌تنظیمات به عنوان دکمه‌های انتخاب سریع هنگام شروع جلسات پیش‌پرداخت ظاهر خواهند شد.


فاز 3: بررسی تنظیمات شبکه

  1. در حالی که هنوز در تنظیمات هستید، به تب Network بروید.
  2. پورت شنود را بررسی کنید. پیش‌فرض 7842 است. فقط در صورتی که سرویس دیگری در شبکه شما از آن پورت استفاده می‌کند، آن را تغییر دهید.
  3. کلید اتصال را تنظیم یا یادداشت کنید. این کلید اتصالات کلاینت را تأیید می‌کند. همه کامپیوترهای کلاینت باید از همان کلید برای اتصال استفاده کنند.
  4. اطمینان حاصل کنید که فایروال کامپیوتر سرور اتصالات ورودی TCP را در پورت تنظیم‌شده مجاز می‌کند. در ویندوز، HandyCafe معمولاً این قانون را در طول نصب اضافه می‌کند. اگر پورت را تغییر دادید، یک قانون فایروال جدید به صورت دستی اضافه کنید.
  5. آدرس IP کامپیوتر سرور که در تب Network نمایش داده می‌شود را یادداشت کنید. اگر کلاینت‌ها نتوانند سرور را از طریق کشف خودکار پیدا کنند، به آن نیاز خواهید داشت.

نتیجه مورد انتظار: تب Network پورت شنود و کلید اتصال را نشان می‌دهد. نشانگر وضعیت سرور "Listening" را به رنگ سبز نشان می‌دهد.


فاز 4: استقرار اولین کلاینت

  1. نصب‌کننده HandyCafe Client را از داشبورد خود دانلود کنید.
  2. آن را روی اولین کامپیوتر کلاینت خود نصب کنید. نصب‌کننده را اجرا کرده و دستورات را دنبال کنید.
  3. HandyCafe Client را اجرا کنید. کلاینت به‌طور خودکار تلاش می‌کند سرور را از طریق mDNS در شبکه محلی کشف کند.
  4. اگر کشف خودکار شکست خورد، آدرس IP سرور و پورت را به صورت دستی در دیالوگ اتصال کلاینت وارد کنید.
  5. کلید اتصال که در فاز 3 یادداشت کردید را وارد کنید.
  6. منتظر بمانید تا اتصال برقرار شود. صفحه کلاینت به صفحه بیکار تغییر می‌کند و یک صفحه قفل با ساعت را نشان می‌دهد.

نتیجه مورد انتظار: در سرور، پنل مدیریت اکنون یک کلاینت متصل را نشان می‌دهد. کاشی کلاینت نام میزبان و وضعیت "Idle" به رنگ آبی را نمایش می‌دهد. کامپیوتر کلاینت صفحه قفل را نشان می‌دهد.

  1. سرور به‌طور خودکار یک نام نمایش به کلاینت بر اساس نام میزبان آن اختصاص می‌دهد. برای تغییر نام آن، کاشی کلاینت را در سرور انتخاب کرده و روی Rename کلیک کنید.

فاز 5: اجرای اولین جلسه آزمایشی

  1. در پنل مدیریت سرور، روی Start در کاشی کلاینت بیکار کلیک کنید.
  2. در دیالوگ جلسه، Postpaid را انتخاب کنید. فیلد عضو را برای یک جلسه مهمان خالی بگذارید.
  3. برای شروع جلسه روی Confirm کلیک کنید.

نتیجه مورد انتظار: کاشی کلاینت به رنگ سبز تغییر کرده و یک تایمر در حال اجرا را نشان می‌دهد. در کامپیوتر کلاینت، صفحه قفل ناپدید شده و صفحه دسکتاپ Online Page ظاهر می‌شود.

  1. بگذارید جلسه حداقل 5 دقیقه اجرا شود تا بتوانید محاسبات قیمت‌گذاری را بررسی کنید.
  2. روی Stop در کاشی سبز کلاینت در سرور کلیک کنید.
  3. دیالوگ تجزیه و تحلیل هزینه را بررسی کنید. این موارد را نشان می‌دهد:
    • مدت زمان (مثلاً 5 دقیقه).
    • نرخ ساعتی اعمال‌شده.
    • مقدار VAT.
    • کل هزینه.
  4. یک روش پرداخت انتخاب کنید (پیش‌فرض نقدی است).
  5. برای بستن جلسه و ثبت پرداخت روی Confirm کلیک کنید.

نتیجه مورد انتظار: کاشی کلاینت به وضعیت "Idle" آبی بازمی‌گردد. کامپیوتر کلاینت دوباره صفحه قفل را نشان می‌دهد. یک تراکنش در سیستم ثبت می‌شود.


فاز 6: بررسی در گزارش مالی

  1. با استفاده از نوار کناری سمت چپ به صفحه گزارش مالی بروید.
  2. تأیید کنید که گزارش امروز یک تراکنش جلسه را نشان می‌دهد.
  3. بررسی کنید که مبلغ تراکنش با تجزیه و تحلیل هزینه‌ای که هنگام توقف جلسه دیدید مطابقت دارد.
  4. بررسی کنید که ستون روش پرداخت "نقدی" (یا هر روشی که انتخاب کرده‌اید) را نشان می‌دهد.

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


فاز 7: مراحل اختیاری بعدی

پس از اینکه تنظیمات پایه شما کار می‌کند، این ویژگی‌ها را در نظر بگیرید:

  1. افزودن اعضا. به صفحه Members بروید. روی Add کلیک کنید تا حساب‌های کاربری با نام‌های کاربری و موجودی‌های کیف پول اختیاری ایجاد کنید. اعضا می‌توانند از کامپیوترهای کلاینت وارد شوند.
  2. راه‌اندازی محصولات. به صفحه Products بروید. آیتم‌های غذا و نوشیدنی با قیمت‌ها اضافه کنید تا صندوقداران بتوانند سفارش‌ها ایجاد کنند.
  3. پیکربندی منوی کلاینت. به Settings > Client Menu بروید. دسته‌بندی‌های برنامه و برنامه‌ها را اضافه کنید تا مشتریان یک شبکه لانچر در صفحه Online Page ببینند.
  4. استقرار کلاینت‌های اضافی. HandyCafe Client را روی هر کامپیوتر ایستگاه در کافی‌نت خود نصب کنید. هر کدام به‌طور خودکار در سرور ظاهر می‌شود.
  5. ایجاد حساب‌های صندوقدار. به صفحه Management بروید. حساب‌های صندوقدار با نقش‌های مناسب اضافه کنید تا کارکنان بتوانند وارد شوند و جلسات را مدیریت کنند.
  6. راه‌اندازی قیمت‌گذاری اوج/غیراوج. به Settings > Pricing Schedule بروید. ضریب‌های زمانی برای شارژ بیشتر در ساعات شلوغ ایجاد کنید.
  7. فعال‌سازی ورود OAuth. به Settings > OAuth بروید. Google یا سایر ارائه‌دهندگان را پیکربندی کنید تا مشتریان بتوانند با حساب‌های اجتماعی خود وارد شوند.

اشتباهات رایج برای اجتناب

  • رد کردن قانون فایروال. اگر کلاینت‌ها نمی‌توانند متصل شوند، شایع‌ترین علت یک قانون فایروال ویندوز است که پورت شنود را مسدود می‌کند. قبل از بررسی مشکلات دیگر، اطمینان حاصل کنید که قانون وجود دارد.
  • کلیدهای اتصال ناهماهنگ. کلید در هر کلاینت باید دقیقاً با کلید در سرور مطابقت داشته باشد. برای جلوگیری از اشتباهات تایپی، آن را کپی-پیست کنید.
  • تنظیم نرخ ساعتی به 0. اگر نرخ ساعتی را روی صفر بگذارید، همه جلسات پس‌پرداخت رایگان خواهند بود. همیشه قبل از شروع به کار قیمت‌گذاری خود را بررسی کنید.
  • فراموش کردن ذخیره تنظیمات. تغییرات در صفحه تنظیمات تا زمانی که روی Save کلیک نکنید اعمال نمی‌شوند. اگر تنظیمات پس از راه‌اندازی مجدد تغییر نکرده‌اند، احتمالاً فراموش کرده‌اید که ذخیره کنید.
  • اجرای سرور و کلاینت روی یک کامپیوتر. در حالی که از نظر فنی برای آزمایش ممکن است، این برای تولید توصیه نمی‌شود. کامپیوتر سرور باید یک ایستگاه اختصاصی باشد.