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

网页结账会显示找零，套用储值后实收金额也会跟着变

• 网页默认的结账流程，现在跟小程序一样会直接显示「找零 ¥X」,不用等结完账看小票才知道。
• 结账弹窗开着时才套用储值、礼品卡或挂账，系统自动填的「实收」会跟着剩下要收的现金一起更新;收银员自己输入的金额不会被改动。这样不会算出一笔根本没收到的找零，叫收银员多找钱给客人。
• 应收金额还不确定时，照原来的规则不显示金额。
• Flutter 有同样的「实收不跟着变」问题，这次一起修好。

结账收款

用积分抵扣时，失败不会再白白扣掉客人的积分

• 结账时用会员积分抵扣，现在「扣积分」和「套上折扣」在同一步完成：要么都成功，要么都不生效。不会再出现积分已经扣掉、订单却没打折的情况。
• 订单已经在「结账中」时也能正常用积分抵扣。
• 删掉一句做不到的建议:「改用整单折扣手动补上约 ¥X」。整单折扣只有百分比档位，根本补不了这个差额。
• 网页、小程序、Flutter 三端都改用同一个新接口。

结账收款

存酒不再有「没收」:到期可以延期，或转回店里库存

• 存酒拿掉「没收」。到期的酒现在有两种处理：给客人「延期」(设新的到期日),或者「到期转回库存」(剩下的酒回到店里库存，客人之后就不能再取)。
• 延期的确认框会写清楚原到期日和新到期日;转回库存的确认框会写「这瓶酒已过期 N 天。剩余 N 瓶转回店里库存，客人之后不能再取」。只有真的过期了才能转回库存。
• 存酒列表新增「7 天内到期」筛选，在打开页面时计算，没有定时任务。已经过期但还没处理的，也会列在里面。
• 客人在「我存的酒」里看得到已经转回库存的那一瓶，排在最下面、灰色显示，写着哪一天转回。
• 延期和转回库存都要有存酒管理权限;只有查看库存权限的人看不到这两个按钮。
• 网页、小程序、Flutter 三端都改了。

流失预警读不到时，不再说「没有需要联系的常客」

• 后台总览的「流失预警」卡：名单读取失败时，卡片照常显示，并写「流失预警读取失败，不代表没有需要联系的常客」,附重试按钮。
• 还在读取中、或这项功能没开的时候，维持原样不显示;真的读到了而且名单是空的，才不显示这张卡。

官网首页改成简单直接：是什么、要不要钱、怎么开始

• 首页只剩五段：首屏「免费的收银系统」和两个按钮(免费开店、先看演示店);能做什么(6 行);酒吧用得上的(4 行);费用加 3 个常见问题(要买设备吗、能从现在的系统换过来吗、数据安全吗);结尾。
• 新增「全部功能」页 /features/,完整功能清单搬到这里。
• 删掉演示动画、自造词和比喻句(管家、五柱、雷达、口径、满血等)、首页的「最近更新」和对比表。
• 每一句都对照过代码：例如微信、支付宝写明「用你店里原来的收款码」,简报写「打开后台就有」而不是「每天早上推送」,换系统写「商品和会员可以用表格导入」。

打烊后的提示在读不到桌况时，不再硬说「是还没打烊」

• 网页：桌况读不到或还在读取时，打烊提示拿掉「不是没做生意，是还没打烊」这句没有根据的话。
• 小程序：同一个情况改用已有的「桌况读不到」说法，跟同一页的其他提示一致。

结账时会员资料读不到，储值和积分不再被当成 0

• 结账弹窗里，会员资料读取失败或还在读取时，储值余额和积分那两处改成显示「会员资料读不到」的提醒，不再显示 0,也不再按 0 去计算能抵多少。
• 真正超额的情况(例如储值不够扣)仍然显示原来的红色错误提示，跟「读不到」分开。

结账收款

预订、翻台、分红、月结、合伙出资、提成、库存、存酒等页面读不到数据时,不再显示成「没有」或 0

• 预订页、翻台效率:数据一时读不到时,以前会显示成「今天没有预订」或空白的效率表;现在显示「读取失败」加重试。
• 分红页:分红记录读不到时,以前按钮可能照常可按;现在读不到就停用「确认分红」,读到了才恢复。
• 月结交接、合伙出资总览:读不到时不再显示成「没有待办」或金额 0。
• 咨客台、提成明细:读不到时不再显示成「没有人」「没有提成」。
• 库存页、存酒页:读不到时不再显示成「没有记录」,改为读取失败加重试。

结账「拆分收款」在应收金额不确定时,不再让收银员照着一个可能算错的数字操作

• 订金/低消/积分兑换比例任一读不到时,「拆分收款」的入口按钮(不管是默认结账路径还是切到扫码/刷卡通道收款那条路径下的)现在会停用,并且有一句可见的提示说明原因,不再是一颗看起来正常却按了没反应的按钮。
• 已经点进拆分收款面板、正在分单据每一份要付多少的时候,如果这时应收金额变得不确定:标题从显示金额改成「应收未确定」,每一份的金额输入框和快捷加减按钮(+¥10/20/50/100/清零)全部停用,「已分配/应收」核对那一行不再下「对不对得上」的结论,改成一句警示,避免把一个用错误金额算出来的「配平了」或「差多少」当真话讲给收银员听。

结账收款

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

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

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

App(iOS/Android/macOS)选桌页面读不到桌台清单时,不再悄悄显示成本店没有桌台,统一先说读取失败再给重试

• 选桌页面——以前读不到桌台清单时会直接显示「本店暂无桌台」,看起来跟「这家店真的没有设置任何桌台」一模一样;现在读不到就换成「桌台读不到——不是没有桌台」加一个重试按钮,同时「一键清台」旁边的数量也老实显示成「—」,不会看起来像「没有要清的桌」。读失败但手上有上一次读到的旧桌台清单时,桌台图照常显示,只在最上面加一条提示,说明这是旧数据、当前读取失败。

老板首页开台数、选桌页面、客人扫码点单页读不到桌台清单时,不再悄悄当成确定的数字或没有桌台,统一先说读取失败再给重试;结账最低消费门槛读不到时也不再悄悄当成没有门槛

• 老板首页「此刻脉搏」区块的开台中/在店客人/待结账/开台未结这四个数字——以前读不到桌台清单时会静默沿用一套只看时间的旧判断,首次读取失败时这四个数字会直接显示成 0 或 ¥0,看起来像「现在完全没有生意」;现在读不到就统一显示「—」,读取中显示「…」,读失败但手上还有上一次读到的旧数字时数字照常显示、加一个「旧数据」标记。
• 选桌(桌台图)页面——以前读不到桌台清单时,不管是平面图还是列表视图都会直接画成空的,看起来跟「这家店真的没有设置任何桌台」一模一样;现在读不到就换成一句「桌台读不到——不是没有桌台」加一个重试按钮,不会误导成本店没有桌台;读失败但手上有上一次的旧桌台清单时,桌台图照常显示,只在最上面加一条「这是旧数据、当前读取失败」的提示。
• 客人自己扫码点单的页面——以前如果桌台信息一时读不到,桌号会退化成显示一串没有意义的服务器内部编号,而不是客人认得出来的桌号;现在读不到就老实显示「桌号暂时读不到」,不会把内部编号露给客人看。
• 结账时的最低消费门槛——以前如果桌台信息一时读不到,门槛会被悄悄当成 0 处理,可能让原本设了最低消费的桌子被当成完全没有门槛去收款;现在读不到就把「确认收款」这个按钮锁住,画面提示读取失败并给一个「重试」按钮;点单页面的合计金额旁边也会加一句「低消读不到」的提示,不会让画面看起来像「这桌明确没有低消门槛」。外卖单、吧台单本来就没有桌台、没有最低消费这个概念,这次改动确认不会误伤这两种订单。

收银结账、费用编辑、会员备注、供应商异议等多处数据读不到时,不再悄悄当空值处理,统一先挡住再给重试

• 结账时「已收订金」这个数字如果一时读不到,以前会被当成「没收过订金」,可能让客人被要求再付一次已经付过的钱;现在读不到就把收款按钮锁住,画面提示读取失败并给一个「重试」按钮,不会拿一个不确定的数字去收钱。
• 客人自己在手机上「自行付款」时是同一个订金数字、同一个风险,而且这个画面没有店员在旁边盯着;现在同样读不到就不显示金额、不给按,只提示稍候或呼叫店员。
• 编辑一笔订单的服务费/开瓶费时,如果这张单原有的费用数字一时读不到,以前会把输入框悄悄预填成 0,一旦确认就会把服务器上真实的费用直接改成 0;现在读不到就把输入框和确认按钮都锁住,不会误删已经设定好的费用。
• 应付账款页面,如果「供应商是否有异议」这份记录一时读不到,以前会当成「没有异议」处理,店员照样能替这个供应商申请付款;现在读不到就先把所有供应商的「申请付款」都锁住,等确认真的没有异议才放行,避免付款给一个其实有未解决异议的供应商。
• 会员详情页的私下备注和服务偏好,如果原有内容一时读不到,以前保存时会把这些内容悄悄覆盖成空白;现在读不到就把输入框改成只读、保存按钮锁住,不会把已经存在的备注或偏好覆盖掉。
• 会员等级管理页,如果现有等级列表一时读不到,以前新增等级可能会跟既有等级的编号撞在一起、打乱升降级顺序;现在读不到就把「新增等级」锁住,等确认列表真的读到了才能新增。
• 员工角色的权限设置页,目录读不到时原本显示「共 0 项权限可选」,把「读不到」说成了「系统里就是没有权限」;查过旧代码,保存角色这个动作本身不会把权限清空(勾选框是照着目录画出来的,目录读不到时没有勾选框可以改,新建角色时空集合本来就会被挡住存不了),这次只是把误导人的文案改成「权限目录读取失败」并给重试按钮。
• 收银台首页扫码枪扫到条码、顶栏「出餐」计数、以及零门店账号看到的「你是谁」手机号——这三处以前读不到时会分别误报「未找到这个条码对应的商品」「出餐 0(看起来像后厨已经清空)」「这个身份没有手机号」;现在改成读取中/读取失败的老实提示,顶栏「出餐」读不到时显示「—」而不是假的 0(跟同一栏「毛额」的既有做法一致)。
• 商品主档表里「本店是否上架」这一栏、成本条目「建立人」这一栏、日结页「本月待发提成」这个数字——以前读不到时分别会误显示成「未上架」「已离职/停用账号」「¥0.00」;现在改成读取中/读取失败并给重试,不冒充这三种具体结论。
• AI 财务管家「成本覆盖率」判断、库存商品的进货流水记录、应付账款的订单三方核对表——以前读不到时分别会误报「近期没有发现异常」「这件商品还没有采购收货记录」「这张采购单本来就没有品项」;现在改成老实说读取失败,不下没查过的结论。
• 商品寄存页的会员搜索、月度交接包「后端说没启用会计模块」这句提示是否属实的核对、以及前场「待取看板」——以前读不到时分别会误显示「找不到这位会员」「这句提示确实成立」「暂无待取的单」;现在改成读取失败/核对不了/看不到的老实提示。
• 开业向导里「重做」面板、「桌贴码开通进度」、「添加第一个商品」这一步——以前读不到时分别会误显示「没有可重做的品项」「进度 0/N(像没开通)」「这一步还没做」;即使店家其实已经做完,也会被显示成没做,现在改成读取失败并给重试,不会让已完成的进度看起来像没做。
• 总部集团采购单展开明细时的门店名称、以及收银结账画面的会员搜索——以前读不到时分别会误显示「未知门店」(即使是正常营业的店)和「找不到这位会员」;现在改成读取失败并给重试。
• 收银台首页顶栏「开台」这个数字——以前读不到时前端只是跳过把新数据写回画面、继续显示上一次的本地状态,首次读取失败时这个状态就是初始空值,画面上看起来跟「真的开台数是 0」一模一样;现在读不到就显示「—」而不是假的 0,读失败但手上还有上一次成功读到的旧数字时,数字照常显示、旁边加一个「旧数据」的小标记,读取中显示「…」。

订单退款记录三端一致:谁退的、什么时候、为什么都写清楚;读不到时明说读不到

• 网页、小程序、平板/手机 App 的订单详情都有一块「退款记录」,逐笔列出金额、状态(已退款/审批中/已批准·待退款/已驳回)、时间、操作人、原因。以前 App 的订单详情完全没有这块,小程序的退款那一行太长会被截断、看不到时间。
• 操作人分三种说法:有名字就写名字;账号已经删掉的写「账号已不存在」;单子上从没记过操作人的写「未记录操作人」。原因没填的写「未填写原因」,不会空着。已驳回的那笔金额加删除线,不算进合计。
• 退款记录读不到的时候,三端都明写「退款记录读取失败」,不会显示成「没有退款」。
• 老板首页的今日金额在小程序和 App 上都标明是「净销售 · 已扣退款」;小程序经营诊断页那个没扣退款的数字改叫「毛额」并注明「未扣退款」,跟网页的叫法一致。
• 先查过小程序和 App 的「今日/本班」金额:都已经直接读后台的汇总数字,没有网页之前那种「自己拉单子加总、超过 200 单就少算」的问题。

收银台顶栏、财务页、交班弹窗多处「今日」数字改读后端统一聚合口径,退款明细补齐真实时间与原因

• 收银台顶栏原来标「营收」、其实显示的是毛额(标签与数值不一致),现在改成读后端统一的今日汇总接口,并把标签订正为「毛额」。
• 财务页的打印摘要与导出表格、按支付方式分桶的数字,同样改读后端同一份日结报表;此前有几种支付方式被错误合并显示,现在分开显示,退款那一格的标签也改成明确写「退款笔数」。
• AI 页的「今日摘要」卡片改用同一份后端数据,并理清了页面上「营收」与「净营收」两种说法互相冲突的地方。
• 交班弹窗里的退款数字标签改成注明是「全店范围」,作废数字标签改成注明是「当前这台设备本次开班以来」——这两个原本容易被读成同一个范围。
• 退款明细此前遇到历史数据缺口时会显示成固定的占位文字(原因写「未填写」、时间用付款时间代替、经手人用当时的收银员代替);现在改成显示每一笔退款真实的时间、方式、经手人和原因,查不到经手人时也会写明原因而不是编一个。
• 订正了后台一处代码注释里对「某个全局提示条在这个页面也能看到」的错误描述——实测这个页面走的是完全独立的另一条路由,那个提示条渲染不到这里。
• 后端三支与「今天」相关的统计快照(会员、会员周报、桌台翻台率)原本没有按门店自己设置的交班时间切分「今天」,统一改成按门店自己的设置计算——这条界面看不到变化,但会让这几类数字本身更准。
• 还没来得及换成读后端的数字(仍靠本地拉取当天记录汇总的部分)补上了「读取失败/被截断」时的明确提示,不会再悄悄显示成一个看起来正常但可能不完整的数字。

角色首页在日结报表重读失败时，不再把旧数据当成当下事实

• 网页角色首页：手上有上次读到的日结报表、但这次重读失败时，旧数字照样显示并逐项标「旧数据」，上方写「刷新失败，下面是 HH:MM 读到的旧数据」。
• 这种情况下：店长的「确认日结」挡住并写明原因;收银不再推开班或交班盘点，改为「看今天的班次」;会计不再显示「本期已关账」。

订位查询的日期参数全是空白时不再报错 500

• 订位清单的营业日、起日、迄日参数只填了空白时，一律当作没填：与新的营业日区间一起送不再报 500,单独送则回默认的日期范围。

预警中心三张卡和日结确认按钮：读不到时不再显示成 0、「没有」或照常可按

• 库存预警中心的损耗率卡读失败时数字写「读不到」，不再显示 0.0%;盘点提醒卡不再说「这家店还没有过确认盘点」，改说读不到、不确定盘过没有;进价异动卡不再显示 0 和「都在 15% 波动范围内」。
• 网页日结页：报表没读到时，「确认日结」按钮挡住并写明原因;读成功过、这次重读失败时，旧数据照样显示并标明，按钮同样挡住。
• 小程序日结：拿掉「红字错误」和「可以按的旧报表」同时出现的矛盾，照同一套判准处理。
• App 日结：下拉刷新或确认后自动重读失败时，不再只弹一次提示，改成常驻「刷新失败，下面是 HH:MM 读到的旧数据」，确认/取消确认按钮都挡住。

日期填错不再被悄悄忽略：订位、提成明细、门店资产改为直接报错

• 订位清单的营业日参数填了不合法的日期时，以前会不加任何日期条件、回传整张表的历史订位，现在直接报错并点名参数。
• 提成明细(明细、按人、按日、按类、对账五支)的起止日期填错时，以前会悄悄返回全部期间的数据，现在直接报错。
• 门店资产的购入日期、关账日期填错时：以前关账会被悄悄记成今天并直接关掉、修改会悄悄不改却回成功、不存在的日期会报 500;现在一律直接报错并点名参数，没填的照旧。
• 检查测试脚本会不会连到正式机的扫描器，补上一种原本看不到的写法，并修掉「正式机 IP 只用作请求 Host 标头」的误报;既有 586 条逐条具名记入基准，之后只挡新增。

预约页爽约统计的「近 90 天」改为真正按营业日计算，凌晨场不再算错天

• 预约页爽约统计的近 90 天区间改按营业日算：凌晨的预约归到前一个营业日(按这家店自己的换日时间)，区间两端不再有几小时误差。
• 订位清单接口新增营业日区间参数;与旧日期参数混用、日期格式不对、起日晚于迄日都会直接报错，不再悄悄返回不对的结果。