BevDirector Enterprise Suite — Complete Master User Manual (v193)

At the top of the header bar is the 3-button Operational Mode & Security switcher ( Director | Service | Team & Codes):

3.1 Director Mode vs. Service Mode

3.2 Team & Codes (Verified-Email Team Onboarding & Roles)

• Verified-Email Workspace Membership: Click Team & Codes to add staff members by their verified work email address and assign their role:
  • Beverage Director / Owner: Full administrative control, Master PIN management, team roster management, period close/undo, and billing.
  • Bar Manager / Lead: Can authorize floor count unlocks, receive deliveries, and switch to Director Mode using their personal Lead PIN or Master PIN.
  • Closing Bartender / Staff: Defaulted to Service Mode for floor counting, morning prep pulls, and Spec Bible lookup.
• Server-Validated Master PIN (4–6 Digits) vs. Personal Roster PINs: The Master PIN is hashed with PBKDF2 + a server-side pepper and verified via /api/v1/pin/verify with brute-force cooldown protection. Only the Master PIN can change the Master PIN, and only the workspace Owner can trigger an email PIN reset ( Forgot PIN? Email Reset). Every PIN event is logged with masked digits in the Security Audit Log.

5.1 Interactive KPI Cards & Executive Widgets

• 4 Clickable Executive KPI Cards:
  1. Active Venue Program: Displays active cocktail count; click to view the Full Menu Library Roll-Up Table.
  2. Blended Menu COGS %: Sales-weighted menu pour cost percentage vs. target (default 18.0%); click to inspect the 4-Quadrant Menu Engineering Matrix.
  3. Total Period Revenue: Projected or actual PMix revenue ($); click to open the Blended Program P-Mix Model.
  4. Master Price Book SKUs: Total tracked SKUs and active price-creep count; click to open the Master Price Book & Price-Creep Auditor.
• 3 Stylized Executive Dashboard Widgets:
  1. POS Live Depletions: Real-time ring counters across Cocktails, Wine BTG, Coffee (g), and Draft Pints, with a 1-click jump to AvT Theoretical Depletions.
  2. At-A-Glance Risk Radar: Live hazard counters for $0 Cost (uncosted SKUs), Below Par (stockout threats), Price Spikes (distributor cost creep), and Matrix Dogs (low-margin, low-volume items). Click any counter box to filter directly to the offending items.
  3. Flavor Balance & Portfolio: Displays your menu's proportional palate balance normalized to the classic 2.0 : 0.75 : 0.75 Golden Ratio (Spirit Eq. : Sour/Acid Eq. : Sweet/Mod Eq.). Click Program Balance Modal to audit style diversity across your entire menu.

5.2 Consolidated Executive Reporting Center ( Consolidated Reports)

Click Consolidated Reports in the Command Center action bar to open the 11-Report Executive Suite with Location Filtering (All Locations Comparative Rollup or individual outlet), Period Filtering (Current Period, Last 30 Days, QTD, YTD), and 1-click Print PDF, Export Excel (.xlsx), and CSV:

1. 1. P&L Rollup: Executive revenue, COGS $, COGS %, gross profit, and variance vs. budget.
2. 2. COGS by Location: Multi-outlet comparative breakdown of Beginning Inventory, Purchases, Transfers In/Out, Ending Inventory, Net COGS, and Pour Cost % per venue.
3. 3. COGS by Category: Standardized 5-Category Hospitality Ledger (Spirits & Fortified [GL 5110 / 1410, 18.0%], Wine & Champagne [GL 5120 / 1420, 18.0%], Beer [GL 5130 / 1430, 18.0%], N/A Bev [GL 5140 / 1440, 16.0%], and Pantry & Produce [GL 5150 / 1450, 15.0%]).
4. 4. AvT & Pour Cost: SKU-by-SKU Actual vs. Theoretical usage, variance in bottles/ounces, and wholesale dollar shrinkage.
5. 5. Menu Matrix & PMix: Kasavana & Smith quadrant performance, unit contribution margins, and sales velocity.
6. 6. Vendor Spend & Creep: Spend share by distributor and wholesale price-hike audit trail.
7. 7. Valuation & DOH: Sitting shelf + walk-in cambro asset valuation and Days on Hand (DOH) velocity metrics.
8. 8. Spills, Comps & Waste: Categorized waste ledger separating logged VIP comps, spilled drinks, and dock breakage from unexplained theft/shrink.
9. 9. CFO GL & Trial Bal: Balanced double-entry General Ledger journal preview for QuickBooks Online (QBO), Restaurant365 (R365), and Xero (Total Debits === Total Credits across GL 5110–5150, 1410–1450, 2010 Accounts Payable Clearing, and 5190 Shrinkage Variance).
10. 10. Transfers & Par: Inter-bar and commissary transfer audit log plus below-par reorder exposure.
11. 11. Audit Comparisons (openAuditComparisonReport in bd-commissary-reports.js): Side-by-side comparison across 3 unified sources—Option 0: Live Current Inventory, Closed Accounting Periods, and Saved Audit Snapshots—with 4-Tab Excel Workbook export (1_Executive_Summary, 2_SKU_AvT_Variance, 3_Menu_Engineering_Matrix, 4_Price_Creep_Audit).

Hub 2 (powered by bd-rd-depletion.js & bd-commissary-reports.js) combines cocktail costing, Service Mode R&D Sandbox isolation, 11-Rule molecular palate balance analysis, POS depletion spec mapping, pre-batch cambro scaling, and 4 scientific bar-lab calculators across 5 Sub-Tabs.

6.1 Sub-Tab 1: Active Spec, Pour & Depletion Builder ( Active Spec, Pour & Depletion Builder)

Understanding the 3 Recipe & System Scopes + R&D Sandbox

• Menu Recipe (Drink Lab & Menu): FOH cocktails and signature serves. Appears in Drink Lab KPIs, the 4-Quadrant Menu Engineering Matrix, and the Cocktail Spec Bible.
• System POS Depletion (POS Match Only): Standardized single-item pours (e.g., Tito's Neat 2.0 oz, Tito's Shot 1.5 oz, House Pinot Noir BTG 5.0 oz, Draft IPA Pint 16.0 oz). Used strictly by the POS Depletion engine to deduct liquid from inventory without skewing cocktail menu metrics. Click Bulk POS Pours (openBulkPosSpecGeneratorModal) in the Library bar to auto-generate System POS Depletion specs for all Spirits, Wine BTG/BTB (intelligently distinguishing fortified modifier wines like Vermouth/Lillet via isFortifiedModifierWine), Draft Pints, and Packaged Cans directly from your Master Price Book in one click!
• [PREP] Sub-Recipe Batch (BOH): House-made syrups, cordials, shrubs, tinctures, and clarifications (or any recipe prefixed with [PREP]). When used as an ingredient inside a FOH cocktail, BevDirector recursively calculates its exact $/oz yield cost and cascades raw ingredient price changes through all nested levels.
• Service Mode R&D Sandbox & Director Promotion (bd-rd-depletion.js): In Service Mode, Drink Lab automatically switches to an isolated R&D Sandbox where bartenders can click Clone Live Menu Drink to Test (openCloneMenuToSandboxModal) to experiment with real bottle costs. In Director Mode, click R&D Sandbox (N) (openDirectorSandboxReviewModal) to audit bartender submissions and click Promote to Live Menu (promoteSandboxRecipeToLiveMenu).
• + Classic & Modern Vault (69 Built-In Specs): Click + Classic & Modern Vault in the Recipe Library bar to browse and import from 69 industry-standard classic & modern classic cocktail specifications (BEVERAGE_CLASSIC_COCKTAIL_DB) organized across 8 Base Spirit Categories (Agave, Whiskey, Gin, Vodka, Rum, Brandy, Liqueur & Amaro, Wine & Spritz). Importing specs automatically matches ingredients to your existing Master Price Book bottles, creates any missing house [PREP] sub-recipes (Simple Syrup 1:1, Rich Demerara 2:1, Honey Syrup 3:1, Raspberry Syrup, Ginger Syrup), and seeds missing SKUs into your Price Book.

Building a Spec, 11-Rule Palate Balance Analyzer & Scaling Pre-Batches

1. Identity & Pricing Bar: Set Active Recipe / POS Item Name, POS Serve / Depletion Type (15 presets from Cocktail to Full Bottle BTB and Draft Pitcher), Recipe Scope, POS PLU / Item Code, and Menu Category. Enter Menu Selling Price ($) or click Auto to snap the selling price to hit your Target COGS % (rounded to the nearest $0.50). Select Target Batch Vessel (1.0 L, 2.0 L, 4.0 L, 8.0 L, or 19.0 L Corny Keg).
2. Ingredients Table & Batch Scaler: Click + Add Ingredient and type any spirit, modifier, or [PREP] sub-recipe. Choose from 40 International & Hospitality Container Formats (50 mL miniatures to 50 L Euro kegs, including 700 mL EU/UK, 720 mL & 1.8 L Sake, 750 mL, 1 L, 1.75 L, 118–296 mL bitters dashers, 40 lb citrus cases, 1–5 lb coffee bags, and 6/12/24-pack cases), Unit Cost ($), Spec Amount, and 19 Hospitality Units (oz, mL, cL, tsp/barspoon, tbsp, dash, drop, pump, g, Piece/Unit, full btl, 5oz/6oz BTG, 2oz Neat/Rocks, 1.5oz Shot, 16oz Pint, 12oz Can, 16oz Tallboy, 60oz Pitcher). Check In Batch? for shelf-stable spirits going into the Cambro; uncheck for fresh citrus, bubbles, or garnishes added a la minute. Use Pull Dist Costs, Gemini Spec Audit, Cambro Labels, and Export Recipe Spec.
3. Secondary Service Specs & 11-Rule Molecular Palate Balance Strip (analyzeCocktailBalance): Configure Target COGS %, Spillage Buffer % (default 2.0%), Execution Method (8s Freezer-Door/Draft up to 42s Scratch Multi-Touch), Glassware, + Craft Ice, Garnish, and AI Write Notes. The Flavor Balance Strip evaluates every ingredient across 11 Molecular Palate Rules connected to BEVERAGE_INTELLIGENCE_DB Brix (°Bx) and Titratable Acidity (%) (1. Aromatic Bitters/Tinctures/Saline, 2. Zero-Proof Botanicals, 3. Distilled Base Spirits, 4. Bitter Aperitivi & Amari [20% Spirit / 50% Sweet / 30% Bitter], 5. Vermouth & Fortified Wines, 6. Sweet Liqueurs & Triple Sec, 7. High-Acid Citrus >=1.8% acid, 8. Tart-Sweet Mixes, 9. Pure Sweeteners & Syrups >=45°Bx, 10. Fruit Juices/Purees, 11. Sparkling/Lengtheners), normalizing the drink to the 2.0 : 0.75 : 0.75 Golden Ratio and surfacing real-time hazard badges (getActiveDrinkHazards).

6.2 Sub-Tab 2: Freezer-Door ABV, Dilution & Viscosity Calculator ( Freezer ABV & Dilution)

Load any library cocktail spec, select your Dilution Target Profile (0% pre-diluted, 22% stirred/freezer-door, 33% shaken citrus, or 15% large rock), and enter your Commercial Freezer Temp (°F). Outputs Undiluted ABV %, Exact Water Dilution to Add (oz), Final Diluted ABV % (ideal freezer window: 24%–28%), and Estimated Freezing Point (°F) so freezer Martinis and Negronis pour silky without slushing.

6.3 Sub-Tab 3: Precision Syrup Brix & Juice Acid-Adjustment Lab ( Syrup Brix & Acid Lab)

• A. Precision Syrup Brix Calculator: Select a preset (1:1 Simple 50.0°Bx, 2:1 Rich Demerara 66.0°Bx, Agave Blend 65.0°Bx, Honey 3:1 62.0°Bx, House Orgeat 55.0°Bx, or Custom) and enter Target Final Volume (mL) and Target Sugar (°Brix). Accounts for 0.62 mL/g sucrose displacement to output exact Sugar Weight (g) and Water Weight (g).
• B. Juice Acid-Adjustment Calculator: Select your starting liquid (Pineapple ~0.8% acid, Orange ~0.9%, Grapefruit ~1.8%, Pomegranate ~1.4%, Watermelon ~0.2%, or Tea/Water 0.0%) and target profile (Fresh Lime 6.0% — 2:1 Citric:Malic or Fresh Lemon 6.0% — 100% Citric) to get exact gram weights of Citric Acid Powder (g) and Malic Acid Powder (g).

6.4 Sub-Tab 4: Milk-Wash / Agar / Centrifuge Clarification Yield Lab ( Milk Clarification)

Tracks Unclarified Batch Volume (mL), Clarifying Agent Added (mL), Total Raw Cost ($), and Final Strained Yield Volume (mL) to compute Total Straining Yield %, True Clarified Cost / Oz ($), and True Pour Cost / Cocktail ($), with 1-click Update Wholesale Cost in Master Price Book.

6.5 Sub-Tab 5: Draft Keg PSI, Line Balancing & Maintenance Log ( Draft Keg PSI & Lines)

• Draft Line & Keg Balancing Hub: Supports Lagers, Craft IPAs, Nitro Stouts (75/25 N2/CO2), Force-Carbonated Cocktails, and Still Draft Cocktails (100% N2). Computes Required Regulator Pressure (PSI), Ideal 3/16" Barrier Line Length (ft), 19L Corny Keg yield, and Check Carbonation Foam Risk.
• Draft Line Cleaning & Preventive Maintenance Log: Tracks mandatory 14-day draft line cleaning cycles (alternating Caustic wash for organics and Acid wash for mineral/beer stone) with technician sign-off and overdue alerts.

Hub 3 (powered by engine.js, bd-enterprise-ops.js, bd-commissary-reports.js, and app.js) consolidates floor counting, AI invoice scanning, variance auditing, walk-in cambro valuation, Bluetooth scale weighing, deposit tracking, commissary transfers, and POS depletion into 7 Sub-Tabs.

7.1 Sub-Tab 1: Floor Bottle Count ( Floor Bottle Count)

• Audit Lifecycle Bar & Manager Audit Edit Mode: Use Start Audit (openStartAuditModal — locks Start Count & Purchases (+) so all floor counts go strictly into Current Inventory), Close Audit, Edit Audit (PIN) (openEditAuditSelectorModal / openPreviousAuditForManagerEdit — unlocks a closed period or historical snapshot with a Manager PIN so you can edit Start Count or Purchases (+) across the table and 3D Bottle Calculator), Compare, and Category COGS.
• Protection & Sorting Controls: Toggle Count Lock (Anti-Fat-Finger PIN protection) and Blind Count Mode (hides theoreticals, starts, and sitting values). Sort by Category or Physical Rail Layout, and filter by Storage Area / Zone.
• 4 Ultra-Fast Floor Counting Methods:
  1. 3D Touch Bottle Calculator & Speed Count ( Speed Count): Drag vertically on the SVG liquid bottle silhouette (or tilt your mobile device) for 0.1 tenths, tap Empty / ¼ / ½ / ¾ / Full, toggle Bottles vs. Case Mode (_bcEntryModeV151), enter full units on the keypad, and tap Apply & Next → to walk sequentially through your shelf order.
  2. Module 1 — Hands-Free Voice Inventory Counter ( Voice Count / openVoiceCountModal in app.js): Speak naturally (e.g., "Fortaleza Blanco 4 point 5", "Campari plus 2", "Tito's 1 case and 3 bottles") across 8-Language Polyglot Voice Recognition (English, Spanish, French, Italian, Portuguese, German, Japanese, Mandarin via normalizeMultilangSpokenNumbers) with 5 Gemini Neural TTS / Web Speech Personas, Hospitality UPC quick-scan presets, and 1-tap session undo.
  3. Camera & Laser UPC Barcode Scanner ( Barcode): Scan bottle or case UPCs via phone camera or USB/Bluetooth laser scanner with instant UPC learning.
  4. Module 2 — Simultaneous Multi-User Zone Counting & Atomic SKU Merge ( Audits & Tools ▾ → Live Zone Merge / openMultiCounterMergeModal in bd-enterprise-ops.js): Multiple bartenders claim different physical zones and count simultaneously; atomic SKU count packets (broadcastAtomicSkuCount / applyIncomingAtomicSkuCount) merge in real time without overwriting co-counters.
• Submitting Counts & Period Close: Click Submit Count to open the Sunday Close Dollar-Leak Debrief Card (openPostCountDebriefModal in app.js), surfacing Total Sitting Asset Value, Unexplained Dollar Shrinkage, Pour Accuracy %, and Top Margin-Leak Bottles. Use Dead Stock Radar, Auto-Tune Pars, History Vault (openAuditHistoryVaultModal), and Close & Archive Period (backed by Undo Last Period Roll in Settings).

7.2 Sub-Tab 2: Actual vs. Theoretical (AvT) Shrinkage Audit & CFO GL Exporter ( AvT Shrinkage Audit)

Includes 6 KPIs (Actual Usage $, Theoretical Usage $, Net Variance $ & %, Pour Accuracy %, Top 3 Margin-Leak SKUs, and Sitting Asset $), the Spill / Comp Log, Export 14-Day AvT Audit PDF, and Module 3 — CFO Accounting GL Mapper & Journal Exporter (openAccountingGlModal in bd-enterprise-ops.js — maps custom GL codes across all 5 Hospitality Categories plus GL 2010 AP Clearing and GL 5190 Shrinkage Variance, guaranteeing Total Debits === Total Credits for QuickBooks Online, Restaurant365, and Xero CSV import).

7.3 Sub-Tab 3: Walk-In Pre-Batch Cambro Credit ( Walk-In Cambro Credit)

Enter Liters Counted On Hand for each pre-batched cocktail or [PREP] blend in the walk-in cooler. BevDirector calculates Sitting Asset Credit ($) and reverse-calculates the exact Bottle Equivalents (+btls) of every constituent spirit inside those batches—crediting them automatically to both AvT Audit and the Multi-Vendor PO Splitter.

7.4 Sub-Tab 4: Opaque Bottle Scale Tare & Module 5 Web Bluetooth ( Opaque Bottle Tare)

Pair directly with a Web Bluetooth GATT (0x181D / 0x2A9D) smart gram scale via Pair Bluetooth Scale (connectWebBluetoothScale in bd-enterprise-ops.js) or enter scale weight manually. Choose from 18 Built-In Opaque & Heavy Bottle Presets (Clase Azul Ceramic 780g, Don Julio 1942 890g, Fortaleza Hand-Blown 585g, Hendrick's 1L 560g, Mr. Black/Kahlua, Carpano Antica, Chartreuse, Disaronno, Japanese Sake, etc.) plus 70+ Brand Tare Profiles in the Internal Beverage Intelligence Database (lookupBottleTareAndUpc) and 17 Scale Container Capacities (50 mL to 3000 mL) to convert gram weights to exact Tenths (0.0–1.0) and Fluid Ounces using ABV & Brix specific gravity—and automatically save confirmed scale tares (Rank 4: confirmed_scale) back to your workspace intelligence DB.

7.5 Sub-Tab 5: Distributor Deposits, Keg Returns & Credit Memo Ledger ( Deposits & Credits Ledger)

Tracks Bottle Deposits, Keg Returns, Not On Truck, Broken / Damaged, Misshipments, and Credit Memos (Pending vs. Reconciled). Click Statement Audit Sheet (openDistributorReconciliationStatementModal in bd-purchasing.js) to generate a formal Distributor Reconciliation Statement with 1-click Copy Rep Dispute Email.

7.6 Sub-Tab 6: Multi-Unit Commissary, Stock Transfers & Transfer Audit Vault ( Commissary & Transfers)

Supports both Single-Venue Inter-Bar Mode (moving stock between wells and liquor rooms) and Multi-Unit Central Commissary Mode (weighted-average wholesale cost transfers across venues/outlets, unlocked on Pro and Group plans). Includes 1-click Restock Destination to Par (restockLocationToPar) and the searchable Full Audit Vault (openTransferHistoryVaultModal in bd-commissary-reports.js).

7.7 Sub-Tab 7: Real-Time POS Depletion Hub & Module 6 24/7 Cloud Webhook Queue ( POS Depletion)

Uses a 3-Pass Matching Engine: Pass 1 (Exact PLU or Saved Alias Rule) → Pass 2 (Normalized Recipe/Sub-Recipe/SKU + Pour Modifier Extraction like Neat 2oz, Rocks 2oz, Shot 1.5oz, Double 3oz, BTG 5oz/6oz, Bottle BTB, Pint 16oz) → Pass 3 (Fuzzy Similarity + POS Mapping Review Queue). Click 24/7 Cloud POS Webhook Queue (openCloudWebhookQueueModal in bd-enterprise-ops.js) to inspect real-time closed-check webhooks from Toast, Square, Clover, and Lightspeed or fire a simulated test ring.

8.1 Sub-Tab 1: Master Price Book, Multi-Vendor SKU Profiles & Creep Auditor ( Master Price Book & Creep Auditor)

• 3-Tier Price Resolution Hierarchy: Tier 1: Director Lock (Contract / Locked Price — Emerald Green) → Tier 2: Provi / Live Wholesale Sync (Cyan) → Tier 3: Last Invoice / Manual Cost. Click the lock icon on any SKU to enforce contract pricing.
• Multi-Vendor Profiles per Master SKU & 4-Step Invoice Pack Matcher (ensureSkuVendorProfiles in bd-purchasing.js): Every Master SKU can store multiple distributor profiles (e.g., Southern Glazer's 12pk case vs. MS Walker 6pk case vs. Secondary Purveyor) with distinct vendor item codes, pack multipliers, bottle/case costs, and split-case fees. Incoming invoices automatically match via 1) Exact Vendor Item Code, 2) Distributor Name, 3) Pack Multiplier Hint (6pk vs. 12pk), or 4) Primary Preferred Vendor—converting delivered cases into canonical Master Price Book bottles without creating duplicate SKU rows.
• Local / Bespoke / Farm-to-Bar SKU Builder (openAddLocalBespokeSkuModal): Dedicated quick-add modal with 5 hospitality presets (Local Farm Produce/Citrus, Artisanal Roastery Coffee, Local Microbrewery/Keg, Small-Batch Distiller/Winery, Custom BOH Supply) that auto-configures storage zones, container formats, and GL buckets.
• Bulk Portfolio Ingestion & Self-Learning SKU Intelligence: Upload distributor catalogs (.csv, .xlsx) from Southern Glazer's, RNDC, Breakthru, Empire, Johnson Brothers, Winebow, etc. Every added or edited SKU automatically queries and trains the Internal Beverage Intelligence Database (resolveBeverageMetadata & ingestConfirmedBeverageIntelligence)—auto-assigning its semantic category, default storage zone across all 11 Canonical Storage Zones (Well 1, Well 2, Backbar, Liquor Room, Wine Cellar, Beer Room, Bar Fridge, Walk-In, Bar Freezer, Bar Storage, Dry Storage), empty tare weight (g), specific gravity, functional role, and 5-Category CFO GL Bucket (Spirits & Fortified 5110, Wine & Champagne 5120, Beer 5130, N/A Bev 5140, Pantry & Produce 5150) while rejecting non-beverage glassware rows.
• Price Book Tools ▾: Auto-Categorize SKUs, Scale Weekend Pars (openBatchScaleWeekendParsModal), Module 4 — Sommelier Cellar Bins & Coravin Oxidation Radar (openSommelierCellarModal in bd-enterprise-ops.js — strict wine-only filter via isTrueWineCellarSku tracking Physical Bin #, Vintage, Appellation, Service Closure, and live Coravin Argon vs. Cork Pull oxidation timers), and Prune 0-Drink SKUs.

8.2 Sub-Tab 2: Multi-Vendor PO Splitter, Manual Order Cart & Auto Invoice Matcher ( Multi-Vendor PO Splitter)

• Smart Split-Case Optimization & Active Vendor Switcher: Compares Effective On-Hand (Shelf + optional Walk-In Cambro Credit) against Weekday or Weekend Rush Pars. Switch any SKU's active distributor profile inline (switchSkuActivePoVendorProfile) and follow the Round to N Cs — Saves $XX.XX badge whenever completing a case beats paying loose-bottle split-case fees.
• Module 11 — Manual Order Cart, Quick-Catalog Drawer & Auto PO-to-Invoice Discrepancy Matcher (bd-enterprise-ops.js): Click Load Par Shortages or open the Quick-Catalog Drawer (togglePoQuickCatalogDrawer) to add novel products on the fly, then click Confirm & Checkout by Vendor → (openPoCartCheckoutModal). Confirmed vendor POs are stored in programSettings.dispatchedPos and automatically pre-populate Manual Invoice Receiving (openManualInvoiceReceivingModal / checkMirVendorPoDiscrepancy) during dock check-in to flag shorted cases or unapproved price spikes!
• Module 6 & 1-Tap Dispatch Channels: Copy Sunday Order (Rep Text) (openSundayOrderTextModal — warm hospitality correspondence formatted in Cases + Loose Btls with inline Rep Directory editing for SMS/iMessage/WhatsApp), Send Order to Provi, Email Order to Rep, Distributor Rep Delivery Portal (openRepDeliveryPortalModal), and Export Fintech / EDI 850 (exportFintechEdiPoCSV).

8.3 Sub-Tab 3: Purchase Orders, Custom PO Builder & Delivery Log ( Purchase Orders & Delivery Log)

Tracks New / Draft, Pending In-Transit, and Received & Reconciled POs. Draft custom multi-line orders via Create Custom PO (openCreateCustomPoModal), convert all shortages in one click via Auto-Generate POs from Par Deficits (autoGeneratePosFromParDeficits), or click Receive Truck Delivery & Dock Exceptions (openReceivePoModal) to reconcile incoming deliveries line-by-line (flagging Intact, Not on Truck, Broken / Damaged, or Misshipment)—stocking only intact units while auto-calculating Net Payable ($) vs. Credit Claim Due ($) and logging claims to the Deposits & Credits Ledger.

8.4 Sub-Tab 4: Post-Off & Case-Break Deal Analyzer ( Post-Off & Case-Break Deal Analyzer)

Evaluates volume drops using Front-Line Cost, Deal Cost, Split-Case Fee avoided, Case Pack, Required Case Drop, and Weekly Velocity to output Cash Tied Up, Total Savings, Weeks on Hand, Annualized Cash-on-Cash ROI %, and a buy/trap verdict badge.

8.5 Sub-Tab 5: Provi Live Catalog & Price Sync ( Provi Live Catalog & Price Sync)

Accessible both as an inline subtab in Hub 4 (#sub-provi-catalog) and as a pop-up modal ( Provi Live Pricing in Command Center and Master Price Book). The Provi Wholesale Hub connects your Master Price Book and Multi-Vendor PO Splitter to regional distributor catalogs with zero password or login friction:

• Passwordless Regional Market & State Liquor License Bar (#proviMarketSel + #proviLicenseNumInp):
  • 34 US Wholesale Markets + National Index (PROVI_MARKET_MULTIPLIERS): Defaults to MA — Boston / Massachusetts (MS Walker • Martignetti • Horizon Bev • Ruby Wines • Burke Dist.) and supports MA, NY, FL, CA, IL, TX, NV, CO, GA, TN, LA, PA, DC, WA, OR, AZ, NC, SC, NJ, CT, RI, ME, NH, VT, MI, MN, OH, MO, WI, IN, MD, VA, KY, HI, and National.
  • State Liquor License Number (#proviLicenseNumInp, e.g., MA-0116): Syncs to programSettings.liquorLicenseNumber and automatically stamps Lic #<number> onto outbound Provi Direct Order dispatches and distributor rep manifests.
  • Automatic Regional Distributor & SKU Code Mapping (resolveProviMarketDistributor): Switching your market automatically updates regional distributor names, distributor item codes (e.g., MSW- MS Walker, MRTG- Martignetti, HRZ- Horizon Bev, RUBY- Ruby Wines, BRK- Burke Dist. in MA/RI; PST- Pine State / NAP- Nappi in ME/NH; ASG- Allan S. Goodman / BRS- Brescome Barton in CT; ALD- Allied Beverage / FED- Fedway in NJ; plus SGWS-, RNDC-, BTG-, EMP-, MBD-), and regional wholesale price multipliers across all unlocked Tier 2: Provi SKUs in your Master Price Book.
• 165+ Verified Wholesale SKUs, Venue Price Book Seeding & Live /api/gemini Catalog Lookup:
  • Pre-Loaded Wholesale Catalog (PROVI_WHOLESALE_CATALOG): Ships with 165+ real commercial wholesale SKUs across Tequila & Mezcal, Bourbon / Rye / American Whiskey, Scotch / Irish / Japanese / Canadian Whisky, Vodka, Gin, Rum, Liqueurs / Amari / Cordials, Wine & Champagne, Draft & Packaged Beer / Hard Seltzers, and Mixers / Bitters / Zero-Proof—each with authentic distributor item codes, container sizes, case pack counts, Front-Line wholesale prices, Case-Break deal prices, allocation badges (Allocated Release, In Stock), and deal tiers (3-Case Break, 5-Case Well Break).
  • Automatic Venue Price Book Seeding (ensurePriceBookInProviCatalog): Automatically merges any custom non-prep bottle from your venue's Master Price Book into the Provi catalog view so every venue bottle is represented.
  • Non-Destructive Search + Live /api/gemini Wholesale Catalog Lookup (queryProviCatalogWithAI): Typing in #proviSearchInp filters local matches instantaneously using non-destructive DOM updates (preserving mobile keyboard/IME focus without re-rendering the input). When a query has no local matches (auto-triggered after a 550ms debounce for queries >= 3 characters) or when you press Enter / click Search / click Live Network Lookup, BevDirector queries /api/gemini (gemini-3-flash-preview) scoped to your active state market and its authorized distributors. Enforces a strict anti-hallucination guardrail—never fabricating fake brands or echoing gibberish queries, returning only 1–4 verified real-world commercial bottlings sold in the US wholesale market and prepending newly discovered SKUs directly into your active catalog.
  • External Provi.com Launch ( Provi.com): Copies your current search query to the clipboard and opens https://www.provi.com/ in a new browser tab.
• 3-Tier Price Book Resolution ("Provi Pulls, Manual Rules"), Filters & Bulk Sync Toolbar:
  • Category & Sync Mode Filters: Filter by Category (All Categories, Spirits, Wine & Champagne, Draft & Packaged Beer, Mixers & Bitters) and Sync Mode (All Catalog, Matched to Book, Director-Locked, Case-Break Deals).
  • 2×2 Bulk Action Toolbar:
    • Sync Front-Line (syncAllMatchedProviPrices(false)): Updates all matched unlocked SKUs to regional Front-Line pricing while strictly protecting Tier 1: Director Lock SKUs (storing proviLiveReferenceCost for reference without overwriting locked contract prices) and cascading updated costs across Drink Lab, Menu Matrix, and AvT.
    • Apply Case Deals (syncAllMatchedProviPrices(true)): Applies multi-case break pricing across all unlocked matched SKUs and cascades savings across all recipes.
    • Import CSV (importProviOrderCsvFile): Imports a Provi Order CSV into the Master Price Book while respecting Director Lock protections.
    • Export Below-Par (exportBelowParForProvi): Exports all below-par shortages (with distributor, item code, container size, case pack, order cases, unit cost, and resolution tier) to Provi_QuickOrder_Export_YYYY-MM-DD.csv.
  • Responsive Desktop 7-Column Table (> 768px) & Mobile Zero-Overflow Card List (<= 768px): Compares Book Cost vs. Front-Line vs. Case Deal (with per-case dollar savings and discrepancy badges such as Provi +$X.XX vs Book or Provi -$X.XX Lower). Each row/card provides 5 actions: / (Toggle Tier 1 Director Lock), Sync / Add (Sync single Front-Line cost or add new SKU to Price Book), $<deal> (Apply Case-Break Deal cost), Order (Open 1-Case Provi Direct Order for that SKU), and (Add 1 or 3 cases to the Multi-Vendor PO Splitter cart).
• Provi Direct Order Dispatch ( Send Order / #proviDirectOrderModal):
  • Aggregates items from a single SKU ( Order), your active Multi-Vendor PO Cart, or Below-Par shortages (collectProviDirectOrderItems).
  • Groups order lines by regional distributor, attaches each distributor rep's name and account number from the Vendor Rep Directory plus your State Liquor License # (Lic #<number>), and generates a friendly hospitality rep note.
  • Clicking Transmit Order Straight to Provi (or Transmit & Open app.provi.com) logs pending PROVI-XXXXXX Purchase Orders into Hub 4 → Purchase Orders & Delivery Log (recordDispatchedPoItems) for 1-click Dock Invoice Receiving and copies the formatted dispatch manifest to your clipboard.

1. Shift Prep Par Planner: Applies day-of-week run-rate multipliers (0.7x Mon to 2.0x Sat Peak) to compare Target Par (L) vs. On-Hand (L), generating Auto-Scaled Morning Batch Recipe Cards, Pull Sheets, and Cambro Labels.
2. Station Layout & Rail Builder: Order bottles left-to-right across physical bar stations (Well 1, Service Bar Rail, Upstairs Speed Rack); drives Sort by Physical Rail Layout in Floor Inventory.
3. Well Station Cheaters: Laminated-ready well reference grids showing Pre-Batch Pour (oz), A La Minute additions, Method & Speed, Glass & Ice, and Garnish.
4. Well Speed Simulator: Models active bartenders and peak hour orders/hr to compute Weighted Avg Build Time, Max Well Capacity (drinks/hr), Utilization %, and Hours Saved per 1,000 Cocktails by Pre-Batching.
5. Staff Spec Trainer: Interactive Flip-Card Flashcards and randomized Multiple-Choice Spec Quiz.
6. Allergen Matrix: Recursively inspects cocktail ingredients and nested [PREP] sub-recipes for Dairy, Egg White, Tree Nuts & Coconut, Gluten/Beer, Wine/Sulfites, and Vegan Status.
7. Banquet Planner: Computes Total Servings, Cocktail Batch Liters, Wine Bottles, Beer Units, and Ice (lbs) from Guest Count and Event Duration.
8. Cocktail Spec Bible: Interactive and printable full-menu recipe cards (available both as an inline subtab in Hub 6 and as a pop-up modal in Drink Lab).