单据开关¶
适用基线：测试环境 /
dev分支 / 2026-07-15。 共享分流语义见单据类型、业务类型与单据配置。
这项配置解决什么问题¶
单据开关用于维护某项受控单据能力的启用或关闭状态。它适合处理明确、可回退的业务入口控制，不应用来替代权限配置、业务类型配置或单据编号规则。
当前可确认的信息只覆盖开关代码、说明、设定值和可用状态；每一个开关究竟影响哪些业务页面、是否即时生效，仍需在测试环境中逐项验证（GAP-062）。因此，任何生产环境的开关变更都应按高风险配置处理。
关键字段业务角色 / 字段业务语义¶
本页为单文档（无独立维护参考）。模式：P1 / P6 / P12。无 P2 级联、无 P3 / P7 / P8。
字段说明总表¶
| 字段 | 业务作用 | 谁在何时维护/选择 | 业务约束摘要 | 影响哪些功能 | 变更或错选风险 |
|---|---|---|---|---|---|
| 开关代码 | 定位具体能力开关 | 通常预置；Web 代码只读 | 唯一性/非空服务校验弱（GAP-062） |
消费方按代码读取 | 改码导致能力失联 |
| 说明 | 业务目的说明 | 维护 | 应写清影响对象与恢复条件 | 变更审计理解 | 说明不清导致误改 |
| 设定值 | 开/关布尔 | 受控变更 | 值域为布尔 | 对应校验/自动动作 | 误开/误关 |
| 是否可用 | 配置是否仍应被使用 | 启停 | 与设定值优先级 ❓；缺失时默认行为矩阵未建（GAP-062） |
消费方读取 | 停用后行为不可预期 |
策略影响表（P12）摘要¶
| 配置变化 | 影响 | 已证实/待确认 | 错配后果 |
|---|---|---|---|
| 设定值开→关 | 相关能力关闭 | 各代码作用范围 ❓ | 业务入口突然不可用 |
| 是否可用 = 否 | 配置可能不被使用 | 与设定值优先级 ❓ | 与“关”混淆导致排查困难 |
| 代码不存在 | 消费方默认 | 矩阵未建（GAP-062） |
校验或自动动作异常 |
Web 无完整新增/导入/导出/删除入口；部分代码前端隐藏编辑。勿把前端隐藏当作服务端保护。
何时可以维护¶
| 场景 | 可以做什么 | 不应直接做什么 |
|---|---|---|
| 新能力准备上线 | 建立或启用经过验证的开关。 | 未确认作用范围就直接打开。 |
| 某能力需要临时限制 | 按已批准的应急方案关闭，并记录原因和恢复条件。 | 把开关当作清理历史数据的手段。 |
| 能力已下线 | 停用开关并保留变更记录。 | 直接删除仍可能被历史配置引用的记录。 |
| 用户无权访问某页面 | 先检查权限和角色。 | 仅通过单据开关解决个人访问问题。 |
维护与变更原则¶
flowchart LR
A["提出启停需求"] --> B["确认开关作用范围"]
B --> C["测试环境验证"]
C --> D["受控变更"]
D --> E["业务结果与恢复验证"]
- 开关代码应稳定、可追溯；说明应写清业务目的、影响对象和恢复条件。
- 设定值与“是否可用”需要同时检查：前者表达当前选择，后者决定该配置是否仍应被使用。
- 没有明确的回退路径、验证人员和验证结果时，不应变更生产中的开关。
维护与查询说明¶
| 维护事项 | 当前可确认做法 | 需要补充验证 |
|---|---|---|
| 新增 | 维护开关代码、业务说明、设定值和可用状态。 | 代码重复校验与各开关的合法取值；Web 入口可能受限（GAP-062）。 |
| 编辑 | 优先修改说明或经验证的设定值。 | 已生效业务是否实时受影响、是否允许编辑代码。 |
| 启停 | 停用前确认没有待处理变更或依赖。 | 停用与设定值之间的优先级。 |
| 导入 | 控制器侧可能有模板配置，但 Web 入口与校验未闭合。 | 应用少量样例确认。 |
| 查询 | 优先显示代码、说明、设定值、可用状态和最近变更信息。 | 详情页分组、审计记录和受影响业务的快捷跳转。 |
快速排查与联查¶
| 现象 | 优先检查 | 后续联查 |
|---|---|---|
| 某项单据能力不可用 | 开关的设定值和可用状态。 | 业务类型、单据设置、角色权限和业务页面提示。 |
| 变更后结果不符合预期 | 作用范围和生效时点是否已验证。 | 对应业务的申请、任务、记录及日志。 |
| 需要恢复能力 | 原设定值、变更原因和回退方案。 | 测试用例与相关业务的恢复结果。 |
待补充的图示与示例¶
📷 截图占位
开关列表、编辑设定值、可用状态与变更确认提示。
📝 待补充
以一个已确认作用范围的开关为例，说明关闭、验证和恢复的完整步骤；并建立缺失/停用默认行为矩阵（GAP-062）。