POS Operations Phase 4+
Phase 4+ adds operational control screens around the tenant POS: command center, payment recovery, shift reconciliation, split studio, receipt templates, terminal preferences, and POS safety checks.
Routes
/r/{tenant}/pos/operationsshows daily POS health, open shifts, active carts, table states, stale order counts, pending pay-links, and quick actions./r/{tenant}/pos/payments/pendinglists sandbox pay-link payments with reconcile, send-link, cancel, and checkout actions./r/{tenant}/pos/shifts/{shift}shows shift cash breakdown, denomination count, events, movements, variance, and force-close controls./r/{tenant}/pos/qualityruns safety checks for stale orders, table mismatches, high variance, missing manager PINs, pending pay-links, and receipt setup./r/{tenant}/pos/settingsstores POS thresholds, terminal preferences, and receipt/KOT template defaults.
Sandbox Payment Recovery
POS sandbox pay-links stay central in the existing payment module. The tenant recovery screen reads the central payment request, records each reconcile attempt locally, and only marks the tenant payment paid when a verified paid central transaction exists. Duplicate reconcile actions are idempotent.
Shift Audit
Shift open, cash movement, payment, refund, close, and force-close actions write pos_shift_events. High cash variance and unpaid-order close attempts require manager PIN approval based on branch POS settings.
Split Studio
The order workspace includes a visual split panel for equal, seat-label, custom amount, and merge workflows. Existing optimistic order versioning protects the split save from stale browser sessions.
Receipt And KOT Templates
Receipt and KOT templates are branch-local JSON configurations. Browser 80mm print views remain the only print mechanism in this phase. Receipt reprint actions write an order timeline event.
Quality Checks
POS QA opens findings for stale held/billing orders, pending pay-links, table/order mismatches, missing manager PINs, duplicate table orders, zero-price sold items, missing receipt setup, orphan bill lines, and high cash variance. Running QA refreshes open findings for the selected branch.