PosPal · 酒吧业态 · 需求方案

酒水回收

v7 云端 · PC · 安卓 自适应嵌入式 H5 云端 4 块 · 无统计菜单 实施细节见 技术备注.md
优先级 / 类型P2 / 需求
来源 / 决策原因客户诉求(酒吧业态 KA) / KA 客户 + 行业需要
所属分类 / 评审人酒吧业态 · 库存与损耗 / 产品 + 云端 + PC + 安卓 + 小微前端
系统侵入性 / 评审低—中(独立模块,复用现有容器与菜单下发,不改存量页面) / 是

一、背景

  1. 酒吧业态 KA 客户提出酒水回收诉求:开瓶未喝完的整瓶酒与散酒需要能退回并计入台账与库存,当前产品无此功能。
  2. 这是酒吧业态的行业共性缺口(存酒 / 回收 / 损耗台账),可复用到同类客户。
  3. 独立新模块,不改造寄存 / 报损 / 取酒记录,只沿用其交互骨架与权限框架。

二、需求

云端 4 块:设置 / 商品 / 权限 / 明细

  1. 新增「酒水回收设置」页,5 个开关:是否需要审核(默认开)、整瓶是否增加库存(默认开)、散酒是否增加库存(默认关)、是否必须回收桌台(默认开)、是否必须关联回收单据(默认关)。
    1. 关闭「是否需要审核」时:提交即置为已审核(状态只有这四个,不新增「已生效」),审核人显示「系统(免审核)」,审核时间取提交时间;免审核单与审核通过单同权,不能绕过作废直接改。
    2. 不提供入库仓选择:整瓶入库走系统默认仓。
    3. 不设打印开关:详情页固定显示「打印」按钮(PC 走小票模板,手持走 H5 打印)。
  2. 新增「酒水回收商品设置」页:每商品两个开关「允许回收」「允许散酒回收」,散酒开关联动回收开关;未设置默认不允许,新增商品默认不允许;支持分类筛选、搜索、勾选批量设置。
    1. 「全选(Y)|已选(X)」为单选(radio)切换视图,不是链接:选「全选」显示全部商品,选「已选」只显示已勾选的商品;X 为当前勾选行数、Y 为商品总数,两端实时变化。
    2. 「已开允许回收(Z)」为独立计数,不参与单选切换,Z 随开关实时变化。
    3. 勾选只是选中,不改变开关状态;批量设置同时覆盖「允许回收」与「允许散酒回收」两个开关,批量开「允许散酒回收」时自动带上「允许回收」;全选只勾选当前筛选下可见的商品。
    4. 商品列表支持分页:默认每页 20 条,可切 50 / 100。
    5. 按门店维度设置,与设置页同层级;总部账号可切换门店逐店配置,首版不做一键下发多店;不做批量导入。
  3. 员工与角色新增权限点【酒水回收申请】【酒水回收审核】,默认不勾选,两项独立可同时授予。
  4. 新增「酒水回收明细」列表:表头为申请时间、申请人、门店、回收商品明细、回收数量、回收金额、回收备注、回收照片、回收桌台、回收单据号、是否增加库存、审核人、状态、审核时间、审核备注、操作。
    1. 时间格式统一 yyyy-MM-dd HH:mm:ss(申请时间、审核时间同一格式,未审核显示 -)。
    2. 回收商品明细在列表内直接展示:商品名 + 数量 + 金额,多条分行。
    3. 「是否增加库存」只有「是 / 否」两个值,不出现空值与其它文案。
    4. 筛选条件拆开:申请时间范围、门店、申请人、状态、回收桌台、回收单据号、商品名,各自独立,可组合。
    5. 列表底部固定统计条:当前筛选条件下「共 X 单,商品数量 Y,回收金额合计 Z」(Y 为瓶数合计,散酒按折算瓶数计,保留 1 位小数;Z 两位小数带 ¥)。
    6. 状态为待审核 / 已审核 / 已驳回 / 已作废;操作按状态给:待审核 → 审核通过 / 驳回 / 作废;已审核 → 作废;已驳回 → 编辑重提(单号不变)/ 作废;已作废 → 无操作。
    7. 作废已审核单需按「是否增加库存」回滚:生成反向库存流水,来源单号指向原单,回滚到系统默认仓,原流水不删改;回滚后库存为负则阻止作废并提示;作废需填原因,不可恢复。
    8. 作废权限归属:待审核单创建人可作废自己的单,持【审核】权限的可作废任意单;已审核 / 已驳回单仅【审核】权限可作废;免审核单同样只认【审核】权限。门店无人持【审核】时由云端管理员作废。不新增第三个权限点。
    9. 支持导出 Excel,内容与当前筛选一致;导出含底部统计的合计行。
    10. 列表支持分页:默认每页 20 条,可切 50 / 100;切页后底部统计仍按当前筛选的全部结果计算,不是本页小计。
  5. 不新增「查询统计」菜单:统计只保留明细页底部的汇总条,不做独立统计页、不做排行。

PC 收银端

  1. 功能菜单「收银管理」新增「酒水回收」入口,排在「酒水寄存」之后,仅对有任一回收权限的工号显示。
  2. 列表沿用寄存申请单骨架:状态页签 + 搜索 + 时间范围 + 表格 + 底部「新增回收」;表格列同云端 4.1–4.3(商品明细列直接显示、时间同格式、库存列是/否),筛选同样拆出桌台 / 单据号 / 商品名三个独立条件,底部同样有统计条,分页同云端(默认 20 条,可切 50 / 100)。
  3. 表单沿用寄存表单骨架,字段换为回收口径(商品、整瓶/散酒、数量、金额、桌台、单据号、备注、照片);金额按售价自动计算、只读;桌台与单据号按云端开关决定是否必填;审核 / 驳回 / 作废按权限显示,驳回与作废必须填备注;详情页固定显示打印。

安卓手持端

  1. 功能菜单「收银管理」新增「酒水回收」入口,排在「酒水寄存」之后;新菜单键需随 APP 发版,兜底并进寄存做 Tab(不发版)。
  2. 列表竖屏单列卡片:卡片内直接显示商品明细(商品名 + 数量)与「是/否 入库」,时间同 yyyy-MM-dd HH:mm:ss;筛选抽屉里含桌台 / 单据号 / 商品名独立条件;列表底部同样有统计条,列表每页 20 条、上拉加载更多。
  3. 新增表单竖屏单列、底部固定提交,散酒用 0.1 步进滑块并实时显示折算毫升;审核 / 驳回 / 作废在详情页底部,驳回与作废弹出底部弹层;扫码、拍照、打印走容器能力。

客户端差异

同一 URL 双断点:≥1024px 表格版(PC 1440×900),<768px 卡片版(手持 540×960);安卓返回键逐级回退;工号与权限由容器注入,服务端二次校验。

三、影响面与验收

端影响
云端3 个新页面(设置 / 商品 / 明细)+ 2 个权限项 + 菜单下发项(配置层);不新增统计菜单
PC / 安卓各加 1 个菜单入口 + 1 个路由,复用现有容器;安卓需发版
存量不改动任何存量页面;库存复用现有流水体系,散酒单独台账
  1. 云端开「必须回收桌台」后,两端桌台为空无法提交;关闭后可提交空桌台。
  2. 商品未开「允许回收」时两端搜不到该商品;散酒只出现开了「允许散酒回收」的商品;商品页「全选|已选」为单选切换视图,勾选数与已开计数实时一致;批量设置能同时改「允许回收」「允许散酒回收」,批量开散酒时自动带上允许回收。
  3. 无【酒水回收申请】的工号看不到入口,直接访问地址被服务端拒绝。
  4. 已审核单创建人不能作废;审核人作废后库存回落,库存不足时作废失败且状态不变。
  5. 明细页时间列均为 yyyy-MM-dd HH:mm:ss;改日期 / 切状态页签 / 加桌台或单据号条件后,底部「共 X 单、商品数量 Y、金额合计 Z」同步变化且与导出合计行一致;翻到第 2 页后统计条数值不变(按全部筛选结果算,不是本页小计)。
  6. 1440×900 与 540×960 打开同一 URL:PC 出表格、手持出卡片,无横向滚动;手持返回键逐级回退;免审核单提交后直接已审核且创建人无作废按钮。

四、排期建议

端内容天
云端设置 / 商品 / 明细 3 页 + 权限项 + 菜单下发1.5
API回收单 CRUD、审核、作废、重提、导出、上传1.3
小微前端一套 H5 双断点(列表 / 新增 / 详情)2.4
PC入口 + 容器接入0.5
安卓入口 + 容器接入(需发版窗口;兜底:并进寄存 Tab,不发版)0.5
合计(关键路径 云端 → API → 前端)6.2

五、待确认

1安卓入口:新菜单 + APP 发版,还是并进寄存做 Tab?
新菜单;赶不上封版就切 Tab。
2云端挂载位置与权限分组(beta 登录态失效未验证)
设置挂「门店设置 → 收银」、权限项挂功能权限收银组,恢复登录态后复核。
3回收单据号规则
系统生成 HS + 门店编码 + yyyyMMdd + 4 位流水,关联单据从已结账订单选,不手填。
4散酒台账口径(整瓶已定走系统默认仓)
散酒只记台账不入库存,首版不联动成本。
5回收照片
非必填、最多 5 张、压缩至 200KB、已审核后不可删。
6自审限制
默认不能审自己的单,云端加「允许自审」开关,默认关。