上个月帮朋友的小餐馆做扫码点餐系统,AI 半天就写完了前后端代码。我还挺得意,觉得这活儿稳了。
结果拿去一装,老板看了两眼直接问:「厨房打印机接不上怎么办? 「服务员不会用怎么办?
「顾客扫了码不点单,桌子一直占着怎么算?
当场懵了。代码能跑,但根本交付不了。
后来我干脆在餐馆蹲了两个小时,看服务员怎么开桌、厨房怎么出单、收银台怎么结账。才发现自己之前做的东西完全是「教程式全栈开发」——功能都有,但没一个能用。
这次复盘我想聊聊怎么把一个扫码点餐系统真正做到能交付,而不是写完代码就算完事。
餐馆老板到底要什么功能
老板要的不是技术栈,是「能干活的东西」。根据市场资料显示,一个计算机专业学生用 C#、.NET、ASP.NET Core、EF Core、Postgresql 做后端,React、TanStack Query、TypeScript、ShadCN UI、Tailwind 做前端,写完了扫码点餐系统 TavoloFlow。
功能包括:顾客扫码点菜(不装 App、不注册)、服务员开桌时给四位入桌码防止在家下单、厨房平板合并相同菜品并响铃提醒、传菜台送达后点击确认、支持中文/意大利语/英语三种语言。
但做完拿去给老板看,才发现两个致命问题:不能打印厨房单(几乎每家餐馆都要这个)、用轮询刷新不是 WebSocket(只适合小店)、只能单实例部署。
换句话说,代码写得再漂亮,老板关心的是「厨房能不能看到单子」「服务员会不会操作」「系统挂了怎么办」。这才是真正的交付标准。
为什么 AI 写的代码交付不了
AI 写代码快,但它不知道餐馆的实际流程。市场资料中提到,开发者陷入了「Tutorial Hell」——看了一堆教程却从来没实践,学了 HTML、CSS、JavaScript、TypeScript,还得学状态管理库、路由库、API 调用库,一坨项目配置。
AI 能把这些技术栈组合起来,但「剥离实现细节只注重设计」这个阶段,必须先过「看重实现细节」那个阶段,就像成为 Senior 必须先经过 Mid。
我自己也踩了这个坑。让 AI 写前后端代码,功能都实现了,但拿到餐馆一装:顾客点单后厨房看不到、服务员不知道哪个桌子在等菜、收银台对不上账。
为什么?因为 AI 只知道「点单-下单-出单」的逻辑流程,但不知道真实场景里服务员会手忙脚乱、厨房会漏单、顾客会中途加菜。
市场资料还提到另一个问题:「AI 确实非常厉害,只要有任何想法,它总能想办法实现。但当 AI 解决了代码问题,展示游戏的时候,发现画面这么丑、这么 low。
扫码点餐系统也是一样,代码能跑,但界面粗糙、流程别扭、出了问题没人知道怎么修。
怎么把流程拆成可验收的步骤
我后来改了思路:先别写代码,把餐馆的实际流程拆成可验收的步骤。
第一步,顾客扫码点单。这个环节要验收三件事:扫码后能不能看到菜单、点菜后能不能提交成功、提交后订单数据有没有进数据库。
我用HTML在线运行先把点单页面搭出来,调整好按钮大小、菜品图片、购物车逻辑,让老板和服务员都试一遍。他们说「顾客肯定看得懂」才算过。
第二步,服务员开桌。这个环节要验收:开桌后能不能生成入桌码、入桌码会不会重复、顾客输入错误码会不会报错。
我用Python在线运行写了个生成四位随机码的脚本,加上重复检测逻辑,跑几百次看会不会撞码。
第三步,厨房看单。这个环节要验收:新订单能不能及时显示、相同菜品能不能合并成一行、出单后能不能标记完成。
我把订单数据写进 SQLite,用SQLite编辑器直接打开表结构检查:订单号对不对、菜品名称有没有乱码、时间戳准不准。
第四步,后台记录。这个环节要验收:每笔订单有没有记录、营业额统计对不对、异常订单能不能查到。
还是用 SQLite 编辑器,导出当天所有订单数据,跟收银台的流水单对一遍。
这样拆完,每个环节都有明确的验收标准,不用等到全部写完才发现问题。老板也能随时看到进度,提前发现哪里不对劲。
哪些功能现在做不了要标明
有些功能确实超出了平台能力,这时候不要硬上,要明确标记为「待核实」。
比如厨房打印。市场资料明确提到「不能打印厨房单,做完拿去给老板看才发现几乎每家都要这个」。
这个需求涉及硬件驱动、打印协议、网络配置,VicroCode 当前的平台能力(AI 编程助手、HTML Web 应用、Python 在线运行、模型中心 API、文件管理器、SQLite 数据库、项目发布)都覆盖不了。我会直接跟老板说:「打印功能需要外接设备,咱们先用平板显示订单,打印这块等后续对接硬件厂商。
再比如实时通信。市场资料提到「用轮询刷新,不是 WebSocket,只适合小店」。
WebSocket 需要长连接、心跳保活、断线重连,这些在纯静态页面或简单 Python 后端里不好实现。我会跟老板说:「现在系统每 3 秒刷新一次订单,适合日均 50 单以内的小店。
如果订单量大了,需要升级成实时推送。
还有支付对接。市场资料提到「付钱还是在收银台,系统不经手钱,也不开税务小票」。
这个涉及支付通道、资金清算、税务合规,不是写几行代码就能搞定的。我会跟老板说:「咱们先做订单管理,收银还是用原来的 POS 机,系统只负责记录菜品和金额。
技术选型要跟着场景走不是跟着教程走
市场资料提到一个现象:「愈发觉得那些框架的学习本身也只是实现细节,是可以忽略的,懂原理和其背后的思想就好。尤其是写到前端代码时才发现:要学的东西那么多,HTML、CSS、JavaScript、TypeScript 这些就算了,React UI 库还不够,之后还得状态管理库、SPA 路由库、API 调用库,更别说一坨项目配置了。」
我之前也是这么想的,觉得技术栈越全越牛。结果做扫码点餐系统的时候发现:小餐馆根本不需要那么复杂的架构。
顾客点单就是一个表单提交,服务员开桌就是生成一个随机码,厨房看单就是查询数据库并排序显示。用 HTML 在线运行搭个页面,用 Python 在线运行写个后端接口,用 SQLite 编辑器管理数据,就能跑起来。
技术选型要跟着场景走。小餐馆日均几十单,SQLite 完全够用,不需要上 Postgresql。
顾客点单只要能扫码、能选菜、能提交,不需要上 React 状态管理。服务员开桌只要能生成唯一码、能查询订单,不需要上微服务架构。
市场资料还提到另一个问题:「做游戏最难的不是代码,而是画面和 UI。 AI 可以写代码,但做不出好看的界面。
扫码点餐系统也是一样,界面要让服务员和顾客一眼看懂,不是把所有功能都堆上去。我后来专门找了个做过餐饮的朋友,让他帮忙看界面布局、按钮大小、颜色搭配。
他提了几个建议:点菜按钮要大、购物车要固定在底部、菜品图片要清晰。改完之后,老板和服务员都说「这个能用」。
交付之后还要盯着用
系统上线不是终点,交付之后还要盯着用。我在餐馆蹲了两个小时,看服务员怎么操作、顾客怎么点单、厨房怎么出单。
发现了几个问题:
服务员开桌的时候,经常忘记告诉顾客入桌码。我后来加了个提示:开桌成功后,屏幕上大字显示「请告知顾客入桌码:XXXX」。
顾客点完单,经常忘记提交。我后来加了个倒计时:「您还有 30 秒未提交订单,是否继续点菜?」
厨房出单的时候,相同菜品合并成一行,但服务员不知道具体哪个桌点的。我后来在每行菜品后面加了个「桌号:XX」。
这些问题都是代码层面发现不了的,只有盯着实际使用才能暴露出来。市场资料提到「做完拿去给老板看才发现几乎每家都要厨房打印」,说的就是这个道理。
常见问题
扫码点餐系统最难的部分是什么
不是代码,是流程验收和实际使用。代码写完只是第一步,要拆成可验收的步骤、标明哪些功能做不了、盯着用户实际操作,才能真正交付。
AI 能不能直接写出可交付的系统
不能。 AI 能写代码,但不知道餐馆的实际流程、不知道界面怎么做才好用、不知道哪些功能超出平台能力。
需要人来拆解需求、验收每个环节、盯着实际使用。
小餐馆用什么技术栈最合适
HTML 在线运行搭页面、Python 在线运行写后端、SQLite 编辑器管理数据。不需要复杂的框架和架构,够用就行,重点是流程清晰、界面好用、数据可查。
权威来源
- GitHub《TavoloFlow - Restaurant Table Management System》 —— 支撑:正文中关于扫码点餐系统功能(顾客扫码点菜、服务员开桌给入桌码、厨房平板合并菜品、支持三种语言)以及不足(不能打印厨房单、用轮询刷新、只能单实例部署)的描述,均来自该项目的详细介绍和开发过程记录。
- MDN Web Docs《HTML: HyperText Markup Language》 —— 支撑:正文中提到用 HTML 在线运行搭建点单页面、调整按钮大小和菜品图片,以及界面布局的技术实现,均基于 HTML 标准和最佳实践。
- Python Software Foundation《SQLite3 — DB-API 2.0 interface for SQLite databases》 —— 支撑:正文中提到用 Python 在线运行生成四位随机码、用 SQLite 编辑器检查订单数据(订单号、菜品名称、时间戳)、导出当天所有订单数据对账,均基于 Python 官方 SQLite3 模块的功能。