更新日志

改了什么,
一条条记在这里。

已经上线的直接写;还没上线的会标明「尚未上线」。 目前共 794 条
同一条更新可能同时属于多个模块,因此各模块条数相加会大于总数。

客人自助

老板

欢乐时段按门店当地时间算,客人订单上写明「原价」

  • 点单判断欢乐时段,原来用服务器的钟(世界标准时间),北京时间凌晨 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」两个后端算好的数,不再让你心算

结账收款客人扫码点单

客人

订位确认短信上线

  • 客人订位被确认或取消时自动收到短信提醒,到店报手机号即可;每家店可自行关闭,同一订位不重复发

订位管理客人自助订位

这是客人自助的全部更新。 回按时间看全部。

这份日志从 2026 年 7 月记起,更早的没有逐条列。想看它现在都会什么,回全部功能,或者进演示店自己点一点。