Help Center: Real-Time POS Queue Monitoring
The POS Queue Monitor is an intelligent visual monitoring feature designed to help store owners and managers reduce customer friction. By analyzing visitor counts, wait times, and emotional cues in real-time, the system automatically detects when a checkout line is becoming congested and sends a "LINE_DETECTED" alert to your management dashboard.
How it Works: The "Three Strikes" Logic
To ensure you only receive alerts for actual service bottlenecks—rather than brief groups of people—the system uses a hierarchical "Three Strikes" verification process.
| Strike | Requirement | What it measures |
|---|---|---|
| Strike 1 | 3+ Visitors | Density: Checks if there are at least three people present in the checkout zone simultaneously. |
| Strike 2 | Wait > 2 Min | Duration: Only triggers if those three (or more) people have been detected in the store for a total of at least 2 minutes. |
| Strike 3 | Frustration | Sentiment: Final trigger occurs if at least one person in that queue has shown a "sadness" or "frustrated" expression at any point during their wait. |
Note on Persistence: Once a visitor is flagged as "sad," the system remembers this state. Even if their expression returns to neutral, they will continue to contribute to Strike 3 for the duration of their visit, as the system has already "noted" their frustration.
Understanding the Dashboard UI
The monitor provides a live visual grid of everyone currently in the POS area.
Status Indicators: Located at the top, these light up in Orange as each strike condition is met.
Visitor Cards: Each detected person gets a temporary ID card showing:
Total Wait: The accumulated time they have been detected.
Frustration Flag: If a visitor is flagged for sadness, their card turns Red and displays a "⚠️ FRUSTRATION NOTED" status.
Live Cleanup: When a customer finishes their transaction and leaves the camera's view, their card is automatically removed from the dashboard to keep the view focused on the remaining queue.
Alerts and Cooldowns
When all three strikes are active, the system sends an immediate LINE_DETECTED command to your store's notification system.
To prevent "notification fatigue," the system enters a 5-minute Cooldown after an alert is sent. During this time:
The system continues to track visitors in the background.
New alerts are silenced.
The dashboard displays a countdown timer until the next active monitoring window.
FAQs
Why does the system say "API Offline"?
This usually occurs due to browser security (CORS) or the recognition engine being turned off. Ensure your recognition software is running on port 55080 and that you are accessing the dashboard via a local server (like Live Server).
Does it remember people if they step out of the frame?
Yes. The system maintains a 15-minute memory window. If a customer steps away and returns, their accumulated wait time and frustration flag are preserved.
Can I test the system without a crowd?
Yes. Use the "Toggle Test Simulation" button at the bottom of the panel to generate mock data and verify that your alerts and UI colors are functioning correctly.
Comments
0 comments
Please sign in to leave a comment.