日常使用手册¶
给谁看：已经开张、每天要用系统接单的店主 / 员工。
最新更新：2026-04-22
一、顾客端（手机浏览器）¶
顾客扫你店里的二维码，会直接进你的点单页：https://shop.coffee.aisaasfor.com/s/你的店铺标识
顾客能做什么¶
- 浏览菜单：左边栏点分类，大图 + 价格一目了然
- 加入购物车：点「+」按钮；多规格菜品（温度/糖度/加料）会弹出选项
- 结算：选「自取 / 堂食」，堂食可填桌号；留下姓名手机号备注（都选填）
- 提交订单：显示订单号 + 你家收款码，扫码付你
- 查订单状态：每 5 秒自动刷新，状态变化：已下单 → 已付款 → 制作中 → 可取餐 → 已完成
- 我的订单（登录后）：历史订单列表；再来一单一键把上次的放回购物车
顾客首次进店¶
- 第一次打开会弹隐私+用户协议，必须勾选才能下单（防合规风险）
- 登录入口在菜单页的「👤 登录 / 注册」
- 登录后可以在「我的 → 修改密码 / 退出登录」
二、店主端 · 每天的 3 个页面¶
登录 https://shop.coffee.aisaasfor.com/m/login。
2.1 订单页（最常用）¶
- 按状态筛选：进行中 / 待确认 / 已付款 / 制作中 / 可取餐 / 已完成 / 已取消
- 卡片上按状态显示对应操作：
- 已下单 → 顾客扫你的收款码付钱，你看到钱到账后点「标记已付款」
- 已付款 → 点「开始制作」
- 制作中 → 做完了点「制作完成」
- 可取餐 → 顾客来取了点「完成订单」
- 任意状态都可「取消」（会弹窗填原因，可留空）
- 每 5 秒自动刷新 + SSE 实时推送，新订单几乎秒级到达
- 🔔 响铃开关（右上角）：默认开，新单响铃 + 标签闪烁。第一次按"响铃开"会播一声以授权浏览器音频
- ⬇ 导出 CSV（右上角）：选日期区间 + 可选状态，下载 CSV。13 列，UTF-8 BOM，Excel 直接打开不乱码，可直接做月度对账
2.2 POS / 吧台点单页¶
- 路径：
/m/pos - 给前台收银用——顾客现场下单、你在吧台平板上帮他录
- 和顾客端 UI 类似，下单后直接标「已付款」走到下一步
2.3 看板页¶
- 路径：
/m/analytics - 4 张统计卡：今日订单 / 今日营收 / 7 日 / 30 日
- 24 小时直方图（按北京时间，每 3 小时一档）
- 30 日热销 TOP 5
- 口径：只统计已付款及之后状态，
已下单和已取消不计 - 60 秒自动刷新
三、每周/每月的管理页面¶
3.1 菜单页¶
- 「+ 新分类」新增；「+ 加菜」按分类加菜品
- 每行菜品：
- 编辑 — 改名字、价格、简介、图片 URL
- 换图 — 上传本地图（≤3 MB，png/jpeg/webp/gif）
- 规格 — 可视化配置规格组（温度/糖度/加料等），每组可设必选或多选，每个选项可加价
- 下架 / 删除 — 临时缺货用下架（顾客端看不到）；真不卖了才删
- 分类：重命名 / 停用 / 删除（删除要先清空分类里的菜品）
价格用「元」输入，系统自动转成分存储。改价格对历史订单无影响（订单保存当时的价格快照）。
3.2 门店设置页（/m/settings）¶
- 接受下单开关（临时歇业直接关）
- 门店名 / 地址
- 营业文案：自由文本，如
周一至周日 08:00-20:00（顾客端顶图展示用） - 排班时段：弹出周一到周日的时段表，勾每天的开始/结束时间（支持跨夜 22:00-02:00）
- 和主开关是 AND：主开关关 = 一定不接单；主开关开 + 排班判定不在时段 = 也不接单
- 全空 = 按主开关走（向下兼容）
- 收款码 URL：粘贴你自己的微信/支付宝收款码图片直链（留空则顾客端提示「现场结账」）
3.3 二维码页（/m/qr）¶
两种模式：
- 门店整体：一张大码，打出来贴门口
- 桌号批量：填桌数 N → 一次生成 N 张（带
?t=N参数），每张桌子贴一张- 顾客扫哪张，进菜单就自动勾好「堂食 + N 号桌」
每张都能点「打印」或「下载高清 PNG」。
3.4 员工账号页（/m/staff）¶
- 店长（tenant_owner）可以新建员工账号（staff）
- 员工只能看订单 + 切换菜品上下架，不能改价、不能看营业数据
- 员工离职了：点「停用」立刻踢下线
3.5 个人中心（/m/me）¶
- 改自己的密码
- 看上次登录时间
四、常见操作场景¶
| 场景 | 怎么做 |
|---|---|
| 今天歇业 | 门店页关「接受下单」开关 |
| 某个菜临时没货 | 菜单页菜品后的「下架」，有货了再「上架」 |
| 顾客扫了码但不想下单了 | 没关系，不提交订单就不占用数据 |
| 顾客付了钱但忘了提交 | 让他重来（或他付的钱没关系，因为平台不经手你钱，钱已经是你的了） |
| 员工忘密码 | 你在店长账号的「员工」页点「重置密码」，给他看一次新密码 |
| 店长忘密码 | 联系系统运营方重置 |
| 要月度对账 | 订单页右上「导出 CSV」→ 选上月 → Excel 打开汇总 |
| 新店做活动 | 菜单页加一个新分类「限时活动」，菜品起名时带 【限时】前缀，活动结束删掉或停用分类 |
五、已知限制¶
- 真实在线支付（微信支付/支付宝 API 调起）暂未接入。当前走「店家收款码」方式，平台不经手资金。
- 菜品图片存在服务器本机（以后会迁到对象存储），单张 ≤3 MB。
- 订单历史（顾客看到的）是本地 localStorage，清浏览器数据会丢；跨设备也不同步。顾客注册登录后会转服务端存储。
- 营业时段按北京时间（Asia/Shanghai），境外的店目前不支持改时区。