# MOD_026 公共配置

## 一、功能简介

「公共配置」是系统的组成部分，供以下角色使用：超级管理员。

**常用场景**：

- 运营维护业务场景字典（门票/酒店/美食/商城…）供各业务线统一引用

**本模块包含的页面**：

| 页面 | 进入方式 |
|------|---------|
| 业务场景 | 业务管理 > 公共配置 > 业务场景 |

---

## 二、页面详细操作指南

### 2.1 业务场景

**进入方式**：

> 系统左侧菜单：业务管理 > 公共配置 > 业务场景

**页面说明**：

> 本页为「公共 · 业务场景：维护全站业务业态场景注册表（cfg_biz_scene）。场景编号与轮播跳转、优惠券适用范围等对齐；本阶段仅配置数据，不自动改写既有业务模块」功能页面

**可用的筛选条件**：

| 筛选项 |
|--------|
| 场景名称（输入框，如：门票场馆、商城商品） |
| 场景编号（输入框，如 TICKET_VENUE、MALL_SPU） |
| 场景分组（下拉，分组常量选项，默认 SCENIC） |
| 能力筛选（下拉，按能力筛选列表） |
| 状态（下拉：禁用/启用） |

填写条件后点击【搜索】刷新列表，点击【重置】清空条件。

**列表展示内容**：列表列：序号/场景名称/场景编号/分组（后端翻译文案）/列表地址（左对齐）/能力（能力标签组，无能力显示—）/排序/状态（标签：启用=绿/禁用=灰）、行操作：[编辑]（打开编辑弹窗，场景编号锁定显示「编辑时不可修改编号」）/[删除]（二次确认）、操作列宽200px，居中对齐，行悬停高亮、空数据提示「暂无业务场景」

**新增/编辑弹窗（三段式表单）**（on_action）：包含 「基本信息」段：注册表说明提示（scene_code 与轮播、优惠券、宫格等能力对齐，编号保存后不可修改）；新增模式下种子复制区——注册表已有数据时提示「注册表已有场景数据：推荐直接编辑列表中的记录；新增场景请手工填写或从下方已启用场景复制字段」，空库时提示「未检测到注册表场景：请先执行 与 」或展示「从注册表种子复制（推荐）」分组按钮（点击填充提示「已填充『场景名』，可按需微调后保存」）；场景名称（必填，≤64字）/场景编号（必填，大写规则校验）/场景分组；「管理端列表接口」段：配置说明提示（POST 分页路径，优惠券选品、轮播选目标按此拉取 data.records）；列表地址（必填，如 对应功能页面，右侧[测试接口]按钮试拉数据并显示「共 N 条；示例：…」结果，未测试时提示「保存前建议点击『测试接口』确认路径与字段配置正确」）/搜索字段（必填，默认keyword）/名称字段（必填，默认name）/封面字段（选填）；「能力与扩展」段：能力说明提示（能力标签决定该场景可被哪些模块引用；ext_json 存放小程序路径、优惠券 legacy 映射等）；能力标签（多选下拉，折叠标签）/扩展 JSON（多行文本，合法JSON校验）/排序（默认0）/状态（必填，默认启用）/备注（选填，≤255字）

#### 本页面可执行的操作

#### 操作1：按条件筛选业务场景

- **操作入口**：搜索表单[搜索/重置]按钮
- **操作说明**：5项搜索：场景名称（如门票场馆、商城商品）、场景编号（如 TICKET_VENUE、MALL_SPU）、场景分组（分组常量选项，默认 SCENIC）、能力筛选（按能力筛选列表）、状态（禁用/启用）

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「按条件筛选业务场景」对应入口）
2. 触发操作：搜索表单[搜索/重置]按钮：在页面 的区域「搜索区」中，通过搜索表单[搜索/重置]按钮触发「按条件筛选业务场景」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写筛选条件：按搜索区条件填写筛选项：5项搜索：场景名称（如门票场馆、商城商品）、场景编号（如 TICKET_VENUE、MALL_SPU）、场景分组（分组常量选项，默认 SCENIC）、能力筛选（按能力筛选列表）、状态（禁用/启用）（预期结果：条件录入完成（可随时点击重置清空条件））
4. 点击查询/搜索按钮：提交筛选条件，系统按条件查询当前租户范围数据（预期结果：列表按条件刷新，分页同步更新）
5. 操作结果反馈：系统提示「操作成功」，列表/界面同步刷新最新数据（预期结果：看到「操作成功」提示且数据已更新）

异常处理：
- 异常路径：请求失败：接口异常或网络中断时，系统提示错误信息；稍后重试或联系管理员
- 异常路径：校验不通过：表单/条件校验失败时，按提示文案修正后重新填写提交

**操作流程图**：

```mermaid
flowchart TD
 A[开始: 进入业务场景页面] --> B[检查登录与权限]
 B -->|权限正常| C[搜索表单「搜索/重置」按钮]
 B -->|无权限| Z0[入口不显示, 结束]
 C -->|请求异常| E1[提示错误, 稍后重试] --> C
 C --> D[填写筛选条件]
 D -->|条件不合法| E2[按提示修正] --> D
 D --> F[点击查询]
 F --> G[列表按条件刷新]
 G --> Z[结束: 按条件筛选业务场景完成]
```

#### 操作2：新增业务场景

- **操作入口**：工具栏[新增]按钮（列表 默认）
- **操作说明**：打开新增弹窗并加载种子模板；内置「从注册表种子复制」快捷填充（数据来自已启用场景，空库提示先执行 与 ）

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「新增业务场景」对应入口）
2. 触发操作：工具栏[新增]按钮：在页面 的区域「工具栏」中，通过工具栏[新增]按钮触发「新增业务场景」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写表单信息：按表单要求逐项填写（必填项带红星）：打开新增弹窗并加载种子模板（预期结果：字段录入完成，未触发校验红字）
4. 点击保存/提交：点击弹窗或表单页的保存/确定按钮提交数据（预期结果：请求提交成功）
5. 操作结果反馈：系统提示「操作成功」，列表/界面同步刷新最新数据（预期结果：看到「操作成功」提示且数据已更新）

异常处理：
- 异常路径：请求失败：接口异常或网络中断时，系统提示错误信息；稍后重试或联系管理员
- 异常路径：校验不通过：表单/条件校验失败时，按提示文案修正后重新填写提交

**操作流程图**：

```mermaid
flowchart TD
 A[开始: 进入业务场景页面] --> B[检查登录与权限]
 B -->|权限正常| C[工具栏「新增」按钮]
 B -->|无权限| Z0[入口不显示, 结束]
 C -->|请求异常| E1[提示错误, 稍后重试] --> C
 C --> D[填写表单信息]
 D -->|校验失败| E2[按红字提示修正] --> D
 D -->|校验通过| F[点击保存/提交]
 F -->|失败| E1
 F --> G[系统提示操作成功, 列表刷新]
 G --> Z[结束: 新增业务场景完成]
```

**系统提示语**（与界面实际提示一致）：

- 「从注册表种子复制」

#### 操作3：批量删除业务场景

- **操作入口**：工具栏[删除]批量删除按钮（列表 默认）
- **操作说明**：勾选多行后确认删除

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「批量删除业务场景」对应入口）
2. 触发操作：工具栏[删除]批量删除按钮：在页面 的区域「工具栏」中，通过工具栏[删除]批量删除按钮触发「批量删除业务场景」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 选定目标数据：在列表中定位目标记录（必要时先通过搜索区筛选）；勾选多行后确认删除（预期结果：目标记录的操作按钮可见可用）
4. 二次确认：系统弹出二次确认弹窗，点击确定继续；取消则终止操作（预期结果：确认后提交请求）
5. 操作结果反馈：系统提示「操作成功」，列表/界面同步刷新最新数据（预期结果：看到「操作成功」提示且数据已更新）

异常处理：
- 异常路径：请求失败：接口异常或网络中断时，系统提示错误信息；稍后重试或联系管理员
- 异常路径：校验不通过：表单/条件校验失败时，按提示文案修正后重新填写提交

**操作流程图**：

```mermaid
flowchart TD
 A[开始: 进入业务场景页面] --> B[检查登录与权限]
 B -->|权限正常| C[工具栏「删除」批量删除按钮]
 B -->|无权限| Z0[入口不显示, 结束]
 C -->|请求异常| E1[提示错误, 稍后重试] --> C
 C --> D[选定目标记录]
 D -->|状态不符| E2[按钮不显示, 操作不可用] 
 D --> F{二次确认}
 F -->|取消| Z1[终止操作]
 F -->|确定| G[系统提示操作成功]
 G --> Z[结束: 批量删除业务场景完成]
```

> **风险提示**：删除操作不可恢复，请确认目标记录无误后再执行。

#### 操作4：编辑业务场景

- **操作入口**：行操作[编辑]按钮
- **操作说明**：打开编辑弹窗，场景编号锁定显示「编辑时不可修改编号」；空数据提示「暂无业务场景」

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「编辑业务场景」对应入口）
2. 触发操作：行操作[编辑]按钮：在页面 的区域「业务场景列表」中，通过行操作[编辑]按钮触发「编辑业务场景」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写表单信息：按表单要求逐项填写（必填项带红星）：打开编辑弹窗，场景编号锁定显示「编辑时不可修改编号」（预期结果：字段录入完成，未触发校验红字）
4. 点击保存/提交：点击弹窗或表单页的保存/确定按钮提交数据（预期结果：请求提交成功）
5. 操作结果反馈：系统提示「暂无业务场景」，列表/界面同步刷新最新数据（预期结果：看到「暂无业务场景」提示且数据已更新）

异常处理：
- 异常路径：请求失败：接口异常或网络中断时，系统提示错误信息；稍后重试或联系管理员
- 异常路径：校验不通过：表单/条件校验失败时，按提示文案修正后重新填写提交

**操作流程图**：

```mermaid
flowchart TD
 A[开始: 进入业务场景页面] --> B[检查登录与权限]
 B -->|权限正常| C[行操作「编辑」按钮]
 B -->|无权限| Z0[入口不显示, 结束]
 C -->|请求异常| E1[提示错误, 稍后重试] --> C
 C --> D[填写表单信息]
 D -->|校验失败| E2[按红字提示修正] --> D
 D -->|校验通过| F[点击保存/提交]
 F -->|失败| E1
 F --> G[系统提示操作成功, 列表刷新]
 G --> Z[结束: 编辑业务场景完成]
```

**系统提示语**（与界面实际提示一致）：

- 「编辑时不可修改编号」
- 「暂无业务场景」

#### 操作5：删除业务场景

- **操作入口**：行操作[删除]按钮
- **操作说明**：二次确认后删除单条场景

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「删除业务场景」对应入口）
2. 触发操作：行操作[删除]按钮：在页面 的区域「业务场景列表」中，通过行操作[删除]按钮触发「删除业务场景」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 选定目标数据：在列表中定位目标记录（必要时先通过搜索区筛选）；二次确认后删除单条场景（预期结果：目标记录的操作按钮可见可用）
4. 二次确认：系统弹出二次确认弹窗，点击确定继续；取消则终止操作（预期结果：确认后提交请求）
5. 操作结果反馈：系统提示「操作成功」，列表/界面同步刷新最新数据（预期结果：看到「操作成功」提示且数据已更新）

异常处理：
- 异常路径：请求失败：接口异常或网络中断时，系统提示错误信息；稍后重试或联系管理员
- 异常路径：校验不通过：表单/条件校验失败时，按提示文案修正后重新填写提交

**操作流程图**：

```mermaid
flowchart TD
 A[开始: 进入业务场景页面] --> B[检查登录与权限]
 B -->|权限正常| C[行操作「删除」按钮]
 B -->|无权限| Z0[入口不显示, 结束]
 C -->|请求异常| E1[提示错误, 稍后重试] --> C
 C --> D[选定目标记录]
 D -->|状态不符| E2[按钮不显示, 操作不可用] 
 D --> F{二次确认}
 F -->|取消| Z1[终止操作]
 F -->|确定| G[系统提示操作成功]
 G --> Z[结束: 删除业务场景完成]
```

> **风险提示**：删除操作不可恢复，请确认目标记录无误后再执行。

#### 操作6：保存业务场景

- **操作入口**：弹窗保存按钮
- **操作说明**：三段式：基本信息（场景名称必填≤64字/场景编号必填，保存时自动标准化为大写——须大写字母开头，仅含大写字母、数字或下划线，编号保存后不可修改/场景分组）、管理端列表接口（列表地址必填如 对应功能页面）、能力与扩展（能力标签多选/扩展JSON须合法或留空，非法提示「扩展 JSON 须为合法 JSON 或留空」/排序默认0/状态必填默认启用/备注≤255字）；新增模式种子复制点击填充提示「已填充『场景名』，可按需微调后保存」

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「保存业务场景」对应入口）
2. 触发操作：弹窗保存按钮：在页面 的区域「新增/编辑弹窗（三段式表单）」中，通过弹窗保存按钮触发「保存业务场景」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写表单信息：按表单要求逐项填写（必填项带红星）：三段式：基本信息（场景名称必填≤64字/场景编号必填，保存时自动标准化为大写——须大写字母开头，仅含大写字母、数字或下划线，编号保存后不可修改/场景分组）、管理端列表接口（列表地址必填如 对应功能页面）、能力与扩展（能力标签多选/扩展JSON须合法或留空，非法提示「扩展 JSON 须为合法 JSON 或留空」/排序默认0/状态必填默认启用/备注≤255字）（预期结果：字段录入完成，未触发校验红字）
4. 点击保存/提交：点击弹窗或表单页的保存/确定按钮提交数据（预期结果：请求提交成功）
5. 操作结果反馈：系统提示「扩展 JSON 须为合法 JSON 或留空」，列表/界面同步刷新最新数据（预期结果：看到「扩展 JSON 须为合法 JSON 或留空」提示且数据已更新）

异常处理：
- 异常路径：请求失败：接口异常或网络中断时，系统提示错误信息；稍后重试或联系管理员
- 异常路径：校验不通过：表单/条件校验失败时，按提示文案修正后重新填写提交

**操作流程图**：

```mermaid
flowchart TD
 A[开始: 进入业务场景页面] --> B[检查登录与权限]
 B -->|权限正常| C[弹窗保存按钮]
 B -->|无权限| Z0[入口不显示, 结束]
 C -->|请求异常| E1[提示错误, 稍后重试] --> C
 C --> D[填写表单信息]
 D -->|校验失败| E2[按红字提示修正] --> D
 D -->|校验通过| F[点击保存/提交]
 F -->|失败| E1
 F --> G[系统提示操作成功, 列表刷新]
 G --> Z[结束: 保存业务场景完成]
```

**系统提示语**（与界面实际提示一致）：

- 「扩展 JSON 须为合法 JSON 或留空」
- 「已填充『场景名』，可按需微调后保存」

#### 操作7：测试管理端列表接口

- **操作入口**：列表地址输入框右侧[测试接口]按钮
- **操作说明**：POST 分页试拉5条；成功提示「接口可用，共 N 条数据」并显示「共 N 条；示例：…」；失败提示「接口请求失败，请检查地址、权限或对应业务模块是否部署」；未测试时提示「保存前建议点击『测试接口』确认路径与字段配置正确」

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「测试管理端列表接口」对应入口）
2. 触发操作：列表地址输入框右侧[测试接口]按钮：在页面 的区域「新增/编辑弹窗（三段式表单）」中，通过列表地址输入框右侧[测试接口]按钮触发「测试管理端列表接口」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写筛选条件：按搜索区条件填写筛选项：POST 分页试拉5条（预期结果：条件录入完成（可随时点击重置清空条件））
4. 点击查询/搜索按钮：提交筛选条件，系统按条件查询当前租户范围数据（预期结果：列表按条件刷新，分页同步更新）
5. 操作结果反馈：系统提示「接口可用，共 N 条数据」，列表/界面同步刷新最新数据（预期结果：看到「接口可用，共 N 条数据」提示且数据已更新）

异常处理：
- 异常路径：请求失败：接口异常或网络中断时，系统提示错误信息；稍后重试或联系管理员
- 异常路径：校验不通过：表单/条件校验失败时，按提示文案修正后重新填写提交

**操作流程图**：

```mermaid
flowchart TD
 A[开始: 进入业务场景页面] --> B[检查登录与权限]
 B -->|权限正常| C[列表地址输入框右侧「测试接口」按钮]
 B -->|无权限| Z0[入口不显示, 结束]
 C -->|请求异常| E1[提示错误, 稍后重试] --> C
 C --> D[填写筛选条件]
 D -->|条件不合法| E2[按提示修正] --> D
 D --> F[点击查询]
 F --> G[列表按条件刷新]
 G --> Z[结束: 测试管理端列表接口完成]
```

**系统提示语**（与界面实际提示一致）：

- 「接口可用，共 N 条数据」
- 「共 N 条；示例：…」
- 「接口请求失败，请检查地址、权限或对应业务模块是否部署」
- 「保存前建议点击『测试接口』确认路径与字段配置正确」

---

## 三、常见问题与系统提示

| 操作 | 界面提示 | 处理建议 |
|------|---------|---------|
| 新增业务场景 | 「从注册表种子复制」 | 属正常反馈，按提示继续操作 |
| 编辑业务场景 | 「编辑时不可修改编号」 | 属正常反馈，按提示继续操作 |
| 编辑业务场景 | 「暂无业务场景」 | 属正常反馈，按提示继续操作 |
| 保存业务场景 | 「扩展 JSON 须为合法 JSON 或留空」 | 属正常反馈，按提示继续操作 |
| 保存业务场景 | 「已填充『场景名』，可按需微调后保存」 | 属正常反馈，按提示继续操作 |
| 测试管理端列表接口 | 「接口可用，共 N 条数据」 | 属正常反馈，按提示继续操作 |
| 测试管理端列表接口 | 「共 N 条；示例：…」 | 属正常反馈，按提示继续操作 |
| 测试管理端列表接口 | 「接口请求失败，请检查地址、权限或对应业务模块是否部署」 | 稍后重试，仍失败请联系管理员 |

> 本章生成日期：2026-08-24，内容基于系统当前版本界面与提示语整理。
