الانتقال إلى المحتوى الرئيسي

تثبيت

قطعة أثرية الإنتاج هي drivers/pc-printer/plato-printer.zip. يحتوي على الملف القابل للتنفيذ، والتكوين الافتراضي، وأصول/شهادات Caddy، وثنائيات Redis.

تثبيت الإنتاج

  1. انسخ plato-printer.zip إلى جهاز Windows الذي يمكنه الوصول إلى الطابعات.
  2. قم باستخراج الملف المضغوط إلى مجلد ثابت، على سبيل المثال C:\PlatoPrinter.
  3. تحرير config.json.
  4. قم بتشغيل plato-printer.exe.
  5. السماح بالوصول إلى جدار حماية Windows لمنفذ HTTP الذي تم تكوينه.
  6. تأكيد إمكانية الوصول إلى الخدمة:
curl http://localhost:8080/health
الرد المتوقع:
{
  "ok": true,
  "version": 66,
  "uptime": 12.345
}

قائمة التحقق من تثبيت الشبكة

  • يمكن لجهاز التشغيل الوصول إلى كل عنوان IP للطابعة ومنفذ الطابعة.
  • يمكن لمتصفحات POS الوصول إلى جهاز التشغيل.
  • المنفذ 8080 مفتوح لـ HTTP، ما لم يتم تغييره في config.json.
  • يكون المنفذ 443 مفتوحًا إذا تم تمكين HTTPS.
  • عناوين IP الخاصة بالطابعة ثابتة أو محجوزة في DHCP.
  • تقبل الطابعات الحرارية ESC/POS الخام عبر TCP.

HTTPS قائمة التحقق من التثبيت

عند تمكين HTTPS:
  1. احتفظ بضبط features.httpsEnabled وcaddy.enabled على true.
  2. تأكد من وجود assets/certs/ca.crt وserver.crt وserver.key.
  3. قم بتوجيه caddy.domain إلى جهاز التشغيل، عادةً من خلال DNS أو إدخال المضيفين.
  4. قم بتثبيت شهادة CA من:
http://<driver-ip>:8080/ca.crt
  1. استخدم برنامج التشغيل HTTPS URL من وحدة التحكم، عادةً:
https://plato-printer.local

إطلاق تلقائي

عند بدء التشغيل، يقوم الملف القابل للتنفيذ بتسجيل التشغيل التلقائي باستخدام اسم التطبيق Plato PC Printer. المسار القابل للتنفيذ هو process.execPath، وتم تكوين الخدمة لبدء المخفية. في حالة فشل التشغيل التلقائي، يقوم برنامج التشغيل بتسجيل الفشل ويستمر في التشغيل.

تثبيت التطوير

من جذر المستودع:
pnpm install
pnpm --filter @plato/pc-printer build
pnpm --filter @plato/pc-printer start
يقرأ خادم التطوير config.json من drivers/pc-printer عند البدء في هذا المجلد.

فحص الصحة المحلية

curl http://localhost:8080/health
curl http://localhost:8080/queue-status
إذا تم تمكين HTTPS وتكوينه:
curl https://plato-printer.local/health