۱۴۰۳/۱۱/۲۰
7 دقیقه زمان مطالعه

راهنمای جامع نصب و پیکربندی Sofreh Printer Agent

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

سفره
تیم توسعه و آموزش سفره
بخش تحقیق و مستندات فنی پلتفرم

#مقدمه و معماری Sofreh Printer Agent

در رستوران‌ها و کافه‌های پرترافیک، هر ثانیه تأخیر در چاپ سفارش می‌تواند روند آماده‌سازی سفارشات سالن یا دلیوری را مختل سازد. پلتفرم سفره برای غلبه بر محدودیت‌های مرورگر و مسدودسازی پاپ‌آپ‌های چاپ، نرم‌افزار واسط Sofreh Printer Agent را توسعه داده است.

این ایجنت به صورت سرویس پس‌زمینه (Background Daemon) روی کامپیوتر صندوق (ویندوز، مک یا لینوکس) اجرا شده و ارتباط WebSocket امن با سرورهای سفره برقرار می‌کند. به محض ثبت سفارش توسط مهمان سر میز یا صندوقدار، داده‌های چاپ به صورت بایت‌های مستقیم ESC/POS به پرینترهای متناظر هدایت می‌شوند.

---

#۱. پیش‌نیازها و ملزومات سخت‌افزاری

قبل از شروع پیکربندی، موارد زیر را بررسی نمایید:

  1. 1
    پرینترهای حرارتی استاندارد: پرینترهای ۸۰ میلی‌متری مجهز به درگاه شبکه (LAN/Ethernet) یا USB که از پروتکل ESC/POS پشتیبانی می‌کنند (مانند Bixolon، Epson، Rongta، Sewoo).
  2. 2
    اتصال شبکه محلی یکپارچه: توصیه اکید می‌شود پرینترهای آشپزخانه و بار از طریق کابل شبکه به روتر سالن متصل باشند و IP ثابت (Static IP) دریافت کنند.
  3. 3
    توکن اتصال مجموعه: کد احراز هویت ایجنت که از مسیر پنل مدیریت سفره ← تنظیمات چاپگرها ← کلید اتصال ایجنت دریافت می‌کنید.

---

#۲. مراحل نصب نرم‌افزار واسط

##نسخه ویندوز (Windows Service)

  1. 1
    فایل نصبی sofreh-printer-agent-setup.exe را از بخش مدیریت دریافت کرده و اجرا کنید.
  2. 2
    در پنجره تنظیمات، نام مجموعه و Agent Secret Key را وارد کنید.
  3. 3
    دکمه Verify Connection را بزنید تا چراغ وضعیت سبز شود.
  4. 4
    ایجنت به صورت خودکار پرینترهای تعریف‌شده در سیستم‌عامل را شناسایی می‌کند.
BASH
# بررسی وضعیت اجرای ایجنت در لینوکس یا سیستم‌های POS
systemctl status sofreh-printer-agent

---

#۳. مسیریابی چاپ بر اساس ایستگاه‌های آشپزخانه

یکی از ویژگی‌های کلیدی پلتفرم سفره، قابلیت تفکیک خودکار اقلام بر اساس ایستگاه کاری است:

  • ایستگاه بار سرد / گرم: اقلام نوشیدنی، قهوه و دسر مستقیماً به پرینتر بار هدایت می‌شوند.
  • ایستگاه آشپزخانه اصلی: سفارش‌های پخت، استیک و پیتزا با فونت درشت و ذکر توضیحات اختصاصی مهمان چاپ می‌گردند.
  • فیش مشتری (صندوق): خلاصه کل سفارش همراه با کیوآرکد رهگیری و جزئیات مالی برای میز صادر می‌شود.