云上家宴 — 餐厅扫码点餐 SaaS 系统产品系统Vibe Coding

传统中式餐厅在点餐环节普遍存在服务员手写单容易出错、客流高峰期后厨与前厅信息不同步、菜品调价改菜耗时长等痛点。本项目聚焦小型餐厅（10-30 桌规模）的实际经营场景，以扫码点餐为入口，打通顾客点单、后厨备餐、老板管理、服务员协作四端的信息流，让餐厅在零硬件投入、零运维成本的前提下完成数字化升级。已在江西九江某中式餐厅 14 桌台规模实际投产运行。

项目包含四端业务闭环：

1、顾客点单 H5：扫桌台二维码进入，无需关注公众号、无需小程序授权，支持菜品分类浏览、图文展示、购物车、订单备注、用餐中加菜等功能。

2、后厨实时看板：三栏布局展示"待接单 / 制作中 / 已上齐"订单流转，新单到达响铃 + 闪烁提醒，支持 confirm 防误触确认。

3、老板管理后台：实时订单监控、历史订单查询、菜品增删改、菜品图片端侧压缩上传、桌台二维码批量生成与打印。

4、服务员协作端：加菜、催菜、桌台状态切换。

5、用餐中状态管理：支持同桌多轮加菜聚合到同一订单，桌台空闲/用餐中/停用状态机管理。

本人独立负责全栈开发，从需求调研、架构设计、数据库建模、前后端编码到上线部署、运维迭代全流程。

技术架构：Cloudflare Workers（API 层）+ D1（SQLite 数据库）+ Pages（前端托管）+ R2（资源存储），全 Serverless 架构，月成本控制在 10 元以内，零运维。

实现亮点：
1、菜品图片采用端侧 Canvas 压缩（800×800 JPEG75%）后 base64 入库，省去对象存储依赖，降低复杂度；
2、后厨页采用乐观更新 + 5 秒锁定窗口策略，巧妙规避 D1 数据库写后读最终一致性窗口导致的 UI 闪烁问题；
3、订单状态机设计支持多轮加菜聚合，通过 added_at_round 字段标记每轮加菜批次；
4、三端均采用 PWA 部署，手机添加桌面图标后全屏运行，体验接近原生 App。