更新日志

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

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

基础设置

老板尚未上线

老板首页「要你处理」补上开票申请、顾客跟进、临期批次、服务呼叫、入职审核;读不到的写「没读到」,不再当成没有

  • 网页总览和小程序老板首页的「要你处理」,新增这几类:开票申请、顾客跟进到期、临期批次(7 天内到期或已过期、还有库存)、服务呼叫(不含催菜)、入职审核;小程序首页同时补上了供货申请。每一类的数字都跟它自己那一页的列表一致,点一下进到那一页;没有对应权限的人看不到那一类。
  • 后端某一类这次没算出来(比如雷达扫描、补货建议出错),首页会写「XX没读到 · 重试」,不再悄悄当成「没有」,也不再在这时说「今天没有要你处理的事」。
  • 已经有自己行的几类(未交班、超时桌;网页上还有供货申请)不重复列第二次。网页上「服务呼叫 4 4」这类数字重复显示的问题一并修了。

顾客 CRM进销存客人呼叫服务员工账号与权限

老板

开票申请、挂账、员工账号、班次:每行一行,批量只有一个按钮且先确认

  • 开票申请:顶部写「待开 N 笔 · 合计 ¥…」,唯一的金色按钮是「全部标记已开」,点了先出确认(笔数、合计、「标记已开后不可撤回」);一笔一笔提交,失败的逐条写原因,成功的不回滚;每行点开才有单笔「标记已开」;默认显示 20 条,其余点「看更多」;已开的收进折叠行。
  • 挂账应收:顶部写欠款合计、几位客人、最久几天;按欠款从大到小,默认 20 条加「看更多」;核销和催收话术点开一行后在侧边详情里做;账龄分布、已核销/已退款收成折叠行。
  • 员工账号:搜索加「全部/启用/停用」,每行姓名加状态;点开看手机号、岗位、最近登录;重设密码是次要按钮;「停用这个账号」放在最底部「危险操作」里,点了必须先确认(写清「立刻生效,已登录的设备下次请求会被拒,班次订单记录保留,之后可以恢复」)。
  • 班次纪录:本班在上,下面历史;交班留言、现金差异、趋势、班次对比收成折叠行,行上写具体数字;代为交班、平账等操作原样保留。
  • 小程序的开票申请、挂账、待我批核、员工账号也是同一个形态;小程序员工账号停用同样先确认。

财务/日结/流水员工账号与权限开班交班

老板

后台设置改成分类列表:一次只改一类,改了才亮「保存」

  • 网页后台设置:左边是分类列表(店铺资料、营业时间与交班、收银与打包、出品站、会员与积分、股东订台与提现、数据与诊断,另有跳转到员工与时薪、提成规则、店规与公告、功能模块等入口),右边只显示当前这一类;窄屏先看列表,点进去再看表单。
  • 每一类页面底部只有一个「保存」,没改任何东西时显示「没有改动」,改了才亮并写「改了 N 项:…」;一次保存会把改过的几项都存上,失败的会逐项写原因,其余已存的不回滚。
  • 原来勾一下就立刻写入的开关(沽清、叫服务生、不卖酒等),现在先改、再统一保存;各项说明缩成一行,详细解释点 ⓘ。
  • 功能模块页顶部写「已开 N/47」,按分组折叠;不再显示模块代号和权限码。
  • 小程序后台设置也是同样的分类首页(首页 1 屏、不出现输入框,进某类才出表单,改了才出现保存条)。

功能模块开关

老板

请假、报销确认带提交人,排班标请假/临时班,扫码点单终端不能指派给员工

  • 请假确认单带提交人姓名(没有姓名用手机号),不再写「(未知提交人)」;报销类别用报销自己的中文,金额补到两位小数。
  • 排班「我的」:已批准的假盖住的那天写「请假」(本来有班就写班次加「· 请假」);今天没排班但有没下班的卡写「临时班」。请假表单今天已打上班卡时给出橙色提醒,不挡提交。
  • 看不到收款也看不到报表的人,加菜抽屉写「本单已 —」,不再写「¥0.00」。服务员首页大按钮写「实时桌况」。
  • 「扫码点单终端」角色不能指派给员工(服务器拒绝);指派真岗位后会撤掉同店的「待分配岗位」;名字含「扫码点单」的账号放到员工账号页最下面,停用要先确认。

排班打卡报销员工账号与权限

老板

开瓶寄存带有效期,沽清标来源,员工名单不再混进扫码点单账号

  • 存酒表单有「有效期」,预填今天起 180 天,可改,空着不让提交;存酒只列酒水,名单空了写「没有可寄存的酒水」,读不到写「商品读取失败」。
  • 新的寄存在日志里写「创建寄存」,不再混在「建立账号」里。
  • 沽清每一行标来源:「系统判断售罄」「人工沽清」,两边都有就都写。
  • 员工名单默认排除「扫码点单」设备账号(提成、员工账号、默认时薪都吃到)。
  • 「我能做什么」老板的整张清单收进「展开全部功能」;积分规则提示写成「100 分抵 ¥1」;周报单数不足 20 时写「样本太少,先不下结论」,不再写「大盘走弱」。

开瓶寄存(客人+吧台)菜单商品建置员工账号与权限

收银/店员/现场

点单可以按简体、繁体、拼音首字母和别名找商品,常点放在最前面

  • 打简体也能找到繁体酒名,比如世涛找到世濤黑啤,琴通宁找到琴通寧。
  • 拼音首字母可以找:sq 找到山崎 12 年,mxt 找到莫希托。全拼也能包含匹配,但不算排在最前的那种。
  • 店里的叫法写在菜单管理的「别名(搜索用)」,比如金汤力找到琴通寧。别名只用来搜,不出现在点单卡片上。
  • 打分类名也能找到这一类,比如啤酒。有关键字时不再被当前分类挡住。
  • 没有关键字、看全部时,最上面是这个员工在这家店最近常点的;这桌绑了会员,再多一排「这位客人常点」。
  • 搜不到时提示可以试拼音首字母。能改商品的人还会看到:到菜单管理给商品加别名。

点单送厨菜单商品建置

收银

收银台、进货核对、导入、损耗——读不到的时候不再显示成「就是没有/就是零」

  • 结账时如果订金/低消/积分兑换比例这几项之一读不到,「找零」和三颗快捷收现钮(刚好/凑整)以前照样显示一个可能算错的金额,现在改讲「应收未确定,暂不能算找零」并停用这三颗钮,等读到了才恢复——避免收银员照一个错的找零金额多找或少找钱给客人。
  • 结账合计与结账按钮上的金额,以前服务器账单读不到时会悄悄退回本机估算的数字,看起来跟服务器核定过的一样;现在读不到标「本机估算」、用的是上次读到的旧数据时标「旧数据」。
  • 后台「从平台商品库导入」弹窗,以前本店上架清单读不到时导入按钮照样能按,可能把已经上架过的商品重复导入;现在读不到时弹窗顶部提示 + 全部导入操作(单选、全选、一键导入)停用,重试成功才恢复。
  • 采购三方对帐表里第二处引用收货记录的地方,以前读不到时数量悄悄当成 0,让「票、款、货」对不上的情况可能被误判成对上了;现在读不到明讲「读取失败」,不当真数字用于比对。
  • 老板首页多处(今日生日会员、储值沉睡提醒、流失名单、应收账龄提醒、开太久没交的班、当班状态、日结核对结论)以前读不到时会静静显示成「没有」或直接消失;现在每一处都补上「读取中」「读取失败+重试」的提示。首页那句「今天没有要你处理的事」以前只要伺服器待办清单读不到就可能被误判说出口,现在改成这几个来源里只要有一个还没读到/读失败,就先说「有些提醒还没读到,不确定」,不敢再打包票。
  • 总部页「集团合计」「集团日结汇总」逐日期栏跟合计栏,读不到时以前用各自写的检查(合计栏那一格甚至完全没检查),现在统一用同一套读取状态判断,读失败时清楚标示、不当真数字显示。
  • 股东档案页「合伙出资与股份总览」卡片,以前服务器汇总数字读不到时会悄悄退回用本店档案自己加总的估计值,画面上跟服务器确认过的数字长得一模一样;现在读不到时加一句「服务器汇总读不到,以下为本店档案本地估算」的提示。
  • 库存批次「效期核对」以前读取失败或还在读的时候,会跟「确认查过、真的没有临期批次」印同一句话;现在分成「正在核对」「读取失败,不确定」「确认没有」三种不同的话。
  • 报损单里额度预判的金额计算,防御性修正,画面本身没有可见差异——只是把批次信息还没读到时曾经会被算成的假「0」改成「算不出来」,交给后端的额度检查兜底,不影响任何按钮或文字。
  • 结账「找零」门槛第一版只补了「拆分收款/通道收款」那条切换路径,默认结账(不切分账/通道收款)走的是另一段独立代码,三颗快捷收现钮当时都没停用;现在补齐:默认路径的「刚好」钮也会在读不到时停用,警示文字从容易被当成「一切正常」的绿色底框换成跟旁边既有错误提示同一套的红色警示样式,「完成收款」按钮在应收未确定时只显示「完成收款」不带金额。

结账收款菜单商品建置采购老板经营看板连锁 HQ股东与分红进销存

全员

网页商品和库存清单翻完所有页,超过 100 项的店不再少列

  • 网页的商品清单和库存清单现在会一页一页抓到最后,超过 100 项的店不会再静默少掉后面的列;盘点页也因此都拿得到单位。
  • 翻页超过上限或中途失败会直接报错,不会只显示一部分。

进销存菜单商品建置

老板尚未上线

小程序后台设置能开关「咨客带位」

  • 小程序后台设置 › 桌台楼面多了「咨客带位」这一行开关。以前咨客入口已经受这个开关控制,设置页却没有这一行,老板在小程序上关不掉它。
  • 模块登记的两份资料改成与正式数据库一致(少的一个模块补上,九处权限与一处适用端对齐)。

功能模块开关

客人

扫码菜单不再出现按毫升计价的调酒原料,商品可设「客人菜单可见」

  • 客人扫码菜单(小程序、网页扫码页、店内平板点单)不再出现按毫升计价的调酒原料,例如以前会看到「蔓越莓汁 1L/瓶 ¥0.10」
  • 这类原料就算有人改请求硬送,扫码下单也会整张被拒,提示「这一项不能扫码点,请找店员」;员工收银台照常可以点
  • 后台「菜单」点开商品,多了「客人菜单可见」开关,可以自己决定哪些商品不给客人扫码点
  • 按毫升卖的商品新建时默认对客人不可见;把商品改成按毫升卖、又没特别设定时,也会自动改成不可见

客人扫码点单菜单商品建置

店长尚未上线

删掉的桌台,贴在桌上的访客码以前还扫得开、还能下单

  • 桌台删除后,那张桌的访客扫码桌贴原本不会失效——客人照样扫得开、照样能点单,单落在一张店员在楼面图上已经看不见的桌。
  • 现在删桌时会一并撤销这张桌的所有访客码(留撤销记录);即使是以前就删掉、码还挂着的桌,扫码时也会显示「这个二维码无效或已停用,请找店员确认」。
  • 为什么现在修:从 T-2683 起每张新桌都会自动带一张访客码,这个缺口从「少数手动产过码的桌」扩大到「所有新桌」。
  • 正式机目前有 2 张有效码指向已经不存在的桌,上线后会被挡下;官网演示码不受影响。

桌台建置/平面图/QR客人扫码点单

店长尚未上线

新建的桌台现在自动带一张访客扫码桌贴

  • 以前建好桌台后,访客码要店长另外去「访客扫码」页一张张按「产生桌贴」——rico 测试门店 16 张桌只开了 3 张。
  • 现在建桌那一刻就顺带产生一张(单建、批量建、总部一键开店都算),店长去印桌贴时码已经在了。
  • 已经存在的桌台不会被自动补开(店家可能刻意撤过);要补的在「访客扫码」页按「一键开通全店」。
  • 门店还没开通扫码点单时,建桌照常成功、只是不产生码;之后去访客扫码页产生时会看到明确的原因。

桌台建置/平面图/QR客人扫码点单

店长

桌贴上印的「新客扫码点单 立减20」,是一张没有客人拿得到的测试券

  • 「桌台 QR」每张桌卡都印着「新客扫码点单 立减20」。查它从哪来:页面挑的是「任何一张生效的满减券」——在 rico 测试门店挑中的是「T487测试券-营销闭环验证」。
  • 🔴 后端只在客人扫码后**认领会员**时发券,而且只发勾了「入会自动发」的券。这家店 17 张券全部没勾 ⇒ 桌上写的「立减20」没有任何客人拿得到。
  • 另外那一页的码本来就是店内平板用的(客人手机扫不开,见 T-2674),印券更没有意义。
  • 现在:「桌台 QR」不再印券;「访客扫码」桌贴只在两件事都成立时才印——那张券是「入会自动发」,而且这是真的小程序码(认领会员的入口目前只有小程序有)。文案改成真实的触发条件「扫码入会 送…券」,不写「新客」。
  • 「扫码点单终端」账号卡也讲清楚是给店里平板用的,客人手机请用访客扫码桌贴。

桌台建置/平面图/QR客人扫码点单优惠券活动

店长

开店引导让新店去印的桌贴,客人用自己的手机扫了打不开

  • 开店检核清单第 3 步写「建好后记得去「桌台 QR」把二维码印出来贴到桌上」,总部开店精灵开完店也直接落在「桌台 QR」。
  • 🔴 那页的码连的是旧版点单页,要这台设备先有店员登录过。客人用自己的手机扫,看到的是「这台设备还没有服务生登录过,暂时无法浏览菜单」——而卡片上还印着「新客扫码点单 立减20」。
  • 给客人自己手机扫的是另一页「访客扫码」,那页的说明早就写对了(两套机制),只是开店的两个入口都指向旧的那页。
  • 现在:检核清单与开店精灵都改指「访客扫码」;「桌台 QR」页首说明改成「这页的码给店里的点单平板用」,并给一个「访客扫码 →」跳转。两页同一道权限,不会把人导到打不开的门。
  • ⚠️ 没动:桌台 QR 卡片上的「新客扫码点单 立减20」在旧版平板上拿不拿得到没验,待裁。rico 测试门店目前只开通了 3/16 桌的访客码(MP-117)。

桌台建置/平面图/QR客人扫码点单

后台

管理总览重排:手机/iPad 跟小程序同一套层级,电脑两栏,每一块都照后台「门户配置」和权限显示

  • 手机和 iPad 照小程序的顺序:进账 → 「N 件要你管」+ 此刻 → AI 一句判断和问话条 → 要你管的 → 钱对不对 → 参考 → 管理。
  • 电脑上左栏放进账和 AI,右栏放此刻、要你管的、钱对不对、参考,打开第一屏就看得到店里现在的状况和要处理的事。
  • 首页每一块都对应后台「门户配置」里的一张卡:关掉就不显示、没权限就不显示;以前「此刻」「钱对不对」「AI」三块关不掉。
  • 补上网页以前没有的「待我批核」和「要付的钱」(后台标为不可关闭的两张),以及「桌台排行」「净利怎么算的」。
  • 回本、趋势、应付、供应商、桌台、净利改成「参考」区一行一张,点开才加载,顺序跟后台排的一样。
  • 管理宫格和「改价/员工任免/分红确认」同时看权限和店铺功能模块开关;「改价」以前没有任何权限判断。
  • 修掉「此刻」四格被排成 3+1 的问题,页面上小于 12px 的字全部拉到 12px。

财务/日结/流水小程序门户卡片布局审批收件箱采购

老板

出厂员工岗不能改提成规则、不能确认日结

  • 新邀请的「员工」只能点单、查会员、看提成、看商品,不能改规则、关账、改商品、批采购。
  • 没有设置权限的人,提成页不出现「保存酒水范围」。没有关账权限的人,日结不出现「确认日结」。
  • 顶栏「我的分红」进自己的只读门户,不能在那里确认分红。

员工账号与权限提成/推广财务/日结/流水

店长

平台导入弹窗点得到分类,不会点到背后那一排

  • 打开平台导入后,点「啤酒」只会筛弹窗里的平台分类,不会点到背后商品管理的分类。
  • 香槟、软饮这类重复名字只留一条。打开时默认进啤酒,不要一上来一百条威士忌。
  • 手机上是全屏,不是一个盖不住背后的小窗。

菜单商品建置

店长

从平台库上架菜单,填的是本店卖价,不是进货价

  • 商品管理 › 平台导入:每一行分开写「建议零售」和「本店售价」。进货价不在这里填。
  • 本店已经有同规格的,按钮改成「已在本店」,不会再导入成第二份。
  • 批量导入会说明:先用建议零售价上架,到菜单页再改卖价。

菜单商品建置

店长

班表上那句解释只在「读不到名册」时出现,而 65% 的情况走的是另一条路

  • 上一轮补的那句解释挂在「名册读取失败」上。但名册读得到、而这个排班对象不在名册上时,格子照样只显示编号,而那句解释不出现——看到的跟修之前一模一样。
  • 查了生产库:排班表未删 150 行、不同的排班对象 34 个。其中账号表里找得到的只有 13 个,查无此人的 21 个,账号存在但已停用的 1 个 ⇒ 22 / 34 = 65% 走的是没有解释的那条路。
  • 根因不是业务状态,是孤儿数据:排班行上的员工字段是一个裸 UUID,不是外键 ⇒ 删掉账号不会连带清掉排班行,也没有任何约束会出声。前端把它渲染成「这个员工怎么了」,而真相是「这一行指向一个不存在的人」。
  • 现在两句话分开,而且互斥:读不到名册(店长自己解决得了——去要权限)/有 N 个排班对象不在名册上(店长解决不了,那是数据的事)。两句话的行动不同,所以不能合并成「你没有权限」。
  • ⚠️ 文案刻意不讲时间。第一版想写「这几个人的班还排在这一周」,查了之后是假的:那些行的日期全部落在一个月前,排在今天及以后的 0 行(对照:非孤儿且排在今天及以后的有 52 行,证明那个 0 是真的 0)。而且这一页可以往回翻,我们不知道用户站在哪一周。
  • ⚠️ 下一个人:数的是不同的人,不是格子数。一个人排七天是十四格,报「14 个排班对象」会让店长去找十四个不存在的人。
  • 🟡 那 34 行孤儿数据没有清,它横跨 11 个门店 / 2 个租户。稽核性质的历史排班该不该留是产品决定,这里只负责把它量出来。

排班打卡员工账号与权限

全员

全站统一说「登录 / 退出 / 设备」——原来一半页面说的是台湾话

  • 「登入」「登出」「装置」是台湾用法。产品面向大陆市场,这几个词读起来就是「外国软件」——而它们每一个字本身都是简体,所以繁简检查对它们永远是绿的。
  • 这一轮改的是用户看得到的每一处:登入→登录、登出→退出、装置→设备。页首那颗按钮现在写「退出」,未结单的提示现在写「换设备/刷新后也能从这里接手结账」。
  • ⚠️ 动手前先查了两格,因为机械替换最怕改到的不是显示文字:这四个词被当成比较值的地方 0 处(同一支检查对「任意中文字符串比较」命中 11 处,所以那个 0 是真的 0);被当成对象键的 1 处是误报,那个冒号是三元运算符。
  • 最该担心的一处逐行读了:操作日志的动作标签表里写着 user_login: '登入'。键才是后端存进日志的动作码,中文只是显示标签 ⇒ 改值不会让改动前后的日志对不上。
  • ⚠️ 验收条件是「检查对这四个词回 0」,不是「我改了多少处」。改动数是过程量,会因为别人同时在改而对不上;回 0 才是状态量。改前 47/0/49/10,改后全部 0。
  • ⚠️ 下一个人:这四个词已经收进检查的词表了,而且收表和清空是同一次提交——所以它从来没有以「一上线就红 N 处」的状态存在过。一个一上线就红一堆的检查,教会大家的是绕过它。
  • 🟡 注释里还留着约 130 处「装置」。这是刻意的(这一轮的范围是用户看得到的文字,不碰注释也不碰标识符),但它跟上一轮「连注释一起改」的做法不一致——要不要统一是另一个决定,没有在这里顺手抹平。

员工账号与权限结账收款收款与小程序

店长

班表上十四格全写「员工 0730170f」,而那个人的姓名后台里存得好好的

  • 用受限账号打开周排班,整张表十四格印的都是「员工 0730170f」。查了后台:那个人的姓名是存着的,而且全库 615 个账号里,姓名为空的有 0 个。
  • 所以这串编号从来不是「姓名没填」——它百分之百是「名册没读到」。写法上一个 ?? 把三种完全不同的情况折成同一串字:名册读不到、名册里没这个人、这个人没填姓名。
  • 为什么一直没人发现:员工名册要的是「用户管理」权限,而这一页的门槛是「排班查看」权限。两个不同的码,所以店长进得来、名册读不到。用全权限账号走查永远看不到这一格。
  • 最麻烦的一格:正确的那句解释本来就写好了,就在同一个文件里——但它在「新增排班」表单内,而表单只对有编辑权限的人显示。⇒ 只读的人看得到症状、看不到解释。
  • 而他唯一看得到的权限说明是「安排/调整需要排班管理权限」,讲的是另一个权限。⇒ 这比没有说明更糟:它会把人指到错的方向。
  • 现在把解释放到格子上方(只读也看得到),并且明写这是两个不同的权限。另外「找到了但姓名为空」改成一句不一样的话——今天走不到,但哪天真的出现,它不可以再混进「读不到」那一堆里。

排班打卡员工账号与权限

老板

其余设置卡也改成四态:读不到就不画表单、平台预设会明说

  • 营业时间、桌台开台提醒、呼叫队列零时效提醒、股东订台窗口这四张卡,改成跟「钱的那一组」同一套四态:读失败时整卡换成一句人话(「这次没读到这家店的设置。为了不把平台默认值当成店家设置写回去,这里先不显示可以保存的表单。」)+「重新读取」,表单与保存钮都不出现;载入中有自己的一格画面,不与读不到共用。
  • 根因在读取层:这四张卡(外加月目标、AI 建议问题)的读取原本是 catch-all——500/断网/权限不足全部被吞成平台预设,于是画面上「看起来有值」、保存钮可按。改成只吞 404/CONFIG_NOT_FOUND(未配置才走平台预设),其余一律往上抛,卡片才拿得到「读不到」。
  • 顺手把三处与程序行为不符的注释改成真话(原本逐字写「退回默认,不是载入失败」,而码是 catch-all,下一个人会相信它已经处理好了)。
  • 验收(本机 dev,阻断 4 支设定读取、回 500):拦截命中 8 次(证明拦到)+页上出现 4 个「这次没读到」状态、其中表单 0 个、保存钮 0 个、强制点击后写入 0 笔。已验、未部署(与 P1-106/P1-107 同一批上)。

功能模块开关

老板

设置页「钱的那一组」改成四态:读不到就不给存,平台预设会明说

  • 收银规则(13% 税率/纳税人类型/抹零偏好)、外带打包费、Happy Hour 时段价、退款自动核准门槛、积分规则、满赠、交班时间(营业日边界)、股东银行卡与提现这 8 张设置卡,改成两端共用的「四态」:载入中/这次没读到/未配置(平台预设)/有值。
  • **读失败(断网/伺服器出错/权限不足)不再显示可保存的表单**:整格换成一句人话「这次没读到这家店的设置。为了不把平台默认值当成店家设置写回去,这里先不显示可以保存的表单。」+「重新读取」按钮。技术细节(HTTP 状态/错误码)另起一段,不混进主句。
  • 未配置(这家店没设过)与读不到是两件事:未配置仍可保存,但栏位旁会挂一枚「这是平台预设(这家店没设过)」标签。实测 Happy Hour 与满赠这两张在测试店就是未配置,标签确实出现;收银规则的 13% 是店家值,标签不出现。
  • 外带打包费/交班时间/股东提领这三个系统设定值改成「值+有没有设过」一起回来(`{fee,configured}`/`{hour,configured}`/`{enabled,configured}`),画面因此分得出「平台预设」与「店家设的 0」。
  • 验收实测(本机 dev,拦截每个 key 的读取各一次):8 张卡 × 两种失败型态(连线层中断 + HTTP 500)=16 组,全部「没有表单、没有保存钮、有重试、主句不含英文、强行点/拨每一颗控件后 0 笔写入」。happy path 两张卡做同值回写,值前后不变。

功能模块开关

老板

设置屏现在会说出「这是平台预设」和「这格读起来不对」

  • 「后台设置」那 10 格(营业时间、交班时间、打包费、开台提醒、过期阈值、自动沽清、叫人按钮、渠道口径、订台窗口、提现开关)现在会标示「这个值是谁的」:店家没设过(平台预设)会明说「这是平台预设」;读到的是店家自己设的值就不标;后端没说(含这颗 key 根本不存在)则既不标、也不断言有店家值。
  • 另外加了一道通用防护:后端如果说「这是店家值」、但值的型别明显不对(例如物件型栏位收到 false),画面会把值照实显示并说「这格的设置读起来不对」——不会在两个说法里挑一个硬讲。(今天这一格是「营业时间」。)
  • 为什么以前分不出来:单键回应本来就有「这是不是店家设的」与「来源」两个栏位,是读取器把它们丢掉了。这次补上,并且只影响这一屏那 10 格——其他屏的读取路径一个字都没改。
  • 验收(线上产物 http://localhost:5405/js/app.1fe6ea61.js,375 宽):25/25 断言通过——平台预设两格标出该句、型别不对那格标出该句、店家值两格(开台提醒 37、过期阈值 45,其中 45 刚好等于平台预设值)都不标来源;四态闸门与逐项重试全部零回归。

功能模块开关

老板

刚登录还没拿到门店时,设置屏会说清楚并给重试,不再卡在「先选择门店」

  • 之前:人还在登录状态、但这台设备还没记住门店时(刚登录/从连结直接进来/清过浏览器),「后台设置」会一直停在「先选择门店」——而那一屏没有切店条,卡住的人只能离开这一页。同一族的另外四屏(小票、结账规则、欢乐时段、桌台颜色)会自己解析门店,只有这一屏不会。
  • 现在:改用同一颗共用的门店解析(含两级重试)。解析期间显示载入中——不会先给一张不能提交的表单、也不会误说你没有门店;解析慢过 2.5 秒会显示「还没拿到你的门店」+两条指引(刚登录就回一次首页,首页会记住当前门店;刚断网就等网络恢复,按下面的重试)+一颗「重试」。
  • 验收(线上产物 :5405,375 宽):清掉本机门店后直接进这一屏 ⇒ 表单出现,且画面与正常进入时逐位元组相同;把门店清单的来源延迟 3 秒 ⇒ 期间是载入中、保存钮 0 颗;把门店来源拦成空 ⇒ 出现「还没拿到你的门店」与重试;按重试 ⇒ 真的重打门店清单(读取 +1),恢复后能正常渲染表单。

功能模块开关

老板

小程序设置屏读不到时不再显示平台预设,也不给保存

  • 「后台设置」里的营业时间、交班时间、外带打包费、桌台开台提醒、呼叫队列过期阈值、见底自动沽清、叫人按钮、外部点单渠道、股东订台窗口、股东提现开关、退款门槛这 11 组,读不到时各自换上一句人话(「营业时间这次没读到——载入成功前这颗保存不会送出,先按重试。」)+自己那一颗「重试」,那一颗保存钮同时锁住;按重试只重打这一项(实测只多 1 笔读取),其他项不动。
  • 根因在读取层:「呼叫队列过期阈值」原本是 catch-all——断网/权限不足/500 全部被吞成平台预设 45,于是那一格永远进不了「这次没读到」,画面显示 45 而且可以保存(按下去就把平台预设写成这家店的设置)。改成只吞 404/CONFIG_NOT_FOUND(未配置才走平台预设),其余一律往上抛;顺手把同一支读取在「呼叫队列」那一屏的调用端一起接上。
  • 验收(本机 dev 与线上产物 http://localhost:5405/js/app.cee123b9.js,375 宽):阻断 11 支设置读取 ⇒ 11 句人话/11 颗重试/11 颗保存钮全部锁住;三种强制点击(含真实鼠标强制点击)⇒ 写入 0 笔,该轮非 GET 只有登入;正常路径显示店家值(开台提醒 37,平台预设是 90;呼叫队列阈值 45,由接口 configured=true 认定)。
  • (限制,不要误读)本轮「值」是唯读取证;保存链——写入→验证→还原、乐观锁与 409——留待第二轮一起验。

功能模块开关

客人

演示店现在讲得出「餐是业绩、酒才抽成」

  • 演示店以前整间都是酒,没有一道菜,所以「餐食会进业绩、只有酒算提成」这件事在演示店里根本演不出来。
  • 现在演示菜单里有主食类菜品,并且历史订单每一单都是「一份酒 + 一份餐」——打开账单点开任一单,能看到同一张单里酒进了提成基数、餐只进业绩(基数 0、应发 0、原因写「非酒水」)。
  • 守卫同时加严:混合单不足 8 张就直接报错,不再静默给出一份空账单。

提成/推广菜单商品建置

老板

只读账号打开提成规则页不再一直转圈

  • 只有查看权限、没有设置权限的账号,以前打开提成规则页会看到三块永远「载入中…」;现在直接说明「没有设置权限,只能看说明」。
  • 没有再发出会被拒绝的请求,界面不留永远转不完的载入状态。

提成/推广员工账号与权限

老板

没有 POS 可回的人,不再看到那颗按了没反应的「← 回 POS」

  • 弱权限帐号(例如纯咨客)的后台侧栏与窄屏抽屉不再显示「← 回 POS」——他没有 POS 前台可回,点了画面不会变。
  • 有 POS 权限的帐号(店长/收银)照旧看得到、按得动。

点单送厨员工账号与权限

老板

连锁总部的筹备门店有「查看这家店」入口,状态也不再被写成「已停用」

  • 筹备中的门店(还没开业)在总部「门店总览」与「开店筹备」两页都有「查看这家店 →」(以前只有营业中的店有)。
  • 状态标签与统计口径从「筹备中/停用」改成「未启用」——不再把还没开业的店说成「已停用」,也不再让一句标签盖掉两种状态。
  • 按「查看这家店」时会先问后端这家店读不读得到;读不到就在那一行说清楚原因(而不是跳进一个每一页都失败的后台)。
  • 两个入口(总览/开店筹备)共用同一支判断,不是各写一套。

连锁 HQ功能模块开关

老板

设定页可以把一项配置回复成「未配置」(走平台预设)

  • 提成规则页的三个区块(抽哪些/员工怎么抽/谁能拿)各多一颗「回复成未配置(走平台预设)」。
  • 按下去会先问一次,并写清楚后果:之后新分类会自动落平台预设,已生成的提成行不重算。
  • 以前一旦存过一次就再也回不到「未配置」——现在回得去,平台预设之后的修正才到得了这家店。

提成/推广员工账号与权限

全员

進不去的後台頁面會明說「你看不到這一頁」,不再偷偷換一頁給你看

  • 以前:員工點了沒有權限的後台頁(例如日結),畫面會靜默退回總覽——看不出是權限問題,會以為自己記錯網址。
  • 現在:明說「这一页你看不到」+缺哪一道權限+一顆「回你的首页」;只有網址本身打錯才回總覽。

员工账号与权限

老板

账号面板:你自己的那些事

  • 进来先看「接下来做什么」——店开好了但还差什么,它直接列出来,做完自己消失
  • 「我的身份」列出你名下所有的店和供应商账号
  • 改密码在这里;换手机号暂时还没开放(手机号是我们认人的钥匙,只改一边会让另一边认不出你)

员工账号与权限

全员

一个手机号可以既开店又供货

  • 已经是供应商的人,可以直接在账号面板里开一家店;已经开店的也能登记成供应商
  • 两种身份都列在一起,点哪个进哪个
  • 新身份沿用同一个密码——不然登录时只认得出其中一个

员工账号与权限供应商门户

全员

开店的、供货的,现在从同一个门进

  • 官网上「登录 / 注册」一个入口:不用先想自己算商户还是供应商,填手机号和密码就认得出你
  • 注册也在同一页:选「我要开店」或「我是供货商」,其余的表都一样
  • 从这里点进自己的店,不用再登一次

员工账号与权限

全员

手机上能改自己的密码了

  • 改密码这件事后台一直支持,只是小程序上没有任何地方进得去;现在「我的账号」里就有

员工账号与权限

老板

AI 分析散在五个地方,现在收进一个门

  • 要找某条分析,原本得在侧栏里翻五个入口,其中三对其实是同一份分析的两个范围;现在一个目录进去,看得到的分析从 3 个变成 7 个
  • 首页可以自己整理了:哪些卡要、哪些收起来、顺序怎么排,你说了算。没权限的卡不会出现在整理清单里——那是权限的事,不是版面的事
  • 网页端的老板看板终于会读这份版面设定;先前你在手机上排好,网页照旧不理

问一问AI 工作台老板经营看板小程序门户卡片布局

老板

商品在手机上就能建全

  • 补上网页六个动作里缺的五个,新店不再卡死在「还没有分类」
  • 规格(冰量、杯型这些)加得了,带常用预设,也删得掉其中某一个选项
  • 会员价 / VIP 价设得了
  • 平台商品直接导进来,分类就地能管

菜单商品建置

老板

官网注册完,扫个码就在微信里管店

  • 网页上有一张绑定卡,扫码即绑;小程序那头认得这条路,第一次打开直接分流到该去的地方

收款与小程序

全员

纯股东和供应商不用再输 PIN 了

  • PIN 从「登入前无条件要」改成「登入后只对收银角色要」。原本那道门把从不碰收银台的人也挡在外面

员工账号与权限

全员

每个员工看得到自己到底能做什么

  • 新增「我能做什么」——不用靠试,也不用问店长

员工账号与权限

老板

开店引导修了三处堵点

  • 一个人开的店不再被员工步骤永远卡在引导页(有员工再补,不挡你看生意)
  • 选「纸本菜单」的老板现在真的能从平台商品库挑菜建菜单
  • 营业时间步骤讲真话了:设了之后打烊时间外客人扫码会看到休息中;没确认过就不会替你写死一个时段

员工账号与权限

全员

手机验证码也能登录了

  • 员工、老板、股东都可以用短信验证码登录;新账号首次进来可以顺手设个密码,不设也没关系

员工账号与权限

这是基础设置的全部更新。 回按时间看全部。

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