这是掌中易 SaaS 在现场最末端的作业终端——跑在工业一体秤（10.1″–21.5″ 触摸屏）上，把生鲜/食材配送的「订单明细 → 逐条称重 → 打标签 → 回写系统」连成闭环。桌面端有 zzy-python-desktop、Web 有 zzy-saas-web-mch-js，本 App 补的是分拣员手上那一环。
真实场景是：同一个商品被几十上百个客户同时订购且数量各异，分拣员要逐个客户称出来、打一张能看出给谁 / 放哪个货位 / 走哪条线路的标签贴上去，装车时按货位归堆。没有系统时靠手写纸单，痛点是重量靠估、标签信息不全、漏称漏打无法追溯。
主链路
三层页面：登录 → 商品管理（选商户/ERP 分类/商品，看已打未打条数与数量）→ 分拣称重台（该商品下所有客户明细卡片，逐个称重打标）→ 本地打印日志 + 异步回写后端（打印次数 + 实际重量）。
① 取重：串口自动读（秤是持续主动输出型，不轮询）→ 26 字节帧解析 → 连续 3 帧稳定才落数 → 去皮 T / 置零 Z / 停止-开始切换。
② 卡片与色卡：每张卡 = 一个客户的一条明细（[货位号]客户名）。点卡片激活称重，实时回显；三色提示 —— ≤目标绿 / ≤150% 黄 / >150% 红。
③ 打印：点卡片"打印/重打"按钮 → 超差弹确认框但仍放行（阈值默认上下 5%）→ 已打印的再确认一次 → 出标签。货位号为空或 N/A 直接禁打。防重打三重保护（全屏遮罩 + 逻辑锁 + 锁在标记完成后才释放）。
④ 回写与留痕：本地打印日志（按商户分文件，可表格查看 + 关键词/时间检索）；异步上报打印次数与实际重量，失败重试 3 次，成功后才刷新列表。
打印业务逻辑调整：
1、Android本地文件存储每次打印都记录打印日志，日志格式： 时间 商户ID 操作人 商品名称 商品单位 称重重量；
2、打印界面顶部可以查看对应商户ID（mch_id）的打印日志；
3、打印界面可以筛选称重打印和未打印商品；
4、称重过程中：商品选项卡颜色设置：称重重量小于等于商品重量为当前选择绿色色卡，称重重量大于当前重量小于超重50%为黄色色卡，称重重量大于商品重量50%色卡为红色；
5、商品卡片UI上的“操作”按钮修改为“打印”，“打印”按钮宽度调整成人大拇指方便操作，称重的显示值加粗放大，点击商品卡片的“打印”实现单张打印;
6、一键打印先隐藏，商品选项卡称重打印完成才标记已称重；
7、打印界面底部的去皮设置和清零，停止按钮移到实时称重区域；
8、UI 和当前主体保持一致；
9、打印顶部“选择称重筐”、“表头设置”、“一键分拣”、“调试”打印测试隐藏；
10、去皮克数直接去当前称重重量，没有则为“0”，同时去掉去皮克数的输入框，定量、去皮、清零、停止按钮调整大一点，“KG”按钮去掉；
11、在打印界面添加打印重量阈值上限和下限下拉弹出窗配置：
12、打印界面目标重量和实际重量不等时，需要根据打印阈值提示，打印和重打都放行，不在做任何限制为了兼容标配；
评论