​

استكشاف الأخطاء وإصلاحها

1. صحة عملية السائق.
2. إمكانية الوصول إلى برنامج التشغيل إلى الطابعة TCP.
3. حالة قائمة الانتظار.
4. تكوين الطابعة وحدة التحكم.
5. HTTPS أو مشكلات الثقة في المتصفح.

​

السائق غير قابل للوصول

curl http://localhost:8080/health

• تأكد من تشغيل plato-printer.exe.
• تأكد من أن config.json صالح JSON.
• تأكد من عدم استخدام server.port بالفعل.
• تحقق من سجلات بدء التشغيل بحثًا عن Port already in use.

• افتح جدار حماية Windows لـ server.port.
• استخدم عنوان شبكة السائق من شعار بدء التشغيل.
• تأكد من أن جهاز POS موجود على نفس الشبكة أو أنه يسمح بشبكة VLAN.

​

الطابعة غير متصل

curl -X POST http://localhost:8080/status \
  -H "Content-Type: application/json" \
  -d '{"ip_address":"192.168.1.50","port":"9100","validate":true}'

​

وظائف عالقة

curl http://localhost:8080/queue-status

• waiting: وظائف جاهزة ولكنها غير نشطة.
• active: تتم الطباعة حاليًا.
• delayed: المهام المستقبلية المجدولة أو إعادة المحاولة المؤجلة.
• failed: المهام الفاشلة التي احتفظ بها BullMQ.
• totalPending: الانتظار والتأخير في جميع الطابعات.
• isProcessing: توجد وظيفة نشطة واحدة على الأقل.

​

تم قبول طلب الطباعة ولكن لم يتم طباعة أي شيء

1. GET /queue-status.
2. POST /status مع validate: true.
3. IP الطابعة والمنفذ في تكوين وحدة التحكم.
4. يدعم طراز الطابعة خطوط ESC/POS النقطية عبر TCP.
5. الطابعة بها ورق ولم يتم إيقافها مؤقتًا.

​

عنوان الطابعة مفقود

{
  "ip_address": "192.168.1.50",
  "port": "9100"
}

​

فشل HTTPS

curl http://localhost:8080/ca.crt
curl https://plato-printer.local/health

• قم بتثبيت شهادة CA على جهاز POS.
• قم بإجراء حل plato-printer.local لجهاز التشغيل.
• فتح المنفذ 443.
• تأكيد وجود assets/certs.
• تأكيد بدء العلبة في السجلات.

​

فشل الشبكة

curl http://localhost:8080/mesh-status

{
  "features": {
    "meshEnabled": true
  }
}

wss://plato-printer.local/mesh

​

فشل Redis في البدء

• الإصدار الثنائي Redis الذي تم تكوينه مفقود أو تالف.
• منفذ Redis الذي تم تكوينه قيد الاستخدام بالفعل.
• يقوم Windows بحظر الملف الثنائي الذي تم تنزيله.
• إصدار Redis الذي تم اكتشافه لا يتطابق مع redis.version.

• قم بتشغيل البرنامج النصي للحزمة لإعداد redis-binaries.
• تغيير redis.port.
• احذف مجلد redis-binaries/<version> التالف وأعد البناء.
• استخدم redis.mode: "external" مع خادم Redis المعروف.

​

إعادة تعيين آمنة

pnpm --filter @plato/pc-printer clean