餐饮流水管家 · 云端部署与维护

这是一份纯前端应用:界面 + 逻辑都在浏览器跑,数据要么存在本机浏览器(本机模式),要么存在你自己的Supabase 云端库(云端模式)。部署就是把静态文件托管到一个网址(Cloudflare Pages),再按需建云端库。当前版本 v4.20.0。

当前版本 v4.20.0 · 更新日期 2026-11-04 · 纯静态前端 + Supabase
📋 查看更新日志 📖 查看使用说明
目录
一、部署包二、模式三、Pages 部署四、Supabase五、本机配置六、备份维护七、升级八、常见问题

📦 一、部署包结构

发布时生成 v4.20.0_部署包/ 目录,里面是可直接托管的全部文件(不含开发用的 .bak 备份、不含 __verify 测试):

路径作用
餐饮流水管家.html应用主入口
assets/core.js assets/app.js assets/style.css逻辑与样式(版本号随发版升级、强制刷新缓存)
assets/vendor/第三方库:chart.umd.min.js(图表)、xlsx.full.min.js(导出)、supabase.min.js(云端)
系统文件/云端配置与建库脚本:Supabase云数据库-云端配置.js、supabase_schema.sql
icons/应用图标(PWA 安装到手机用)
manifest.json _redirectsPWA 清单与路由重定向
v4.20.0更新日志.html 等三份文档更新日志 / 使用说明 / 本部署文档

🔀 二、本机模式 / 云端模式

本机模式云端模式
数据位置这台电脑的浏览器 localStorage你自己的 Supabase 库
多设备同步不支持(换设备看不到)支持(同邮箱登录即同一份账)
清空缓存风险会丢,需定期导出备份库在云端,不受浏览器缓存影响
访问口令建议设置(默认 123456)邮箱+密码注册/登录
⚠️ 本机模式只是「单机便利」,不是「安全存储」。正式经营请用云端模式,并每月导出备份留底。

☁️ 三、Cloudflare Pages 部署

  1. 准备目录:用发布生成的 v4.20.0_部署包/ 作为站点根目录。
  2. 新建项目:Cloudflare Pages 控制台「Create a project」→ 直接拖拽上传该目录,或从 Git 仓库连接。
  3. 构建设置:纯静态站点,构建命令留空,输出目录设为根(部署包本身就是构建好的静态文件)。
  4. 部署:等待几秒,得到 https://xxx.pages.dev 网址;可再绑自己的域名。
  5. 开启云端:配置好 Supabase(见下一节)后,打开网址即走云端模式。
ℹ️ 不依赖任何服务器运行时,不装依赖、不跑构建。上传即上线。

🛢️ 四、Supabase 云端库

云端模式需要一个 Supabase 项目(免费额度足够小门店)。建库方式:

  1. 在 Supabase 新建项目,记下 URL 与 anon key。
  2. 打开 系统文件/supabase_schema.sql,在 Supabase「SQL Editor」里执行,建好所需的表(记录、分类、预算、周期账、单价、设置、账号等)与必要的函数/权限。
  3. 把 URL 和 anon key 填进 系统文件/Supabase云数据库-云端配置.js(或直接通过应用内「我的 → 高级设置」配置)。
  4. 刷新应用,顶栏切换「☁️ 云端」,用邮箱+密码注册即可。
⚠️ 云端隐私:注册需开启邮箱验证(Supabase 后台 Confirm email);管理员邮箱不被任意用户整张拉走(已用数据库函数判定身份)。配置项改动请对照 supabase_schema.sql 与云端配置说明,避免权限过宽。

🔐 五、本机模式配置

💾 六、备份与维护

⬆️ 七、版本升级

  1. 静态文件:把新部署包的 assets/ 与 餐饮流水管家.html 覆盖上传到 Pages(或重新拖拽部署包)。三份文档一并上传。
  2. 强制刷新:用户端打开网址后按 Ctrl+F5 强刷,顶栏版本号应变新(如 v4.20.0)。每次发版 ?v= 缓存号都会升,就是为了强刷生效。
  3. 云端库:v4.19.x 均未改动库表结构(编号规则、工作表名变化只在备份文件里),无需执行任何 SQL。若将来大版本提示「云端缺列」,按提示在 Supabase 执行对应建列语句即可。
ℹ️ v4.20.0 升级注意:本版新增停用/恢复分类、休息记录编辑、旧损耗标记分类,并修掉定时记账保存卡死;均是前端改动,云端库表无变更,无需执行任何 SQL。旧账本直接覆盖上传、强刷即可用;已停用的分类会留在分类管理里,随时可恢复。

❓ 八、常见问题

升级后页面没变 / 版本号没变?

浏览器缓存。覆盖上传后请用户 Ctrl+F5 强刷;确认部署包的 ?v= 已随版本升级(v4.20.0 部署包应为 ?v=4.20.0)。

云端模式登录提示缺表?

在 Supabase SQL Editor 执行 系统文件/supabase_schema.sql 重建/补齐表与权限;若只缺单列,按应用内提示执行对应建列语句。

本机模式数据怎么迁移到云端?

本机模式「导出备份」下载 xlsx → 切到云端模式注册/登录 → 「导入数据」选该 xlsx,账本即搬上云。

导入备份后定时计划没了?

该问题在上一补丁版已修复(本机模式导出/导入对设置项约定不一致导致)。升级到 v4.20.0 后重新导出再导入即可恢复;本版未改动导出/导入逻辑。

餐饮流水管家 · 云端部署与维护 · 当前 v4.20.0 · 生成于 2026-11-04 · 配套 更新日志 / 使用说明