ZoneX Cloud — Tableau de bord web
ZoneX Cloud est le point de contrôle central de tous vos actifs traçés par RFID. Accessible depuis n'importe quel navigateur, sur n'importe quel appareil.
- Multi-entreprise, multi-site — chaque client ne voit que ses propres données
- Flux d'événements temps réel via MQTT — lectures et alertes en moins d'1 seconde
- Accès par rôle — visibilité par module et permissions par page
- Authentification JWT — session navigateur, sans VPN
- Affichage avec fuseau horaire configurable (défaut : Africa/Tunis)
ZoneX Cloud — visibilité RFID multi-sites en temps réel
Exploitation
Temps réel
Vue arborescence
Arbre D3 interactif des zones, types d'actifs, alertes et portes RFID. Rafraîchissement automatique toutes les 5 secondes. Filtrable par liste de suivi. Navigation directe vers listes ou alertes depuis chaque nœud.
Alertes
Moteur d'alertes
Trois flux d'alertes — alertes objets, alertes équipements, alertes camions — avec filtrage, suivi de statut et commentaires. Moteur de règles configurable (conditions, pièces jointes, types).
Flotte
Suivi camions & flotte
Positions camions en temps réel via MQTT, zones GPS, classification des actifs par véhicule, popup détaillée (lecteur, heartbeat, catégories). Historique des voyages avec manifeste.
Overview
Vue d'ensemble des zones
Navigation par arborescence d'emplacements. Vue grille par zone avec résumé des actifs, recherche et panneau détaillé. Polling périodique pour maintenir les comptages à jour.
Tracking
Audit & suivi des mouvements
Audit des passages par porte, lecteur ou liste de suivi. Chronologie des mouvements d'actifs. Analyse des cycles de déclenchements RFID. Liste de suivi stockée par session navigateur.
Analytics
Tableau de bord analytique
Statistiques produits, couverture par zone, répartition par catégorie et détection d'objets étrangers (tags détectés non enregistrés). Widgets résumé et graphiques de distribution.
Management
Infrastructure
Gestion lecteurs & infrastructure
CRUD complet : lecteurs, antennes, zones, portes. Détail lecteur : heartbeat temps réel, température, CPU/RAM, courbes de perte de retour antenne. Commandes à distance : démarrage/arrêt RFID, redémarrage, puissance antenne, ping, SMS.
Objets
Registre des actifs
Enregistrez, modifiez et suivez chaque actif tagué. Vue cycle de vie complet et historique des mouvements par objet. Hiérarchie catégorie/type. Détection d'éléments étrangers.
Inventaire
Gestion des inventaires
Planification des campagnes d'inventaire. Ajustements en trois modes : mobile (portable), desktop (navigateur) ou MQTT (lecteur fixe temps réel). Reporting des sessions terminées.
Équipe
Utilisateurs, rôles & journal
CRUD utilisateurs, attribution des rôles et contrôle de visibilité par module. Journal complet des actions utilisateurs pour la conformité. Gestion de l'entreprise, des licences et de leur historique.
Caisse
Point de vente RFID (Caisse)
Module POS complet piloté par RFID. Choisissez le lecteur et les antennes, ouvrez une session, scannez les articles via MQTT, regroupez par type et prix, encaissez, consultez l'historique des commandes.
Monitoring
Performance & monitoring plateforme
Métriques de performance API (intercepteur frontend et backend). Tableau de bord multi-tenant : score de santé par entreprise, filtres à risque, statut des licences, graphe de dépendances.
Stack technique
| Frontend | React, Vite, MUI, Redux, React Router |
| Backend | Django, Django REST Framework, JWT (Djoser + Simple JWT) |
| Temps réel | MQTT broker — topics per reader serial and company ID |
| Cartographie | Leaflet / Mapbox for GPS zone views and truck tracking |
| Authentification | JWT — browser session, no VPN, multi-company scoping |
| Base de données | MySQL — fully relational, per-company row-level isolation |
| Hébergement | cloud.zonex-rfid.com (VPS, continuous uptime) |
| Fuseau horaire | Configurable display timezone (default Africa/Tunis) |
ZoneX Edge — Logiciel lecteur fixe
WatchReader est le logiciel ZoneX Edge fonctionnant sur les lecteurs fixes Hopeland HH340. Il scanne en continu, évalue les tags par rapport aux règles configurées sur le cloud, déclenche les sorties physiques et diffuse la télémétrie — sans intervention humaine, dès la mise sous tension.
- Jusqu'à 4 ports d'antenne indépendants — contrôle de puissance par antenne (0–33 dBm)
- 2 000 lectures de tags par cycle avec déduplication — comptages EPC et TID uniques
- Moteur d'alarmes piloté par le cloud — liste des EPC surveillés mise à jour toutes les 10 minutes
- 8 topics MQTT : statut, heartbeat, télémétrie, alarmes, perte de retour, alertes groupées
- Sorties GPIO : avertissement (GPIO3) et alarme (GPIO4) indépendants — minuteries 1 à 30 s
- Télémétrie de santé : CPU, RAM, disque, toutes les zones thermiques, détection de kernel-panic
- Service de premier plan permanent — résiste à l'écran éteint, au mode Doze et au kill OS
- Configuration à distance via MQTT — aucune visite sur site requise pour les changements de paramètres
Portique Hopeland HH340 sous ZoneX Edge — comptage automatique de palettes
Moteur d'alarmes
Moteur d'alarmes piloté par le cloud
Les règles et actifs surveillés sont gérés sur ZoneX Cloud et synchronisés automatiquement sur le device. Chaque tag porte une liste de zones interdites ; toute violation déclenche un cycle complet de NEW à EXPIRED.
| État | Condition | Action |
|---|---|---|
| NEW | EPC détecté en zone interdite pour la première fois | Déclenchement GPIO + 3 publications MQTT |
| UPDATE | Même EPC toujours présent | Heartbeat MQTT allégé |
| DEBOUNCE | EPC réapparaît dans les 20 s suivant l'effacement | Traité comme continuation — compteur conservé |
| EXPIRED | EPC absent depuis > 20 s | Alarme effacée — résumé groupé mis à jour |
Topics MQTT de télémétrie
| Topic | Déclenchement |
|---|---|
watchreader/status/{serial} | Naissance / LWT (retenu) |
watchreader/heartbeat/{serial} | Toutes les ~15 s — uptime, entreprise |
watchreader/telemetry/{serial} | Toutes les ~60 s — CPU, RAM, température |
watchreader/rl/{serial} | Périodique — perte de retour antenne (dB) |
alertbyreader/{serial} | Par événement d'alarme — mise à jour alarme unique |
alert/{company_id} | Nouvelle alarme — détail complet (retenu) |
alert_grouped/{company_id} | Tout changement d'alarme — agrégat actif complet |
Fonctionnalités clés
Service permanent
Service de premier plan Android avec wake lock CPU, exemption Doze et démarrage automatique BOOT_COMPLETED. Le scan RFID est totalement indépendant de l'interface — fermer l'app n'a aucun effet.
Surveillance de la santé device
CPU, RAM, disque et toutes les zones thermiques sysfs capturés toutes les 60 s. La détection des sentinelles kernel-panic MT6765 publie un avertissement avant le crash — permettant un redémarrage préventif à distance.
Santé antenne (perte de retour)
Mesure périodique de la perte de retour sur tous les ports actifs. Alerte de seuil publiée lorsqu'un défaut de câble ou d'antenne est détecté — avant que les performances ne dégradent.
Configuration à distance
Tous les paramètres — intervalle heartbeat, fenêtre de drain, puissance antenne, minuteries GPIO, seuil perte de retour — peuvent être poussés via commande MQTT. Aucun accès physique requis.
Contrôle des sorties GPIO
GPIO3 (avertissement) et GPIO4 (alarme) indépendamment configurables : impulsion unique, continu ou répétition pulsée. Minuteries : 1–30 s chacune. Déclenche immédiatement à la détection d'une nouvelle alarme.
Déploiement en masse
Script Bash ADB déploie sur tous les appareils en parallèle via tunnels SSH inverses. Désinstalle l'ancienne version, installe l'APK, accorde l'exemption Doze, lance le récepteur de boot, redémarre. Résultat succès/échec par appareil.
APPLICATION COMPLÉMENTAIRE
ZoneX Alarm Monitor
Application poste de travail Windows qui reçoit les alertes d'intrusion RFID depuis ZoneX Cloud via MQTT et notifie immédiatement le personnel de sécurité sur site par signaux visuels et sonores. Fonctionne silencieusement en arrière-plan ; remonte au premier plan automatiquement à chaque nouvelle alerte.
- Grand compteur d'alarmes (0–99+) avec code couleur par sévérité — vert / orange / rouge
- Panneau zone active en police 72pt — lisible depuis l'autre côté de la salle de sécurité
- Arduino Nano + matrice LED 8×8 + buzzer — série USB auto-détectée, sans configuration manuelle
- Buzzer intelligent : se déclenche uniquement sur les nouvelles violations, silencieux en cas de comptage décroissant
- Alarme de test intégrée en un clic — exerce toute la chaîne sans événement RFID réel
- Intégration au démarrage Windows — lancement en arrière-plan sans fenêtre console
- Journal de fichier rotatif : 5 × 5 Mo de piste d'audit — événements MQTT, alarmes, actions utilisateur
INDICATEURS D'ÉTAT
| Transport | MQTT / TCP port 1883, QoS 1 |
| Hardware | Arduino Nano + MAX7219 8×8 LED matrix, 9600 baud |
| OS | Windows 10 / 11 (64-bit), no admin rights required |
| Multi-tenancy | Per-company topic scoping — no cross-tenant visibility |
Spécifications techniques — WatchReader
| Platform | Android 8.0+ (minSdk 26), targetSdk 34 |
| Hardware | Hopeland HH340 (MT6765 SoC) |
| RFID standard | UHF EPC Gen2 (ISO 18000-6C) |
| Antenna ports | Up to 4 simultaneous |
| Reader interface | Hopeland SDK — TCP 127.0.0.1:9090, 20 s hang timeout |
| Alarm refresh | Every 10 minutes from ZoneX Cloud API |
| Heartbeat | Every ~15 seconds |
| Telemetry | Every ~60 seconds |
ZoneX Mobile — Application Android
ZoneX Mobile fonctionne sur le terminal portable UHF RFID Chainway C5. Il couvre l'intégralité du cycle de vie terrain : enrôlement, inventaire, transfert, réparation et recherche d'actifs — avec support hors ligne complet et synchronisation au cloud à la reconnexion.
- Lecture simultanée EPC + TID — ISO 18000-6C / EPC Gen2
- Déclencheur physique matériel (keyCode 293) — sans appui sur l'écran
- Cache SQLite hors ligne — inventaire complet sans connexion active
- API REST avec auth JWT — synchronisation vers ZoneX Cloud à la reconnexion
- Puissance antenne, seuil RSSI et filtres de comptage de lectures configurables par module
- Intégration antivol — les sorties des lecteurs fixes déclenchent GPIO + MQTT + journal cloud
ZoneX Mobile sur Chainway C5 — inventaire du linge en office hôtelier
Modules applicatifs
Réception
- Enrôler de nouveaux articles en une seule session de scan
- 1 à 4 TIDs par article (mode Simple / Double / Triple / Quadruple)
- Détection automatique des articles déjà enregistrés (signalés par couleur)
- Upload par lot vers le cloud — 20 articles par lot
- Compteur temps réel : nouveau / valide / total scanné
Inventaire
- Comptage zone par zone : navigation fil d'Ariane bâtiment → étage → chambre
- Comparaison temps réel avec le plan de référence cloud
- Classification des tags : présent / inattendu / manquant
- Répartition par catégorie (draps, serviettes, taies d'oreiller, etc.)
- Cache local hors ligne — cycle complet sans connexion
Transfert
- Suivre le linge partant en blanchisserie et revenant
- Validation de zone par article : En Place / Mauvaise Zone / Inconnu
- Mouvement enregistré dans ZoneX Cloud (API MoveElements)
- Filtrage des doublons temps réel — chaque EPC compté une seule fois par session
Réparation
- Identification par TID — fonctionne même si l'EPC est endommagé
- Correspondance des TIDs scannés avec la base de données de défauts serveur
- Le personnel confirme chaque article individuellement avant validation
Recherche & Localisation
- Localiser tout article tagué n'importe où dans le bâtiment
- Radar de proximité RSSI temps réel : rouge (loin) → orange → jaune → vert (proche)
- Bip directionnel — l'intervalle se raccourcit en approchant (4 niveaux de vitesse)
- Cible sélectionnée dans la liste de scan en direct
Configuration
- Puissance antenne par module (0–100 % / 5–1300 cm / 1–33 dBm)
- Filtre de seuil RSSI par module (rejeter les lectures faibles)
- Filtre de nombre de lectures minimum par module (rejeter les lectures fugaces)
- 5 tonalités de bip de scan sélectionnables avec aperçu instantané
- Code PIN d'effacement d'inventaire (4–16 chiffres)
Matériel compatible
| Appareil | Chainway C5 — Android 11+, UHF Gen 2, IP65, 8 h+ battery |
| RFID | Simultaneous EPC + TID — ISO 18000-6C / EPC Gen2 |
| Déclencheur | Physical hardware button (keyCode 293) — no on-screen tap needed |
| Cloud | REST API + JWT auth — zonex-rfid.com (Django + MySQL + MQTT) |
| Hors ligne | Local SQLite cache — reads queue and sync on reconnect |
Intégration antivol
Lecteurs fixes aux sorties
- Les lecteurs RFID fixes aux sorties de l'hôtel scannent en continu
- Les articles en zone interdite déclenchent la sortie GPIO → alarme physique (lumière / sirène)
- Alerte MQTT → ZoneX Alarm Monitor (Windows) pour le poste de sécurité sur site
- Entrée de journal cloud persistante — piste d'audit complète par événement