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

整单折扣金额三端算法不一致,统一由后端计算

• 结账时打整单折扣(店长特批),同样的金额和百分比,以前网页、小程序、Flutter APP 算出来的折扣金额可能不一样,现在统一由服务器算,三端显示的金额永远一致
• 连续打好几次折扣,现在是依序砍在上一刀剩下的金额上,不会重复对原价打折
• 网络不稳定时重复送出同一次打折操作,现在只会真的扣一次钱,不会因为重试或手滑连点被多扣一次折扣
• 如果同一次操作在网络异常后换了不同的折扣内容重新送出,系统会明确提示需要刷新确认,不会误把旧的结果当成新的生效

结账收款

撤销结账按钮旁加提醒,指向真正的退款入口

• 订单详情页「撤销结账」按钮旁边加一句提醒:撤销结账只会把订单退回结账中,不会把钱退给客人,要退钱请到「收款退款」
• 点击提醒里的链接会直接跳到「收款退款」页面,并自动筛选出这一张订单的收款记录、高亮显示,不用自己在列表里翻找
• 这张订单如果是几天前结的账(不在今天的收款记录范围内),会自动改用精确查询,一样能正确显示这张订单的收款和退款状态,不会被误显示成「没收过钱」

财务/日结/流水

代为交班补齐:Flutter 也能真的操作了,判准三端只剩一份

• Flutter App 之前(T-2935)只把「只有本人交得了」这句谎话止住,没有做真的操作入口;现在有代为交班权限的人在老板首页的未交班提示、日结页的未交班清单,都能直接点开「代为交班」输入现金+原因完成代关,行为跟 web/小程序一致(要写原因,必留稽核)
• web 端顺手把 ProxyCloseRow.tsx 跟老板首页(T-2935 新加的)两处各自抄的权限判准式子,合并成一支共用函式,以后改判准只用改一处、三端(web/小程序/Flutter)对应的三份不会再各自漂移

结账/交班相关金额统一显示到分,不再整元四舍五入

• 结账弹窗的找零金额改成精确到分显示,不再出现类似 ¥91.000000000000001 这种浮点误差,也不会被四舍五入成整元
• 交班/日结页面的开班现金、应有现金、实点现金、现金差异、退款金额,统一显示到分,不再有的画面到分、有的画面整元的不一致
• 现金差异趋势卡片里每一班的差异数字也改到分显示,避免几毛钱的差异被整元格式吃成看不见
• 退款弹窗的可退金额、送出按钮上的金额改成到分显示
• 收款方式明细补上「现金退款」这个中文标签,不会再看到英文原始代码
• 「本班至今 vs 上班」对比卡片:本班还没结束时不再用红色警示色显示差异,改成中性提示并加一句「本班还没结束，数字会继续变化」

Flutter App 5处「读不到」不再显示成「没有」

• 会员储值页:绑定会员的资料/本金/余额读取失败时,不再误判成「先选会员」或「没有可退本金」,改成明说读不到、可重试
• 盘点选品清单读取失败时,不再显示成「没有可选商品」
• 会员消费纪录读取失败时,不再显示成「这位会员目前没有消费纪录」
• 老板通知中心读取失败时,不再跟「今天没有待办事项」共用同一句话
• 今晨补货草稿读取失败时,不再整张卡片悄悄消失

小程序 8 处「读不到」不再显示成「没有」

• 会员消费时间线读取失败时,不再整块消失,改说读不到、可刷新重试
• 订单/活动小抄(时段价、满赠)读取失败时,不再一个字都不显示
• 部分盘点选品清单读取失败时,补上明确的错误提示
• 今晨补货草稿读取失败时,不再整张卡片悄悄消失
• 候位列表读取失败时,不再跟「目前没有人在候位」同时矛盾显示
• 开店回本进度、近7/30天营业趋势读取失败时,分别改说读不到、可刷新重试(营业趋势会区分真的没权限看跟单纯读不到两种情况)
• 股东回本进度读取失败时,改说读不到、可刷新重试,不影响同屏待发分红照常显示

未交班提示不再说「只有本人交得了」——代为交班早就有了

• 老板首页「这班开了 N 小时还没交班」的提示,原本对所有非本人的班一律说「只有 X 本人交得了」——这是过期的谎话,代为交班功能(有权限的人可以代替开班人结掉这一班,要写原因,会留记录)T-2601/T-2686 就已经上线了,只是这条提示没跟着改
• 现在:有代为交班权限的人会看到「……或你去「班次纪录」代为交班」;没有权限的人看到「……或找有代为交班权限的人」
• 结账页开班后的提醒,同一句谎话也改掉:「打烊前记得回来交班；你没空交的话，有「代为交班」权限的人可以代交（要写原因、会留记录）」
• Flutter App 同一句话也改了;Flutter 目前还没有代为交班的实际按钮(这是下一步要补的功能缺口),先止住说谎的文案

小程序开票页403权限不足不再误显示成0笔申请

• 开票申请页以前读取失败(比如账号在这家店没有看开票的权限)会显示成「还没有开票申请」,跟真的没有申请长得一模一样;现在权限不够会明确显示「没有权限」,其他读取失败(比如断网)会显示「读不到,不是没有」并给一个刷新重试按钮。

小程序补齐8项与网页端的一致性缺口(挂账/日结/现金流水/开票/订单)

• 开票申请、挂账列表以前只拉第一页(开票100笔、挂账50笔),超过这个数量后面的悄悄消失,现在会自动翻页拿完整份清单。
• 只能看到自己班次的账号,以前「今日班次」页面会让人误以为看的是全店范围,现在会明确提示只看得到自己的班次。
• 日结「今天」这块以前看不到是谁确认/取消确认的,现在跟「历史」分页一样显示姓名。
• 现金进出记录、挂账、开票申请以前都看不出经手人是谁,现在会显示姓名;挂账单号现在能点进去看订单详情;开票申请标记已开后能看到开票时间。
• 订单详情新增退款记录列表(单号、经手人、时间、金额、原因);会员标签现在能点进去看会员档案。
• 现金进出记录读取失败时,以前会跟「这一班本来就没有记录」显示成同一句话,现在能区分出是读取失败(会提示重试)还是真的没有记录。

点单送厨成本与毛利顾客 CRM

督导端(Flutter)班次范围说真话、开票清单不再只拿第一页、日结和现金流水标出经手人

• 班次页不再写死「全店进行中」:按后端返回的可见范围显示;只看得到自己的班次时明说,读不到范围时说读不到,不假装是全店。
• 开票清单翻完全部分页,任何一页读失败就整体报错,不再只显示前 100 笔。
• 日结横幅显示确认人/重开人和时间;现金流水每笔显示操作人(读不到显示「—」,不省略,免得代做的一笔被当成本人做的)。
• 开票记录显示经手人和开票时间;运营异常中心显示生成时间。

固定薪资/时薪重复计算警语改准了:两个页面现在用同一套后端判断

• 成本页里「固定薪资和时薪工资可能被算两次」这句警语,以前不管本期有没有人真的在领时薪都会显示——现在改成后端真的算过才显示:本期真有未关联员工的固定薪资项目、且真有人在打卡领时薪,两个条件都成立才提醒,少了一个都不提醒
• 同一个判断现在跟股权分红确认页共用同一套后端逻辑,两个页面对同一家店、同一个月的判断保证一致,不会一边说有风险、另一边说没有
• 警语下面直接列出两份清单:本期有打卡时薪记录的是谁、还没关联到员工的固定薪资是哪几笔,方便直接去处理,不用自己猜
• 如果这项判断本身读取失败,页面会明说读不到、不代表没有风险,不会因为数据没读到就当成安全

沽清/恢复零确认改直接切换，长按与点击两种手势各自讲对应话术

• 店长/员工在商品管理页把一支商品标成沽清或恢复销售，不再需要先跳出一个确认框才能操作——按一次(或长按清单列)就直接生效，成功后用一句提示告诉你怎么撤销
• 清单列长按跟编辑抽屉里的按钮是两个不同的入口，提示话术依你实际做的手势分开讲:按钮点击说「再点一次恢复」，长按清单说「再长按可恢复」(跟点单页既有的长按沽清是同一种说法)；恢复销售那句提示两个入口共用同一句，不受影响
• 移除这个确认框的理由:它属于'可撤销、按错能马上按回来'的动作，不属于系统规定要问一次的三类(不可逆/动到钱/改别人的权限)之一，硬留着确认反而是把'防误触'包装成了不合身的分类
• 同一轮顺手处理的内部维护:合并闸门里管这条规矩的脚本新增了一张'输入防呆'例外清单(跟三类分类是两回事)，把盘点存货页一支'数字跟账面差太多才问、问完还能改'的确认收进去；一支验证用的 e2e 测试因为环境限制暂时跳过测试而非重写；清理了一个全端零呼叫端的历史遗留函式

App 的今晚订台和候位清单可以点「查看完整号码」

• 订位清单、候位清单的联系电话旁新增「查看完整号码」按钮，点开显示完整号码，再点「隐藏」切回遮蔽。
• 按钮只对有「查看完整手机号」权限的人显示；错误提示（被限流、没权限）逐字显示后端返回的话。
• 补上候位清单的取号接口调用；清单逐行用各自的数据编号做 key，避免重排后一行揭开的号码出现在另一行。

订位管理候位叫号

下架商品不再误报「已下架」成功,采购退货驳回补上后果警语

• 商品下架被后端挡下(这个商品还有生效配方/库存/活动)时,原本会一边跳出「仍要强制下架」的决定画面,一边同时显示「已下架」成功提示——商品其实根本没停,现在这种情况下不会再显示假成功
• 选「仍要强制下架」真的执行之后,才会显示真正的成功提示
• 采购退货被驳回时,补上一句提醒:驳回后这批货不会退还给供应商,要再退货得重新发起一张退货单

空态说谎:29条读取失败被误当没有数据,补isError三态显示

• 全站排查出29处「读不到数据」跟「真的没有数据」被当成同一种画面处理——数据请求失败时(权限不够、网络问题、后端错误),用户看到的是「没有xxx」「目前没有需要关注的事项」这类肯定句,以为是真的空,实际上系统根本没读到。逐一改成三种状态分开显示:读取中、读取失败(明确提示+建议刷新重试)、真的是空。
• 本次先落地子任务(b):15处需要重建三态逻辑或补上游信号的复杂修法,包含通知铃(聚合7支查询的失败信号)、供应商入驻申请审核(呼叫端把失败静默转成空清单)等跨层级的修法。另一个子任务(a,15处机械型的加错误判断)另开变更记录。

收款結帳低消讀不到時不當事實顯示,成本頁刪確認框改行內,三端矩陣補6節點

• 收銀結帳頁(PayModal)的「低消门槛」这一行,原本读不到服务端核定数字时会静静显示本地估算值,收银员看不出这行数字是伺服器核定过的还是本地猜的。现在读不到时改印一句诚实的错误提示,不再假装是确定的数字;不影响结账本身(结账时仍会以服务端核定为准)。
• 成本页(AdminCosts)删除一笔固定成本时用的是浏览器原生弹窗,现在改成跟本站其他删除动作一致的行内确认写法,文案不变。
• 顺手把老板首页/AI 分析/挂账/会计/咨客台/我的账号这6个较晚加入侧栏的功能,补进三端(web/小程序/督导App)对齐核对表。

点单送厨成本与毛利

咨客可以直接开台、并桌、不占桌入座，开错的空台自己能撤销

• 小程序咨客页：有「带位开台」权限的人点空桌就能开台（只开台不点菜，填人数和客源）；带位时点空桌＝开台并把客人从队列划掉，桌况立刻变成用餐中。
• 带位时点使用中的桌＝并到那桌，人数自动加上；客人坐吧台站位或自己找到位子，可以按「不占桌入座」只划掉队列。
• 还没点菜的单，开台的人可以「撤销开台」，桌子变回空桌、单子记为作废；点过菜的仍要找有「作废」权限的人。
• 桌卡显示「N 位 · 几点开台」；点使用中的桌可以改人数或撤销。
• 网页咨客台同步：先开单再划候位（开台失败时客人不会从队列消失）、不占桌入座不再带桌号、台中页加撤销开台，页面上的权限码与开发用语清掉。
• 督导端（Flutter）同步：候位看板带位点空桌＝开台、点使用中的桌＝并桌、不占桌入座；收银桌况长按加「撤销开台（还没点菜）」，「改人数」只给有带位开台或开台点单权限的人。

咨客带位

薪资方式(时薪/固定月薪)改为员工属性:结构性解决同一员工工资重复计入分红/净利

• 员工的薪资方式(打卡算时薪 / 拿固定月薪 / 不计工资)现在是这个员工在这家店的一个正式属性,在员工薪资设置页(web/小程序)可以直接设置。设成「固定月薪」的员工,打卡只用来记出勤,系统不会再按小时另外扣一笔工资;设成「不计工资」的员工(比如老板本人、股东)完全不产生工资成本。这从结构上让「同一个人的工资被算两次」这件事变得不可能发生,不用再靠人工核对(过渡期措施T-2891的核对清单还留着,当作双保险)。
• 固定月薪按自然月天数分摊到每一天,保证「每天分摊金额加总=整月固定月薪」分毫不差(最后一天吸收尾差),跟日结页/成本页月损益既有的口径完全一致。日结页、老板首页、情景模拟、股权分红预览/确认、老板首页摘要卡这五处会扣人力成本的地方,全部改成读同一个后端权威计算,不再各自维护一套判断。
• 如果店里有些员工的薪资方式还没设置(既有旧数据),受影响的地方现在会明确列出「这些人的工资算不出来」,不会悄悄当成0或悄悄跳过——宁可显示「未知」也不要显示一个错的数字。

成本与毛利股东与分红

督导端(Flutter):股权分红确认新增「重复计入」核对清单

• 督导端(Flutter运营App)的股权分红确认弹窗,跟web/小程序(T-2891)对齐:确认前会列出「本期有打卡时薪、又可能拿了固定薪资」的员工名单,以及店里本期记的固定薪资笔数,并要求勾选「已核对无重复」才能继续确认分红。
• 这张票是过渡期措施,让督导在根本解法(T-2894,把薪资方式改成员工属性)上线前,分红前多一道人工核对,避免同一个人的工资被重复扣两次导致分红金额算错。

股东与分红

分红确认页补重复计算人工核对清单+必勾确认(web/小程序,Flutter待补)

• 股权分红的预览/确认页(web、小程序)现在会列出两份清单:本期有打卡时薪记录的员工姓名,以及payroll类固定成本明细;按下「确认分配」前要先勾选「已核对,固定薪资与打卡时薪没有重复计算」才能送出,后端也会验证这个确认,不是只靠前端画面挡。
• 背景:如果店里某个员工同时被记了固定薪资、又有打卡时薪记录,系统原本会把这个人的工资算两次,导致分给股东的可分配利润被低估。目前资料模型还没办法让系统自动比对,所以先靠人工核对这一步过渡,根本解(把薪资方式变成员工自己的属性)正在另一张票开发。
• Flutter端(总部/督导App)的确认分红入口目前还没有补上这个核对步骤,会被后端新加的检查挡下、显示错误讯息,不会误发生分红。这是暂时的空窗,目前全平台没有真实商户使用,补齐前不影响任何人。

股东与分红