## 一、前言

在之前的系列文章中，我写了LikeShop连锁点餐系统的门店自提与第三方配送对接、上门家政系统的派单流程、同城跑腿系统的地图定位与订单调度。这一篇聚焦扫码点餐——连锁点餐系统中最核心的堂食场景入口。

扫码点餐和普通商城的下单流程有本质区别。普通商城是“浏览商品 → 加入购物车 → 结算 → 支付”，用户和商品之间没有空间绑定关系。而扫码点餐的起点是**桌台二维码**——顾客扫的是哪张桌子，系统就自动识别桌号、门店、菜单，整个下单链路围绕“桌台”这个空间标识展开。

这个差异带来了三个技术核心：**桌台二维码的生成与校验**、**堂食订单的状态机设计**、**厨房打印的自动触发**。这三个环节串联起来，构成了从“顾客扫码”到“厨房出餐”的完整链路。这篇文章就围绕这三条线，把扫码点餐的技术实现路径拆开讲清楚。

## 二、桌台管理：从数据库到二维码

### 2.1 桌台数据表设计

桌台是堂食场景的基础设施。后端需要建立桌台管理数据表，包含桌号、二维码地址、桌台状态等字段。核心表 `ls_table` 的字段设计如下：

| 字段名 | 数据类型 | 说明 |
|--------|----------|------|
| id | int | 桌台id |
| shop_id | int | 所属门店id |
| table_no | varchar | 桌号（如A01、B05） |
| table_name | varchar | 桌台名称（如“大厅1号桌”） |
| qr_code | varchar | 二维码地址 |
| qr_token | varchar | 二维码签名token |
| status | tinyint | 桌台状态：0-空闲；1-使用中；2-已预订 |
| capacity | int | 可容纳人数 |
| area_id | int | 区域id（大厅/包间/露台） |
| sort | int | 排序 |
| create_time | int | 创建时间 |
| delete_time | int | 删除时间 |

**`qr_token` 是安全设计的关键**。二维码中不能只包含桌台ID，否则用户可以随意篡改桌号。系统需要为每张桌台生成一个唯一的签名token，二维码内容为 `https://域名/scan?table_id=1&token=abc123`，后端校验签名有效性后才返回桌台信息和菜单数据。

### 2.2 二维码的生成与校验

二维码的生成在管理后台完成。平台端或门店端添加桌台后，系统自动生成二维码并支持批量下载打印。

**二维码的校验逻辑**：顾客扫码后，小程序解析二维码内容，向后端发起桌台验证请求，后端校验签名有效性后返回桌台信息和菜单数据。

```php
// server/app/api/logic/TableLogic.php
class TableLogic
{
 /**
 * 扫码验证桌台
 */
 public static function verifyTable(string $qrToken, int $tableId): array
 {
 $table = TableModel::where('id', $tableId)
 ->where('delete_time', 0)
 ->find();

 if (!$table) {
 throw new Exception('桌台不存在');
 }

 // 校验签名token
 $expectedToken = md5($tableId . $table['shop_id'] . config('table_secret'));
 if ($qrToken !== $expectedToken) {
 throw new Exception('二维码无效，请重新扫码');
 }

 // 检查桌台状态
 if ($table['status'] == 2) {
 throw new Exception('该桌台已被预订');
 }

 // 查询所属门店信息
 $shop = ShopModel::where('id', $table['shop_id'])
 ->where('status', 1)
 ->find();
 if (!$shop) {
 throw new Exception('门店已停业');
 }

 // 更新桌台状态为使用中
 TableModel::where('id', $tableId)->update([
 'status' => 1,
 'update_time' => time(),
 ]);

 return [
 'table' => $table,
 'shop' => $shop,
 ];
 }
}
```

### 2.3 多门店的桌台隔离

连锁点餐系统的桌台必须按门店维度隔离。**桌号只在门店内唯一，不同门店可以有相同的桌号**。比如门店A有“A01”桌，门店B也可以有“A01”桌。唯一索引应该是 `(shop_id, table_no)` 的组合。

桌台表的 `shop_id` 字段关联到连锁门店表，扫码验证时需要同时校验桌台是否属于当前访问的门店。

## 三、扫码下单：从菜单加载到订单创建

### 3.1 堂食订单的状态机

扫码点餐的订单状态和普通商城不同，需要覆盖堂食场景的完整生命周期。订单状态包括**待确认、已确认、制作中、已出餐、已完成、已取消**。

```
待确认(0) → 已确认(1) → 制作中(2) → 已出餐(3) → 已完成(4)
 ↓ ↓ ↓
已取消(5) 已取消(5) 已取消(5)
```

**每个状态变更都需要触发相应的业务逻辑**：状态变更为“制作中”时推送通知到厨房，变更为“已出餐”时通知服务员取餐，变更为“已完成”时释放桌台资源。

```php
// server/app/common/logic/DineInOrderStatusLogic.php
class DineInOrderStatusLogic
{
 const TRANSITIONS = [
 0 => [1, 5], // 待确认 → 已确认 / 已取消
 1 => [2, 5], // 已确认 → 制作中 / 已取消
 2 => [3, 5], // 制作中 → 已出餐 / 已取消
 3 => [4], // 已出餐 → 已完成
 4 => [], // 已完成 → 终态
 5 => [], // 已取消 → 终态
 ];

 public static function transit(int $orderId, int $toStatus, string $remark = ''): bool
 {
 $order = OrderModel::find($orderId);
 if (!$order) {
 throw new Exception('订单不存在');
 }

 if (!in_array($toStatus, self::TRANSITIONS[$order['order_status']] ?? [])) {
 throw new Exception("非法状态迁移：{$order['order_status']} → {$toStatus}");
 }

 // 乐观锁更新
 $affected = OrderModel::where('id', $orderId)
 ->where('order_status', $order['order_status'])
 ->update([
 'order_status' => $toStatus,
 'update_time' => time(),
 ]);

 if (!$affected) {
 throw new Exception('订单状态更新失败，请重试');
 }

 // 状态变更后的联动处理
 self::afterTransit($orderId, $toStatus);

 // 记录日志
 OrderLogModel::create([
 'order_id' => $orderId,
 'content' => $remark ?: '状态变更',
 'create_time' => time(),
 ]);

 return true;
 }

 private static function afterTransit(int $orderId, int $toStatus): void
 {
 switch ($toStatus) {
 case 2: // 制作中 → 触发厨房打印
 KitchenPrintServer::printOrder($orderId);
 break;
 case 3: // 已出餐 → 通知服务员取餐
 PushServer::sendToWaiter($orderId);
 break;
 case 4: // 已完成 → 释放桌台
 $order = OrderModel::find($orderId);
 TableModel::where('id', $order['table_id'])->update([
 'status' => 0, 'update_time' => time(),
 ]);
 break;
 }
 }
}
```

### 3.2 菜单加载与缓存

扫码验证通过后，系统返回门店的菜单数据。**菜单数据配合Redis缓存使用，减少数据库压力**。菜单按分类组织，包含菜品名称、图片、价格、规格、库存等信息。

```php
// server/app/api/logic/MenuLogic.php
class MenuLogic
{
 public static function getMenuByShop(int $shopId): array
 {
 $cacheKey = "menu:shop:{$shopId}";

 $menu = Redis::get($cacheKey);
 if ($menu) {
 return json_decode($menu, true);
 }

 $categories = CategoryModel::where('shop_id', $shopId)
 ->where('status', 1)
 ->order('sort', 'desc')
 ->select();

 $menu = [];
 foreach ($categories as $category) {
 $goodsList = GoodsModel::where('shop_id', $shopId)
 ->where('category_id', $category['id'])
 ->where('status', 1)
 ->where('delete_time', 0)
 ->field('id,name,image,price,stock,spec_type')
 ->select()
 ->toArray();

 $menu[] = [
 'category_id' => $category['id'],
 'category_name' => $category['name'],
 'goods_list' => $goodsList,
 ];
 }

 Redis::setex($cacheKey, 1800, json_encode($menu)); // 缓存30分钟
 return $menu;
 }
}
```

### 3.3 购物车与下单

购物车支持加减数量、多规格、套餐组合、用户备注和实时价格计算等功能。下单时，系统需要校验菜品库存、计算总价、生成订单。

```php
// server/app/api/logic/CartLogic.php
class CartLogic
{
 /**
 * 堂食下单
 */
 public static function submit(array $params, int $userId): array
 {
 $tableId = $params['table_id'];
 $goodsList = $params['goods_list'];

 // 1. 校验桌台状态
 $table = TableModel::find($tableId);
 if (!$table || $table['status'] == 2) {
 throw new Exception('桌台不可用');
 }

 // 2. 校验菜品并计算总价
 $totalAmount = 0;
 foreach ($goodsList as $item) {
 $goods = GoodsModel::where('id', $item['goods_id'])
 ->where('status', 1)
 ->find();
 if (!$goods) {
 throw new Exception("菜品{$item['goods_id']}已下架");
 }
 if ($goods['stock'] < $item['num']) {
 throw new Exception("菜品{$goods['name']}库存不足");
 }
 $totalAmount += $goods['price'] * $item['num'];
 }

 // 3. 创建订单
 $order = DineInOrderModel::create([
 'order_sn' => 'D' . date('YmdHis') . mt_rand(1000, 9999),
 'user_id' => $userId,
 'shop_id' => $table['shop_id'],
 'table_id' => $tableId,
 'total_amount' => $totalAmount,
 'order_status' => 0, // 待确认
 'create_time' => time(),
 ]);

 // 4. 写入订单商品
 foreach ($goodsList as $item) {
 DineInOrderGoodsModel::create([
 'order_id' => $order['id'],
 'goods_id' => $item['goods_id'],
 'goods_name' => $item['goods_name'],
 'price' => $item['price'],
 'num' => $item['num'],
 'remark' => $item['remark'] ?? '',
 ]);
 }

 return $order;
 }
}
```

### 3.4 订单状态的实时推送

**WebSocket是实现订单状态实时推送的常用技术方案**，用户端和商户端通过WebSocket长连接接收状态变更通知，避免轮询带来的服务器压力。

门店后台需要**实时订单语音提醒**，确保生意再忙也不易漏单。当新订单创建时，系统通过WebSocket向门店后台推送新订单通知，触发语音播报。

## 四、厨房打印：从订单到出餐单

### 4.1 打印设备的接入方式

LikeShop的小票打印**接入易联云等第三方硬件设备，实现自动打印订单小票**，方便门店管理订单。同时支持标签打印，方便门店制作贴纸标识茶饮订单。

易联云的对接需要先在开发者平台申请应用，获取应用ID和应用密钥，然后在LikeShop商家管理后台的「应用」→「小票打印」→「打印设置」中填写这两个参数。

LikeShop目前使用到的易联云接口包括：

| 接口 | 用途 |
|------|------|
| `printer/addprinter` | 添加打印机 |
| `printer/deleteprinter` | 删除打印机 |
| `printer/getprintstatus` | 获取打印机状态 |
| `printer/seticon` | 设置LOGO |

### 4.2 厨房打印的触发时机

厨房打印的触发时机是**订单状态变更为“制作中”时**。这个设计的意义在于：订单从“已确认”进入“制作中”意味着门店已经确认接单，此时才需要通知厨房开始制作。

```php
// server/app/common/server/KitchenPrintServer.php
class KitchenPrintServer
{
 /**
 * 打印厨房单
 */
 public static function printOrder(int $orderId): void
 {
 $order = DineInOrderModel::find($orderId);
 $shop = ShopModel::find($order['shop_id']);
 $table = TableModel::find($order['table_id']);
 $goodsList = DineInOrderGoodsModel::where('order_id', $orderId)->select();

 // 查询该门店配置的打印机
 $printers = PrinterModel::where('shop_id', $order['shop_id'])
 ->where('type', 'kitchen')
 ->where('status', 1)
 ->select();

 foreach ($printers as $printer) {
 $content = self::buildKitchenTicket($order, $shop, $table, $goodsList);
 self::sendToPrinter($printer, $content);
 }
 }

 /**
 * 构建厨房单内容
 */
 private static function buildKitchenTicket($order, $shop, $table, $goodsList): string
 {
 $content = "<CB>{$shop['name']}</CB> ";
 $content .= "桌号：{$table['table_no']} ";
 $content .= "订单号：{$order['order_sn']} ";
 $content .= "下单时间：" . date('Y-m-d H:i:s', $order['create_time']) . " ";
 $content .= "-------------------------------- ";

 foreach ($goodsList as $item) {
 $content .= "{$item['goods_name']}";
 $content .= " x{$item['num']} ";
 if ($item['remark']) {
 $content .= "备注：{$item['remark']} ";
 }
 }

 $content .= "-------------------------------- ";
 $content .= "合计：" . count($goodsList) . " 项 ";
 $content .= "<CUT>";

 return $content;
 }
}
```

### 4.3 厨房单的模板设计

厨房单的模板可以自定义。编辑模板的接口为 `/printer.printer/editTemplate`，参数包括模板名称、小票名称、是否显示店铺名称等。

厨房单的模板设计需要注意几点：

**打印类型**：支持“一桌一单”（按桌台汇总所有菜品）、“一类一单”（按菜品分类分单打印）、“一菜一单”（每个菜品单独打印）三种模式。

**不打印的品项**：后台品项档案中可以设置某些品项不打印厨房单，比如酒水饮料通常不需要厨房制作。

**总单合并菜**：开启后打印总单时将合并相同的菜品，避免重复打印。

### 4.4 打印失败的处理

厨房打印是异步操作，打印失败不应该影响订单状态。建议的设计是：**打印任务通过消息队列异步执行**，打印失败时记录日志并重试，同时通过WebSocket通知门店后台“打印失败，请手动处理”。

```php
// 异步打印任务
Queue::instance()
 ->do('fire')
 ->job(KitchenPrintJob::class)
 ->data(['order_id' => $orderId])
 ->push();
```

## 五、二开扩展点与核心约束

### 5.1 新增打印设备的对接

如果门店使用的不是易联云，而是其他品牌的打印机（如飞鹅云、中午云），需要新建一个打印Service实现统一接口：

```php
// server/app/common/server/PrinterFactory.php
class PrinterFactory
{
 public static function create(string $brand): PrinterInterface
 {
 return match ($brand) {
 'yilianyun' => new YiLianYunPrinter(),
 'feieyun' => new FeieYunPrinter(),
 'zhongwuyun'=> new ZhongWuYunPrinter(),
 default => throw new Exception("不支持的打印机品牌：{$brand}"),
 };
 }
}
```

### 5.2 扫码后自动加入会员

一个常见的二开需求是：顾客扫码点餐时，如果还不是会员，自动引导注册。这需要在桌台验证成功后，检查当前用户是否已登录。未登录时跳转到注册页，注册成功后自动绑定桌台继续点餐。

### 5.3 多门店的打印机隔离

连锁点餐系统中，不同门店的打印机配置是独立的。**打印机配置必须按 `shop_id` 隔离**，门店A的订单不能打印到门店B的打印机上。

### 5.4 桌台状态的并发控制

高峰期多个顾客可能同时扫码同一张桌台。桌台状态的更新需要做并发控制，使用乐观锁防止状态冲突：

```php
$affected = TableModel::where('id', $tableId)
 ->where('status', 0) // 只更新空闲状态的桌台
 ->update(['status' => 1, 'update_time' => time()]);

if (!$affected) {
 throw new Exception('桌台已被占用，请刷新后重试');
}
```

## 六、二开避坑清单

**坑一：二维码只包含桌台ID，没有签名校验。** 用户篡改桌台ID可以访问其他桌台的信息，必须增加签名token校验。

**坑二：桌台状态没有并发控制。** 多个用户同时扫码同一张桌台时，需要乐观锁防止状态冲突。

**坑三：厨房打印阻塞订单状态流转。** 打印是异步操作，打印失败不应该影响订单状态变更。建议用消息队列异步执行。

**坑四：打印机配置没有按门店隔离。** 连锁点餐系统中不同门店的打印机是独立的，配置必须带 `shop_id` 过滤。

**坑五：菜单缓存没有失效机制。** 菜品上下架后，菜单缓存需要及时刷新，否则用户看到的还是旧菜单。建议在菜品状态变更时主动清除对应门店的缓存。

**坑六：订单状态可以随意修改。** 所有状态变更必须走状态机入口，不要在任何地方直接 `update` 状态字段。

## 七、总结

LikeShop连锁点餐系统扫码点餐的核心可以概括为三条线：

**桌台管理**：桌台表按门店隔离，二维码包含签名token防止篡改。扫码后校验签名和桌台状态，返回门店信息和菜单数据。桌台状态变更需要乐观锁控制并发。

**扫码下单**：菜单数据配合Redis缓存减轻数据库压力。堂食订单状态机涵盖“待确认→已确认→制作中→已出餐→已完成”的完整生命周期。WebSocket实现订单状态的实时推送，门店后台配语音提醒防漏单。

**厨房打印**：接入易联云等第三方硬件，订单状态变更为“制作中”时触发打印。厨房单模板支持“一桌一单/一类一单/一菜一单”三种模式。打印任务通过消息队列异步执行，失败不影响主流程。

二开时守住三条底线：**二维码必须带签名校验、桌台状态必须做并发控制、打印机配置必须按门店隔离**。把这三点处理好，扫码点餐的完整链路就能稳定运行。

在之前的系列文章中，我写了LikeShop连锁点餐系统的门店自提与第三方配送对接、上门家政系统的派单流程、同城跑腿系统的地图定位与订单调度。这一篇聚焦扫码点餐——连锁点餐系统中最核心的堂食场景入口。

LikeShop 连锁点餐系统扫码点餐：桌台、下单与厨房打印对接

数据库

扫码点餐系统核心链路拆解：围绕桌台二维码安全校验、堂食订单状态机设计和厨房自动打印三大模块展开，涵盖多门店桌台隔离、Redis菜单缓存、WebSocket实时推送、易联云打印对接及并发控制等关键技术，附二开避坑指南，适合连锁餐饮系统开发者参考。

消息队列

代码解释

服务器

WebSocket

Redis

热销域名限时优惠，新客首年免费！


domain

2026上云采购 | AI焕新·智启新局

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

LikeShop 连锁点餐系统扫码点餐：桌台、下单与厨房打印对接-腾讯云开发者社区-腾讯云

LikeShop 连锁点餐系统扫码点餐：桌台、下单与厨房打印对接

LikeShop 连锁点餐系统扫码点餐：桌台、下单与厨房打印对接

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐