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

咨客入口改用独立模块开关（floor_hostess）

• 咨客入口原本借用桌况模块 floor_tables ⇒ 店家关掉桌况会连咨客一起关，想单独关咨客做不到（违反 WALK-181「能配置的就配置」）
• 改成独立模块 floor_hostess（label 咨客带位、group floor、defaultEnabled true、permissionAnyOf hostess:view/hostess:seat、wired true）
• 改前先验镜像：miniapp/src/data/module-registry.json 47 个模块、真的含 floor_hostess，且与仓根 module-registry.json 逐字节一致（不是只改引用指向一个不存在的 id）
• 实测：关闭 floor_hostess 后咨客入口消失（证明这个 id 真的被读，不是换了个没人读的字符串）

桌台楼面候位叫号

咨客与候位叫号收成一颗入口

• 目录原本有两颗指同一份 GET /waitlist/ 队列、同一组动作的入口（咨客／候位叫号），票面要求收成一个岗位一颗入口
• 移除「候位叫号」目录项，保留「咨客」；floor_waitlist 模块保留当能力开关
• 咨客入口的 show 保留旧闸（orders:create｜settings:organization）当 OR，避免原本靠候位页管队列的店长／服务生失去入口；代价与替代方案写在码注解里待指挥定

候位叫号桌台楼面

咨客屏：队列与桌况分开失败、模块未开要明说

• 队列与桌况原本共用一个错误，而且那个错误喂给 StaffPage 的 error=，会用错误格取代整页 children——实测 /waitlist/ 403 时连桌况一起消失
• 改成两个独立错误各自行内显示：队列读不到就说队列读不到并注明「下面的桌况与开台照常可用」
• 候位叫号模块未开时明说「排队／叫号不在这一屏」，不再留白（能力开关是 floor_waitlist）

候位叫号桌台楼面

财务页保存后重读失败：保留旧值但要说它是旧的

• 保存固定成本后重读 daily-pnl 失败原本静默保留旧 pnl——数字是旧的却看不出来
• 改成出红 Banner 并印「资料时间 HH:MM:SS · 之后没有再读到」（套用看板那条的新鲜度样板）；不清掉旧值，因为清掉等于丢掉已算好的成本资讯

老板经营看板成本与毛利

老板首页「今天的实收」读失败要出声

• fetchBossToday 原本静默吞掉所有失败；画面只是整块安静消失（老板会读成「没生意」或「系统没这功能」）
• 改成四态：没 reports:view（403/401，刻意）整块不渲染；其余失败出红 Banner「今天的实收没读到——这不等于今天没有生意」
• 更正：PM 说读失败时也会印「还没有生意记录」——查证不成立（卡片 gate 是 isBossView && bossToday，失败时 bossToday 为 null）；原本的病是安静消失，不是假断言

老板经营看板

储值套餐读不到时不再安静消失（三态分开）

• 点桌「储值」的「套餐一键充」原本三个来源长得一样：没 members:view、读失败、真的没有启用中的套餐
• 现在读失败出红 Banner 说明「先别手打金额：手打容易少给或多送赠额」并给重试；没权限明说没权限；真的没有才安静
• 顺带修一个自己造的缺陷：没权限那行第一版放在「套餐区」，而那一区要先绑定会员才渲染、绑定本身又要 members:view，所以永远看不到

礼品卡桌台楼面

待办清单读不到时不再说「今天没有要你处理的事」

• 首页待办清单如果伺服器没回应，以前会显示「今天没有要你处理的事」，店长会以为没事；现在会明说「待办清单没读到——不是今天没有要你处理的事」，并给一颗重新读取。
• 本地那几张提醒卡（生日、沉睡客、应收、流失）不受影响，照常显示。

老板经营看板

快吧／外带的未结单换一台装置就点不到了——现在可以在订单查询里作废

• 在快吧或外带开了一张还没结帐的单，如果换一台装置（或重整页面），那张单在收银台就点不到了；订单查询里看得到，但以前也没有任何动作可以做，等于卡死。
• 现在订单查询的明细里可以直接作废这种未结单（同一颗动作后端本来就支援未结帐的单，是界面少给了）。
• 有桌台的未结单不受影响（它们本来就能从桌台图找回）。

结账收款点单送厨

P0-22 C 批（小程序）：失败不再变成「没有」——已送品项/看板/负债/固定成本/仓库清单

• 代客点单：已送品项读失败时出红 Banner 明说「没读到，这不等于本单没有已送品项，先别重复点」＋重试钮（原本整块安静消失，服务生会重复点菜）
• 桌况看板：标记清洁/结账等动作成功但重抓失败时，明说「看板可能是你操作前的状态（资料时间 HH:MM:SS · 之后没有再读到），尤其别再收一次款」＋手动重新读取（原本停在操作前且一个字都不说；指挥官裁定不做自动退避重试——自动重试成功会让人以为看到最新，改印新鲜度）
• 礼品卡：发卡/充值后的未核销负债重抓失败会显示「没读到，下面的数字可能是操作前的」（同档冻结那条早已修，这两处是漏改）
• 财务：固定成本/净利读不到时明说并给重试（原本「填 3 个数」与净利拆解整块安静消失，老板会以为不用录成本）
• 移仓：商品/仓库清单读不到时列出缺哪一项，并且不再出现「只有一个仓库时无需移仓」这句假空态

桌台楼面结账收款老板经营看板礼品卡进销存

咨客（移動端）：一屏看候位隊列與桌況，四顆動作對齊後端前置條件

• 新增「咨客」屏：待帶位隊列（叫号／过号／未到／带位）＋桌況（台型、可坐人數、低消帶來源）
• 按鈕與後端前置條件一對一：waiting→叫号、called→过号、兩態都有未到（終態）與带位；非法組合按不到
• 帶位與開台在畫面上分成兩步：帶位只記「誰坐了哪張桌」，真正開台是點那張桌開單
• 低消印結帳真的會用的數：桌级设定優先，否則標「區域預設」
• 權限碼 hostess:view／hostess:seat：沒碼看不到入口，深連結給中文說明不 bounce

桌台楼面

收银规则卡读不到税率时不再把设定覆盖成预设

• 收银规则（税率／纳税人类型／进位方式）以前读取失败会静默填上预设值——一般纳税人、13% 税率、不进位——按一次保存就把店家原本的税务设定整表覆盖。
• 现在只有「从未配置」才走预设；真正读不到会显示「配置载入失败，稍后再试」并且不显示保存钮，不会再把店家设定改掉。
• 同时清掉两个已经没人用的旧常数 import。

结账收款财务/日结/流水

积分折抵不再用前端预设汇率算钱（读不到就不放行）

• 结账时的积分折抵以前如果没读到折抵汇率，会用一个前端自带的预设值（100 分抵 1 元）去算客人折抵多少——店家若设 120 就是折太多、设 80 就是客人吃亏。
• 现在读不到汇率就明说「汇率没读到，这单先不要用积分折抵」，并给一颗重新读取；UI 与送出流程各有一道闸，不是只把入口藏起来。
• 会员页那个「可折抵 ¥X」也不会再用预设汇率报价。
• 积分规则卡的读取失败以前永远不会被判定成失败（错误被上一层吞掉），所以那段「载入失败就不显示保存钮」形同装饰；现在只有「从未配置」才算预设，真正读不到会显示失败并可重试，不会再用预设值把整张表覆盖存回。
• 顺带扫描了同类写法：另有多处设定项在读取失败时会静默落回预设值，已列出清单待修。

结账收款顾客 CRM

P0-14 複驗：日結『錢的面』與訂單收款對得上

• 日结页的收款金额不再显示为 0，会与实际收到的钱一致。
• 明细按支付方式分开列（现金/微信/支付宝等），可以核对笔数。
• 当天再收一笔款，日结数字与笔数会同步增加。

财务/日结/流水

P0-13 閉環：真員工在網頁 POS 開台會落歸屬人，收款後提成行掛對人

• 由员工账号在收银台开台时，画面会显示「归给 <开台人>」，送单后这张单的归属人就是他。
• 结账后提成明细会出现这张单的行，并挂在该员工名下。
• 由管理员账号开台的单没有归属人，也不会产生提成行（这是刻意设计，不是漏做）。

点单送厨提成/推广

P0-15 複驗：建立採購單不再 500（同一顆按鈕走完 draft→confirmed）

• 采购买手在后台按「送出(建立草稿)」不再跳出服务器内部错误，采购单会正常建立。
• 建立后可以按「确认订单」，状态从草稿变成已确认，并留下是谁确认的纪录。
• 确认采购单不会产生应付账款或收货单（承诺与负债分开）。

采购

贴一份价目表，一次把商品加完

• 「我的商品目录」里多了一颗「贴一份价目表」——微信里发的、Excel 里复制的，整段贴进去就行。
• AI 拆成一行行商品之后，**它自己不确定的那几格会被标出来并自动展开**，确定的行收着；两百个品不用重读，只看标出来的那几格。
• 改过的格子标记立刻消失，标记的意思就是「你还没看过」。
• 缺必填的行会被单独退回来并说明原因，**不影响其他行**——两百个品里六个有问题，先把一百九十四个拿到手。
• 目录还空着的时候这颗是主按钮：新开户的供货方第一件事就是把手上那份价目表弄进来。

供应商门户

点单画面与抽盘不再把「读不到」讲成「没有」

• 点单主画面：菜单读取失败时以前会显示「这个分类目前没有商品」，收银会照这句话告诉客人「没有」；现在会明说「菜单没读到」并给一颗重新读取。
• 抽盘：商品清单读不到时以前会显示「待盘品项都已录入」，等于说盘完了；现在明说读不到、并请先别抽盘。
• 同时更正两份盘点里的两条误判：少画提示标签、以及失败时整块不显示的写法，都不属于这一族（判准是「失败时会不会说出没有」，不是「有没有写错误分支」）。

点单送厨进销存

更新日志同一天里，新的排在上面了

• 同一天写进来的更新原本是「先写的在上」，于是刚做完的那几条沉到当天最后、甚至被挤到第 2 页。
• 现在同一天里最新的排最上面，首页「最近更新」那几条也跟着对了。

设定页可以把一项配置回复成「未配置」（走平台预设）

• 提成规则页的三个区块（抽哪些／员工怎么抽／谁能拿）各多一颗「回复成未配置（走平台预设）」。
• 按下去会先问一次，并写清楚后果：之后新分类会自动落平台预设，已生成的提成行不重算。
• 以前一旦存过一次就再也回不到「未配置」——现在回得去，平台预设之后的修正才到得了这家店。

提成/推广员工账号与权限

更新日志能搜了，也不再是长得看不完的一整页

• 顶上多了搜索框：想知道某块改过什么，直接搜，搜的是全部更新不只是当前这一页。
• 按时间分页，一天一段，段头写明那天出了几条——一眼看得出哪几天在密集地改。
• 打开页面时会去对一次，这一页生成之后又多的几条会补在最上面并说明。
• 左边「按模块查」现在每个模块有自己的一页，可以直接把连结发给人。