​

Sorun giderme

1. Sürücü işlem durumu.
2. Sürücüden yazıcıya TCP erişilebilirliği.
3. Kuyruk durumu.
4. Konsol yazıcısı yapılandırması.
5. HTTPS veya tarayıcı güven sorunları.

​

Sürücüye Ulaşılamıyor

curl http://localhost:8080/health

• plato-printer.exe’nin çalıştığını doğrulayın.
• config.json’nin geçerli JSON olduğunu doğrulayın.
• server.port’nin halihazırda kullanılmadığını doğrulayın.
• Port already in use için başlangıç ​​günlüklerini kontrol edin.

• server.port için Windows Güvenlik Duvarı’nı açın.
• Başlangıç ​​başlığındaki sürücünün ağ adresini kullanın.
• POS cihazının aynı ağda olduğunu veya izin verilen VLAN’da olduğunu doğrulayın.

​

Yazıcı Çevrimdışı

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

​

Takılıp Kalan İşler

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

• waiting: işler hazır ancak etkin değil.
• active: şu anda yazdırılıyor.
• delayed: gelecekte planlanan veya yeniden denenen gecikmeli işler.
• failed: BullMQ tarafından tutulan başarısız işler.
• totalPending: tüm yazıcılarda beklemeye ek olarak gecikmeli.
• isProcessing: en az bir aktif iş mevcut.

​

Yazdırma İsteği Kabul Edildi Ancak Hiçbir Şey Yazdırılmıyor

1. GET /queue-status.
2. validate: true ile POST /status.
3. Konsol yapılandırmasındaki yazıcı IP’si ve bağlantı noktası.
4. Yazıcı modeli TCP üzerinden ESC/POS taramayı destekler.
5. Yazıcıda kağıt var ve duraklatılmamış.

​

Eksik Yazıcı Adresi

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

​

HTTPS Başarısız

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

• CA sertifikasını POS cihazına yükleyin.
• plato-printer.local’nin sürücü makineye çözümlenmesini sağlayın.
• 443 bağlantı noktasını açın.
• assets/certs’nin var olduğunu doğrulayın.
• Caddy’nin günlüklerde başladığını doğrulayın.

​

Ağ Başarısızları

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

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

wss://plato-printer.local/mesh

​

Redis Başlatılamıyor

• Yapılandırılmış Redis ikili sürümü eksik veya bozuk.
• Yapılandırılmış Redis bağlantı noktası zaten kullanımda.
• Windows indirilen ikili dosyayı engeller.
• Tespit edilen Redis sürümü redis.version ile eşleşmiyor.

• redis-binaries’yi hazırlamak için paket komut dosyasını çalıştırın.
• redis.port’yi değiştirin.
• Bozuk redis-binaries/<version> klasörünü silin ve yeniden oluşturun.
• redis.mode: "external"’yi iyi çalıştığı bilinen bir Redis sunucusuyla kullanın.

​

Güvenli Sıfırlama

pnpm --filter @plato/pc-printer clean