DĂ©tails du projet
🚀 QueueX – De A à Z (Version finale)
🎯 Objectif
Supprimer les files d’attente dans cafés, fast-foods et restos → remplacer les tickets papier par une file virtuelle accessible par QR code, avec gestion côté staff.
👤 Côté Client
Le client arrive → scanne le QR code affiché à l’entrée.
Il ouvre QueueX (site web PWA).
Il saisit Nom + Prénom (obligatoire).
L’app affiche en temps réel :
“Bienvenue Chedly Ben Achour 👋”
“Vous êtes #7 dans la file (~9 minutes)”.
Quand c’est son tour :
Notification push : “Chedly Ben Achour, avancez à la caisse 🚀”.
Son nom s’affiche aussi sur la tablette staff.
🏪 Côté Staff (tablette caisse)
Un lien staff unique par point de vente (ex: queuex.app/staff/CAFE123).
Affiche la liste des clients avec Nom + Prénom et leur ordre.
Actions rapides :
Appeler → notif + affiche le nom en grand.
Servi → retire de la file.
No-show → si absent.
Tous les caissiers du même point de vente utilisent le même accès staff.
🏢 Côté Resto (compte marchand)
Création initiale
Le responsable va sur queuex.app/merchants.
Il clique Créer un compte resto.
Il remplit :
Nom du restaurant
Nom du responsable
Email
Téléphone
Mot de passe
Nombre de points de vente (ex: 1, 2, 3, …).
Il paie immédiatement :
Prix = nb points de vente Ă— tarif mensuel (ex: 99 DT).
QueueX génère automatiquement :
âś… Un QR code client unique par point de vente (ex: queuex.app/join?loc=CAFE123).
âś… Un lien staff unique par point de vente (ex: queuex.app/staff/CAFE123).
✅ Possibilité de télécharger QR en PNG/PDF pour l’imprimer.
Ajout de nouveaux points de vente (après coup)
Le resto se connecte Ă son profil marchand sur QueueX.
Il clique “Ajouter un point de vente”.
Il entre :
Nom du lieu / adresse.
Le système demande paiement du supplément (ex: 99 DT/mois en plus).
Une fois payé :
✅ Un nouveau QR code client est généré.
✅ Un nouveau lien staff est attribué pour ce point de vente.
Les files sont toujours séparées par point de vente → pas de mélange.
đź“Š Exemple concret
CoffeeX crée un compte avec 2 cafés (Lac 2 et La Marsa).
Prix = 2 Ă— 99 DT = 198 DT/mois.
QueueX génère 2 QR + 2 liens staff.
Un mois plus tard, CoffeeX ouvre un 3ᵉ café à Ariana.
Le gérant va dans son profil QueueX → clique Ajouter un point de vente.
Il paie 99 DT supplémentaire.
QueueX génère immédiatement le QR et le lien staff pour Ariana.
⚙️ Technique pour le dev
Base de données :
Table Organization (restos).
Table Location (points de vente).
Relation 1 → N (un resto peut avoir plusieurs points de vente).
Facturation :
Montant mensuel = nb de Location actifs Ă— prix/lieu.
Quand un nouveau lieu est ajouté → mettre à jour la facturation.
QR & Staff : générés automatiquement pour chaque Location.
Tablette Staff : un lien unique par lieu.
✅ Résumé final
1 compte resto = plusieurs points de vente possibles.
Au moment de créer le compte → il choisit combien de points de vente → paie → reçoit QR + Staff pour chacun.
Si plus tard il ouvre un nouveau café/resto → il va dans son profil QueueX, clique Ajouter un point de vente, paie → QueueX génère automatiquement le nouvel accès.
Chaque point de vente a sa file séparée.
👉 En gros : QueueX = un abonnement modulable par point de vente.
