菜单发布链路
4 步
编辑 / 发布 / 扫码 / 回流分析
Enterprise Gateway for Restaurants
餐厅菜单管理与 二维码点餐展示 的统一入口
HiMenu 是一套面向餐饮商家的轻量化系统：商家在移动端维护菜单，顾客通过二维码打开免安装 H5 菜单，平台同步记录浏览与点击行为，支持多语言展示。
- Expo + React Native 商家端
- Supabase 数据与存储
- Cloudflare Pages 托管 H5
Merchant Console
Live
终端形态
App + H5
商家管理 + 顾客浏览分离
语言支持
2+
商家 UI / 顾客菜单双语基础
数据回流
7 日看板
浏览、点击、语言分布、Top 菜品
Merchant App
- 菜品增删改
- 分类排序
- 图片上传
- 推荐标签
Customer H5
- 二维码直达
- 多语言切换
- 仅展示可售项
- 事件埋点
适配场景
快餐档口
咖啡店
小馆子
连锁试点
海外华人餐厅
Core Capability Map
围绕“更新菜单效率”和“顾客打开体验”的核心能力
01 商家侧
移动端菜单维护
通过 Expo + React Native 商家应用管理菜品、分类、可售状态与门店设置，适合店内运营人员直接维护。
02 菜品运营
图片、标签与分类编排
支持图片上传、推荐标签、固定分类与自定义分类，并具备分类排序能力，提升菜单展示结构清晰度。
03 顾客侧
二维码直达 H5 菜单
顾客无需安装 App，扫码即可打开公开 H5 菜单，支持 query/path 模式访问与语言参数覆盖。
04 多语言
中英双语基础 + 扩展翻译链路
商家 UI 与 H5 外壳已具备中英支持，并配套 Supabase Edge Functions 处理菜品翻译任务与回填。
05 数据闭环
菜单浏览 / 点击事件分析
记录 H5 菜单浏览、菜品点击、语言切换事件，商家看板展示最近 7 天数据与热门菜品表现。
06 部署能力
Cloudflare Pages 一键托管 H5
仓库已包含 Cloudflare 部署脚本与加固脚本，可快速发布顾客菜单前端并叠加 WAF 与速率限制策略。
Merchant → Customer → Analytics
从商家更新到顾客查看，再到数据回流的完整路径
商家维护菜单
在商家 App 中新增或编辑菜品，设置分类、推荐标签、价格、图片及可售状态。
生成 H5 链接与二维码
仪表盘根据门店 slug 和默认语言生成菜单 URL 与二维码，门店可直接打印或贴到桌牌。
顾客扫码浏览
顾客通过 H5 页面查看可售菜品、切换语言、浏览图片和分类结构，无需下载任何应用。
埋点回流与看板分析
菜单浏览与点击数据进入 `menu_events`，商家看板查看 7 日趋势、Top 菜品与语言分布。
Tech Architecture
当前工程的技术组成（基于仓库现状）
前端与客户端
- 商家端：Expo + React Native（`App.tsx` / `screens/*`）
- 顾客端：H5 静态站（`h5/*`）+ Cloudflare Pages Functions（`h5/functions/api/*`）
- 国际化：商家与 H5 壳层中英双语基础
数据与服务
- 数据库 / 鉴权：Supabase
- 存储：Supabase Storage（菜品图片）
- 服务层：`services/*` 管理菜单、分类、分析、翻译与门店数据
- 边缘函数：翻译任务处理与自动翻译回填（`supabase/functions/*`）
交付与托管
- Cloudflare Pages 部署脚本：`scripts/deploy-h5-cloudflare.sh`
- Cloudflare Zone 加固脚本：`scripts/harden-cloudflare-zone.sh`
- 支持 Pages 项目创建、环境变量注入、H5 发布与 WAF 基线策略
Why This Model
比“纯 App 点餐”更轻，比“纸质菜单”更可运营
| 维度 | HiMenu（App 管理 + H5 展示） | 纸质菜单 | 顾客端 App |
|---|---|---|---|
| 更新成本 | 即时修改，实时生效 | 重印成本高 | 需要版本更新与发版 |
| 顾客进入门槛 | 扫码即看，无需安装 | 低，但无互动与数据 | 高，需要下载与注册 |
| 多语言支持 | 可扩展，支持语言参数切换 | 需多套印刷 | 可做，但开发成本更高 |
| 运营分析 | 浏览/点击/语言分布可统计 | 基本不可追踪 | 可做，但改造复杂 |