Parcours & données
Suivi du remplissage, indisponibilités et règles d’affichage.
6. Parcours d’intégration à couvrir
6.1 Ouvrir l’espace bacs d’une pharmacie
- Retrouver la connexion client No Waste : tenant, environnement et magasin.
- Utiliser l’origine d’API propre à ce tenant et les accès associés.
- Lister les bacs du magasin :
GET /api/promo-bins?storeId={storeId}. - Afficher les produits, l’indicateur de remplissage et la date de dernière mesure.
- Présenter distinctement une donnée valide, une donnée absente et une donnée ancienne.
- Rafraîchir les données selon la cadence convenue avec Tekshelf.
L’ouverture de l’écran ne doit pas être présentée comme un réveil ou une nouvelle pesée du matériel.
6.2 Suivre l’évolution du remplissage
- Lister les bacs du magasin (parcours 6.1).
- Pour chaque bac, lire l’historique :
GET /api/promo-bins/{deviceId}/fill-history?hours=48. - Dédoublonner les points reçus par leur date
at: il n’existe pas de curseur, les fenêtres se recouvrent. - Calculer la rotation côté No Waste à partir de la baisse de
percent(ou deweightGsipercentestnull).
Cadence recommandée : pour conserver le pas de 15 minutes, demander hours=48 au moins une fois toutes les 48 heures (par exemple chaque jour). Une lecture sur 30 jours (hours=720) donne un point toutes les 4 heures.
6.3 Gérer une indisponibilité
No Waste conserve la dernière donnée connue avec sa date et signale son ancienneté. Une perte de connexion ne transforme pas un bac en rupture. Le bac se réveille à intervalles réguliers : l’absence de mesure récente n’est pas une rupture ; la fraîcheur se juge avec lastMeasureAt et acquisition. Après reprise, la relecture de l’historique permet de retrouver l’état courant.
7. Données et règles d’affichage
7.1 Informations à afficher
| Information | Règle d’affichage |
|---|---|
| Identité du bac | Identifiant, nom, numéro de série et magasin, interprétés dans le contexte du tenant. |
| Produits présentés | Produits associés au bac. |
| Poids | weightG en grammes (unité à confirmer) ; référence 100 % dans baseG. |
| Quantité | Indiquer qu’il s’agit d’une estimation dérivée du poids ; disponible seulement en mono-produit. |
| Remplissage | Pourcentage par rapport à la référence 100 % ; la référence peut évoluer. |
| Dernière mise à jour | lastMeasureAt (historique) ou lastAt (acquisition). |
7.2 Valeurs absentes et fraîcheur
nullou absence de mesure signifie « inconnu » ; ce n’est pas équivalent à zéro.- Une mesure ancienne peut rester visible avec sa date et une indication de fraîcheur.
- Les règles qui rendent une donnée « ancienne » dépendent de la cadence du bac (
intervalS) et doivent être fixées avec Tekshelf. - La consultation fréquente de l’API n’augmente pas la fréquence des relevés physiques.