Nº13 · Jackson VenturesJackson VenturesProduction · restaurant operations生产环境 · 餐饮运营

IPOT Restaurant Platform

A reservation service real guests use, the POS money path, and Nalu, the bilingual booking agent.真实客人在用的预订服务、POS 资金链路，以及双语预订助手 Nalu。

Try the POS reimplementation试用 POS 重写版 →
  1. Guest · QR · Nalu客人 · 扫码 · Nalu
  2. Reservation APIReservation API
  3. Twilio VerifyTwilio 验证
  4. One transaction单一事务
  5. PostgreSQLPostgreSQL
SECTION · IPOT RESTAURANT PLATFORMDesign view · code private设计视图 · 代码私有

01Problem问题

A growing restaurant group needed bookings, payments and guest messaging that do not break on retries, double taps or a model that guesses.一个成长中的餐饮集团，需要在重试、重复点击和模型乱猜时都不出错的预订、支付与客人消息。

02What I built我做了什么

  • Reservation API: capacity-based booking, Twilio Verify phone OTP, SMS with delivery-status tracking, token-based self-service reschedule and cancel.Reservation API：按容量预订、Twilio Verify 手机验证码、带送达状态跟踪的短信、基于令牌的自助改期与取消。
  • POS: atomic settlement and refunds, sale-time price snapshots, audited voids; revived a long-failing test suite and fixed diverged Alembic heads.POS：原子结算与退款、售出时价格快照、可审计作废；修复长期失败的测试套件与分叉的 Alembic heads。
  • Nalu: deterministic field resolution and an explicit-yes gate after the LLM pilot invented values.Nalu：LLM 试点编造字段后，改为确定性字段解析加“明确说是”闸门。
  • Google Ads and Meta daily spend importers for the revenue agent.为收入 Agent 编写 Google Ads 与 Meta 每日花费导入器。

03Architecture架构

Guest message客人消息Rules read and validatefields · no model规则读取并校验字段 ·不用模型Fields valid and slotfree?字段有效且有空位？Ask or correct追问或更正Show the booking summary展示预订摘要Explicit yes to thissummary?对这份摘要明确说“是”？No booking written不写入预订Claim once · sameidempotency key只领取一次 · 同一幂等键Reservation API decidesReservation API 决定状态Confirmed已确认Received, pending已收到，待确认no否retry重试yes是no / vague否 / 含糊yes是
Nalu: a booking needs an explicit yesNalu：预订必须得到明确的“是”Simplified for a public page公开版简化图
Scan table QR扫桌码Verify guest验证顾客Open or reuse tablesession打开或沿用桌台会话Order · validated againstmenu下单 · 按菜单校验Kitchen rounds · new itemsonly厨房分轮 · 只发新菜Settle: payment, tip,close, table in onetransaction结账：付款、小费、结单、清台在一个事务里Table free桌台空出Refund or void · audited退款或作废 · 留审计auto-fire自动出单checkout结账later之后
Dine-in to a settled bill从堂食到结清账单Simplified for a public page公开版简化图

04Measured测量结果

33/39
Nalu held-out cases fully correct, 0 invented valuesNalu 留出集全字段正确，0 编造
src · IPOT nalu-api (private)
73 / 80
my commits on the Reservation API我在 Reservation API 上的提交数
src · IPOT reservation-api git log (private)

05Limits, stated plainly局限，直说

  • Employer code is private. The POS and booking demos are independent reimplementations on synthetic data.雇主代码不公开；POS 与预订演示是基于合成数据的独立重写。