Ana içeriğe atla

Kurulum

Üretim yapısı drivers/pc-printer/plato-printer.zip’dir. Yürütülebilir dosyayı, varsayılan yapılandırmayı, Caddy varlıklarını/sertifikalarını ve Redis ikili dosyalarını içerir.

Üretim Kurulumu

  1. plato-printer.zip’yi yazıcılara ulaşabilen Windows makinesine kopyalayın.
  2. Zip’i sabit bir klasöre çıkarın, örneğin C:\PlatoPrinter.
  3. config.json’yi düzenleyin.
  4. plato-printer.exe’yi çalıştırın.
  5. Yapılandırılmış HTTP bağlantı noktası için Windows Güvenlik Duvarı erişimine izin verin.
  6. Hizmetin ulaşılabilir olduğunu doğrulayın:
curl http://localhost:8080/health
Beklenen yanıt:
{
  "ok": true,
  "version": 66,
  "uptime": 12.345
}

Ağ Kurulumu Kontrol Listesi

  • Sürücü makinesi her yazıcı IP’sine ve yazıcı bağlantı noktasına erişebilir.
  • POS tarayıcıları sürücü makinesine erişebilir.
  • config.json’de değiştirilmediği sürece 8080 bağlantı noktası HTTP için açıktır.
  • HTTPS etkinleştirilirse 443 bağlantı noktası açıktır.
  • Yazıcı IP adresleri statiktir veya DHCP’de ayrılmıştır.
  • Termal yazıcılar TCP üzerinden ham ESC/POS’yi kabul eder.

HTTPS Kurulum Kontrol Listesi

HTTPS etkinleştirildiğinde:
  1. features.httpsEnabled ve caddy.enabled’yi true olarak ayarlı tutun.
  2. assets/certs/ca.crt, server.crt ve server.key’nin mevcut olduğundan emin olun.
  3. caddy.domain’yi genellikle DNS veya ana bilgisayar girişi aracılığıyla sürücü makinesine yönlendirin.
  4. CA sertifikasını şuradan yükleyin:
http://<driver-ip>:8080/ca.crt
  1. Konsoldan HTTPS sürücüsünü URL kullanın, genellikle:
https://plato-printer.local

Otomatik Başlatma

Başlangıçta yürütülebilir dosya, Plato PC Printer uygulama adını kullanarak otomatik başlatmayı kaydeder. Yürütülebilir yol process.execPath’dir ve hizmet gizli başlayacak şekilde yapılandırılmıştır. Otomatik başlatma başarısız olursa sürücü arızayı günlüğe kaydeder ve çalışmaya devam eder.

Geliştirme Kurulumu

Depo kökünden:
pnpm install
pnpm --filter @plato/pc-printer build
pnpm --filter @plato/pc-printer start
Geliştirme sunucusu, bu klasörde başlatıldığında drivers/pc-printer’den config.json’yi okur.

Yerel Sağlık Kontrolü

curl http://localhost:8080/health
curl http://localhost:8080/queue-status
HTTPS etkinleştirilmiş ve yapılandırılmışsa:
curl https://plato-printer.local/health