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

「隔夜未交」的班次现在直接告诉你抽屉里应该有多少钱

• 原本那一行只有:收银员姓名、班次编号、开班时间、营业日——三个识别码、零个金额。
• 现在会显示「抽屉应有 ¥X」;这一班根本没经手现金的时候说「这班没经手现金」,而不是显示 ¥0;算出来是负数的时候标红并说明现金进出记错了。
• 这个金额精确到分:点钞要跟手上的钞票对,四舍五入到元会让收银员对不上号。

开班交班

窄一点的屏幕上,后台页面标题不再一个字一行竖着排

• 1024×768 的 iPad 横屏、或者把窗口贴在 1920 屏幕一半的时候,后台左上角的页名(例如「班次纪录」)会变成四个字竖着排。现在恢复单行。

网络不稳时,后台不再把「读不到」说成「你没有」

• 「还没有交过班」「还没有预约」「你今天还没开班」「这个区间内还没有任何一笔钱动过」「没有符合条件的挂账纪录」——这些话现在只在真的读到数据、而数据确实是空的时候才出现。
• 「我的班次纪录(0)」标题里那个 0 也一起修了:读不到的时候不显示数字,而不是显示 0。
• 总览页「还差一项没设置:时薪」不会再在读不到人力数据时冒出来。

审批收件箱财务/日结/流水订位管理开班交班

股东门户的「累计消费」会把角分四舍五入掉，而这个文件自己禁止过

• 股东在门户里看自己维护客户的累计消费，用的是全站共用的那支格式化函数——它把金额四舍五入到元，8432.5 会印成 ¥8,433。
• 而这个文件的文件头就写着：分红/结算金额一律两位小数精确显示，不用那支共用函数，理由是股东端和老板端对不上小数就是「数字对不上号」的信任问题。
• 那条规矩当初只套在分红和结算那几格，这一格漏了。现在改用本文件自己的两位小数函数。
• 窄屏卡片和宽屏表格是同一份数据的两个渲染，两处都改了——只改一边的症状是「换个屏幕宽度数字就变了」，没有任何测试会说话。

股东与分红

会员页：读不到的时候不再说「没有」，两个同名的「新客」讲清楚了，周报不再说「本周」

• 会员列表读不到时以前印「还没有会员资料」；从分群点进来时印「该分群目前没有会员」——而旁边那张分群卡正写着 1。同一屏自相矛盾，而读的人会相信更具体的那句。现在会说「这次没读到会员资料——不是『没有会员』」。
• 预登记、标签目录、会员洞察（生日/沉默/流失）三处同类，一并修好。其中会员洞察那条补偿横幅原本只守两支查询，而它上面的渲染开关吃三支——流失预警掛掉时横幅和区块同时静音，连重试按钮都不会去重读它。
• 同一页上有两个「新客」，一个 4 一个 1，相隔六个区块，原本一个字都没说明。周报的「新客」看注册日期，分群的「新客尝鲜」看到店次数，而且会重叠——同一个人可能两边都算。三处补齐：指标小字、分群提示、口径说明新增一条。
• 周报卡以前叫「本周会员周报」，而它的窗口是滚动 7 天不是自然周，且每周一生成一次之后整周读同一份——周五第一次打开的话，看到的是「周五往前 7 天」那份。改名「近 7 天会员周报」并写明这件事；「较上周」改成直接印后端给的日期区间。
• 「积分发放」的主值以前是裸数字 15282，而同一张卡的环比是 +15,282，两种格式。已统一。
• 六个繁体标签改回简体（活跃会员 / 储值(含赠金) / 积分发放 / 生日名单导出 ×2 / 导出 CSV）。

股东与分红

客人页催你「记得使用」积分，而客人端没有一个地方能用它

• 扫码点单的客人打开「我的积分/储值」，看到「N 积分将在 30 天内到期，记得使用」——而积分抵扣只存在于收银员的屏幕上，客人自己没有任何入口。现在这句话改成讲真话：结账时跟服务员说一声就能抵现，这里不能自己兑换。
• 储值余额以前用的是会把角分吃掉的格式化方式，¥100.50 会显示成 ¥100.5。这是客人自己的钱，他会拿来跟小票对账。现在固定两位小数加千分位。
• 网络不稳时这张卡片以前会整个空白——没有数字也没有任何说明，而客人对「没看到」的默认解释是「我没有」。现在会说「这次没读到你的积分和储值——不是『你没有』」并给重试。
• 后台会员周报一直在说「积分只进不出，建议查兑换门槛」。兑换门槛不是原因，没有客人端的兑换画面才是——这条建议指向了一个调得动的旋钮，而真正缺的是一个不存在的页面。

股东与分红

分红页读不到数据的时候，不再假装「你没有」——七处

• 网络或后端出问题时，这一页以前会把「读不到」印成肯定句：「还没有上一期」「还没有确认过任何一期分红」「累计提现占用合计 ¥0.00」「本月成本确认（0 项）」。现在它们各自会说「读不到」。
• 最要紧的一句是「本店目前没有周期性成本项目，无需确认即可视为成本已核完」——这句主动宣告一道保护可以跳过，而同一段的开场白写着「帐不实不分钱」。现在读不到时它不会出现。
• 「累计 pending 分红合计」和「累计提现占用合计」是一对要老板拿去相减的数，以前只有左边那个会说「我不知道」。现在任一边读不到，旁边就会告诉你现在不能相减。
• 判准统一成一句：只有手上真的握着数据，才可以说「没有」。

股东与分红成本与毛利

分红损益表上两个「¥0」其实是「还没算」，现在它们会自己说出来

• 「固定成本 ¥0」——真实意思是「这个月的成本还没核对完」。那家店明明登记着每月房租和人力，画面上却是一个零。现在显示「本月未核对」，并告诉你目前已核对的部分是多少。
• 「累计亏损（月初）¥0」——真实意思是「还没有确认过更早的分红，没有可结转的余额」。现在显示「还没有上一期」，并写明这不等于「亏损是 0」。
• 这两格的下游就是分钱：累计亏损 → 本月补亏 → 可分配利润。把「没量到」印成 0，等于凭空抹掉一笔成本或一笔亏损，多分出去的钱是真的。
• 同一张表上另外三个零查过了：员工酒水提成、定台提成是真实聚合出来的零，保持原样；其他支出还在议。

股东与分红成本与毛利

分红损益表的金额没有千分位，而同一个数字在老板首页有

• 股权分红那张损益表里的五位数金额，以前是后端回什么就印什么，没有千分位——同一笔钱在老板首页是带逗号的，两个页面看起来像两个数。
• 这是老板决定这个月分多少钱的那一页，少一个逗号就容易把一个数看错一个量级。
• 逗号只加在整数部分，小数原样保留：角分是真的钱，不能被格式化吃掉。

股东与分红

没设置营业时间的店，不会再被显示成「营业中」

• 顾客中心「门店信息」右侧原本永远显示「营业中」，即使这家店从来没有设置过营业时间。
• 现在没设置营业时间的店不显示这个标记——不做没查证过的断言；设置过的店照常显示「营业中」或「已打烊」。

「我的优惠券」看不到券时，主按钮直接带你去认领会员

• 以前这页说明里写着「去『我的会员』认领一下」，但唯一的按钮是「返回」——说了路在哪，却不给路。
• 现在主按钮是「去认领会员」，点了直接到认领页；「返回」降成一行小字。

自助订位可以填「怎么称呼您」，店家不再拿到一串手机号当姓名

• 自助订位表单多了「怎么称呼您」，排在联系电话前面，必填。
• 以前没有这一栏，后端拿不到姓名就把手机号当成联系人写进去——店员看到的订位「联系人」是一串号码。
• 桌边那句「这桌有一组预订」也因此能显示真正的姓氏，而不是一个认不出来的遮罩串。

老板首屏的 AI 早报把「毛利掉了 35 个百分点」说成「低 0.0 个百分点」——已上线修复

• 走查店实测:毛利从 94.3% 掉到 58.8%(少了 35.5 个百分点),而首屏那句话写「毛利较上期低 **0.0** 个百分点,3 个品项是这期毛利偏低的主因」——既说没变、又指认了元凶。
• 根因:那个字段名字叫 points(百分点),装的却是比率。同一个文件里另外三处「个百分点」都乘了 100,只有这一句没有,整整少讲 100 倍。
• 🔴 这个修法**早就写好并合进主干了**,一直没有部署 —— 缺陷在正式机上又活了一段时间,而代码库里它已经是修好的状态。
• 已部署并实测:同一支接口现在回「毛利较上期低 35.5 个百分点」。
• ⚠️ 同一次实测里冒出同族的下一个:一个品项写「拖累店级毛利约 62.7 个百分点」而总计只有 35.5 —— 部分大于全体。已转给该模块的人,本条不含它。

「我存的酒」看不到记录时，会直接带你去认领会员

• 以前这里说「只对已认领会员开放，或者这家店暂时还没上线这个功能」——两个理由并排，客人分不出自己属于哪一种。
• 其中「这家店没上线」这条在后端根本不存在，看不到记录只可能是还没认领会员。
• 现在只讲真正的原因，并且主按钮变成「去认领会员」，点了直接到认领页；「返回订单」降成一行小字。

顾客中心首页的待结金额，也会说明结账时还要另计服务费

• 扫码后的顾客中心首页，待结金额下面会多一句「结账时另计服务费等」。
• 以前这里只印一个金额，看起来像最终要付的钱，其实低消补足和服务费要到结账那一刻才算。
• 没有这类费用的店、以及已经结账的单，不显示这句话。

后台「咨客台」和「会计」两个入口修好了——它们的代码在，但打开它们的那把钥匙没接上

• 咨客台整页(759 行)、会计页、以及两条侧边栏入口,都已经合进主干。但**算「你有没有权限看到它」的那段代码,三个权限位一个都没接**——结果是这两页对任何人都不出现,而且不会报任何错。
• 同一批还有「接手未结单」:按钮会派发两个动作,而处理动作的地方不认得它们。
• 🔴 更值得记的是判断方式:**干净的主干编译不过(5 个错),而大家日常工作的那棵共享目录是通过的** —— 方向跟直觉相反。补齐它的那半只存在于共享目录的未提交文件里,是我昨天做的快照分支唯一留着它。
• 有一个「类型通过了而错误搬到线上」的岔路我没走:接手的单子在界面上叫 adopted,而后端的服务通道只收 堂食/吧台/外带 三种(实读了后端的定义,不是推测)。把 adopted 加进类型会让编译变绿,然后把一个后端不认识的值送上正式机。正解是对接手的单子不送这个字段——那张单在服务器上早就有自己的通道。
• 已部署并在线上确认:侧边栏 54 个图标、咨客台、会计三样都服务得到。
• 同一天在小程序那半找到更大的一批:干净主干的小程序类型检查 **53 个错**,而大家日常用的共享目录只有 16 个 —— 又是「用的人合进来了、提供的人没合进来」。
• 缺的东西具体是:两个界面组件整个文件不在、一个工具文件不在、19 支页面「被别人 import 却没有导出自己那一块」、五个共用组件少了新增的几个属性。
• 已全部补齐,53 → 0。收敛过程是一步一量(53→46→29→14→2→1→0),不是一次全换 —— 每个文件都先确认「主干有而快照没有的导出」是空的(也就是快照是超集)才取。
• ⚠️ 最后一个我没有照抄:快照那版有一处泛型参数省略了,照抄会留一个错。按库里既有的写法修,理由写在代码注释里。
• ⚠️ 记录一次我自己的失误:写这条记录时我按「取第一条」去更新,而这个编号当天被两个人各领了一次,第一条是别人的。我把上面几条写进了别人的记录里。已还原并改到这条。**定位记录要按标题,不要按顺序。**
• ⚠️ 票号订正:这条原本写成 T-2547,而那个号是别人 01:00Z 在公告板上领的。我算了「板上最大号 +1」却**没有在板上写下领号那一行**,也没查那个号是谁领的 —— 撞号的第二种:没领就用。已按协定补领 T-2550(写完立刻重读确认自己是唯一持有者)。

库存「状态」对大多数商品只会说一句「充足」——因为它们根本没设安全水位

• 没设安全水位的商品，以前会被算成「充足」。没有那条线，系统其实判断不了它够不够。
• 现在这些商品显示「未设水位」，并且可以单独筛出来一次补完。
• 「缺货」不受影响——库存为 0 不需要水位也判断得出来。
• 多个仓库合并看同一个商品时，改成取最严重的那个状态，不会被「没设水位」盖掉真的偏低。
• 「未设水位」刻意不计进首页的「要留意几项」——那是没配置，不是快没货，混在一起会让那个数字大到没人再看。

进销存

AI 晨报把 0.2 个百分点的毛利变化讲成「较上期低 0.0 个百分点」,还替它点了 3 个元凶

• 老板首屏的 AI 晨报会印出「毛利较上期低 0.0 个百分点,3 个品项是这期毛利偏低的主因」——同一句话既说没变、又指认了元凶。
• 真实的变化其实是 0.2 个百分点:这句话把一个 0~1 的比率当成百分点直接印,少乘了 100。同一个数字在利润归因页上是对的,只有晨报这句话算错。
• 改法:印不出来的幅度就不宣称方向,整句换成中性叙述(不加「几乎持平但…」这种但书),真的有下降时照样说得出「低 1.3 个百分点」。
• 同一族的另外两句也一起修了:归因卡的「拖累店级毛利约 0.0 个百分点」改印真实上界;损耗卡的「损耗率 0.0%,是店均(0.0%)的 2.5 倍」改印「<0.1%」。
• 还没上线,等合并进主干后随下一次部署生效。

AI 工作台生意诊断

首页「今日估算净利」说「未含人力」，而固定成本里那笔人力其实已经扣了

• 人力有两个入口:按工时算的(打卡×时薪),和你在固定成本里直接填的那一笔。
• 以前这句话只看前者。所以在固定成本里填了人力的店,画面说「未含人力」,而人力已经扣掉一部分了——老板会再加一次,把净利想得更差。
• 现在分四种情况各说各的话:完全没算 / 只算了固定那笔 / 按工时算了 / 两条路都算了。
• 最后一种是数字本身重复扣,页面会直接说出来并给一个可点的下一步:去成本页删掉其中一笔。
• 顺带修掉一句会制造问题的提示:以前对「已经在固定成本里填了人力」的店也催你去设时薪,照做就会变成重复计算。

财务/日结/流水成本与毛利

股東月卡用白話說明「分紅金額以分紅試算為準（扣成本與提成）」

• 股東在月卡上看到的數字是**展示口徑**（不扣成本與提成），與實際決定分紅金額的算法**不同源**。
• 卡片上現在明寫：「**本卡為快速一覽；分紅金額以分紅試算為準（扣成本與提成）。**」，並標示「展示口徑」。
• 沒有新增任何連結或權限（股東端不需要多開權限就看得懂）。

股东与分红