顾客订位原编号防重与回执查询
- 带操作编号的顾客订位提交沿用既有持久防重记录，同一编号匹配原请求后返回原订位，不再次创建。
- 新增原回执只读查询，核对当前合法访客及门店范围，返回原订位当前状态，不返回门店备注或联系电话。
- 回执、订位及审计同事务保存；后端已备份部署，客户端接线仍待发布。
客人自助订位
更新日志
改了什么,
一条条记在这里。
已经上线的直接写；还没上线的会标明「尚未上线」。 目前共 907 条
同一条更新可能同时属于多个模块,因此各模块条数相加会大于总数。
按模块查:
客人自助
顾客撤回未确认订位后端
- 新增本人、本店未确认自助订位的撤回接口，只处理未到店且无排桌、订金、低消、到访或关联账单的申请。
- 保留原订位及取消时间、原因、操作来源；状态与审计一起保存，重复撤回返回原取消结果。
- 门店旧请求在保存前锁定并核对原记录，拒绝覆盖更新后的订位；后端已部署，小程序入口仍待发布。
客人自助订位订位管理
顾客订位H5日期时间改用原生输入
- 本地H5订位日期和时间复用既有原生输入样式，保留微信端原有选择器。
- 保留日期下限、分钟精度、提交禁用和未来时间校验；修正输入更新中事件引用失效造成的白屏。
- 已在本地页面实际填写并验证缺少日期或时间时阻止提交；已编译，微信尚未上传或发布。
客人自助订位
订位号码别名遵循电话脱敏
- 旧订位以联系电话作为姓名时，接口别名沿用同一条记录的电话输出，避免绕过现有遮蔽规则。
- 电话权限按订位所属门店判断；保留平台遮蔽开关和原授权行为，不改历史称呼或号码。
- 后端已备份部署并通过健康检查；无完整号码权限的真实账号分支尚待验收。
客人扫码点单
顾客订位不再按未验证联系电话关联会员
- 顾客填写的联系电话只用于联系，不再据此把新订位自动关联给同号会员。
- 关联会员只接受已验证且属于当前门店的访客档案；旧订位、余额及积分不回填不搬动。
- 订位与审计同交易保存；后端已备份部署，本地正常页面提交和重载回查完成，服务器新建提交尚未单独验收。
客人扫码点单客人会员中心
欢乐时段按门店当地时间算，客人订单上写明「原价」
- 点单判断欢乐时段，原来用服务器的钟（世界标准时间），北京时间凌晨 3 点会被当成傍晚 7 点而打 8.5 折。现在没有指定钟面时，用这家店的当地时间（没配时区就是北京时间）。
- 欢乐时段打折的新品项，客人订单页和买单页每一行下面写「欢乐时段 8.5 折 · 原价 ¥320」这样的一句，原价由折后价和折扣率还原；旧订单不补。
- 促销设置页和前场「活动」小抄加一句：开始和结束是这家店的当地时间（没改过时区就是北京时间），不是世界标准时间。
- 折扣率、已经落单的单价、已收的钱、营业日切点都没改。
点单送厨客人扫码点单
开瓶寄存带有效期，沽清标来源，员工名单不再混进扫码点单账号
- 存酒表单有「有效期」，预填今天起 180 天，可改，空着不让提交；存酒只列酒水，名单空了写「没有可寄存的酒水」，读不到写「商品读取失败」。
- 新的寄存在日志里写「创建寄存」，不再混在「建立账号」里。
- 沽清每一行标来源：「系统判断售罄」「人工沽清」，两边都有就都写。
- 员工名单默认排除「扫码点单」设备账号（提成、员工账号、默认时薪都吃到）。
- 「我能做什么」老板的整张清单收进「展开全部功能」；积分规则提示写成「100 分抵 ¥1」；周报单数不足 20 时写「样本太少，先不下结论」，不再写「大盘走弱」。
开瓶寄存(客人+吧台)菜单商品建置员工账号与权限
有存酒快到期时首页会列出来，并给客人发短信
- 有寄存管理权限的人，首页「要你管的」会看到「N 瓶存酒 N 天内到期」。点进去还是原来的到期筛选。天数用门店设置，默认 7 天，打开页面才算。
- 快到期进入窗口发一次，只剩 1 天或当天再发一次。延期成功、转回库存成功各发一次。每瓶每个阶段只发一次。模板没配或没有手机号就不发，并记下原因。存酒详情看得到「已于X月X日 短信提醒」。
- 模板是空的时，门店设置显示「存酒短信模板还没开通」。不做定时任务。当天没人打开，短信会晚到下一次打开才发。
开瓶寄存(客人+吧台)
收银班次、库存预警、补货下单、客人菜单等多处读取失败时,不再误判成「没有」或「找不到」
- 客人扫码点单的菜单页读取失败时会提示重试,不再显示成「没有菜品」
- 后台库存预警中心的缺货、临期批次、滞销三张卡片读取失败时明确提示读不到,不再显示成「没有xx」
- 采购、调拨、进价历史、损耗记录、班次详情等多个后台页面统一了读取失败的判断,弱网或断线重试期间不再误判成「没有」
- 班次详情读不到时不再笼统显示「找不到这个班次」,并说清楚三种可能原因(没有查看权限/班次不属于这家店/这个班次本身不存在)
- 补货下单不再要求员工额外的「商品查看」权限才能看到计量单位名称——单位名称改由后端直接给出
- App(iOS/安卓/Mac/Windows)收银点单菜单读取失败时给出重试按钮,不再显示成「没有菜品」
- App 的库存台账、入库、出库、临期批次、跨店调拨、进价历史、记损耗、在途采购等页面读取失败时不再误判成空
- App 有 4 个页面原本把「读到了」的标记写反,已改对
- App 入库时如果读不到仓库列表,不会再悄悄把商品入到默认仓库,而是提示读取失败
- 建采购单时,商品计量单位的名称改由后端按 unit_id 查表解出,不再采信客户端传的字符串;已停用的单位仍能正确解出原名;查不到对应单位时会提示具体是哪个商品的单位有问题,不会显示成一串数字
开班交班进销存采购调拨客人扫码点单
客人扫码点单页不再弹出员工用的底部提示
- 客人页（菜单页、扫码页）不再渲染底部通知条，多分页警告和「有新版本」提示都不再出现。
- 原来这条通知压在「送出」按钮上，客人点不到送出，而且两句话是员工用语。
- 取舍：店内平板上长时间开着的菜单页不再看到「有新版本」提示，旧版本会一直跑到有人刷新。
客人扫码点单
网页扫码点单底部那条:「查看/修改」挤成一小条,「送出」看不出是按钮
- 客人直接打开桌贴链接时,底部购物车条左边那颗「已点 N 项 · ¥X · 查看/修改」只有 41px 宽,整句折成好几行;右边「送出」跟底条是同一个颜色,看不出是按钮,手机宽度下两个字还竖着排。
- 从员工页点进来时情况更糟:左边那句的字色跟底条同色,整句看不见。
- 现在改成两行:「已点 3 项 · ¥724」加一行小字「查看 / 修改 ›」;「送出」是深底金字的胶囊按钮,一眼就看得出能按。
客人扫码点单
网页扫码页写明：会员、存酒、订位请用微信扫码
- 网页扫码点单页的菜单最下方写明「会员、存酒、订位请用微信扫这张桌贴」,不用再猜这些功能在哪
- 网页扫码页上「已送到厨房」、订位提醒、错误提示这几句话,以前在客人手机上没有样式,现在正常显示
客人扫码点单
扫码菜单不再出现按毫升计价的调酒原料，商品可设「客人菜单可见」
- 客人扫码菜单(小程序、网页扫码页、店内平板点单)不再出现按毫升计价的调酒原料,例如以前会看到「蔓越莓汁 1L/瓶 ¥0.10」
- 这类原料就算有人改请求硬送,扫码下单也会整张被拒,提示「这一项不能扫码点，请找店员」;员工收银台照常可以点
- 后台「菜单」点开商品,多了「客人菜单可见」开关,可以自己决定哪些商品不给客人扫码点
- 按毫升卖的商品新建时默认对客人不可见;把商品改成按毫升卖、又没特别设定时,也会自动改成不可见
客人扫码点单菜单商品建置
删掉的桌台,贴在桌上的访客码以前还扫得开、还能下单
- 桌台删除后,那张桌的访客扫码桌贴原本不会失效——客人照样扫得开、照样能点单,单落在一张店员在楼面图上已经看不见的桌。
- 现在删桌时会一并撤销这张桌的所有访客码(留撤销记录);即使是以前就删掉、码还挂着的桌,扫码时也会显示「这个二维码无效或已停用,请找店员确认」。
- 为什么现在修:从 T-2683 起每张新桌都会自动带一张访客码,这个缺口从「少数手动产过码的桌」扩大到「所有新桌」。
- 正式机目前有 2 张有效码指向已经不存在的桌,上线后会被挡下;官网演示码不受影响。
桌台建置/平面图/QR客人扫码点单
新建的桌台现在自动带一张访客扫码桌贴
- 以前建好桌台后,访客码要店长另外去「访客扫码」页一张张按「产生桌贴」——rico 测试门店 16 张桌只开了 3 张。
- 现在建桌那一刻就顺带产生一张(单建、批量建、总部一键开店都算),店长去印桌贴时码已经在了。
- 已经存在的桌台不会被自动补开(店家可能刻意撤过);要补的在「访客扫码」页按「一键开通全店」。
- 门店还没开通扫码点单时,建桌照常成功、只是不产生码;之后去访客扫码页产生时会看到明确的原因。
桌台建置/平面图/QR客人扫码点单
桌贴上印的「新客扫码点单 立减20」,是一张没有客人拿得到的测试券
- 「桌台 QR」每张桌卡都印着「新客扫码点单 立减20」。查它从哪来:页面挑的是「任何一张生效的满减券」——在 rico 测试门店挑中的是「T487测试券-营销闭环验证」。
- 🔴 后端只在客人扫码后**认领会员**时发券,而且只发勾了「入会自动发」的券。这家店 17 张券全部没勾 ⇒ 桌上写的「立减20」没有任何客人拿得到。
- 另外那一页的码本来就是店内平板用的(客人手机扫不开,见 T-2674),印券更没有意义。
- 现在:「桌台 QR」不再印券;「访客扫码」桌贴只在两件事都成立时才印——那张券是「入会自动发」,而且这是真的小程序码(认领会员的入口目前只有小程序有)。文案改成真实的触发条件「扫码入会 送…券」,不写「新客」。
- 「扫码点单终端」账号卡也讲清楚是给店里平板用的,客人手机请用访客扫码桌贴。
桌台建置/平面图/QR客人扫码点单优惠券活动
网页扫码点单:合计印成「¥1.7999999999999998」,加错了的菜减不掉
- 客人用网页扫桌码点单,点 3 份 ¥0.6 的品项,底部写「3 项 · ¥1.7999999999999998」(rico2 正式机实测)。现在按分加总,印「¥1.80」。
- 🔴 加错一样东西只能重新整理整页——画面上没有数量、没有 −、没有购物车明细。现在底部那行字点下去会打开「您的订单」:每行 −/数量/+ 和小计,减到 0 就拿掉,全部拿掉弹层自己收起。
- 样式照旧版点单页的购物车,不新增 CSS,两套客人端至少长得一样。
- ⚠️ 还在:弹层里的「送出」会被「有新版本可用」横幅盖住(MP-102,rico2 在修)。
客人扫码点单
开店引导让新店去印的桌贴,客人用自己的手机扫了打不开
- 开店检核清单第 3 步写「建好后记得去「桌台 QR」把二维码印出来贴到桌上」,总部开店精灵开完店也直接落在「桌台 QR」。
- 🔴 那页的码连的是旧版点单页,要这台设备先有店员登录过。客人用自己的手机扫,看到的是「这台设备还没有服务生登录过,暂时无法浏览菜单」——而卡片上还印着「新客扫码点单 立减20」。
- 给客人自己手机扫的是另一页「访客扫码」,那页的说明早就写对了(两套机制),只是开店的两个入口都指向旧的那页。
- 现在:检核清单与开店精灵都改指「访客扫码」;「桌台 QR」页首说明改成「这页的码给店里的点单平板用」,并给一个「访客扫码 →」跳转。两页同一道权限,不会把人导到打不开的门。
- ⚠️ 没动:桌台 QR 卡片上的「新客扫码点单 立减20」在旧版平板上拿不拿得到没验,待裁。rico 测试门店目前只开通了 3/16 桌的访客码(MP-117)。
桌台建置/平面图/QR客人扫码点单
网页扫码点单页:顶上写的是产品名不是店名,分类按钮字是竖着排的,菜品看不出能点
- 客人扫桌上的码(#/g/短码)进来,第一眼看到的是「我的AI商业管家 · 扫码点单」——看不出是哪家店、哪一桌。现在改成「rico 测试门店 · B1 桌 · 扫码点单」。
- 分类按钮少了基底样式 ⇒ 每颗只有 21px 宽,「啤酒」「调酒」两个字竖着排。补上后 70px、可横向滑动。
- 菜品用了一个在样式表里一条规则都没有的 class ⇒ 看起来是一行纯文字,没有价格对齐、没有加号,客人不知道能点。改用已有的列表样式:名称|价格|＋,点过的显示「已点 N」,售完的灰掉并标「售完」。
- 桌上有订位时同样显示「这桌有一组预订(遮罩名)…请叫店员帮您绑定」,跟小程序同一栏位(T-2666)。
- ⚠️ 走查同时发现、这次没修的:没有购物车检视、加错了减不掉;这一页没有会员/储值/存酒/订位入口;多分页横幅会出现在客人画面上;菜单资料多为繁体、有重复品项、原料分类露给客人看。已记在 .role-walk/动线走查-小程序.md。
客人扫码点单
小程序购物车那句「这桌有一组预订」从上线起一次都没出现过
- 客人扫码进小程序、桌上已经有人订位时,购物车应该提醒「这桌有一组预订(张**)。如果是您这组,请叫店员帮您绑定,订金才能抵扣」。
- 🔴 这句话从写好那天起没有任何客人看过:后端 session 一直回 table_reservation_masked_name,而小程序的 mapper 是逐栏手抄的,漏抄了这一栏 ⇒ 前端永远拿到 undefined,条件永远不成立。
- 后果不是少一句提示:订了位、付了订金的客人如果自己扫码点单,订单不会挂到他的预订上,订金就抵扣不了,而他完全不知道要叫店员。
- 修法:型别与 mapper 各补一栏。同时这个缺口让 main 的小程序型别检查是红的(别人已经用了这个栏位),一并修好。
客人扫码点单
线上与 main 合成同一份：走查新做的订台人、短码扫码菜单、逾期提示都保住
- 订台人选择、短码扫码进 Guest 菜单、采购「逾期超过 60 天」等走查成果，从只在线上变成正式收进代码。
- 同一次发布同时带上收银台商品照片与未设水位——两边都在线上了。
订位管理客人扫码点单采购
开瓶寄存第一屏是真人的酒，测号沉底
- 在店的酒标题写清真人瓶数、测号已沉底。存酒是客人的货、店的负债，不是店存货。
- 搜测试名仍能找到。取酒走收银点单，本页不扣库存。
开瓶寄存(客人+吧台)
公开扫码菜单前排是在卖的菜，测号沉到底
- 客人扫桌码打开的公开菜单：前排是店里在卖的菜。
- 测号、走查夹具沉到名单最下面，不会排在第一屏。
客人扫码点单
客人扫桌码打开公开菜单，不用员工登录
- 桌贴短码打开的是客人点单，第一屏就是菜单。
- 不会先卡在员工登录。
客人扫码点单
客人扫码菜单不再出现测号和原料分类
- 客人扫桌码点单：测号、原料/食材、供应商测试类不会出现在菜单和分类芯片里。
- 员工点单仍看得到测号，方便店内对账。
- 店里真实在卖的酒水如果还挂在辅料分类，那个分类芯片会留下，把分类改到可卖成品即可。
客人扫码点单
扫码后看到的第一屏,按情境分
- 还没点、点了在等、吃完要买单——三种情境看到的第一屏不一样,不用自己在一堆入口里找
客人扫码点单
桌况页认得出每桌的来历
- 桌卡加「几点开台 / 带客归属」两行,状态计数条补上结帐中和预订
- 长按桌卡直接开动作抽屉;寄存取酒从桌台直达,不用再回去搜人
桌台楼面开瓶寄存(客人+吧台)
券的事一次说清楚
- 客人看得出哪张券快过期了
- 券页第一屏先回答「花多少换多少」
- 老板那边补上券效 ROI——值不值得的那个数字
- 桌边收款也能核销优惠券了(三端里最后一端)
- 多店老板的券页补上店签
优惠券活动我的优惠券结账收款
客人催菜,厨房收到会回话
- 催一下之后多了第三个状态「厨房已收到」;厨房按掉之后,客人那边不会原地退回「催一下」
客人扫码点单厨房出品
券和低消不再互相坑
- 低消未达时用券,券会被补足额原路吃掉——现在系统直接拦下并保留券,明说「该券此单不产生抵扣」
- 券只够抵一部分时按实际抵扣入账,不再让补足额悄悄吃掉券面差价
我的优惠券结账收款
账单终于会把话说全了
- 服务费、台费、人头费、开瓶费、低消补足逐行列在账单上,合计对不上的差额有「整单优惠」行兜住,不再出现两个对不起来的数字
- 用餐中合计不含结账时才算的费用时,买单按钮上方明示「以结账金额为准」
- 低消显示「已计入 ¥A / 本桌低消 ¥B」两个后端算好的数,不再让你心算
结账收款客人扫码点单
订位确认短信上线
- 客人订位被确认或取消时自动收到短信提醒,到店报手机号即可;每家店可自行关闭,同一订位不重复发
订位管理客人自助订位
这是客人自助的全部更新。 回按时间看全部。