Skip to main content

Dépannage

Problèmes de connexion​

Le kiosk affiche « Hors ligne » en permanence​

  1. Vérifiez la connexion réseau de la machine (Wi-Fi ou Ethernet)
  2. Vérifiez l'URL de l'API dans la configuration — elle doit correspondre à votre instance Stockaj
  3. Testez la connexion depuis l'écran de configuration avec le bouton « Tester la connexion »
  4. Vérifiez que le serveur Stockaj est accessible depuis un navigateur sur la même machine

« Échec ✗ — Impossible de joindre le serveur »​

Cause possibleVérification
URL incorrecteL'URL doit se terminer par /api/v2
Serveur hors serviceTestez l'URL dans un navigateur
Pare-feuVérifiez que la machine peut accéder au domaine *.stockaj.io
Proxy réseauConfigurez le proxy au niveau du système d'exploitation

« Échec ✗ — Erreur inconnue »​

Cela indique généralement un jeton d'API invalide ou expiré. Générez un nouveau jeton depuis l'interface Stockaj et mettez-le à jour dans la configuration.

Problèmes de scan​

Le scanner ne détecte rien​

Consultez la page Scanner QR / code-barres pour le diagnostic complet.

En résumé :

  1. Vérifiez que le scanner est branché et en mode USB HID
  2. Testez dans un éditeur de texte — le code doit apparaître comme du texte
  3. Vérifiez que vous êtes sur le cockpit — le scanner est désactivé sur la page de configuration

« Code inconnu » après un scan​

L'article scanné n'existe pas dans la base de données Stockaj. Vérifiez :

  • Que l'article est bien enregistré dans Stockaj
  • Que le QR code correspond au bon article
  • Que le QR code est lisible (pas abîmé ou flou)

Problèmes d'affichage​

L'application ne s'affiche pas en plein écran​

L'application est configurée pour démarrer en plein écran. Si ce n'est pas le cas :

  • Vérifiez que le fichier tauri.conf.json n'a pas été modifié
  • Sur macOS, autorisez l'application en plein écran dans les préférences système

L'interface est trop petite / trop grande​

L'interface est optimisée pour des écrans d'au moins 1280 × 720 px avec une taille de base de 18 px. Sur des résolutions très différentes, l'affichage peut ne pas être optimal.

Problèmes de données​

Des opérations sont « en attente » depuis longtemps​

L'indicateur jaune « N opération(s) en attente » signifie que des opérations hors-ligne n'ont pas encore été synchronisées.

  1. Vérifiez la connexion réseau
  2. Le kiosk tente de synchroniser toutes les 5 secondes automatiquement
  3. Après 3 échecs, une opération est marquée comme échouée et ne sera plus réessayée
caution

En cas d'opérations échouées persistantes, contactez l'administrateur Stockaj pour vérifier les données sur le serveur.

Un emprunt validé n'apparaît pas dans Stockaj​

Si l'emprunt a été créé hors-ligne, il sera synchronisé une fois la connexion rétablie. Vérifiez l'indicateur de connexion :

  • 🟡 Jaune = en attente de synchronisation
  • 🟢 Vert = toutes les opérations sont synchronisées

Problèmes d'accès​

J'ai oublié le code PIN​

Le code PIN est stocké localement sur la machine. Pour le réinitialiser :

  1. Fermez l'application
  2. Supprimez le localStorage de l'application (clé stockaj-kiosk-config)
  3. Relancez l'application — elle demandera une nouvelle configuration
caution

Cette opération supprime toute la configuration (URL, jeton, PIN). Vous devrez la re-saisir.

Je suis bloqué en mode kiosk​

Utilisez le raccourci Ctrl+Shift+Q ou la touche Échap pour afficher la boîte de dialogue de sortie. Si un code PIN est requis et que vous l'avez oublié, suivez la procédure ci-dessus.

Raccourcis clavier​

RaccourciAction
Ctrl+Shift+KEntrer en mode kiosk
Ctrl+Shift+QSortir du mode kiosk (PIN si configuré)
ÉchapSortir du mode kiosk (PIN si configuré)
EntréeConfirmer une sélection / Fermer l'écran de confirmation
EspaceFermer l'écran de confirmation
↑ ↓Naviguer dans les résultats de recherche