需求摘要与当前评审入口

按用户最新纠正：打印设置放在打印机所绑定档口的编辑页，按档口ID归属；按线上/线下场景及人工/自动补打独立控制。设备只维护绑定/模板/张数，不单独保存策略。换机不丢档口策略，换绑读取新档口策略；配置与执行日志保留档口和设备上下文。PC与商家移动端共用有效策略。本版按用户最新要求将完整Use Case、前置/后置/主/分支/异常、原系统样式与页面/状态规格直接写入正文，V0.1—V0.4仅历史参考。

完整用例＋原系统样式＋现状/原型对照＋53条流程映射

PC可操作原型 · 商家移动端可操作原型

验证：22项档口归属及交互检查通过；仅证明静态演练，不证明真实后端鉴权、事务、供应商或实机出纸。PC依据当前本地源码和归档真实截图；移动端依据已有评审原型，当前生产版本需清涛核对。

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，不开始业务实现。

原系统档口打印设置：页面与样式规格 V0.5

本次纠正：归属与真实入口

源代码事实：stallSet.vue::examine(row)进入/restaurantManagement/restaurantSettings/stallSet/addStallRules?isEdit=1&id=<档口ID>，实际为“编辑档口”整页；不是设备编辑弹窗。equipment.restaurant_id表示打印机绑定档口；MealOrder::resolveReceiptPrinterConfig先取订单restaurant_id，再查同档口设备。

因此主入口为 餐厅管理 → 餐厅设置 → 档口设置 → 编辑 → 原有档口业务表单后的“打印设置”。策略按租户＋档口ID存储，打印机只读展示；设备管理保留绑定、SN、模板和张数，不增加第二份独立策略。移动端新增“我的 → 档口设置 → 目标授权档口 → 打印设置”；原有设备状态入口仍保留，仅可查看绑定档口或执行日志。

原型依据与边界

PC使用现有stallSet.vue档口表格、addStallRules.vue整页表单、restaurantSettings.vue三级页签，以及当前Vue2.7.16/ElementUI2.15.14的组件CSS、图标和官方Logo。本地源码快照HEAD 301815bd695483a5709d2fac4d6b7f29e1334b49，不冒充最新发布。当前没有新采集的真实档口截图，Before只展示归档打印机绑定页作为绑定事实参考；After全部是可操作原型截图。移动样式沿用已有商户移动管理评审原型，不冒充生产截图。

原型只演练新增档口打印配置、补打和日志；原有基础信息、照片、营业/订餐规则只读展示，不改真实档口业务，不连接正式接口。示例时间、名称和开关初始值均为合成数据。

色彩、字体、尺寸

页面/按钮与业务体现

P01 档口设置列表

沿用“区域设置/餐厅设置/档口设置”页签以及所属餐厅、档口名称搜索。目标行点击“编辑”进入P02；不是点击打印机行配置。下载二维码/叫号大屏保留位置但不在本原型执行范围。无搜索结果显示空态与重置方向，商家只见授权档口。

P02 编辑档口整页

页头“编辑档口·A档口”，左返回档口列表、右蓝色保存。原有基础资料/营业时间/订餐规则只读，新增“打印设置”位于其后。配置顶部明确“档口”“当前绑定打印机（只读）”“档口策略版本/修改人/时间”；三组线上/线下/补打开关逐行展示，与原页面同色同字体。任何修改先进入草稿，保存之前不改变有效策略。

保存成功显示绿色就地提示及新档口版本；失败保留草稿与旧配置，版本冲突拒绝覆盖并提供重新加载确认；无权限只读。未绑定打印机可维护档口策略，提示不会实际打印；未绑定/多绑定/离线仍由打印执行/补打前置检查阻断。返回/Escape/取消有草稿时确认，不误写原营业或订餐规则。

“打印日志”在本档口打印设置下，进入P06自动带档口ID；开关日志以档口为修改对象，当前绑定打印机可作快照，不能作为策略主键。

设备管理边界

设备页仍管理设备、绑定档口、模板和张数。原型不修改真实设备；仅提供“查看绑定档口”定位P02，以及“执行日志”只读查询。这里没有可单独保存的开关；不能把设备的编辑动作重新指向设备级策略。

P03—P06 订单、补打与日志

订单详情先显示所属档口，再按最新绑定匹配唯一打印机；判断顺序为档口策略→合法绑定/在线条件→打印。场景或人工补打关闭、无权限、未关联、多关联、离线、上次结果未知均明确说明，不盲重投。补打原因必填，已受理不等于打印成功。

补打记录保留订单所属档口、实际设备ID/名称/SN快照、人工/自动、原因、份数/次数、受理号、策略版本和结果。设备换绑后历史记录不修改；配置日志查询以档口限定，执行日志可按实际打印机进一步筛选。详情可回授权订单，关闭后保留来源筛选。

M01—M06 移动端

“我的”新增档口设置，保留设备状态；进入授权档口卡片→编辑档口·打印设置。配置归属、版本、8开关、保存失败/取消/冲突与PC一致，不因从手机设置形成另一份配置。订单→详情→补打沿用已有移动路径；日志用卡片而非压缩PC宽表。若从设备卡片进入，只定位其当前绑定档口，不携带设备级策略。

状态与用例映射

• UC001：P01/M01读授权档口→P02/M02读版本→修改草稿→保存中→保存成功及操作日志；取消/失败/冲突/无权限/读取失败均有明确反馈；未绑定只影响实际执行。
• UC002：P03/M03读订单所属档口与当前绑定→P04/M04校验原因/开关/权限/设备→P05/M05已受理/明确成功/失败/待确认，拒绝和跳过有原因，不再次扣款。
• UC003：P06/M06按档口操作/补打记录分签，筛选/分页/空/失败/无权限/记录详情和关联订单；保留上下文。
• UC004：后台收到事件→订单.restaurant_id→档口策略→匹配当前打印机→允许/跳过/异常。P07只是原型审查工具，生产不新增用户弹窗。

新增归属回归AC49—52：换机不丢档口策略；换绑读取新档口策略；无机可配置但不能投递；设备页不再有独立策略编辑。原49条流程映射及四种用例前后/主/分支/异常全部继续保留，不能因本次纠正缩回示意图。

现有系统依据（归档真实截图）

现有打印机列表及“关联档口”字段仅作绑定关系参考；配置入口在编辑档口，不在设备页。

原型截图与状态（V0.5演练，不是上线截图）

P02：现有编辑档口整页内新增打印设置，策略归档口

M02：我的→档口设置→打印设置

P02/E2：保存失败，草稿保留且旧配置有效

P05：补打记录，已受理与实际出纸分开

P06：开关操作日志，修改前后值及操作者可追溯