桌码设计、订单状态机与加菜逻辑全链路解析

一、桌码设计的核心逻辑

扫码点餐系统中，桌码不仅仅是一个二维码，它本质上承载了门店ID、桌台ID和点餐入口三重要素 。后台需要建立独立的桌台管理数据表，包含桌台名称、桌码参数、桌台状态、容纳人数等字段：

CREATE TABLE store_table (
  id BIGINT PRIMARY KEY AUTO_INCREMENT,
  store_id BIGINT,
  table_name VARCHAR(100),
  table_code VARCHAR(100),
  status TINYINT,
  capacity INT);

其中 table_code 作为二维码参数生成，例如 https://xxx.com/table?code=A102 ，用户扫码后系统根据桌码自动识别对应门店和桌台 。关键防坑点是桌码必须校验有效性，防止扫旧码或跨桌下单。

二、订单状态机设计

餐饮订单不同于普通电商订单，需要处理待支付、已支付待接单、制作中、已完成四个核心阶段，还需支持加菜追加、换桌、退单等特殊场景。完整流程为：扫码桌码→进入点餐页面→加入购物车→提交订单→支付→厨房打印→上菜完成 。

订单状态机的设计要点是 单向推进、禁止回退 ，并发写用乐观锁保护。加菜逻辑需要支持在原订单基础上追加商品，系统通过订单号关联新菜品，后厨端收到加菜通知后补打小票。换桌操作需要同步更新桌台表状态和订单的桌台关联字段，确保后续加菜和结账仍能正确关联。

三、后厨打印与KDS联动

后厨打印是扫码点餐系统的关键履约环节。订单支付成功后，系统通过云打印机自动输出小票，厨房KDS（Kitchen Display System）同步显示订单信息。技术实现上，打印系统通常对接云打印服务，通过消息队列异步触发打印任务，避免打印服务故障阻塞主订单流程。

中餐场景的后厨分单逻辑需要根据菜品分类自动路由到不同工位。实践中建议配置多台热敏打印机分别对应热菜口、凉菜口、饮品口，系统根据商品的分类ID自动判断打印目标 。KDS系统则以智能触摸屏代替传统打印机小票，支持配菜、划菜、传菜等功能，实现订单信息的实时显示和厨房工作流的数字化 。