推送信息管理

核心概念：任务管理 | 推送信息管理 | 概览

推送信息管理模块用于创建和管理向设备推送的各类apk。本模块集成了审批工作流，确保任务变更的安全性和规范性。

---

核心概念：任务管理 | 推送信息管理 | 快速访问 (推送信息管理)

快速访问 (推送信息管理)

在推送信息管理模块中，您可以快速访问在线系统。

点击访问：推送信息管理

---

核心概念：任务管理 | 推送信息管理 | 审批流程说明 (推送信息管理)

审批流程说明 (推送信息管理)

在推送信息管理模块中，审批流程是保障数据安全的关键机制。

重要

本模块结合了工作流模块，非管理员的修改操作都会触发审批流程。管理员修改则立即生效，无需审批。 审批进度请前往 审批中心 查看。

---

核心概念：任务管理 | 推送信息管理 | 审批状态说明 (推送信息管理)

审批状态说明 (推送信息管理)

在推送信息管理模块中，各类状态的含义如下：

• 业务审批状态：未开始(草稿)、审批中、审批通过、审批不通过、已取消。
• 流程实例状态：审批中、审批通过、审批不通过、已取消。
• 流程实例结果：待审批、审批中、审批通过、审批不通过、已取消、已退回、委派中、审批通过中。

---

核心概念：任务管理 | 推送信息管理 | 变更状态说明 (推送信息管理)

变更状态说明 (推送信息管理)

在推送信息管理模块中，业务数据的变更状态如下：

• 未生效：数据已修改但未通过审批。
• 已生效：数据已通过审批并生效。
• 已生效且做修改标记：原有数据生效中，新的修改正在审批。
• 已生效且做移除标记：请求删除该数据，正在审批中。
• 已生效且修改状态为启用/禁用：请求改变启用状态，正在审批中。

---

核心概念：任务管理 | 推送信息管理 | 1. 任务列表 (推送信息管理)

1. 任务列表 (推送信息管理)

在推送信息管理模块中，任务列表展示了所有的推送任务信息，支持查询和管理。

查询条件 (推送任务)

• 任务名称：输入任务名称进行模糊查询。
• 备注：输入备注信息进行查询。
• 筛选方式：选择筛选方式（1品牌/机型、2渠道、3MAC导入）。
• 启用状态：选择任务的启用状态。
• 变更状态：选择数据的变更状态（如已生效、未生效等）。
• 流程状态：选择审批流程的状态（如草稿、审批中等）。

---

核心概念：任务管理 | 推送信息管理 | 列表字段说明 (推送任务)

列表字段说明 (推送任务)

在推送信息管理模块的任务列表中，各字段含义如下：

• ID：任务唯一标识。
• 任务名称：推送任务的名称。
• 启用状态：任务是否开启。
• 配置方式：显示任务的筛选方式（如渠道、MAC导入等）。
• 设备总数：该任务覆盖的设备总数。
• 推送成功数：成功推送的设备数量。
• 备注：任务备注信息。
• 变更状态：当前数据的审批/生效状态。
• 流程状态：关联的审批流程状态。
• 更新时间：最后修改时间。
• 创建时间：任务创建时间。

---

核心概念：任务管理 | 推送信息管理 | 操作按钮说明 (推送任务)

操作按钮说明 (推送任务)

在推送信息管理模块的任务列表中，支持以下操作：

• 搜索/重置：查询或重置筛选条件。
• 新增：创建新的推送任务。
• 导出：导出任务列表数据。
• 编辑：修改现有任务信息（需审批）。
• 删除：删除任务（需审批）。
• 更多：
  • 草稿：查看或编辑草稿。
  • 取消数据变更：取消当前的修改申请。
  • 提交审批：将草稿或修改提交审批。
  • 取消审批：撤回正在进行的审批。
  • 查看审批：查看审批进度和详情。

---

核心概念：任务管理 | 推送信息管理 | 2. 新增/编辑任务 (推送信息管理)

2. 新增/编辑任务 (推送信息管理)

在推送信息管理模块中，您可以创建或修改推送任务的基本信息。

表单字段说明 (新增/编辑任务)

• 任务名称：必填，任务的显示名称。
• 备注：选填，任务的描述信息。
• 筛选方式：必填，决定了任务推送的范围。
  • 品牌/机型：按设备品牌或机型筛选。
  • 渠道：按渠道进行筛选（需在"渠道配置管理"中配置）。
  • MAC导入：通过导入MAC地址指定设备（需在"MAC配置管理"中配置）。
• 启用状态：设置任务是否立即启用。

---

核心概念：任务管理 | 推送信息管理 | 关联配置管理概述 (推送信息管理)

关联配置管理概述 (推送信息管理)

在推送信息管理模块中，根据业务需求，您可以选择使用 规则引擎模式（推荐） 或 传统配置模式 来定义任务的推送范围。

模式说明

• 规则引擎模式：支持更复杂的逻辑（如“指定渠道且系统版本>10”），是新版系统的核心能力。
• 传统配置模式：仅支持单一维度的筛选（如仅按渠道或仅按MAC），主要用于兼容旧版数据。
• 逻辑共存：当任务同时配置了规则和传统条件时，系统通常会取并集或根据业务逻辑并行处理，建议新任务统一使用规则引擎。

---

核心概念：任务管理 | 推送信息管理 | 1. 规则配置管理 (新版推荐)

1. 规则配置管理 (新版推荐)

这是新版任务推送的核心配置入口，集成了系统强大的规则引擎能力。

• 绑定规则：直接引用规则中心已定义好的规则（如“高端机型通用规则”）。
• 新建规则：为当前任务创建一个专用规则。
• 灵活条件：支持渠道、MAC、地区、版本号、设备型号等多种条件的组合与逻辑运算。

---

核心概念：任务管理 | 推送信息管理 | 2. 传统配置模式 (Legacy)

2. 传统配置模式 (Legacy)

以下配置方式属于旧版逻辑，主要用于兼容历史数据。

2.1 渠道配置管理

当筛选方式选择为"渠道"时，在此处管理关联的渠道。

• 新增：添加关联的渠道。
• 删除：移除关联的渠道。

2.2 MAC配置管理

当筛选方式选择为"MAC导入"时，在此处管理目标设备的MAC地址。

• 新增单条：手动输入单个MAC地址。
• 批量导入：通过Excel文件批量导入MAC地址。
• 异步导出：导出当前的MAC地址列表。导出任务请在 导出任务管理 中查看。
• 删除：移除MAC地址。

2.3 地区配置管理

配置任务生效的地区限制。

• 新增：添加限制的地区（国家/省份/城市）。
• 删除：移除地区限制。

---

核心概念：任务管理 | 推送信息管理 | 3. 设备推送详情管理 (推送信息管理)

3. 设备推送详情管理 (推送信息管理)

在推送信息管理模块中，您可以查看任务推送到具体设备的执行结果。

• 查询：按设备MAC或状态查询。
• 列表展示：显示设备ID、推送状态、结果反馈等信息。

---

核心概念：任务管理 | 推送信息管理 | 3. 请求处理流程 (APK任务推送)

3. 请求处理流程 (APK任务推送)

3.1 简易流程图 (用户视角)

Mermaid Diagram Code:

sequenceDiagram
    participant Device as "终端设备"
    participant Server as "云端服务器"

    Device->>Server: "1. 定时请求任务信息"
    Server->>Server: "2. 筛选适用任务 (规则匹配)"
    Server-->>Device: "3. 返回APK配置信息 (URL/包名/版本号)"
    Device->>Device: "4. 本地检测 (安装状态/版本对比)"
    alt 需要安装/升级
        Device->>Device: "5. 下载并安装 APK"
        Device->>Server: "6. 上报执行结果"
    else 无需操作
        Device->>Device: "7. 忽略"
    end

3.2 详细处理流程 (技术视角)

Mermaid Diagram Code:

sequenceDiagram
    participant STB as "机顶盒/设备"
    participant Biz as "任务推送模块"
    participant Rule as "规则引擎"

    STB->>Biz: "1. 发起任务查询请求"
    
    par "服务端处理"
        Biz->>Rule: "2. 规则匹配 & 基础筛选"
        Rule-->>Biz: "返回命中的任务ID"
    end
    
    Biz->>Biz: "3. 检查任务配置"
    Biz-->>STB: "4. 返回 APK 配置信息"

    Note over STB: 设备端逻辑
    STB->>STB: "5. 检测是否安装同包名应用"
    alt 未安装
        STB->>STB: "6a. 下载安装包并安装"
    else 已安装
        STB->>STB: "6b. 比较版本号 (Local < Server)"
        alt 版本较低
            STB->>STB: "6c. 下载安装包并安装 (升级)"
        end
    end
    STB->>Biz: "7. 上报安装完成结果"

3.3 逻辑详解

这里的任务主要用于 推送 APK。

1. 定时请求: 设备端定时请求任务信息。
2. 服务端匹配: 服务端接收请求后，若匹配上规则，则返回相应的配置信息。
3. 本地检测: 设备根据服务端返回的 APK 信息（如 URL、包名、版本号等），检测机器上是否已经安装了同版本的 APK。
   • 未安装: 若检测到未安装，则下载安装包进行安装。
   • 已安装: 若检测到已安装，则进一步检测本地版本是否 小于 任务推送的版本。
     • 若是，则下载安装包进行安装（升级）。
4. 结果上报: 下载安装完成后，设备向上报执行结果。