顾客端、员工 APP 与微信小程序能力说明

当前正式支持的入口

ZenTea 当前商用移动交付以 Android 员工 APP、员工微信小程序和顾客 H5/桌码端为准。iOS 与 HarmonyOS NEXT 在工程中保留兼容空间，但不是当前文档可以承诺的已验收生产平台；正式上线前必须以对应版本的发布验收记录为准。

顾客端用于查看已开放的商品、寄存、预约、桌码点单和电子茶礼等自助流程；员工移动端用于授权门店内的开单、库存、茶馆、扫码、查询和打印队列操作。经营模式、岗位权限、门店/仓库范围、备份恢复、岗位配置和深度报表仍以 PC 管理后台为准。

登录、授权与门店范围

员工 APP 和员工微信小程序使用同一账号体系，岗位和授权门店由 PC 端配置，后端会在每次请求再次校验。顾客账号与员工账号分离；顾客端只能看到管理员开放的门店、商品和本人业务，不会因为知道桌码或网页地址获得后台数据。

修改岗位、门店或许可证后，先让账号退出并重新登录。能看到入口不等于一定能提交，后端仍会检查许可证、岗位动作、数据范围和单据状态。

设备能力和打印边界

扫码使用系统相机能力；拒绝相机权限时可以搜索或手工输入编码。当前移动端已经可用且适合生产的打印路径是服务端代理打印：老板在 PC“系统管理 → 打印中心”创建并绑定当前门店代理打印机，员工在 APP 选择该设备并查看打印队列。

APP 中的 WiFi/LAN 原生 TCP 打印和蓝牙直连入口属于配置/兼容预留，当前代码会明确提示“尚未接入”或“需要 Android 真机插件验证”，不能把它们写成已完成的生产能力。微信小程序和浏览器也不能通过前端开关绕过平台设备限制。

弱网和重复提交

提交订单、收款、取号或退款超时后，先查询原业务单和打印队列状态，再决定是否重试。页面显示失败不一定表示服务端没有处理；不要连续点击高风险操作。记录门店、账号、时间、业务单号和请求编号后再诊断。

上线验收

1. 用财务、库管、销售和普通业务岗位账号分别登录 Android APP 与员工微信小程序，核对岗位、门店和入口；不要用老板账号代替边界测试。
2. 测试扫码失败后的手工搜索、弱网超时后的状态查询，以及业务保存后进入服务端打印队列。
3. 用顾客测试账号验证商品、寄存、预约、桌码点单和电子茶礼只展示已开放门店及本人数据。
4. 拒绝相机、通知或蓝牙权限后，确认普通业务仍可使用，并能从系统设置重新授权；不要把权限拒绝当成后端岗位授权。

记录客户端版本、手机系统、门店、账号岗位和失败请求编号。未完成真机或微信审核的能力，不得在客户上线清单中标记为“已验收”。