# MOD_018 活动营销

## 一、功能简介

「活动营销」是系统的组成部分，供以下角色使用：超级管理员、站点运营。

**常用场景**：

- 运营创建营销活动并配置规则、投放范围与海报模板
- 运营为店铺（租户）生成推广二维码并查看店铺会员
- 运营跟踪券核销记录与营销统计评估活动效果

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

| 页面 | 进入方式 |
|------|---------|
| 营销活动 | 业务管理 > 活动营销 > 营销活动 |
| 营销规则 | 业务管理 > 活动营销 > 营销规则 |
| 投放范围 | 业务管理 > 活动营销 > 投放范围 |
| 海报模板 | 业务管理 > 活动营销 > 海报模板 |
| 店铺会员 | 业务管理 > 活动营销 > 店铺会员 |
| 营销配置 | 业务管理 > 活动营销 > 营销配置 |
| 推广二维码 | 业务管理 > 活动营销 > 推广二维码 |
| 核销记录 | 业务管理 > 活动营销 > 核销记录 |
| 营销统计 | 业务管理 > 活动营销 > 营销统计 |

---

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

### 2.1 营销活动

**进入方式**：

> 系统左侧菜单：业务管理 > 活动营销 > 营销活动

**页面说明**：

> 本页为「营销 · 活动配置」功能页面

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

| 筛选项 |
|--------|
| 活动编码（输入框） |
| 活动名称（输入框，支持模糊查询） |
| 活动类型（下拉：推广有礼/分享返佣/裂变分享/邀请绑定） |
| 投放场景（下拉：邀请页/我的/首页/支付成功页） |
| 活动状态（下拉：草稿/启用/禁用/过期） |

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

**列表展示内容**：列表列：序号/活动编码/活动名称/分享描述/活动类型（中文）/投放场景（中文）/状态（标签：启用绿/草稿灰/禁用黄/过期红）/排序、内置新增/编辑/删除/批量删除（对应按钮已隐藏）、操作列宽220px

**活动编辑弹窗（分组表单）**（on_action）：包含 分组一「基本信息」：提示文案（活动编码全局唯一，保存后不建议修改；奖励规则请在「活动规则」、可见范围请在「投放范围」菜单维护）；活动编码（必填，≤64字符，占位示例 share_commission_202605）/活动名称（必填，≤200字符）/活动类型（必选）/投放场景（选填，与小程序拉取活动列表 scene 参数一致）/活动状态（必选）/排序号（同场景下越小越靠前）；分组二「活动时间（选填）」：提示文案（留空不限制时间；仅启用且在有效期内的活动对小程序用户生效）；开始时间/结束时间（日期时间选择器，选填）；分组三「小程序分享」：提示文案（用户转发小程序时看到的卡片标题、描述与封面；标题与描述也用于关联海报模板的主标题、副标题）；分享标题（≤200字符，占位示例「邀好友下单得返佣」）/分享描述（多行文本，≤500字符）/分享封面图（单图上传，≤5MB，公开OSS images/marketing/activity）/小程序路径（≤500字符，点击卡片后打开的小程序页面）；分组四「关联海报（选填）」：海报模板下拉（加载启用状态海报模板前500条，标签=模板名称（邀请/分享/返佣海报），不选则不生成定制海报）；校验提示：请输入活动编码/请输入活动名称/请选择活动类型/请选择活动状态

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

#### 操作1：按条件筛选营销活动

- **操作入口**：搜索表单[搜索/重置]按钮
- **操作说明**：5项搜索：活动编码、活动名称（支持模糊查询）、活动类型（推广有礼/分享返佣/裂变分享/邀请绑定）、投放场景（邀请页/我的/首页/支付成功页）、活动状态（草稿/启用/禁用/过期）

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「按条件筛选营销活动」对应入口）
2. 触发操作：搜索表单[搜索/重置]按钮：在页面 的区域「搜索区」中，通过搜索表单[搜索/重置]按钮触发「按条件筛选营销活动」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写筛选条件：按搜索区条件填写筛选项：5项搜索：活动编码、活动名称（支持模糊查询）、活动类型（推广有礼/分享返佣/裂变分享/邀请绑定）、投放场景（邀请页/我的/首页/支付成功页）、活动状态（草稿/启用/禁用/过期）（预期结果：条件录入完成（可随时点击重置清空条件））
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：新增营销活动

- **操作入口**：页面内置[新增]按钮
- **操作说明**：打开活动编辑大弹窗（分组表单）；对应按钮已隐藏；操作列宽220px；后端暂无 MarketingActivity 专属 Controller（可能复用平台接口）

**操作步骤**：

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
 D -->|校验通过| F[点击保存/提交]
 F -->|失败| E1
 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 --> F{二次确认}
 F -->|取消| Z1[终止操作]
 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字符，全局唯一，保存后不建议修改，占位示例 share_commission_202605）/活动名称（必填≤200字符）/活动类型（必选）/投放场景（选填，与小程序拉取活动列表 scene 参数一致）/活动状态（必选）/排序号（同场景下越小越靠前）；分组二「活动时间（选填）」：留空不限制时间，仅启用且在有效期内的活动对小程序用户生效；分组三「小程序分享」：分享标题（≤200字符）/分享描述（多行≤500字符）/分享封面图（单图≤5MB，公开OSS）/小程序路径（≤500字符），标题与描述也用于关联海报模板的主副标题；分组四「关联海报（选填）」：海报模板下拉（加载启用状态海报模板前500条，不选则不生成定制海报）；校验提示：请输入活动编码/请输入活动名称/请选择活动类型/请选择活动状态

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「保存营销活动」对应入口）
2. 触发操作：活动编辑弹窗保存按钮：在页面 的区域「活动编辑弹窗（分组表单）」中，通过活动编辑弹窗保存按钮触发「保存营销活动」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写表单信息：按表单要求逐项填写（必填项带红星）：分组一「基本信息」：活动编码（必填≤64字符，全局唯一，保存后不建议修改，占位示例 share_commission_202605）/活动名称（必填≤200字符）/活动类型（必选）/投放场景（选填，与小程序拉取活动列表 scene 参数一致）/活动状态（必选）/排序号（同场景下越小越靠前）（预期结果：字段录入完成，未触发校验红字）
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[结束: 保存营销活动完成]
```

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

- 「基本信息」
- 「活动时间（选填）」
- 「小程序分享」
- 「关联海报（选填）」

---

### 2.2 营销规则

**进入方式**：

> 系统左侧菜单：业务管理 > 活动营销 > 营销规则

**页面说明**：

> 本页为「营销 · 活动规则」功能页面

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

| 筛选项 |
|--------|
| 活动名称（输入框，模糊匹配活动名称或编码） |
| 规则类型（下拉：绑定奖励/首单奖励/分享奖励/返佣奖励） |
| 状态（下拉：启用/禁用） |
| 奖励角色（下拉：邀请人/被邀请人/分享人/购买者） |

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

**列表展示内容**：列表列：序号/活动名称/规则类型/触发事件/奖励角色/奖励类型/奖励值/返佣比例（百分比展示）/发放方式/结算方式/状态（标签右固定列：启用绿/禁用黄）、全部枚举字段列表行转中文展示、内置新增/编辑/删除/批量删除（对应按钮已隐藏）、操作列宽220px

**规则编辑弹窗（分组表单）**（on_action）：包含 分组一「所属活动与规则」：提示文案（每条规则须绑定一个营销活动；规则类型与触发事件决定何时计算奖励，状态为启用时才会参与小程序侧发放）；所属活动下拉（必填，加载活动列表前500条，标签=活动名称（活动编码），支持筛选）/规则类型（必选）/触发事件下拉（绑定成功/订单已支付/订单已完成/分享成功）/状态（必选）；分组二「奖励设置」：奖励角色（邀请人/被邀请人/分享人/购买者）/奖励类型下拉（优惠券/积分/现金/成长值）/固定奖励值（两位小数，如20元或100积分）/返佣比例（四位小数，0.08=8%，与固定奖励值通常只填其一）；分组三「门槛与封顶（选填）」：门槛金额（订单满此金额才触发奖励）/封顶金额（单笔奖励上限）；分组四「发放与结算」：发放方式（立即发放/延迟发放/人工发放）/结算方式（订单支付后/订单完成后/人工结算）；分组五「额外限制（选填）」：核销后才发放（是/否，返佣类常用）/仅首单计奖（是/否，邀请有礼常用）/发放优惠券下拉（加载启用状态优惠券模板前500条）；校验提示：请选择所属活动/请选择规则类型/请选择状态

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

#### 操作1：按条件筛选营销规则

- **操作入口**：搜索表单[搜索/重置]按钮
- **操作说明**：4项搜索：活动名称（模糊匹配活动名称或编码）、规则类型（绑定奖励/首单奖励/分享奖励/返佣奖励）、状态（启用/禁用）、奖励角色（邀请人/被邀请人/分享人/购买者）

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「按条件筛选营销规则」对应入口）
2. 触发操作：搜索表单[搜索/重置]按钮：在页面 的区域「搜索区」中，通过搜索表单[搜索/重置]按钮触发「按条件筛选营销规则」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写筛选条件：按搜索区条件填写筛选项：4项搜索：活动名称（模糊匹配活动名称或编码）、规则类型（绑定奖励/首单奖励/分享奖励/返佣奖励）、状态（启用/禁用）、奖励角色（邀请人/被邀请人/分享人/购买者）（预期结果：条件录入完成（可随时点击重置清空条件））
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：新增营销规则

- **操作入口**：页面内置[新增]按钮
- **操作说明**：打开规则编辑大弹窗（分组表单）；对应按钮已隐藏；操作列宽220px；全部枚举字段列表行转中文展示

**操作步骤**：

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
 D -->|校验通过| F[点击保存/提交]
 F -->|失败| E1
 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 --> F{二次确认}
 F -->|取消| Z1[终止操作]
 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：保存营销规则

- **操作入口**：规则编辑弹窗保存按钮（新增/编辑共用）
- **操作说明**：分组一「所属活动与规则」：所属活动下拉（必填，加载活动列表前500条，标签=活动名称（活动编码），支持筛选）/规则类型（必选）/触发事件（绑定成功/订单已支付/订单已完成/分享成功）/状态（必选），状态为启用时才参与小程序侧发放；分组二「奖励设置」：奖励角色（邀请人/被邀请人/分享人/购买者）/奖励类型（优惠券/积分/现金/成长值）/固定奖励值（两位小数，如20元或100积分）/返佣比例（四位小数，0.08=8%，与固定奖励值通常只填其一）；分组三「门槛与封顶（选填）」：门槛金额/封顶金额；分组四「发放与结算」：发放方式（立即发放/延迟发放/人工发放）/结算方式（订单支付后/订单完成后/人工结算）；分组五「额外限制（选填）」：核销后才发放（返佣类常用）/仅首单计奖（邀请有礼常用）/发放优惠券下拉（加载启用状态优惠券模板前500条）；三个附加条件字段保存时序列化为 conditionJson；校验提示：请选择所属活动/请选择规则类型/请选择状态

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「保存营销规则」对应入口）
2. 触发操作：规则编辑弹窗保存按钮：在页面 的区域「规则编辑弹窗（分组表单）」中，通过规则编辑弹窗保存按钮触发「保存营销规则」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写表单信息：按表单要求逐项填写（必填项带红星）：分组一「所属活动与规则」：所属活动下拉（必填，加载活动列表前500条，标签=活动名称（活动编码），支持筛选）/规则类型（必选）/触发事件（绑定成功/订单已支付/订单已完成/分享成功）/状态（必选），状态为启用时才参与小程序侧发放（预期结果：字段录入完成，未触发校验红字）
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[结束: 保存营销规则完成]
```

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

- 「所属活动与规则」
- 「奖励设置」
- 「门槛与封顶（选填）」
- 「发放与结算」
- 「额外限制（选填）」

---

### 2.3 投放范围

**进入方式**：

> 系统左侧菜单：业务管理 > 活动营销 > 投放范围

**页面说明**：

> 本页为「营销 · 投放范围：为活动配置中的营销活动设置可见与参与范围，按城市、投放渠道、会员等级或业务类型等维度限定活动对谁生效」功能页面

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

| 筛选项 |
|--------|
| 活动名称（输入框，模糊匹配活动名称或编码） |
| 范围类型（下拉：投放渠道/城市/会员等级/业务类型/指定业务） |
| 展示名称（输入框） |
| 状态（下拉：启用/禁用） |

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

**列表展示内容**：列表列：序号/活动名称/范围类型（中文）/展示名称/范围值（优先展示名称，其次预设编码中文名）/优先级/状态（标签右固定列：启用绿/禁用黄）、内置新增/编辑/删除/批量删除（对应按钮已隐藏）、操作列宽220px

**范围编辑弹窗**（on_action）：包含 分组「所属活动与范围」：提示文案（每条范围记录绑定一个营销活动，用于限定谁能看到/参与；同一活动可配置多条范围，优先级数字越小越优先匹配）；所属活动下拉（必填，加载活动列表前500条，标签=活动名称（活动编码），支持筛选）；范围类型（必选：投放渠道/城市/会员等级/业务类型/指定业务）；范围值提示文案（范围值为系统匹配用的编码：渠道选微信小程序等；城市填区域编码；会员等级选普通会员等；也可在下拉中直接输入自定义编码）；范围值下拉（必填，可选可输可创建：预设微信小程序/APP/H5/微信公众号/普通会员/白银会员/黄金会员/门票业务/酒店业务/商城业务/汾阳城市编码示例）；展示名称（≤200字符，列表展示用）；优先级（数字，越小越优先）；状态（必选：启用/禁用）

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

#### 操作1：按条件筛选投放范围

- **操作入口**：搜索表单[搜索/重置]按钮
- **操作说明**：4项搜索：活动名称（模糊匹配活动名称或编码）、范围类型（投放渠道/城市/会员等级/业务类型/指定业务）、展示名称、状态（启用/禁用）

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「按条件筛选投放范围」对应入口）
2. 触发操作：搜索表单[搜索/重置]按钮：在页面 的区域「搜索区」中，通过搜索表单[搜索/重置]按钮触发「按条件筛选投放范围」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写筛选条件：按搜索区条件填写筛选项：4项搜索：活动名称（模糊匹配活动名称或编码）、范围类型（投放渠道/城市/会员等级/业务类型/指定业务）、展示名称、状态（启用/禁用）（预期结果：条件录入完成（可随时点击重置清空条件））
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：新增投放范围

- **操作入口**：页面内置[新增]按钮
- **操作说明**：打开范围编辑弹窗；对应按钮已隐藏；操作列宽220px；范围值优先展示名称，其次预设编码中文名

**操作步骤**：

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
 D -->|校验通过| F[点击保存/提交]
 F -->|失败| E1
 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 --> F{二次确认}
 F -->|取消| Z1[终止操作]
 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：保存投放范围

- **操作入口**：范围编辑弹窗保存按钮（新增/编辑共用）
- **操作说明**：所属活动下拉（必填，加载活动列表前500条，支持筛选）；范围类型必选（投放渠道/城市/会员等级/业务类型/指定业务）；范围值必填（可选可输可创建，预设微信小程序/APP/H5/微信公众号/普通会员/白银会员/黄金会员/门票业务/酒店业务/商城业务/汾阳城市编码示例，也可输入自定义编码）；展示名称≤200字符；优先级数字越小越优先；状态必选；同一活动可配置多条范围；extJson为隐藏透传字段；校验提示：请选择所属活动/请选择范围类型/请选择或填写范围值/请选择状态

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「保存投放范围」对应入口）
2. 触发操作：范围编辑弹窗保存按钮：在页面 的区域「范围编辑弹窗」中，通过范围编辑弹窗保存按钮触发「保存投放范围」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写表单信息：按表单要求逐项填写（必填项带红星）：所属活动下拉（必填，加载活动列表前500条，支持筛选）（预期结果：字段录入完成，未触发校验红字）
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[结束: 保存投放范围完成]
```

---

### 2.4 海报模板

**进入方式**：

> 系统左侧菜单：业务管理 > 活动营销 > 海报模板

**页面说明**：

> 本页为「营销 · 海报模板：配置用户在小程序里分享活动时使用的海报样式。新增与编辑在独立页面完成，左侧录入、右侧实时预览」功能页面

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

| 筛选项 |
|--------|
| 模板名称（输入框，模糊匹配） |
| 模板类型（下拉：邀请海报/分享海报/返佣海报） |
| 模板状态（下拉：启用/禁用） |

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

**列表展示内容**：工具栏：[新增模板]按钮（跳转独立编辑器页）、列表列：序号/模板名称/模板类型（中文）/预览图（缩略图80×32，点击可放大预览，无图显示—）/状态（标签：启用/禁用）、行操作：[编辑]（跳转独立编辑器页，携带 id）；内置删除/批量删除接口保留、操作列宽220px

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

#### 操作1：按条件筛选海报模板

- **操作入口**：搜索表单[搜索/重置]按钮
- **操作说明**：3项搜索：模板名称（模糊匹配）、模板类型（邀请海报/分享海报/返佣海报）、模板状态（启用/禁用）

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「按条件筛选海报模板」对应入口）
2. 触发操作：搜索表单[搜索/重置]按钮：在页面 的区域「搜索区」中，通过搜索表单[搜索/重置]按钮触发「按条件筛选海报模板」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写筛选条件：按搜索区条件填写筛选项：3项搜索：模板名称（模糊匹配）、模板类型（邀请海报/分享海报/返佣海报）、模板状态（启用/禁用）（预期结果：条件录入完成（可随时点击重置清空条件））
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：新增海报模板

- **操作入口**：工具栏[新增模板]按钮
- **操作说明**：跳转 对应功能页面 独立编辑器页（左侧录入、右侧实时预览）；独立编辑器页模式：列表页 showAdd/对应按钮已隐藏，CRUD 新增/update 为 Promise.resolve 空实现；保存后在「活动配置」中选用对应模板即可生效；页面激活（onActivated）时自动刷新列表

**操作步骤**：

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：编辑海报模板

- **操作入口**：行操作[编辑]按钮（跳转独立编辑器页携带id）
- **操作说明**：跳转独立编辑器页携带 id query，返回带 from 参数；预览图缩略图80×32点击可放大预览，无图显示—；操作列宽220px

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「编辑海报模板」对应入口）
2. 触发操作：行操作[编辑]按钮：在页面 的区域「模板列表」中，通过行操作[编辑]按钮触发「编辑海报模板」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写表单信息：按表单要求逐项填写（必填项带红星）：跳转独立编辑器页携带 id query，返回带 from 参数（预期结果：字段录入完成，未触发校验红字）
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[结束: 编辑海报模板完成]
```

#### 操作4：删除海报模板

- **操作入口**：页面内置行操作[删除]
- **操作说明**：内置删除接口保留；单行删除确认流程

**操作步骤**：

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[结束: 删除海报模板完成]
```

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

#### 操作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[结束: 批量删除海报模板完成]
```

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

---

### 2.5 店铺会员

**进入方式**：

> 系统左侧菜单：业务管理 > 活动营销 > 店铺会员

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

| 筛选项 |
|--------|
| 会员关键词（输入框，会员编号/姓名/手机号） |
| 绑定状态（下拉：未绑定/已绑定/已解绑） |
| 入会来源（下拉：扫码/后台/导入/小程序申请） |
| 店铺角色（下拉：顾客/店员/店长） |
| 渠道编码（输入框） |

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

**列表展示内容**：工具栏：[绑定会员]按钮（新增文案自定义）、列表列：序号/会员编号/会员姓名/会员手机/店铺编码/绑定状态/入会来源/渠道编码/店铺角色/入会时间、行操作：[编辑]（弹窗改店铺角色）/[设店员]/[设店长]/[设顾客]（快捷设置角色，二次确认「确认将xxx设为xxx？」，已是该角色时提示「该会员已是xxx」）、无删除/批量删除（showDelete/对应按钮已隐藏）、操作列宽280px

**绑定会员弹窗**（on_action）：包含 弹窗标题「绑定会员到店铺」（宽560px，关闭即销毁）；店铺编码（必填，自动带出当前店铺，禁用不可改）；会员关键词（必填，≤64字符，手机号/会员编号/会员主键）；店内角色（下拉：顾客/店员/店长，默认顾客）；渠道编码（选填，≤64字符）；底部按钮：[取消]/[确定绑定]（带 loading）；校验提示：请填写会员手机号或编号 / 当前店铺编码为空，请先在营销配置中确认店铺；绑定成功提示「绑定成功」并刷新列表

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

#### 操作1：按条件筛选店铺会员

- **操作入口**：搜索表单[搜索/重置]按钮
- **操作说明**：5项搜索：会员关键词（会员编号/姓名/手机号）、绑定状态（未绑定/已绑定/已解绑）、入会来源（扫码/后台/导入/小程序申请）、店铺角色（顾客/店员/店长）、渠道编码

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「按条件筛选店铺会员」对应入口）
2. 触发操作：搜索表单[搜索/重置]按钮：在页面 的区域「搜索区」中，通过搜索表单[搜索/重置]按钮触发「按条件筛选店铺会员」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写筛选条件：按搜索区条件填写筛选项：5项搜索：会员关键词（会员编号/姓名/手机号）、绑定状态（未绑定/已绑定/已解绑）、入会来源（扫码/后台/导入/小程序申请）、店铺角色（顾客/店员/店长）、渠道编码（预期结果：条件录入完成（可随时点击重置清空条件））
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：打开绑定会员弹窗

- **操作入口**：工具栏[绑定会员]按钮（新增文案自定义）
- **操作说明**：打开「绑定会员到店铺」自定义绑定弹窗；不支持删除（删除/批量删除为 Promise.resolve 空实现，showDelete/对应按钮已隐藏）

**操作步骤**：

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：编辑店铺角色

- **操作入口**：行操作[编辑]按钮
- **操作说明**：弹窗仅用于修改店铺角色；操作列宽280px

**操作步骤**：

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[结束: 编辑店铺角色完成]
```

#### 操作4：快捷设置店铺角色

- **操作入口**：行操作[设店员]/[设店长]/[设顾客]按钮
- **操作说明**：二次确认「确认将xxx设为xxx？」；已是该角色时提示「该会员已是xxx」

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「快捷设置店铺角色」对应入口）
2. 触发操作：行操作[设店员]/[设店长]/[设顾客]按钮：在页面 的区域「店铺会员列表」中，通过行操作[设店员]/[设店长]/[设顾客]按钮触发「快捷设置店铺角色」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写表单信息：按表单要求逐项填写（必填项带红星）：二次确认「确认将xxx设为xxx？」（预期结果：字段录入完成，未触发校验红字）
4. 点击保存/提交：点击弹窗或表单页的保存/确定按钮提交数据（预期结果：请求提交成功）
5. 操作结果反馈：系统提示「该会员已是xxx」，列表/界面同步刷新最新数据（预期结果：看到「该会员已是xxx」提示且数据已更新）

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

**操作流程图**：

```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[结束: 快捷设置店铺角色完成]
```

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

- 「确认将xxx设为xxx？」
- 「该会员已是xxx」

#### 操作5：提交会员绑定

- **操作入口**：绑定弹窗[确定绑定]按钮（带loading）
- **操作说明**：店铺编码必填（自动带出当前店铺，禁用不可改，取自营销配置 getTenantExtInfo）；会员关键词必填（≤64字符，手机号/会员编号/会员主键）；店内角色下拉（顾客/店员/店长，默认顾客）；渠道编码选填≤64字符；校验提示：请填写会员手机号或编号/当前店铺编码为空，请先在营销配置中确认店铺；绑定成功提示「绑定成功」并刷新列表

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「提交会员绑定」对应入口）
2. 触发操作：绑定弹窗[确定绑定]按钮：在页面 的区域「绑定会员弹窗」中，通过绑定弹窗[确定绑定]按钮触发「提交会员绑定」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写表单信息：按表单要求逐项填写（必填项带红星）：店铺编码必填（自动带出当前店铺，禁用不可改，取自营销配置 getTenantExtInfo）（预期结果：字段录入完成，未触发校验红字）
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[结束: 提交会员绑定完成]
```

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

- 「绑定成功」

---

### 2.6 营销配置

**进入方式**：

> 系统左侧菜单：业务管理 > 活动营销 > 营销配置

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

#### 操作1：保存店铺营销配置

- **操作入口**：卡片右侧[保存]按钮（带loading）
- **操作说明**：form_layout 单卡片配置页（非列表页），进入即加载当前店铺营销配置；店铺编码只读展示；开通营销开关（默认开启）/扫码免审入会开关（默认开启）/落地页标题（≤64字符带字数统计）/落地页副标题（≤128字符带字数统计）/Logo URL（≤500字符）；保存后提示「保存成功」并重新加载；该配置为店铺会员绑定弹窗的店铺编码来源

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「保存店铺营销配置」对应入口）
2. 触发操作：卡片右侧[保存]按钮：在页面 的区域「店铺营销配置卡片」中，通过卡片右侧[保存]按钮触发「保存店铺营销配置」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 录入/选择配置内容：按界面要求填写配置项：form_layout 单卡片配置页（非列表页），进入即加载当前店铺营销配置（预期结果：必填项填写完成，格式校验通过）
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[结束: 保存店铺营销配置完成]
```

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

- 「保存成功」

---

### 2.7 推广二维码

**进入方式**：

> 系统左侧菜单：业务管理 > 活动营销 > 推广二维码

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

| 筛选项 |
|--------|
| 渠道名称（输入框，占位「如 门店默认码、海报推广」） |

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

**列表展示内容**：工具栏：[生成推广码]按钮、列表列：序号/渠道名称/推广码（二维码缩略图56×56+[下载]链接新窗口打开，未生成显示「未生成」）/扫码次数/创建时间、内置删除/批量删除；无新增弹窗编辑（showAdd/对应按钮已隐藏）、操作列宽120px

**生成推广码弹窗**（on_action）：包含 弹窗标题「生成推广码」（宽560px，关闭即销毁）；顶部提示（信息条）：选择常用推广场景即可，系统会自动生成渠道编码与微信太阳码；顾客扫码后入会并可在营销小程序领券；渠道预设单选面板「选择推广渠道」：每个预设卡片含渠道名称、已生成标签（已生成项禁用不可再选）与说明文字；默认选中第一个未生成的预设；底部按钮：[取消]/[生成太阳码]（带 loading）；校验提示：请选择推广码渠道 / 「xxx」已生成，请在列表中下载；成功提示「推广码生成成功」并刷新列表

**生成结果弹窗**（on_action）：包含 弹窗标题「推广太阳码已生成」（宽420px）；太阳码大图展示（220×220）；结果信息：推广渠道、渠道编码；[新窗口打开/下载]按钮

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

#### 操作1：按渠道名称筛选推广码

- **操作入口**：搜索表单[搜索/重置]按钮
- **操作说明**：1项搜索：渠道名称（占位「如 门店默认码、海报推广」）

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「按渠道名称筛选推广码」对应入口）
2. 触发操作：搜索表单[搜索/重置]按钮：在页面 的区域「搜索区」中，通过搜索表单[搜索/重置]按钮触发「按渠道名称筛选推广码」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写筛选条件：按搜索区条件填写筛选项：1项搜索：渠道名称（占位「如 门店默认码、海报推广」）（预期结果：条件录入完成（可随时点击重置清空条件））
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：打开生成推广码弹窗

- **操作入口**：工具栏[生成推广码]按钮
- **操作说明**：渠道预设生成模式：不支持编辑（对应按钮已隐藏，CRUD update 空实现），通过渠道预设选择弹窗生成；操作列宽120px

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「打开生成推广码弹窗」对应入口）
2. 触发操作：工具栏[生成推广码]按钮：在页面 的区域「推广码列表」中，通过工具栏[生成推广码]按钮触发「打开生成推广码弹窗」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写表单信息：按表单要求逐项填写（必填项带红星）：渠道预设生成模式：不支持编辑（对应按钮已隐藏，CRUD update 空实现），通过渠道预设选择弹窗生成（预期结果：字段录入完成，未触发校验红字）
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：下载推广码

- **操作入口**：推广码列[下载]链接（新窗口打开）
- **操作说明**：二维码缩略图56×56展示，未生成显示「未生成」

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「下载推广码」对应入口）
2. 触发操作：推广码列[下载]链接：在页面 的区域「推广码列表」中，通过推广码列[下载]链接触发「下载推广码」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 录入/选择配置内容：按界面要求填写配置项：二维码缩略图56×56展示，未生成显示「未生成」（预期结果：必填项填写完成，格式校验通过）
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[结束: 下载推广码完成]
```

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

- 「未生成」

#### 操作4：删除推广码

- **操作入口**：页面内置行操作[删除]
- **操作说明**：内置删除保留；单行删除确认流程

**操作步骤**：

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[结束: 删除推广码完成]
```

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

#### 操作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：提交生成推广码

- **操作入口**：生成弹窗[生成太阳码]按钮（带loading）
- **操作说明**：顶部信息条：选择常用推广场景即可，系统自动生成渠道编码与微信太阳码，顾客扫码后入会并可在营销小程序领券；渠道预设单选面板：每个预设卡片含渠道名称、已生成标签（已生成项禁用不可再选）与说明文字，默认选中第一个未生成的预设；校验提示：请选择推广码渠道/「xxx」已生成，请在列表中下载；成功提示「推广码生成成功」并刷新列表

**操作步骤**：

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[结束: 提交生成推广码完成]
```

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

- 「xxx」
- 「推广码生成成功」

#### 操作7：下载推广太阳码

- **操作入口**：结果弹窗[新窗口打开/下载]按钮
- **操作说明**：弹窗「推广太阳码已生成」（宽420px）：太阳码大图展示（220×220）+推广渠道与渠道编码信息

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「下载推广太阳码」对应入口）
2. 触发操作：结果弹窗[新窗口打开/下载]按钮：在页面 的区域「生成结果弹窗」中，通过结果弹窗[新窗口打开/下载]按钮触发「下载推广太阳码」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写表单信息：按表单要求逐项填写（必填项带红星）：弹窗「推广太阳码已生成」（宽420px）：太阳码大图展示（220×220）+推广渠道与渠道编码信息（预期结果：字段录入完成，未触发校验红字）
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[结束: 下载推广太阳码完成]
```

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

- 「推广太阳码已生成」

---

### 2.8 核销记录

**进入方式**：

> 系统左侧菜单：业务管理 > 活动营销 > 核销记录

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

| 筛选项 |
|--------|
| 会员关键词（输入框，会员编号/姓名/手机号） |
| 会员券ID（输入框） |
| 核销类型（下拉：线下扫码） |

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

**列表展示内容**：工具栏：[核销优惠券]按钮、列表列：序号/会员编号/会员姓名/会员手机/优惠券/核销类型/核销时间/操作人/核销店铺/券归属店铺、无行操作列（对应按钮已隐藏），无新增/编辑/删除

**核销优惠券弹窗**（on_action）：包含 弹窗标题「核销优惠券」（宽520px，关闭即销毁）；顶部提示（信息条）：请输入顾客券码（或扫码枪扫描得到的核销码/二维码内容），系统校验后将券置为已使用；核销码（多行文本框3行，占位「请输入或扫描核销码 / 二维码内容」）；店铺编码（选填，占位「可选，默认取当前登录企业」）；底部按钮：[取消]/[确认核销]（带 loading）；校验提示：请输入核销码或扫码内容；成功提示「核销成功」并刷新列表

**核销结果弹窗**（on_action）：包含 弹窗标题「核销成功」（宽460px）；结果信息：优惠券/会员编号/会员姓名/会员手机/核销时间；[确定]按钮关闭

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

#### 操作1：按条件筛选核销记录

- **操作入口**：搜索表单[搜索/重置]按钮
- **操作说明**：3项搜索：会员关键词（会员编号/姓名/手机号）、会员券ID、核销类型（当前仅线下扫码）

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「按条件筛选核销记录」对应入口）
2. 触发操作：搜索表单[搜索/重置]按钮：在页面 的区域「搜索区」中，通过搜索表单[搜索/重置]按钮触发「按条件筛选核销记录」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写筛选条件：按搜索区条件填写筛选项：3项搜索：会员关键词（会员编号/姓名/手机号）、会员券ID、核销类型（当前仅线下扫码）（预期结果：条件录入完成（可随时点击重置清空条件））
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：打开核销优惠券弹窗

- **操作入口**：工具栏[核销优惠券]按钮
- **操作说明**：只读流水页：CRUD 增删改均为 Promise.resolve 空实现，无行操作列（对应按钮已隐藏）；核销动作通过弹窗完成

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「打开核销优惠券弹窗」对应入口）
2. 触发操作：工具栏[核销优惠券]按钮：在页面 的区域「核销记录列表」中，通过工具栏[核销优惠券]按钮触发「打开核销优惠券弹窗」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 选定目标数据：在列表中定位目标记录（必要时先通过搜索区筛选）；只读流水页：CRUD 增删改均为 Promise.resolve 空实现，无行操作列（对应按钮已隐藏）（预期结果：目标记录的操作按钮可见可用）
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[结束: 打开核销优惠券弹窗完成]
```

#### 操作3：提交优惠券核销

- **操作入口**：核销弹窗[确认核销]按钮（带loading）
- **操作说明**：顶部信息条：请输入顾客券码（或扫码枪扫描得到的核销码/二维码内容），系统校验后将券置为已使用；核销码多行文本框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：查看核销结果

- **操作入口**：结果弹窗[确定]按钮关闭
- **操作说明**：弹窗「核销成功」（宽460px）：展示优惠券/会员编号/会员姓名/会员手机/核销时间

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「查看核销结果」对应入口）
2. 触发操作：结果弹窗[确定]按钮关闭：在页面 的区域「核销结果弹窗」中，通过结果弹窗[确定]按钮关闭触发「查看核销结果」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写筛选条件：按搜索区条件填写筛选项：弹窗「核销成功」（宽460px）：展示优惠券/会员编号/会员姓名/会员手机/核销时间（预期结果：条件录入完成（可随时点击重置清空条件））
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.9 营销统计

**进入方式**：

> 系统左侧菜单：业务管理 > 活动营销 > 营销统计

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

| 筛选项 |
|--------|
| 开始日期（日期选择器，默认今天往前30天） |
| 结束日期（日期选择器，默认今天） |
| 渠道（输入框，可选渠道编码） |
| [查询]按钮（带 loading，重新拉取统计） |

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

**列表展示内容**：「渠道统计」卡片表格：渠道/入会/领券/核销，空提示「暂无数据」、「日趋势」卡片表格：日期/入会/领券/核销，最大高度420px可滚动，空提示「暂无数据」

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

#### 操作1：查询营销统计

- **操作入口**：条件栏[查询]按钮（带loading）
- **操作说明**：stats_layout 统计页（非列表页）：进入默认取近30天日期范围并自动查询；3项条件：开始日期（默认今天往前30天）/结束日期（默认今天）/渠道（可选渠道编码）

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「查询营销统计」对应入口）
2. 触发操作：条件栏[查询]按钮：在页面 的区域「查询条件栏」中，通过条件栏[查询]按钮触发「查询营销统计」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写筛选条件：按搜索区条件填写筛选项：stats_layout 统计页（非列表页）：进入默认取近30天日期范围并自动查询（预期结果：条件录入完成（可随时点击重置清空条件））
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[结束: 查询营销统计完成]
```

---

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

| 操作 | 界面提示 | 处理建议 |
|------|---------|---------|
| 保存营销活动 | 「基本信息」 | 属正常反馈，按提示继续操作 |
| 保存营销活动 | 「活动时间（选填）」 | 属正常反馈，按提示继续操作 |
| 保存营销活动 | 「小程序分享」 | 属正常反馈，按提示继续操作 |
| 保存营销活动 | 「关联海报（选填）」 | 属正常反馈，按提示继续操作 |
| 保存营销规则 | 「所属活动与规则」 | 属正常反馈，按提示继续操作 |
| 保存营销规则 | 「奖励设置」 | 属正常反馈，按提示继续操作 |
| 保存营销规则 | 「门槛与封顶（选填）」 | 属正常反馈，按提示继续操作 |
| 保存营销规则 | 「发放与结算」 | 属正常反馈，按提示继续操作 |

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