Skip to main content

Stockaj Kiosk

Stockaj Kiosk est une application de bureau (Windows, macOS, Linux) conçue pour gérer le prêt et le retour de matériel lors de festivals et d'événements. Elle fonctionne comme un terminal en mode kiosk — plein écran, sans distractions — et supporte les lecteurs de QR codes USB.

Fonctionnalités principales​

FonctionnalitéDescription
🔄 Cockpit unifiéEmprunt et retour dans un seul écran à 3 colonnes avec onglets
📡 Hors-ligneLes opérations sont mises en file d'attente et synchronisées automatiquement à la reconnexion
🔒 PIN de protectionAccès aux paramètres protégé par un code PIN à 4 chiffres (optionnel)
📱 Scanner QR / code-barresCompatible avec tout lecteur USB HID (clavier émulé)
🖥️ Mode kioskPlein écran, barre de navigation masquée, sortie protégée par PIN
🇫🇷 Interface en françaisTous les textes sont en français

Architecture​

┌─────────────────────────────────────────────┐
│               Stockaj Kiosk                 │
│         (Tauri 2 — plein écran)             │
│                                             │
│   React 18 + TypeScript + TailwindCSS       │
│   ┌─────────────┐  ┌────────────────────┐   │
│   │ Zustand      │  │ TanStack Query     │   │
│   │ (config,     │  │ (données serveur)  │   │
│   │  scanner)    │  │                    │   │
│   └─────────────┘  └────────────────────┘   │
│                                             │
│   ┌─────────────────────────────────────┐   │
│   │ File d'attente hors-ligne (SQLite)  │   │
│   └─────────────────────────────────────┘   │
└─────────────────────────────────────────────┘
                      │
                      ▼
            API Stockaj (Laravel)
           https://app.stockaj.io

Écrans de l'application​

L'application comporte 2 écrans principaux :

  1. Configuration — Saisie de l'URL API, du jeton d'authentification et du code PIN (premier lancement)
  2. Cockpit — Écran principal unifié pour emprunter et retourner du matériel

Un indicateur de connexion est présent en bas à gauche sur tous les écrans, et la barre de navigation en haut permet d'accéder au cockpit et aux paramètres.

Pré-requis​

  • Un compte Stockaj avec accès à l'API (https://app.stockaj.io/api/v2)
  • Un jeton d'API (Bearer Token) généré depuis l'interface Stockaj
  • (Optionnel) Un lecteur de QR codes / codes-barres USB