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

结账画面:低消补足算进「应收」,「刚好」不再只填小计

• 低消桌结账:「应收」那一行现在把**低消补足**算进去(以前只显示小计),低消那一行仍逐项写出「低消 ¥500 / 结账将补收 ¥220」。
• 「刚好」那一颗填的是**同一个应收数字**——以前它填小计,按下去会得到一个系统自己会拒绝的金额,收银员要在客人面前改口再收差额。
• 低消门槛改用**开台当下锁在订单上的那个值**(locked_min_spend),桌台设定只当读不到时的退路:老板中途改过桌台低消时,同一张单不会再出现两个门槛。
• 守门没有放宽:实收不足仍然红字提示且不送出任何请求。

后台侧边栏的图标退回了系统 emoji——已修复并上线,同时补上让它不会再静默发生的两道闸

• 问题:侧边栏 54 个自绘图标在 19:06 的一次发布后整批变回系统 emoji。原因是那次发布从一棵「共享工作目录」构建,而那里的侧边栏文件停留在图标接线之前的版本。
• 🔴 最值得记的是:发布脚本的 20 项健康检查**全部通过**。它们检查的是「线上服务的是不是这次构建的包」,不检查「功能还在不在」。**是用户自己看到才发现的。**
• 已修复并验证上线:线上的侧边栏分包里重新有 94 段图标路径,而且同一次发布没有撤掉其他人已经在线上的功能(逐条比对过)。
• 同时量到同一个原因还影响 115 个网页文件共 838 行,其中 324 行是用户看得到的文字:会计页「本店尚未初始化」整段说明、一条安全提示、预收义务那段「客人手上有钱而账面一笔分录都没有」、分红的提现口径说明。小程序侧另有 1,549 行。
• 两道新闸:①发布脚本发现「这次构建会撤掉用户看得到的文字」就中止,并列出是哪些文件、丢了多少行;②每轮收尾的检查补上「共享目录落后主干多少行」这个方向——它原本只看「新写的文件出不去」,看不到「别人写的会被你盖掉」。
• ⚠️ 票号订正:这条原本写成 T-2531,而那个号早就有人领去做别的事了——**我用了号没有先登记**,撞上的正是我当天点名过别人的同一件事。改成 T-2539。两颗提交(ffeaf243 / e87615cf)的信息里仍写着旧号,查的时候以这张表为准。
• 🔴 顺着同一个线索还量到一件更大的:后台「咨客台」整页(750 行)与「会计」的侧边栏入口,**只存在于那棵共享工作目录里,版本库里完全没有**。两页现在线上都是活的(之前从那棵目录发布过),但任何一次从主干的正常发布都会让咨客台整页消失、会计从侧边栏不见。
• 另外量到 904 行用户看得到的文字只存在于工作目录(11 个文件整个不在版本库:老板第一屏、未结单、设置四态…)。
• 两道闸补成对称的:一条挡「你会撤掉主干上已有的」，另一条挡「你会撤掉只活在工作目录里的」——后者才是大家默认走的那条路。判准相同,方向相反。
• ✅ 保存问题已经归零:同事另开了一条快照分支收下 409 个文件里的 339 个,我补上最后 2 个(其中一个就是载着那两条菜单项的文件)。**现在共享目录里每一个文件的内容都在版本库里了**,再也不会「只存在于一台机器的磁盘上」。

分红确认后账目还在变,老板现在看得到差多少

• 分红一旦确认就按当时的数字发钱,但营业额、成本、提成之后还会补录——以前系统完全不知道自己曾经冻结过,差多少没有任何地方看得到。
• 现在分红预览会直接告诉你:这个月已经确认过了、当时冻结的每一项是多少、现在算出来是多少、差额多少,只列真的不一样的项目。
• 还没过完的月份不能确认分红了。当月按下确认等于拿半个月的数字发整个月的钱,月底剩下的营业额全漏在外面。被挡下时会告诉你什么时候可以再来。
• 已经确认过的分红再点一次,行为不变——还是原样返回那一笔,不会因为新的限制变成报错。

股东与分红

「我的订单」里还没结账的单，会说明金额还会变

• 还在用餐中的单，金额下面会多一句「结账时另计服务费等，以结账金额为准」。
• 以前这张卡只印一个金额，看起来像最终要付的钱，其实服务费和低消补足要到结账那一刻才算。
• 已结账的单不显示这句话。

股东订了桌但没来,散客坐上去的消费不再算进股东分红

• 股东在门户自己订的桌台,开单结账时会自动绑成「自有台」并计入分红。
• 原本只要那张桌上有一笔时间对得上的预约,就会绑——哪怕这笔预约状态还停在「已确认」、根本没人标过客人到场。
• 结果:股东订了 18:00 的台没来也没标爽约,18:30 一组散客坐上同一张桌,整桌的钱被算进那位股东的分红。
• 现在只认「有人真的标过客人到了」(已到场 / 已完成)两种状态,「已确认」不再触发自动绑定。
• 代价写明:不习惯标到场的店,会从「自动绑」退回「老板手动补一笔绑定」。方向是刻意的——宁可不绑,不可绑错。

股东与分红提成/推广订位管理

购物车里也能看到商品图片

• 客人在购物车确认自己点了什么时，每一行左边会显示商品照片。
• 没有照片的行不显示灰色空框。改动之前存下的购物车没有这个字段，读回来就是不显示图，不会出错。

顾客中心不再对正在吃饭的客人说「我的订单 还没有」

• 以前客人桌上有一张没结的单，顾客中心的「我的订单」却写「还没有」，点进去又列着那张单。现在会写「本桌这一单还没结」。
• 「我的会员」以前在「读不到资料」和「不是会员」两种情况下显示一模一样的字，现在分开：读不到显示栏目说明，不是会员就直说「还不是会员」。

客人扫码点单的菜单会显示商品图片了

• 客人扫桌贴进菜单，每道菜左边会显示一张照片。
• 没有照片的品项不显示灰色空框——空框看起来像「图片加载失败」，而不是「这道菜没拍照」。
• 图片延迟加载，进菜单不会一次性发几十个图片请求。

后台侧边栏的图标不再是系统 emoji:54 个自绘线性图标已上线,每台电脑看到的终于一样

• 以前侧边栏 34 个是彩色 emoji、21 个是单色符号,画它们的是你的操作系统而不是我们——所以同一个后台在 Mac、Windows、不同版本上长得都不一样,而且有 6 对不同功能被迫共用同一个字符(咨客台和等位是同一张椅子、财务和报销是同一个符号)。
• 现在 55 项里 54 项换成自绘的线性图标,同一套线宽、同一个尺寸,跟着侧边栏的选中/未选中/悬停与深浅两套主题一起变色。
• 剩下的 hostess(咨客台)、accounting(会计)两项的菜单碼还在别人的分支上没并进来,登记表里记着它们是待办,不是漏掉。
• 看起来像的两颗是量出来的不是看出来的:每颗在真实渲染尺寸 20 像素下光栅化两两比对,54 颗共 1,431 对全部高于合格线。
• 另外做了一件事:把这个量测从「我手动跑一次」变成仓库里的一支脚本,下一个画图标的人不用重新发明它。

同时开多个页面时的提示改成简体，并且说清楚不照做会怎样

• 以前这句提示是繁体字，而同一屏的登录表单是简体，一屏两套字。
• 以前只说「建议只保留一个页面操作」，没说不照做会怎样。现在先讲后果：购物车和未送出的品项不会跨页面同步，在这一页点的单另一页看不到。

客人菜单上卖完的东西，按钮会直接写「已售罄」

• 以前卖完的品项，按钮还是写「加入」，按下去什么都不会发生、也不说一句话。
• 现在按钮直接写「已售罄」——按之前就知道按了没用。

线上收款流水页现在真的列得出每一笔微信/支付宝收款，时间也按门店当地时间显示

• 以前不管挑哪一天，这页都显示「¥0.00 · 0 笔 · 全部对上了 · 这天还没有线上收款」。现在会把那天每一笔微信/支付宝收款列出来，并给出合计与未对账笔数。
• 时间栏以前印的是 UTC，比门店当地早 8 小时——整晚的流水会显示成中午到下午。现在按当地时间显示。
• 拿不到合计时改用列表自己算，不再退回 0——0 在这页的意思是「这天没有线上收款」，那是一句关于钱的话，不能当默认值。

网页收银开台建单时带上服务员身份，结账才算得出服务员提成

• 网页收银台开台/建单时，会带上「这台机器上现在是谁在操作」的身份，结账时服务员提成才算得出来。
• 离线送单队列重放时带的是入队当下那个人，不是重放那一刻在线的人。
• 客人扫码自己点的单不带服务员身份，不会记到店里员工头上。

收银台顶部营收在历史详情没读到时显示「¥—」，不再显示一个说不清的 0

• 今天的历史里若有单的详情没读到，收银台顶部「营收」那格改显示「¥—」（滑过有说明），不再显示 ¥0——那会被抄数字的人当成「今天真的没赚」。
• 旁边的说明句照旧保留（值面与说明要一致）：有 N 张单的详情没读到、未列入今日历史。
• **不得把没读到的清单金额补进营收**（那会变成合成数字）；没读到的单就是不计入，但要说出来。
• 后台首页 hero 不受影响（它读 /ai/boss-realtime/，与这一格不同源）。

老板经营看板

桌效页的各桌明细多了一行合计，终于看得到「营收贡献榜」那些百分比是拿什么当分母

• 「桌效 / 翻台率」→「各桌明细」表格下方新增一行合计：总翻次、总营收贡献。
• 下面那张「营收贡献榜」的百分比（例如「B1 占 38%」）一直是用全部桌的营收总额当分母，而那个总额**页面上从来没有以数字出现过** —— 走查实测是 ¥3,980，零处显示。现在它就在合计那一行。
• 合计行的「平均时长」「平均人数」两格是**空的**，这是刻意的：把几个平均值加起来不是任何东西。
• 窄屏（手机/平板竖屏，≤768px）下这张表会自动换成一张张卡片，不再横向滚动。

演示店的「一句话」现在会自己说数据到哪天为止

• 演示店最近没有当天生意时，页面会退回「上一个营业日」并照常给出一句话总结——以前它只说生意怎么样，不会说「数据其实停在几天前」，访客看不出来。
• 现在这一句话的结尾会直接写出来：数据最新到哪一天、之后没有记录。访客现在就看得到这个改变。
• ⚠️ 这一条只交付「把话说清楚」那一半；「资料不缺时不会出现这句」要等资料补到当前营业日（另一张票）才能验证。

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

• 「后台设置」那 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——留待第二轮一起验。

功能模块开关

已经绑了会员的单，重新整理或换一台机器接手后不会再变成「没绑」

• 以前：一张已经绑定会员的单，收银按了重新整理（或换另一台机器用未结单接手）之后，画面变成「没绑会员」——储值折抵与积分折抵整块消失，结帐窗还叫收银重新绑一次。
• 现在：记忆体里的分页没了之后，绑定的会员会用「订单自己记的会员」还原——重新整理后从「未结单」接手、或另一台机器接手，徽章上还是那位客人，储值折抵与积分折抵照常出现。
• 完全没绑会员的单不会误显示：徽章不出现、折抵区也不出现。

点单送厨结账收款