Passer au contenu principal

​
Installation

L’artefact de production est drivers/pc-printer/plato-printer.zip. Il contient l’exécutable, la configuration par défaut, les actifs/certificats Caddy et les binaires Redis.

​
Installation de production

  1. Copiez plato-printer.zip sur la machine Windows pouvant accéder aux imprimantes.
  2. Extrayez le zip dans un dossier stable, par exemple C:\PlatoPrinter.
  3. Modifiez config.json.
  4. Exécutez plato-printer.exe.
  5. Autorisez l’accès au pare-feu Windows pour le port HTTP configuré.
  6. Confirmez que le service est joignable :
curl http://localhost:8080/health
Réponse attendue : 
{
  "ok": true,
  "version": 66,
  "uptime": 12.345
}

​
Liste de contrôle d’installation réseau

  • La machine pilote peut atteindre chaque adresse IP et port d’imprimante.
  • Les navigateurs POS peuvent accéder à la machine pilote.
  • Le port 8080 est ouvert pour HTTP, sauf modification dans config.json.
  • Le port 443 est ouvert si HTTPS est activé.
  • Les adresses IP des imprimantes sont statiques ou réservées dans DHCP.
  • Les imprimantes thermiques acceptent les ESC/POS bruts sur TCP.

​
Liste de contrôle d’installation de HTTPS

Lorsque HTTPS est activé :
  1. Gardez features.httpsEnabled et caddy.enabled réglés sur true.
  2. Assurez-vous que assets/certs/ca.crt, server.crt et server.key existent.
  3. Pointez caddy.domain vers la machine du pilote, généralement via DNS ou une entrée d’hôtes.
  4. Installez le certificat CA à partir de :
http://<driver-ip>:8080/ca.crt
  1. Utilisez le pilote HTTPS URL depuis la console, généralement :
https://plato-printer.local

​
Lancement automatique

Au démarrage, l’exécutable enregistre le lancement automatique en utilisant le nom de l’application Plato PC Printer. Le chemin de l’exécutable est process.execPath et le service est configuré pour démarrer caché. Si le lancement automatique échoue, le pilote enregistre l’échec et continue de s’exécuter.

​
Installation de développement

Depuis la racine du référentiel : 
pnpm install
pnpm --filter @plato/pc-printer build
pnpm --filter @plato/pc-printer start
Le serveur de développement lit config.json à partir de drivers/pc-printer lorsqu’il est démarré dans ce dossier.

​
Bilan de santé local

curl http://localhost:8080/health
curl http://localhost:8080/queue-status
Si HTTPS est activé et configuré : 
curl https://plato-printer.local/health