如果断网或云端不可用

连接可能中断：运营商、路由器、雷暴、运营商故障。门店不会因此停业——客人还在收银台前排队。以下是哪些功能继续可用、哪些不可用，以及班次该怎么做。

请区分两种故障，因为它们的表现不同：

发生了什么	门店内的收银	街上的客人
门店断网	离线工作：可结账、打印、累积队列	展示页可以打开（由 CDN 分发），订单会发往云端——但门店只有在连接恢复后才能看到
云端不可用	同样如此：收银无法区分两者——对它来说都是“记录未发送”	展示页可能从缓存打开，下单和支付无法完成

收银有意不去猜测原因：任何网络错误都意味着“本地工作，记录进入队列”。

哪些功能继续可用#

收银（Web POS）。 这不只是缓存的页面，而是设备上真正的记录队列：

订单可以结账并进入订单队列（在收银上保留 24 小时）；
收据和现金班次——各自的操作队列（开班、存入和取出、收据、退款、关班）。每个操作都有客户端幂等键，因此补发不会造成重复；
离线开班的班次会获得临时号码并继续工作：“没有开班禁止支付”这道关卡在离线时同样生效，它按本地缓存计算；
菜单、价格、桌子、字典从浏览器本地缓存读取——它们是在还有连接时进入缓存的；
刷新页面不会跳到登录页：收银会按本地快照以“降级会话”打开，并在网络恢复后自行重新连接。

打印。 收据、厨房小票和标签由同一台电脑上的网桥打印：收银通过本机本地地址访问它——这不需要互联网。

税控收据。 如果税控机连接到同一台电脑，收据通过网桥以同样的本地通道开具： fiscal drive 会累积文档，税务数据运营商会在连接恢复后追补。对 54-FZ 来说这是常规模式，而非违规。

登录界面。 只要浏览器中还有近期的会话（窗口为 7 天），收银员就能登录并工作；发送累积数据在连接恢复时仍需要真正的授权。

没有连接时哪些功能不可用#

厨房屏幕（KDS）。 小票通过云端到达它；没有互联网，新订单不会进入厨房——它们会在连接恢复后送达。在此期间，厨房按打印小票工作（如果已配置厨房打印），或按口头传达。
银行终端。 刷卡支付需要银行授权——离线无法完成。请收取现金。
客人在线支付（展示页刷卡、桌边支付账单、自助机支付）——需要访问支付服务商。
第二台收银和服务员平板。 设备之间在局域网内不会同步：每台各自维护自己的队列并自行补发。我们有意不做统一的本地环路（“LAN 模式”）——这是产品负责人的决定：以一台收银加打印来实现自主运行。
X 报表。 中间汇总在服务器上按销售计算——离线时收银会如实拒绝。班次可以关闭，Z 报表会在连接恢复后生成。
在服务器上计算的管理后台板块——“订单”、“财务”、“统计”、“库存”、“员工”。它们读取云端，离线时最多显示最后成功读取的内容。
取餐屏、排队叫号屏、自助机——同样是云端界面。

员工该怎么做#

继续结账。 连接一断，收银上会出现琥珀色“离线”横幅和**“N 未发送”**标签。这是正常模式：订单已接受、收据已打印、钱已收取。
照常给客人打印收据。 打印是本地进行的——纸会出来。
在同一台设备和同一个浏览器上工作。 队列在这台电脑上：不能换到第二台平板“从那里补交”。
不要清除浏览器缓存、不要退出账户、不要以无痕模式打开收银——这样会抹掉未发送的订单和收据。
可以刷新页面。 队列能经受刷新和浏览器重启。
不要“以防万一”把同一笔订单结两次：系统在补发时防止重复，但两笔不同的订单会被如实计为两笔。
不要接受刷卡——终端离线无法授权。收现金，如果客人愿意——开账单稍后支付。
**红色横幅“N 未送达”**表示部分记录即使在连接恢复后也未发送（超期或服务器拒绝）。这是叫主管来的理由，而不是隐藏横幅。

连接恢复后会发生什么#

补发会自动开始——在“网络出现”事件、返回标签页时以及按定时器触发。

“N 未发送”标签会减少并消失。 订单出现在“订单”板块和厨房屏幕上，收据获得编号，库存按配方卡扣减。
不会重复。 每笔订单都有客户端标识符，每个收银操作都有幂等键；服务器识别重复，不会再次应用。
离线班次会被替换为真实班次。 临时班次号会在所有仍在队列中的收据和操作中改写为真实号码。
Z 报表会生成——针对离线关闭的班次。
不会静默删除任何内容。 无法送达的记录（超过 24 小时或服务器返回不可恢复的错误）会进入单独的“未送达”列表（保留 7 天，最多 100 条记录），并以红色横幅显示，可手动隐藏。

顺序会保持：队列按顺序补发，遇到服务器临时错误时会以递增的间隔重试。

限制#

离线仅支持收银和打印。 厨房屏幕、银行终端以及局域网内设备之间的同步在没有互联网时无法工作；我们有意不实现完整的局域网闭环。
队列与设备和浏览器绑定。 它存储在特定浏览器的存储中：另一台电脑、另一个浏览器或隐身模式都无法看到它。
队列的有效期为 24 小时，适用于订单和收银操作。超过一天没有连接，记录会进入“未送达”列表，而不是悄无声息地消失。
离线会话持续 7 天。 之后收银将要求正常登录，而没有网络就无法登录。
离线无法使用 X 报告——它在服务器上计算。
面向顾客的界面（展示页、自助终端）队列仅保留一小时——它们是为顾客移动网络短暂中断而设计的，而非无互联网工作。
Android 收银。 离线接单和本地税控收据可以工作，但离线写入收据登记簿和现金班次尚不支持（已计划）。离线状态下，税控存储器是事实来源。
在真实税控机上进行的“拔掉网线”端到端测试尚未完成。 收银的离线模式已通过代码和自动化测试覆盖（包括“会话内离线”的 e2e 测试），但由所有者在实际硬件上进行的验证仍在计划中——我们直言这一点，而不是把它说成已经完成。

故障排除#

收银要求登录，尽管之前一直能用。 会话已超过七天，或者浏览器被清理过。没有网络无法登录——请恢复连接。

“N 条未发送”的标签不减少。 检查连接是否确实恢复（打开任意网站），并保持收银标签页处于活动状态：补发会在网络事件、返回标签页和定时器触发时进行。如果标签停留在同一个数字——请查看红色横幅：部分记录可能已进入“未送达”。

出现红色横幅“N 条未送达”。 记录未被服务器接受：要么超过了一天期限，要么响应不可恢复（例如访问被撤销）。此列表中的订单和收据需要手动处理——请对照该班次的纸质收据。

订单在离线状态下打出，但厨房没有。 这是正常的：票据会在连接恢复时发送到厨房屏幕。在没有网络时，厨房依靠打印的票据运作。

离线时收据无法打印。 这说明问题不在互联网：请检查此电脑上的网桥是否已启动，打印机是否已连接——Cenaly Hardware Bridge。网桥和收银在同一台机器内通信。

连接恢复后出现重复订单。 补发不会产生重复——请检查是否手动将同一订单打了两遍，并在“订单”部分取消多余的那个。

常见问题#

收银没有互联网能工作吗？#

可以：它能打出订单、打印收据，并通过同一台电脑上的网桥进行税控。所有需要上传到云端的内容都会在设备上的队列中累积，并自动补发。

数据会丢失吗？#

不会。队列能经受页面刷新和浏览器重启，而未能送达的内容会进入可见的“未送达”列表，而不是消失。只有手动清理浏览器数据才会丢失它。

可以根据 54-FZ 离线打印收据吗？#

可以，如果税控机连接到与网桥相同的电脑：税控存储器会累积文档，并在连接恢复时将其传送给税务数据运营商。这是法律规定的模式。

为什么厨房屏幕不工作？#

票据通过云端传输。我们的收银和厨房屏幕之间没有局域网——这是有意的决定：我们实现的是收银加打印的自主性，而不是整个门店。在没有网络时，厨房依靠打印的票据运作。

在我们没有互联网时，顾客能打开菜单吗？#

可以——展示页由 CDN 分发，不依赖您的互联网。顾客下的订单会到达云端，但在门店中，您只有在连接恢复后才能看到它。

刷卡支付怎么办？#

接受现金：银行终端需要在银行进行授权。

收银没有连接能坚持多久？#

订单和收银操作的队列为一天，会话为七天。实际意味着：您可以安心完成一个班次。