VWCG-1414｜按业务场景控制小票打印：完整 Use Case 与原型规格 V0.5

2026-10-09｜负责人赖清涛｜Review / DoR: BLOCKED（原系统识别与上线契约待评审，见末章）

目标与范围

解决线上点餐、线下菜单消费共用打印机混打的问题。标品 PC 和商家移动端以档口ID作为策略归属，按“档口＋业务场景”独立开关；打印机仅是已绑定执行设备；人工/自动补打独立控制；配置操作及每次补打可查询日志。默认保持旧业务行为，不改订单、金额、支付、模板或既有打印份数，不增加打印机绑定关系。

最新用户明确要求完整 Use Case 直接可见，图片不能替代前置/后置/主/分支/异常流程。V0.5正文为当前权威版本；V0.1—V0.4附件仅历史参考。

现有系统依据与证据边界

PC档口入口：store/public/static/src/view/restaurantManagement/restaurantSetting/stallSet.vue及addStallRules.vue。设备绑定：store/public/static/src/view/system/device/deviceManagement.vue、device/index.vue、router/system/index.js、assets/common.css、view/home.vue、订单列表/详情源码与归档真实截图。实体仓库HEAD 301815bd695483a5709d2fac4d6b7f29e1334b49；本地旧分支，不能冒充最新生产发布。复用已安装Vue 2.7.16、Element UI 2.15.14及图标字体、官方Logo；不改业务仓库。

商家移动端：沿用已评审商户移动管理端的“我的→设备、订单→详情→补打”、蓝色、卡片、字体和44px触控规范。该来源是已有原型，不是本次新获取的生产截图。本机业务8080/CDP9222无监听；当前真实部署样式和来源枚举需清涛对照发布版本评审。原型使用合成数据，仅浏览器本地演练，不调用业务/支付/云打印接口。

角色与权限

前后端同样校验。原型角色切换仅演练，不是正式权限认证；正式角色ID映射待评审。

独立开关

仅显示已启用且可以可靠识别的业务。称重、AI识别、点餐机等其他场景须证明分类互斥后按同一结构扩展，不凭设备名称或支付方式猜来源。人工补打需同时满足场景开关、人工补打开关、权限；自动补打需同时满足场景开关、自动开关和原合法重试规则。日志不能被关闭。

页面地图与原系统落位

原型 prototype.html 可切PC/移动端、角色、故障条件；每个按钮的演练和状态都能按下述Use Case定位，审查工具明确与生产页面分开。

UC-STALL-PRINT-SWITCH-001｜维护档口的分场景打印策略

• Use Case ID：UC-STALL-PRINT-SWITCH-001
• 版本/状态：V0.5 / Review；DoR: BLOCKED（末章明确负责人）。
• 主要角色：具备目标档口打印策略修改权限的管理员/商家。
• 触发：需要保留线上打印，关闭线下菜单消费打印，或调整其他独立开关。

前置条件

1. 已登录，账号有效，拥有目标档口查看及打印策略修改权限。
2. 已选择有效授权档口并读取档口策略版本；绑定打印机为只读执行上下文，不是策略主键。未关联可维护策略，但不得实际投递；多关联沿用原系统阻断。
3. 已有配置及版本成功读取；只展示该档口已启用且能可靠分类的消费场景。
4. 原业务模板、张数及订单规则保留；演练中的初始开关仅为样例，不充当正式迁移默认值。

后置条件

成功：

• 仅本次修改的场景/补打开关持久化，新版本和最后修改人/时间可读。
• 配置和成功操作审计一致提交；另一端重新读取/刷新后值一致。
• 尚未提交的打印按有效策略重新判定；已受理任务不声称可撤回。

失败/取消：

• 旧有效配置仍生效；未保存草稿不影响实际打印。
• 错误留在表单内，保留草稿并给出重试或刷新入口；无成功提示。
• 越权、失效档口不修改数据；审计失败不提交配置。

主流程

分支流程

异常/恢复流程

UC-STALL-PRINT-SWITCH-002｜人工补打和失败自动补打，追踪每次请求结果

• Use Case ID：UC-STALL-PRINT-SWITCH-002
• 版本/状态：V0.5 / Review；DoR: BLOCKED（末章明确负责人）。
• 主要角色：有补打权限的管理员/商家；自动任务以系统身份执行。
• 触发：某个已支付订单需要补打，或系统处理明确失败的打印任务。

前置条件

1. 订单属于账号授权档口，订单满足原有可打印状态，无重复支付或重建订单。
2. 按订单所属档口自动匹配唯一有效打印机；不允许随意切换到其他档口或新增多机关系。
3. 原业务场景允许打印且人工/自动对应开关开启；人工还需补打权限。
4. 目标可用；上次结果未知或已受理未结时先查询，不盲目再次投递。

后置条件

成功：

• 产生可追溯的补打请求及逐目标尝试，记录原因、份数、次数、操作者/系统、配置版本。
• 云受理号与状态可查；明确区分已受理、打印成功、失败、结果待确认。
• 订单金额、支付、模板和既有打印张数配置不被本需求改变。

失败/取消：

• 被禁止或校验不通过时不发送打印，不增加实际投递次数；记录拒绝/跳过原因。
• 相同请求重试复用原结果；无法判定受理结果时停在待确认。
• 未保存补打请求日志前不对外投递，失败可定位且不得静默继续。

主流程

分支流程

异常/恢复流程

UC-STALL-PRINT-SWITCH-003｜查看开关操作日志与补打记录

• Use Case ID：UC-STALL-PRINT-SWITCH-003
• 版本/状态：V0.5 / Review；DoR: BLOCKED（末章明确负责人）。
• 主要角色：具备日志查看权限的管理员/商家/运营只读人员。
• 触发：查询谁更改了开关，或追查订单补打原因、次数和结果。

前置条件

1. 已登录并有日志查看权限，查询范围限定在授权商家/食堂/档口。
2. 从档口编辑“打印日志”或订单“补打记录”进入；保留来源上下文。
3. 记录已经产生；没有记录时进入真实空状态而非造数据。

后置条件

成功：

• 按筛选条件分页返回完整记录，能看变更前后值或补打各次结果及原因。
• 订单入口只返回该订单、档口入口继承该档口上下文；打印机ID只用于执行记录筛选；返回路径保留原上下文。
• 日志只读，敏感字段脱敏，不提供关闭审计/编辑/删除按钮。

失败/取消：

• 无权限不显示其他租户/档口记录；查询失败不显示伪造结果。
• 筛选条件保留，重试能恢复；空结果与读取失败明确区分。

主流程

分支流程

异常/恢复流程

UC-STALL-PRINT-SWITCH-004｜系统按订单来源与有效打印策略执行首次打印

• Use Case ID：UC-STALL-PRINT-SWITCH-004
• 版本/状态：V0.5 / Review；DoR: BLOCKED（末章明确负责人）。
• 主要角色：支付成功后既有打印触发链路及打印服务。
• 触发：线上点餐或线下消费产生符合原规则的首次打印事件。

前置条件

1. 订单已达到现有合法打印时点，支付/订单状态以现有业务为准。
2. 订单来源、就餐方式/消费类型能确定唯一叶子场景，不能把联网在线/离线或支付方式当业务来源。
3. 目标档口和打印机绑定合法；有效配置可读；迁移映射已经评审。

后置条件

成功：

• 命中允许场景且原规则可打印时按既有模板/份数投递；关闭时跳过并记策略原因。
• 系统运行记录可解释“是否投递及原因”；云服务受理与物理出纸明确分开。
• 不会影响同机其他档口、其他场景；不重复支付或创建重复订单。

失败/取消：

• 未知场景/无效绑定/配置不可用不盲投，保留原订单及可追溯异常。
• 失败任务进入可解释状态，只在策略允许且结果明确时重试。

主流程

分支流程

异常/恢复流程

归属纠正与绑定变化（本次V0.5核心）

• 打印策略及版本以商家/租户＋档口ID归属，不以打印机ID或SN归属。编辑入口在现有addStallRules整页的“打印设置”；设备管理不再提供另一份可编辑策略。
• 执行链：订单.restaurant_id → 档口有效打印策略 → 按equipment.restaurant_id查当前关联打印机 → 按允许场景执行。
• 同一档口换打印机，策略/版本保持；同一打印机换绑另一档口，读取新档口策略，不携带旧档口开关。绑定变化仍走原设备管理，不在打印设置中直接改绑。
• 无打印机时允许预配置档口开关并明确“当前未绑定，不会实际打印”；实际订单/补打仍阻断未关联、多关联及无效设备。打印机异常不改变策略主键。
• 配置日志以档口记录修改对象，可附当前绑定打印机快照；补打日志记录订单所属档口与实际执行打印机。历史日志不因换绑改写。
• 新验收AC49：换机不丢策略；AC50：换绑只读新档口策略；AC51：无机可配但不能投递；AC52：设备页没有独立策略编辑入口。额外测试与映射见ownership-tests.json。

核心规则、状态和数据

• BR01：一个订单按来源+业务类型命中唯一场景；原规则不打印时，新开关不能强行打印。联网在线/离线和支付方式不能代替业务来源。
• BR02：开关只影响指定档口/合法打印目标/命中场景；关闭线下菜单不能误关线上点餐或其他档口。
• BR03：配置版本+审计同一事务保存。读取成功后编辑，保存前只是草稿；并发版本冲突拒绝覆盖。
• BR04：保存成功后对尚未向云服务提交的任务按新策略判定；已受理/正在打印不能承诺撤回。再次开启不集中追打历史抑制任务。
• BR05：补打不改支付，不重建订单；唯一目标由原系统绑定匹配，不开放跨档口任选打印机。被关闭场景不能被自动重试绕过。
• BR06：先持久化补打请求再投递；同请求重试幂等，人工/自动并发同订单目标防重；供应商无去重/结果查询能力时不能承诺物理打印恰好一次。
• BR07：首次打印、人工补打、自动补打分开标识；状态为待提交→处理中→已受理→明确成功/明确失败/结果待确认，关闭策略为已跳过，权限/校验不通过为已拒绝。
• BR08：配置与执行日志不允许业务用户关停/编辑/删除。日志不可用时新人工补打不得投递；失败状态保留可追踪请求，不删除历史。

日志字段

日志不保存密码、token、打印机云密钥、小票全文或未脱敏联系方式。默认倒序、分页10条。时间展示Asia/Shanghai，日志保留/归档期由清涛评审。

API与数据契约（能力定义，具体路径/字段待技术评审）

上述状态码是拟议语义，不宣称当前接口已支持。数据库对象为按档口ID归属的策略及配置审计、补打请求、逐目标尝试；保留现有业务订单和支付状态。跨云打印调用不是可回滚数据库事务。

验收标准与自动化测试矩阵

每个上表AC的Given=对应前置/分支/异常条件，When=对应动作，Then=同一行可观察响应/数据结果；traceability.csv逐条保留映射，不用一张总截图冒充全部通过。

后端权限、事务、幂等、供应商状态和物理打印不能由静态原型证明。现阶段测试只证明文档/原型路径与模拟行为，发布必须补正式API/并发/权限/设备回归。

性能、安全、发布与待确认

• 安全：服务端鉴权和租户/档口隔离，前端隐藏不是权限控制；请求防重，日志字段最小化，无跨域生产调用。
• 性能：配置读取沿用缓存版本策略，不新增逐单跨端轮询；日志分页和组合索引；响应时间/业务峰值/日志容量的量化阈值需结合当前发布版本评审，本次不捏造已测性能结果。
• 发布：历史行为对照→迁移预演→测试档口实机→小范围灰度→两端/日志/自动任务冒烟。配置/功能回滚不抹掉已受理打印或历史审计。

文档和原型是完整评审包，不是生产可用证明。以上P0未关闭时DoR保持BLOCKED，不开始业务实现。