Manager Navigation
Barman Inventory
Barman Inventory · v1

Recognition Guide for Managers, MCs, and Screen Operators

Use this guide to run customer recognition as a premium guest-experience system across your floor, MC booth, and TV displays.

Open Recognition Preview Open Recognition Dashboard Open Recognition Settings Open Recognition Logs

Table of contents

A. What Recognition is

Recognition is a customer-engagement engine that watches live open tab activity and surfaces notable guest moments in real time.

It converts qualifying activity into visible celebration moments for your MC and venue screens to build atmosphere, social proof, and premium treatment energy.

Recognition events are tied to service points and tabs (guest groups), not to employee rankings.

B. Who Recognition is for

  • Managers / owners – control configuration, links, live moderation, and review.
  • MC / DJ / host – receive ready shoutout lines and queue flow from MC Assist.
  • TV/public screen operators – run tokenized TV display links for public celebration moments.
  • Guests (indirectly) – experience atmosphere, celebration, and social energy.

C. How Recognition works (actual implementation flow)

  1. Engine runs from feed polling: Each recognition feed request runs one engine pass, then returns active events.
  2. Data source: The engine reads only OPEN tabs in OPEN sessions and computes tab metrics (orders count, duration, velocity, total, average value).
  3. Tier classification: Tabs are classified into none/regular/vip/legend using business thresholds and hot velocity settings.
  4. Candidate generation: The engine builds candidates for tier upgrades, hot moments, and milestones based on enabled toggles and thresholds.
  5. Duplicate protection: It tracks already-emitted keys per tab and shift, prevents same-tier re-emits, and applies global plus per-event cooldown checks.
  6. Priority selection: Only the top-priority candidate is emitted per run (for controlled pacing).
  7. Lifecycle: New events start ACTIVE with short TTLs (tier upgrade 90s, milestone 60s, hot 45s). Expired items are auto-marked EXPIRED.
  8. Visibility and moderation: Managers can hide events (HIDDEN), expire events immediately, and MC operators can mark events announced (implemented as expire-now).
Important behavior note: When Public Recognition is OFF, the engine stops creating new events. Existing active events may remain visible until hidden or expired.

D. Recognition event types in this product

1) Tier upgrade

  • Trigger: Tab tier rank increases (none → regular → vip → legend).
  • Why it matters: Signals premium guest progression and status moments.
  • Operational usage: MC gives a classy or hype shoutout; TV can spotlight the moment to lift room energy.

2) Hot moment

  • Trigger: VIP/LEGEND tab qualifies as hot by velocity rules and is not blocked by hot cooldown.
  • Why it matters: Highlights momentum and pace on high-energy guest groups.
  • Operational usage: Use short hype bursts; avoid over-announcing repeated hot bursts from the same area.

3) Milestone

  • Trigger: Order-count milestones (exact threshold hit) or duration milestones (highest unmet threshold reached while minimum velocity is satisfied).
  • Why it matters: Captures loyalty, staying power, and celebration opportunities beyond pure spend.
  • Operational usage: Great for birthdays, loyal groups, and social tables—especially with tasteful TV copy plus optional MC mention.

E. Recognition Dashboard as control center

In the current implementation, your operational center is split across two manager screens:

  • Recognition Preview – live queue moderation, token controls, pause/resume, hide/expire actions.
  • Recognition Dashboard – the analytics page showing KPI totals, trends, event mix, and top service points.

Use Preview to run tonight’s floor. Use Dashboard/Analytics to tune tomorrow’s strategy.

F. Which screen to use for each task

Screen Primary purpose Key actions
Recognition Preview Manager live operations See active/recent events, pause/resume, regenerate TV/MC tokens, hide/expire events.
Recognition Dashboard (Analytics) Performance review and tuning Filter by date/type, inspect trends, export CSV tab summaries.
Recognition Settings Behavior configuration Enable/disable public recognition, panic mode flag, event-type toggles, rotation seconds, default MC style.
Recognition Logs Audit/history lookup Review status transitions and event history with status/kind/time filters.
MC Assist MC execution surface Follow queue, switch copy style, replay/next, pin, announced, hide.
TV Display Public visual atmosphere Auto-rotating fullscreen event display via secure token link.

G. How to use Recognition effectively in real operations

  • Enable Recognition when your floor has enough active open tabs for momentum.
  • Start with fewer event types and raise milestones gradually until shoutouts feel premium, not noisy.
  • Use milestone and tier moments for birthdays, repeat groups, VIP tables, and major social moments.
  • Use MC voice for high-impact events; let TV-only rotation handle lower-intensity celebration moments.
  • If queue pressure is high, hide low-value moments or mark announced quickly to keep flow clean.

H. Public shoutouts and hype usage

  • Some customers enjoy strong MC/DJ hype; others prefer quiet or visual-only recognition.
  • Match style to your venue type: lounge/classy bars often prefer tasteful pacing, clubs can sustain higher hype.
  • TV shoutouts can create social proof even when MC stays light.
  • Keep copy aspirational and celebratory—never invasive, mocking, or overly personal.

I. Privacy and safety

  • Public recognition templates avoid exposing customer identity fields and do not present spend amounts in event text.
  • Use only service-point/tab style references when speaking publicly unless a guest clearly consents to naming.
  • MC/TV links are tokenized. If a link leaks, regenerate token from Recognition Preview to invalidate old links immediately.
  • To stop recognition fast: pause Public Recognition, hide/expire active events, and replace any shared token links.

J. Troubleshooting

No events showing

  • Confirm Public Recognition is enabled and there are open tabs with meaningful activity.
  • Check event-type toggles in Recognition Settings (tier/hot/milestone).
  • Remember global cooldown and per-event cooldown can intentionally delay next event.

MC/TV link not working or token expired

  • Open Recognition Preview and copy fresh links.
  • Regenerate TV/MC token if old link may be stale or shared incorrectly.

Too many events / repeats / noisy experience

  • Disable one or more event types temporarily (often milestones first).
  • Increase milestone thresholds and tighten what qualifies as meaningful.
  • Use hide/expire actions in Recognition Preview to curate live atmosphere.

MC Assist queue empty

  • Verify MC token link is valid and Public Recognition is enabled.
  • Check Preview/Logs to confirm events are being created and not already expired/hidden.

TV display empty

  • Verify TV token link is valid and feed endpoint is reachable from that screen device.
  • If events are short-lived, increase rotation discipline operationally by keeping meaningful events active.

K. Best practices

  1. Start conservative: enable only the event types that matter for your brand tone.
  2. Tune thresholds to your venue size and traffic so recognition feels earned.
  3. Use hype selectively—save strong MC energy for premium or milestone moments.
  4. Protect guest comfort: celebrate groups without exposing private details.
  5. Coordinate Preview + MC Assist + TV Display so each channel supports one polished customer experience.