​

Dépannage

1. Santé du processus du pilote.
2. Accessibilité TCP du pilote à l’imprimante.
3. État de la file d’attente.
4. Configuration de l’imprimante de la console.
5. HTTPS ou problèmes de confiance du navigateur.

​

Pilote non joignable

curl http://localhost:8080/health

• Confirmez que plato-printer.exe est en cours d’exécution.
• Confirmez que config.json est valide JSON.
• Confirmez que server.port n’est pas déjà utilisé.
• Vérifiez les journaux de démarrage de Port already in use.

• Ouvrez le pare-feu Windows pour server.port.
• Utilisez l’adresse réseau du pilote indiquée dans la bannière de démarrage.
• Confirmez que le périphérique POS est sur le même réseau ou sur le même VLAN autorisé.

​

Imprimante hors ligne

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

​

Emplois bloqués

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

• waiting : tâches prêtes mais non actives.
• active : impression en cours.
• delayed : tâches futures planifiées ou avec nouvelle tentative retardée.
• failed : travaux ayant échoué conservés par BullMQ.
• totalPending : attente et retard sur toutes les imprimantes.
• isProcessing : il existe au moins un travail actif.

​

Demande d’impression acceptée mais rien ne s’imprime

1. GET /queue-status.
2. POST /status avec validate: true.
3. IP de l’imprimante et port dans la configuration de la console.
4. Le modèle d’imprimante prend en charge le raster ESC/POS sur TCP.
5. L’imprimante a du papier et n’est pas en pause.

​

Adresse de l’imprimante manquante

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

​

HTTPS échoue

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

• Installez le certificat CA sur l’appareil POS.
• Faites en sorte que plato-printer.local soit résolu sur la machine pilote.
• Ouvrez le port 443.
• Confirmez que assets/certs existe.
• Confirmez que Caddy a démarré dans les journaux.

​

Échec du maillage

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

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

wss://plato-printer.local/mesh

​

Redis ne parvient pas à démarrer

• La version binaire Redis configurée est manquante ou corrompue.
• Le port Redis configuré est déjà utilisé.
• Windows bloque le binaire téléchargé.
• La version détectée de Redis ne correspond pas à redis.version.

• Exécutez le script du bundle pour préparer redis-binaries.
• Remplacez redis.port.
• Supprimez le mauvais dossier redis-binaries/<version> et reconstruisez-le.
• Utilisez redis.mode: "external" avec un serveur Redis connu et en bon état.

​

Réinitialisation sécurisée

pnpm --filter @plato/pc-printer clean