Skip to content
Youssef Alouani
← Osoul platform

Deep dive · Osoul · live

Osoul deep-dive: secure NFC/QR table sessions

How a tap on a table's NFC tag or QR code opens a short-lived session for an anonymous diner, bound to one table and one visit.

Part of the Osoul platform case study.

Problem

Diners order from their phone after tapping the table, without an account. That makes the table itself the credential: whoever holds a valid link can order to that table. A photo of a QR code, a link shared in a group chat or a guess at a table number must not let anyone order to someone else’s bill.

Constraints

  • No sign-up: asking diners to create an account before ordering kills adoption.
  • Physical tags are public: anyone can photograph a QR code, so the code alone cannot be the whole secret.
  • Sessions end with the visit: an order link must stop working once the table is cleared.
  • Staff see the same truth: the Waiter App needs to know which tables are seated and for how long.

Architecture

Osoul NFC/QR table sessionsEach table carries an NFC tag and QR code that identify the table with a credential. A tap opens a short-lived session bound to that table and visit, which the Guest App uses to order. The Waiter App sees the same session on the floor view, and the session ends when the table is cleared.TableNFC tag · QR codetable id + credentialSessionTable sessionshort-lived · one table, one visitAppsGuest Apporder · call serviceWaiter Appfloor · sections · statusEndTable clearedsession closed
Diagram source (Mermaid)
flowchart TB
  tag[NFC tag · QR code · table id + credential] --> session[Table session · short-lived, one table, one visit]
  session --> guest[Guest App · order, call service]
  session --> waiter[Waiter App · floor, sections, status]
  waiter --> cleared[Table cleared · session closed]
Osoul Waiter App floor view: Main Room and Jardin tabs, a table map with the waiter's section outlined, and all tables sorted by urgency with a seated walk-in guest
The Waiter App sees each table's session: seated, for how long, and whose section it is in.

Key decisions

  1. A session per visit, not a permanent table URL. A permanent link would work forever for anyone who saved it. The tap exchanges the tag’s credential for a short-lived session token bound to that table and that visit.
  2. Sessions close with the table. When staff clear the table, the session ends, so a link from lunch cannot order at dinner.
  3. One session, two views. The Guest App and the Waiter App read the same session, so the floor view shows who is seated and for how long without staff entering it twice.

Results

Numbers to come.

Stack and links