| 优先级 / 类型 | P2 / 需求 |
| 来源 / 决策原因 | 客户诉求(酒吧业态 KA) / KA 客户 + 行业需要 |
| 所属分类 / 评审人 | 酒吧业态 · 库存与损耗 / 产品 + 云端 + PC + 安卓 + 小微前端 |
| 系统侵入性 / 评审 | 低—中(独立模块,复用现有容器与菜单下发,不改存量页面) / 是 |
一、背景
- 酒吧业态 KA 客户提出酒水回收诉求:开瓶未喝完的整瓶酒与散酒需要能退回并计入台账与库存,当前产品无此功能。
- 这是酒吧业态的行业共性缺口(存酒 / 回收 / 损耗台账),可复用到同类客户。
- 独立新模块,不改造寄存 / 报损 / 取酒记录,只沿用其交互骨架与权限框架。
二、需求
云端 4 块:设置 / 商品 / 权限 / 明细
- 新增「酒水回收设置」页,5 个开关:是否需要审核(默认开)、整瓶是否增加库存(默认开)、散酒是否增加库存(默认关)、是否必须回收桌台(默认开)、是否必须关联回收单据(默认关)。
- 关闭「是否需要审核」时:提交即置为已审核(状态只有这四个,不新增「已生效」),审核人显示「系统(免审核)」,审核时间取提交时间;免审核单与审核通过单同权,不能绕过作废直接改。
- 不提供入库仓选择:整瓶入库走系统默认仓。
- 不设打印开关:详情页固定显示「打印」按钮(PC 走小票模板,手持走 H5 打印)。
- 新增「酒水回收商品设置」页:每商品两个开关「允许回收」「允许散酒回收」,散酒开关联动回收开关;未设置默认不允许,新增商品默认不允许;支持分类筛选、搜索、勾选批量设置。
- 「全选(Y)|已选(X)」为单选(radio)切换视图,不是链接:选「全选」显示全部商品,选「已选」只显示已勾选的商品;X 为当前勾选行数、Y 为商品总数,两端实时变化。
- 「已开允许回收(Z)」为独立计数,不参与单选切换,Z 随开关实时变化。
- 勾选只是选中,不改变开关状态;批量设置同时覆盖「允许回收」与「允许散酒回收」两个开关,批量开「允许散酒回收」时自动带上「允许回收」;全选只勾选当前筛选下可见的商品。
- 商品列表支持分页:默认每页 20 条,可切 50 / 100。
- 按门店维度设置,与设置页同层级;总部账号可切换门店逐店配置,首版不做一键下发多店;不做批量导入。
- 员工与角色新增权限点【酒水回收申请】【酒水回收审核】,默认不勾选,两项独立可同时授予。
- 新增「酒水回收明细」列表:表头为申请时间、申请人、门店、回收商品明细、回收数量、回收金额、回收备注、回收照片、回收桌台、回收单据号、是否增加库存、审核人、状态、审核时间、审核备注、操作。
- 时间格式统一
yyyy-MM-dd HH:mm:ss(申请时间、审核时间同一格式,未审核显示 -)。
- 回收商品明细在列表内直接展示:商品名 + 数量 + 金额,多条分行。
- 「是否增加库存」只有「是 / 否」两个值,不出现空值与其它文案。
- 筛选条件拆开:申请时间范围、门店、申请人、状态、回收桌台、回收单据号、商品名,各自独立,可组合。
- 列表底部固定统计条:当前筛选条件下「共 X 单,商品数量 Y,回收金额合计 Z」(Y 为瓶数合计,散酒按折算瓶数计,保留 1 位小数;Z 两位小数带 ¥)。
- 状态为待审核 / 已审核 / 已驳回 / 已作废;操作按状态给:待审核 → 审核通过 / 驳回 / 作废;已审核 → 作废;已驳回 → 编辑重提(单号不变)/ 作废;已作废 → 无操作。
- 作废已审核单需按「是否增加库存」回滚:生成反向库存流水,来源单号指向原单,回滚到系统默认仓,原流水不删改;回滚后库存为负则阻止作废并提示;作废需填原因,不可恢复。
- 作废权限归属:待审核单创建人可作废自己的单,持【审核】权限的可作废任意单;已审核 / 已驳回单仅【审核】权限可作废;免审核单同样只认【审核】权限。门店无人持【审核】时由云端管理员作废。不新增第三个权限点。
- 支持导出 Excel,内容与当前筛选一致;导出含底部统计的合计行。
- 列表支持分页:默认每页 20 条,可切 50 / 100;切页后底部统计仍按当前筛选的全部结果计算,不是本页小计。
- 不新增「查询统计」菜单:统计只保留明细页底部的汇总条,不做独立统计页、不做排行。
PC 收银端
- 功能菜单「收银管理」新增「酒水回收」入口,排在「酒水寄存」之后,仅对有任一回收权限的工号显示。
- 列表沿用寄存申请单骨架:状态页签 + 搜索 + 时间范围 + 表格 + 底部「新增回收」;表格列同云端 4.1–4.3(商品明细列直接显示、时间同格式、库存列是/否),筛选同样拆出桌台 / 单据号 / 商品名三个独立条件,底部同样有统计条,分页同云端(默认 20 条,可切 50 / 100)。
- 表单沿用寄存表单骨架,字段换为回收口径(商品、整瓶/散酒、数量、金额、桌台、单据号、备注、照片);金额按售价自动计算、只读;桌台与单据号按云端开关决定是否必填;审核 / 驳回 / 作废按权限显示,驳回与作废必须填备注;详情页固定显示打印。
安卓手持端
- 功能菜单「收银管理」新增「酒水回收」入口,排在「酒水寄存」之后;新菜单键需随 APP 发版,兜底并进寄存做 Tab(不发版)。
- 列表竖屏单列卡片:卡片内直接显示商品明细(商品名 + 数量)与「是/否 入库」,时间同
yyyy-MM-dd HH:mm:ss;筛选抽屉里含桌台 / 单据号 / 商品名独立条件;列表底部同样有统计条,列表每页 20 条、上拉加载更多。
- 新增表单竖屏单列、底部固定提交,散酒用 0.1 步进滑块并实时显示折算毫升;审核 / 驳回 / 作废在详情页底部,驳回与作废弹出底部弹层;扫码、拍照、打印走容器能力。
客户端差异
同一 URL 双断点:≥1024px 表格版(PC 1440×900),<768px 卡片版(手持 540×960);安卓返回键逐级回退;工号与权限由容器注入,服务端二次校验。
三、影响面与验收
| 端 | 影响 |
| 云端 | 3 个新页面(设置 / 商品 / 明细)+ 2 个权限项 + 菜单下发项(配置层);不新增统计菜单 |
| PC / 安卓 | 各加 1 个菜单入口 + 1 个路由,复用现有容器;安卓需发版 |
| 存量 | 不改动任何存量页面;库存复用现有流水体系,散酒单独台账 |
- 云端开「必须回收桌台」后,两端桌台为空无法提交;关闭后可提交空桌台。
- 商品未开「允许回收」时两端搜不到该商品;散酒只出现开了「允许散酒回收」的商品;商品页「全选|已选」为单选切换视图,勾选数与已开计数实时一致;批量设置能同时改「允许回收」「允许散酒回收」,批量开散酒时自动带上允许回收。
- 无【酒水回收申请】的工号看不到入口,直接访问地址被服务端拒绝。
- 已审核单创建人不能作废;审核人作废后库存回落,库存不足时作废失败且状态不变。
- 明细页时间列均为
yyyy-MM-dd HH:mm:ss;改日期 / 切状态页签 / 加桌台或单据号条件后,底部「共 X 单、商品数量 Y、金额合计 Z」同步变化且与导出合计行一致;翻到第 2 页后统计条数值不变(按全部筛选结果算,不是本页小计)。
- 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自审限制
默认不能审自己的单,云端加「允许自审」开关,默认关。