14 · POS & Mobile POS

flowchart TB
  LOGIN[Platform login · session cookie] --> POS["/pos"]
  POS --> ENTRY[PosEntryRoute]
  ENTRY -->|viewport ≤768 or pref mobile| MOB[MobilePOS.jsx]
  ENTRY -->|desktop / pref modern| MOD[ModernPOS.jsx]
  BOOK["/pos/mobile"] --> MOB
  KURL["/pos/kiosk"] --> KIOSK[Kiosk.jsx]
  KDS["/pos/kitchen"] --> KITCHEN[KitchenDisplay · KDS]
  BAR["/pos/bar"] --> STUB1[Placeholder]
  REST["/pos/restaurant"] --> STUB2[Broken placeholder]
  HAND["/pos/handheld"] --> STUB3[Broken placeholder]
          

flowchart TD
  A[Platform login] --> B[Device context
deviceKey · location · catalogs]
  B --> C[Register authenticate
email + POS PIN]
  C --> D{Register open?}
  D -->|no| E[Open shift + float]
  D -->|yes + staff match| F[canTransactOnRegister]
  E --> F
  F --> G[POST /api/pos/carts]
  G --> H[Add items · barcode · customer]
  H --> I[Optional metadata seat/table · Modern]
  I --> J[Tender cash/card/crypto/…]
  J --> K{Covered?}
  K -->|no| J
  K -->|yes| L[POST .../finalize]
  L --> M[CoreInvoicingService]
  M --> N[(Invoices + payments)]
  L --> O[Inventory / recipe consumption]
  L --> P[kitchen_tickets if preparable]
  H --> Q[Mobile: send-to-kitchen]
  Q --> P
          

flowchart LR
  subgraph UI["What staff open"]
    MPOS[Mobile POS page
MobilePOS.jsx]
    KUI[Kiosk.jsx]
  end
  subgraph API["What they call"]
    POSAPI["/api/pos/* · session"]
  end
  subgraph ALT["Separate unattended routers"]
    MAPI["/api/mobile/*"]
    KAPI["/api/kiosk/*"]
  end
  MPOS --> POSAPI
  KUI --> POSAPI
  MAPI -.->|not used by MPOS| X[ ]
  KAPI -.->|not used by Kiosk.jsx| X