|
|
@@ -0,0 +1,649 @@
|
|
|
+# AIDOP S5/S6/S7 KPI 配置化系统操作手册
|
|
|
+
|
|
|
+> **副标题：汇总配置、维度配置、筛选与明细下钻**
|
|
|
+
|
|
|
+| 项 | 内容 |
|
|
|
+|---|---|
|
|
|
+| 系统名称 | Ai-DOP 企业智慧运营管理系统 |
|
|
|
+| 文档名称 | AIDOP S5/S6/S7 KPI 配置化系统操作手册 |
|
|
|
+| 适用版本 | server 1.0.294 / Web 2.4.273（以登录后系统实际版本为准） |
|
|
|
+| 覆盖模块 | S5 物料仓储 / S6 生产执行 / S7 成品仓储 |
|
|
|
+| 覆盖 KPI | 9 个正式 KPI（见附录 A） |
|
|
|
+| 编制日期 | 2026-08-05 |
|
|
|
+| 文档版本 | v1.0 |
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 修订记录
|
|
|
+
|
|
|
+| 文档版本 | 日期 | 修订内容 | 编制人 |
|
|
|
+|---|---|---|---|
|
|
|
+| v1.0 | 2026-08-05 | 首次编制：覆盖汇总配置、维度配置、看板筛选与明细下钻 | 项目组 |
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 目录
|
|
|
+
|
|
|
+1. 系统概述
|
|
|
+2. 登录与页面入口
|
|
|
+3. KPI Master 与配置状态查看
|
|
|
+4. 汇总配置操作
|
|
|
+5. 维度配置操作
|
|
|
+6. 看板筛选操作
|
|
|
+7. 明细下钻操作
|
|
|
+8. 9 个 KPI 使用速查表
|
|
|
+9. 状态说明
|
|
|
+10. 常见问题与处理
|
|
|
+11. 管理员操作注意事项
|
|
|
+12. 数据同步与 NO_DATA 说明
|
|
|
+- 附录 A～F
|
|
|
+
|
|
|
+> 在 Word / PDF 版本中，目录自动生成并带页码。
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 第一章 系统概述
|
|
|
+
|
|
|
+### 1.1 系统用途
|
|
|
+
|
|
|
+Ai-DOP 智慧运营管理系统的 KPI 配置化功能，用于将 S5/S6/S7 三个模块的关键运营指标（KPI）从"写死在代码里的计算"升级为"由管理员在页面上配置、可版本管理、可筛选下钻"的能力。业务人员无需开发介入，即可在看板上按日期、月份、物料、工单、订单、品类等维度查看 KPI 表现并下钻到明细。
|
|
|
+
|
|
|
+### 1.2 KPI 配置化解决的问题
|
|
|
+
|
|
|
+- **汇总口径可维护**：每个 KPI 的汇总计算 SQL（SUMMARY_SQL）可在页面上查看、复制、校验、试算、发布、激活，管理员改口径无需重新部署。
|
|
|
+- **维度可筛选下钻**：每个 KPI 的维度计算 SQL（DIMENSION_SQL）产出按维度拆分的结果，看板筛选与"查看明细"直接读取维度结果。
|
|
|
+- **版本安全**：汇总配置与维度配置均有版本管理与版本一致性门禁，避免"口径已变、维度还用旧口径"造成数据错配。
|
|
|
+
|
|
|
+### 1.3 汇总配置与维度配置的关系
|
|
|
+
|
|
|
+- **汇总配置（SUMMARY）**：产出 KPI 的整体汇总值，展示在看板卡片的默认状态。
|
|
|
+- **维度配置（DIMENSION）**：在汇总口径基础上，按维度（日期/月份/物料/工单/订单/品类）拆分产出结果，用于**筛选**与**明细下钻**。
|
|
|
+- **绑定关系**：每个维度配置必须**绑定当前生效的汇总配置版本**。当汇总配置发布新版本后，旧的维度配置会进入"版本不一致（VERSION_MISMATCH）"状态，需要重新绑定当前汇总版本。
|
|
|
+
|
|
|
+### 1.4 使用边界
|
|
|
+
|
|
|
+- **KPI 管理员**：进入"运营指标主数据（KPI Master）"，维护汇总配置与维度配置。
|
|
|
+- **普通看板用户**：进入 S5/S6/S7 智能运营看板，使用已发布的筛选与下钻，无需理解或编辑 SQL。
|
|
|
+
|
|
|
+> 当前不做细粒度权限拆分：具备 KPI 配置管理页面访问权限者，即可使用页面当前开放的配置操作。本手册不虚构"只读管理员""发布管理员"等当前不存在的角色。
|
|
|
+
|
|
|
+### 1.5 覆盖范围
|
|
|
+
|
|
|
+当前覆盖 S5、S6、S7 三个模块共 **9 个正式 KPI**（详见附录 A 与第八章速查表）。
|
|
|
+
|
|
|
+### 1.6 数据流程
|
|
|
+
|
|
|
+```
|
|
|
+业务 SQL（汇总口径 SUMMARY_SQL）
|
|
|
+ → 汇总配置（发布 / 激活）
|
|
|
+ → 维度配置（绑定当前汇总版本，发布 / 激活）
|
|
|
+ → 自动跑批（模块刷新 refresh，产出汇总值 + 维度结果）
|
|
|
+ → KPI 卡片（默认展示汇总值）
|
|
|
+ → 筛选（按已声明维度过滤，读维度结果）
|
|
|
+ → 明细下钻（查看维度明细 + 后端聚合值）
|
|
|
+```
|
|
|
+
|
|
|
+> 上图可用 Word 原生形状绘制，无需截图。
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 第二章 登录与页面入口
|
|
|
+
|
|
|
+### 2.1 登录系统
|
|
|
+
|
|
|
+**用途**：进入 Ai-DOP 系统。
|
|
|
+
|
|
|
+**步骤**：
|
|
|
+1. 打开系统地址（内网访问地址，以实际部署为准）；
|
|
|
+2. 在**账号**输入框输入账号；
|
|
|
+3. 在**密码**输入框输入密码；
|
|
|
+4. 点击 **登 录**；
|
|
|
+5. 进入系统首页（工作台）。
|
|
|
+
|
|
|
+> 
|
|
|
+> **图 2-1** 登录页面（账号登录页签；密码框内容不显示明文）
|
|
|
+>
|
|
|
+> 
|
|
|
+> **图 2-2** 登录后进入的系统首页（工作台）
|
|
|
+
|
|
|
+> ⚠️ 截图中不得显示真实密码、Token。
|
|
|
+
|
|
|
+### 2.2 进入 KPI 管理页面（运营指标主数据）
|
|
|
+
|
|
|
+**用途**：进入 KPI 配置管理入口。
|
|
|
+
|
|
|
+**步骤**：
|
|
|
+1. 展开一级菜单 **Ai-DOP**；
|
|
|
+2. 展开 **智慧运营看板**；
|
|
|
+3. 点击 **运营指标主数据**（页面标题为 **运营指标主数据**，右上角标识 **KPI Master**）。
|
|
|
+
|
|
|
+> 
|
|
|
+> **图 2-3** 左侧菜单：Ai-DOP → 智慧运营看板 → 运营指标主数据
|
|
|
+>
|
|
|
+> 
|
|
|
+> **图 2-4** 运营指标主数据（KPI Master）页面：左侧为 KPI 树，右侧为指标详情
|
|
|
+
|
|
|
+### 2.3 进入 S5/S6/S7 看板
|
|
|
+
|
|
|
+**用途**：进入三个模块的智能运营看板。
|
|
|
+
|
|
|
+**步骤**：在 **Ai-DOP → 智慧运营看板** 下分别点击：
|
|
|
+- **S5 物料仓储看板**
|
|
|
+- **S6 生产执行看板**
|
|
|
+- **S7 成品仓储看板**
|
|
|
+
|
|
|
+> 
|
|
|
+> **图 2-5** S5 物料仓储看板
|
|
|
+>
|
|
|
+> 
|
|
|
+> **图 2-6** S6 生产执行看板
|
|
|
+>
|
|
|
+> 
|
|
|
+> **图 2-7** S7 成品仓储看板
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 第三章 KPI Master 与配置状态查看
|
|
|
+
|
|
|
+### 3.1 页面结构
|
|
|
+
|
|
|
+**运营指标主数据（KPI Master）** 页面顶部有四个页签：
|
|
|
+
|
|
|
+- **指标管理**：KPI 树、指标基本信息（编码、名称、层级、单位、方向、阈值、责任部门等）。
|
|
|
+- **数据导入**：Excel 模板导入。
|
|
|
+- **计算配置**：汇总配置（SUMMARY）管理。
|
|
|
+- **维度配置**：维度配置（DIMENSION）管理。
|
|
|
+
|
|
|
+**步骤**：
|
|
|
+1. 在 **指标管理** 页签左侧 KPI 树中，展开对应模块（如 S5 物料仓储）；
|
|
|
+2. 点击某个 KPI（如 `S5_L1_001` 物料上线周期），右侧显示指标详情；
|
|
|
+3. 切换到 **计算配置** 或 **维度配置** 页签查看/维护对应配置。
|
|
|
+
|
|
|
+> 
|
|
|
+> **图 3-1** KPI 树（按模块 S1～S9 分组，层级 L1/L2/L3/L4）
|
|
|
+>
|
|
|
+> 
|
|
|
+> **图 3-2** 选中 `S5_L1_001` 后右侧显示指标详情
|
|
|
+>
|
|
|
+> 
|
|
|
+> **图 3-3** 顶部页签：指标管理 / 数据导入 / 计算配置 / 维度配置
|
|
|
+
|
|
|
+### 3.2 配置状态说明
|
|
|
+
|
|
|
+配置（无论汇总或维度）有以下发布状态：
|
|
|
+
|
|
|
+| 状态 | 含义 |
|
|
|
+|---|---|
|
|
|
+| `DRAFT` | 草稿，可编辑、可校验、可试算，不参与正式取数 |
|
|
|
+| `PUBLISHED` | 已发布，只读；发布后需再"激活"才成为当前生效版本 |
|
|
|
+| `RETIRED` | 已退役，只读，不再供数，不可再次激活 |
|
|
|
+| **Current（生效）** | 当前生效版本；同一 KPI 只能有一个 Current |
|
|
|
+
|
|
|
+> 本系统配置发布状态实际取值为 `DRAFT` / `PUBLISHED` / `RETIRED`，以及"是否 Current（生效）"标记。手册不描述系统当前不存在的状态。
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 第四章 汇总配置操作（计算配置页签）
|
|
|
+
|
|
|
+> 适用读者：KPI 管理员。
|
|
|
+
|
|
|
+### 4.1 查看当前汇总配置
|
|
|
+
|
|
|
+**用途**：查看某 KPI 当前生效的汇总计算配置。
|
|
|
+
|
|
|
+**步骤**：在 **计算配置** 页签下查看版本列表与当前生效版本。主要字段：
|
|
|
+
|
|
|
+| 字段 | 说明 |
|
|
|
+|---|---|
|
|
|
+| 版本号 | 汇总配置版本 |
|
|
|
+| 引擎（CalcEngineType） | 计算引擎，如 `CONFIG_SQL` |
|
|
|
+| 数据源（DataSourceCode） | 如 `MDP_LOCAL`（本地中台库） |
|
|
|
+| SQL | 汇总计算 SQL（只读展示） |
|
|
|
+| 状态 | `DRAFT` / `PUBLISHED` / `RETIRED` |
|
|
|
+| 是否生效 | 是否为 Current |
|
|
|
+| 发布人 | 发布该版本的用户 |
|
|
|
+
|
|
|
+> 
|
|
|
+> **图 4-1** 计算配置页签：版本列表与当前生效版本
|
|
|
+
|
|
|
+### 4.2 复制为新草稿
|
|
|
+
|
|
|
+**用途**：在不影响正式版本的前提下修改配置。
|
|
|
+
|
|
|
+**要点**：
|
|
|
+- 已发布版本**不能原地修改**；
|
|
|
+- 修改需**复制为新版本**，复制后进入 `DRAFT`；
|
|
|
+- 未保存时不影响正式版本。
|
|
|
+
|
|
|
+> 
|
|
|
+> **图 4-2** 新建/复制草稿后进入可编辑状态
|
|
|
+
|
|
|
+### 4.3 编辑并保存草稿
|
|
|
+
|
|
|
+可编辑字段：计算引擎、数据源、超时（秒）、SQL 等。
|
|
|
+
|
|
|
+> ⚠️ **警告**：不要随意修改业务 SQL、数据源与业务计算口径；口径变更需业务方确认。
|
|
|
+
|
|
|
+### 4.4 Validate（校验）
|
|
|
+
|
|
|
+**用途**：检查 SQL 安全性、引用表与输出契约。
|
|
|
+
|
|
|
+**要点**：
|
|
|
+- Validate 只检查 **SQL 安全性 / 引用表 / 输出契约**；
|
|
|
+- **Validate 成功 ≠ 业务公式正确**，业务 SQL 由业务方负责。
|
|
|
+
|
|
|
+> 
|
|
|
+> **图 4-3** 校验结果：`VALID` 及引用表信息
|
|
|
+
|
|
|
+### 4.5 Preview（试算）
|
|
|
+
|
|
|
+**用途**：用真实**只读**数据试算，不写正式值。
|
|
|
+
|
|
|
+展示：返回值、分子、分母、行数、耗时。
|
|
|
+
|
|
|
+> `NO_DATA` 不一定是错误——可能是当前口径下确无数据。
|
|
|
+
|
|
|
+> 
|
|
|
+> **图 4-4** 试算结果：`SUCCESS`，含指标值 / 分子 / 行数 / 耗时
|
|
|
+
|
|
|
+### 4.6 Publish（发布）
|
|
|
+
|
|
|
+发布后版本状态由 `DRAFT` 变为 `PUBLISHED`（只读）。发布后**仍需激活**才成为 Current。
|
|
|
+
|
|
|
+### 4.7 Activate（激活）
|
|
|
+
|
|
|
+**要点**：
|
|
|
+- 激活后成为 **Current**；
|
|
|
+- 同一 KPI **只能有一个 Current**；
|
|
|
+- 激活前应确认维度配置的绑定关系。
|
|
|
+
|
|
|
+### 4.8 Retire（退役）
|
|
|
+
|
|
|
+**要点**：
|
|
|
+- 只能退役**非 Current** 版本；
|
|
|
+- `RETIRED` 版本只读、不再供数。
|
|
|
+
|
|
|
+### 4.9 手工运行（Run）
|
|
|
+
|
|
|
+**要点**：
|
|
|
+- 正常情况下由模块 **刷新（refresh）** 自动跑批；
|
|
|
+- 不建议频繁手工执行；
|
|
|
+- 手工 Run 前确认日期、租户与版本。
|
|
|
+
|
|
|
+### 4.10 汇总运行日志
|
|
|
+
|
|
|
+字段：BatchId、配置版本、运行状态（SUCCESS/NO_DATA/FAILED）、行数、开始时间、结束时间、错误摘要。
|
|
|
+
|
|
|
+> 
|
|
|
+> **图 4-5** 汇总配置版本列表
|
|
|
+>
|
|
|
+> 
|
|
|
+> **图 4-6** 汇总运行日志
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 第五章 维度配置操作（维度配置页签）
|
|
|
+
|
|
|
+> 适用读者：KPI 管理员。
|
|
|
+
|
|
|
+### 5.1 汇总配置与维度配置的关系
|
|
|
+
|
|
|
+> **核心规则：维度配置必须绑定当前生效的汇总配置版本。**
|
|
|
+
|
|
|
+当汇总配置发布并激活了新版本后，仍绑定旧汇总版本的维度配置会进入**版本不一致（VERSION_MISMATCH）**状态，需复制维度配置并重新绑定当前汇总版本。
|
|
|
+
|
|
|
+### 5.2 查看当前维度配置
|
|
|
+
|
|
|
+在 **维度配置** 页签的"配置概览"中查看：
|
|
|
+
|
|
|
+| 字段 | 说明 |
|
|
|
+|---|---|
|
|
|
+| 维度版本 | 维度配置版本，如 `v1` |
|
|
|
+| 绑定汇总版本 | 该维度配置绑定的汇总版本，如 `v2` |
|
|
|
+| 当前汇总版本 | 当前生效的汇总版本，如 `v2` |
|
|
|
+| 版本一致 | `一致` / `不一致`（不一致时显红） |
|
|
|
+| 数据源 | 如 `MDP_LOCAL` |
|
|
|
+| 聚合类型（AggregationType） | 见 5.4 |
|
|
|
+| 支持维度（SupportedDimensions） | 见 5.3 |
|
|
|
+| 发布状态 | `DRAFT` / `PUBLISHED` / `RETIRED` |
|
|
|
+| 最后运行 | 最近一次维度跑批状态与时间 |
|
|
|
+
|
|
|
+> 
|
|
|
+> **图 5-1** 维度配置概览：维度版本 / 绑定汇总版本 / 当前汇总版本 / 版本一致 / 支持维度 等
|
|
|
+
|
|
|
+### 5.3 支持维度（SupportedDimensions）
|
|
|
+
|
|
|
+系统当前实际支持的维度字段：
|
|
|
+
|
|
|
+| 维度标识 | 含义 |
|
|
|
+|---|---|
|
|
|
+| `value_date` | 日期 |
|
|
|
+| `biz_month` | 月份 |
|
|
|
+| `material_code` | 物料编码 |
|
|
|
+| `work_order_no` | 工单号 |
|
|
|
+| `category_code` | 品类编码 |
|
|
|
+| `order_no` | 订单号 |
|
|
|
+
|
|
|
+> 
|
|
|
+> **图 5-2** 支持维度：如 `S5_L1_001` 为"日期、物料编码"
|
|
|
+
|
|
|
+### 5.4 聚合类型（AggregationType）
|
|
|
+
|
|
|
+| 聚合类型 | 通俗解释 |
|
|
|
+|---|---|
|
|
|
+| `AVERAGE_OF_SUMS` | 各维度累计值之和 ÷ 样本数之和（均值口径） |
|
|
|
+| `RATIO_OF_SUMS` | 分子之和 ÷ 分母之和（比率口径，人效 KPI 使用） |
|
|
|
+
|
|
|
+> 顶部聚合值由后端计算，前端不重算（见第七章）。
|
|
|
+
|
|
|
+### 5.5 复制、保存、Validate、Preview、Publish、Activate、Retire
|
|
|
+
|
|
|
+维度配置的生命周期操作与汇总配置**流程一致**（复制草稿 → 保存 → Validate → Preview → Publish → Activate → Retire），但**增加版本绑定检查**：激活时若绑定的汇总版本与当前生效汇总版本不一致，系统将**禁止激活**。
|
|
|
+
|
|
|
+> 
|
|
|
+> **图 5-3** 维度配置校验结果：`VALID`
|
|
|
+>
|
|
|
+> 
|
|
|
+> **图 5-4** 维度配置试算结果：`SUCCESS`，含输出列与样本行
|
|
|
+
|
|
|
+### 5.6 版本不一致（VERSION_MISMATCH）
|
|
|
+
|
|
|
+**触发条件**：
|
|
|
+
|
|
|
+```
|
|
|
+当前生效汇总版本 ≠ 维度配置绑定的汇总版本
|
|
|
+```
|
|
|
+
|
|
|
+**系统行为**：
|
|
|
+- 维度配置概览显示**红色"版本不一致"**，并给出提示："当前维度配置绑定的汇总版本与生效汇总版本不一致，看板将标记 version_mismatch 且不回落。请复制新版本、重新绑定当前汇总后发布激活。"；
|
|
|
+- **禁止激活**旧绑定的维度版本；
|
|
|
+- 看板筛选返回 **`—`**（版本不一致），并且**不回落**旧维度值、**不回落**汇总值、**不回落** Atomic 值。
|
|
|
+
|
|
|
+> 
|
|
|
+> **图 5-5** 维度配置版本列表（示例含一个真实已退役 `RETIRED` 版本，用于说明版本关系）。
|
|
|
+>
|
|
|
+> ⚠️ **关于版本不一致截图的说明**：为避免破坏当前正式生效版本，本手册**未在正式环境重新构造** VERSION_MISMATCH 状态。版本不一致的红色提示（"绑定汇总 v2 / 当前汇总 v4 / 版本不一致" + 红色警告 + 激活按钮禁用）已在系统上线前的配置门禁验证（UAT）中真实出现并通过；此处以真实版本列表说明版本管理关系。当实际发生汇总版本推进时，维度配置概览会自动显红并给出上述提示。
|
|
|
+
|
|
|
+> ⚠️ 如当前正式环境没有 mismatch，**不得再次破坏性构造**。本手册对应截图采用配置生命周期 UAT 期间的真实页面证据；若无该截图，则以真实历史（已退役）版本列表说明版本关系，不伪造当前 mismatch。
|
|
|
+
|
|
|
+### 5.7 维度运行日志
|
|
|
+
|
|
|
+字段：BatchId、维度版本、汇总版本、业务日期、状态（SUCCESS/NO_DATA/FAILED）、行数、耗时、错误摘要。
|
|
|
+
|
|
|
+> 
|
|
|
+> **图 5-6** 维度配置版本列表（含"载入 / 复制新版本 / 退役"操作）
|
|
|
+>
|
|
|
+> 
|
|
|
+> **图 5-7** 维度运行日志（自动调度 / 手工 Run 记录）
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 第六章 看板筛选操作
|
|
|
+
|
|
|
+> 适用读者：普通看板用户。
|
|
|
+
|
|
|
+### 6.1 默认（汇总）状态
|
|
|
+
|
|
|
+**未使用筛选时，卡片显示当前汇总配置结果**（页面内部状态为 `summary_only`，正文称"默认汇总"）。普通用户无需理解内部状态码。
|
|
|
+
|
|
|
+> 
|
|
|
+> **图 6-1** 未筛选时，KPI 卡片显示默认汇总值
|
|
|
+
|
|
|
+### 6.2 日期筛选
|
|
|
+
|
|
|
+适用于支持日期维度的 KPI。
|
|
|
+
|
|
|
+**步骤**：
|
|
|
+1. 在看板顶部**基础查询**区选择**日期**范围；
|
|
|
+2. 按需输入**业务维度**（物料 / 工单 / 订单）；
|
|
|
+3. 点击 **查询**；
|
|
|
+4. 查看卡片变化（命中维度时显示"已按筛选"）；
|
|
|
+5. 点击 **重置** 返回默认汇总。
|
|
|
+
|
|
|
+> 
|
|
|
+> **图 6-2** 基础查询：日期、产品、订单号、物料、工单等
|
|
|
+>
|
|
|
+> 
|
|
|
+> **图 6-3** 选择日期与业务维度后点击查询
|
|
|
+
|
|
|
+### 6.3 月份筛选（人效 KPI）
|
|
|
+
|
|
|
+适用于三个人效 KPI（`S5_L1_003` / `S6_L2_003` / `S7_L1_003`）。
|
|
|
+
|
|
|
+**要点**：
|
|
|
+- 只能按**月份**筛选；
|
|
|
+- **不支持**物料、工单、订单等分维人效；
|
|
|
+- 人数是**月度总体人数**；**系统不分摊人数**。
|
|
|
+
|
|
|
+> 
|
|
|
+> **图 6-4** 人效 KPI 明细：仅"月份"筛选，展示月度总体人效
|
|
|
+
|
|
|
+### 6.4 各业务维度筛选对照
|
|
|
+
|
|
|
+| 维度 | 适用 KPI |
|
|
|
+|---|---|
|
|
|
+| 物料（material_code） | `S5_L1_001` |
|
|
|
+| 工单（work_order_no） | `S5_L1_002`、`S6_L2_002` |
|
|
|
+| 品类（category_code） | `S5_L1_004` |
|
|
|
+| 订单（order_no） | `S7_L1_001`、`S7_L1_002` |
|
|
|
+| 月份（biz_month） | `S5_L1_003`、`S6_L2_003`、`S7_L1_003` |
|
|
|
+
|
|
|
+> S6_L2_002 / S6_L2_003 卡片位于 S6 看板的 **L2 指标** 区：分别在"订单制造满足率""订单制造人效"L1 页签下展示。
|
|
|
+
|
|
|
+> 
|
|
|
+> **图 6-6** 在 S6 看板"订单制造满足率"L1 页签下，L2 区显示"工单制造满足率"卡片及其"查看明细"入口
|
|
|
+
|
|
|
+### 6.5 无数据状态
|
|
|
+
|
|
|
+筛选范围内没有数据时，卡片显示 **`—`** 和"当前筛选范围暂无数据"。
|
|
|
+
|
|
|
+> **强调：`—` 不等于 0。** 合法的 NO_DATA 不是系统错误。
|
|
|
+
|
|
|
+> 
|
|
|
+> **图 6-5** 筛选命中范围内无数据：显示 `—`
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 第七章 明细下钻操作
|
|
|
+
|
|
|
+### 7.1 通用维度下钻
|
|
|
+
|
|
|
+适用于：`S5_L1_001`、`S5_L1_002`、`S5_L1_003`、`S5_L1_004`、`S6_L2_002`、`S6_L2_003`、`S7_L1_002`、`S7_L1_003`。
|
|
|
+
|
|
|
+**步骤**：
|
|
|
+1. 在 KPI 卡片点击 **查看明细**；
|
|
|
+2. 抽屉顶部显示**当前筛选聚合值**；
|
|
|
+3. 查看明细行；
|
|
|
+4. 使用分页 / 排序；
|
|
|
+5. 调整筛选；
|
|
|
+6. 关闭抽屉。
|
|
|
+
|
|
|
+**顶部字段**：当前筛选指标值、样本数、汇总版本、维度版本。
|
|
|
+**明细字段**：日期或月份、维度编码、维度名称、指标值、分子、分母、累计值、样本数、批次（BatchId）。
|
|
|
+
|
|
|
+> 
|
|
|
+> **图 7-1** 通用维度明细抽屉：顶部聚合值 + 明细表 + 筛选 + 分页
|
|
|
+>
|
|
|
+> 
|
|
|
+> **图 7-2** 比率型 KPI（如工单制造满足率）明细含"分子 / 分母"列，顶部聚合值来自后端（示例 67.5%）
|
|
|
+>
|
|
|
+> 
|
|
|
+> **图 7-2b** 品类物料库存周转按"品类编码"维度下钻
|
|
|
+
|
|
|
+### 7.2 S7_L1_001 专用订单周期下钻
|
|
|
+
|
|
|
+**要点**：
|
|
|
+- 使用**专用抽屉**（标题"订单发货周期 · 订单明细"）；
|
|
|
+- 支持日期与订单搜索；
|
|
|
+- 顶部**平均发货周期来自后端**，前端不重算；
|
|
|
+- 明细显示订单号与周期。
|
|
|
+
|
|
|
+> 
|
|
|
+> **图 7-3** `S7_L1_001` 订单发货周期专用明细抽屉
|
|
|
+
|
|
|
+### 7.3 聚合值说明
|
|
|
+
|
|
|
+> **卡片筛选值 = 明细抽屉顶部聚合值（aggregateValue）。** 分页只影响当前展示行，不影响顶部聚合值。
|
|
|
+
|
|
|
+### 7.4 明细 NO_DATA
|
|
|
+
|
|
|
+无数据时：顶部显示 `—`、明细表为空、提示"当前筛选范围暂无数据"、不显示旧数据。
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 第八章 9 个 KPI 使用速查表
|
|
|
+
|
|
|
+| KPI 编码 | 名称 | 所属模块 | 单位 | 支持筛选 | 下钻方式 | 当前可能状态 |
|
|
|
+|---|---|---|---|---|---|---|
|
|
|
+| `S5_L1_001` | 物料上线周期 | S5 | 天 | 日期、物料 | 通用抽屉 | 正常 |
|
|
|
+| `S5_L1_002` | 物料上线满足率 | S5 | % | 日期、工单 | 通用抽屉 | 正常 |
|
|
|
+| `S5_L1_003` | 物料仓储人效 | S5 | 个/人 | 月份 | 通用抽屉 | 可能 NO_DATA |
|
|
|
+| `S5_L1_004` | 品类物料库存周转 | S5 | 天 | 日期、品类 | 通用抽屉 | 可能 NO_DATA |
|
|
|
+| `S6_L2_002` | 工单制造满足率 | S6 | % | 日期、工单 | 通用抽屉 | 正常 |
|
|
|
+| `S6_L2_003` | 工单制造人效 | S6 | 个/人 | 月份 | 通用抽屉 | 可能 NO_DATA |
|
|
|
+| `S7_L1_001` | 订单发货周期 | S7 | 天 | 日期、订单 | 专用抽屉 | 正常 |
|
|
|
+| `S7_L1_002` | 订单发货满足率 | S7 | % | 日期、订单 | 通用抽屉 | 正常 |
|
|
|
+| `S7_L1_003` | 成品仓储人效 | S7 | 个/人 | 月份 | 通用抽屉 | 可能 NO_DATA |
|
|
|
+
|
|
|
+> 名称、单位、支持维度以 KPI Master 与系统 capability 实际返回为准。
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 第九章 状态说明
|
|
|
+
|
|
|
+| 页面状态 | 含义 | 用户处理 |
|
|
|
+|---|---|---|
|
|
|
+| 正常值 | 当前范围存在有效数据 | 正常查看 |
|
|
|
+| `—` | 当前结果为空，**不等于 0** | 检查日期、月份与数据同步 |
|
|
|
+| 当前筛选范围暂无数据 | 筛选条件无匹配结果 | 调整筛选或重置 |
|
|
|
+| 配置版本不一致 | 汇总版本与维度绑定版本不一致 | 联系管理员重新绑定 |
|
|
|
+| 维度计算失败 | 当前维度跑批失败 | 查看运行日志 |
|
|
|
+| 尚未配置维度筛选 | KPI 没有已发布维度配置 | 联系管理员配置 |
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 第十章 常见问题与处理
|
|
|
+
|
|
|
+**1. 为什么卡片显示 `—`？** 可能：当前筛选无数据 / 人效 KPI 当月人数为 0 / 维度结果尚未生成 / 配置版本不一致 / 跑批失败。
|
|
|
+
|
|
|
+**2. 为什么卡片为 0，但明细为空？** 真实 0 与"无数据"不同——以页面状态与明细为准。
|
|
|
+
|
|
|
+**3. 为什么修改 SQL 后不能直接生效？** 需走：草稿 → Validate → Preview → Publish → Activate。
|
|
|
+
|
|
|
+**4. 为什么 Activate 按钮不可用？** 可能：当前版本不是可激活状态 / 已是 Current / 已 Retired / 绑定的汇总版本已过期（当前汇总版本与维度绑定版本不一致）。
|
|
|
+
|
|
|
+**5. 为什么人效 KPI 只能按月份筛选？** 因为当前人数数据是**月度总体人数**，系统不把人数分摊到订单、物料、工单或仓库。
|
|
|
+
|
|
|
+**6. 为什么筛选无数据后不显示默认汇总值？** 这是安全设计：筛选后无数据时**不回落**未筛选结果，避免把不相干的值误认为筛选结果。
|
|
|
+
|
|
|
+**7. 为什么看板显示与 Atomic 历史值不同？** 当前 9 个受管 KPI 的筛选结果统一由 DIMENSION_SQL 提供，不再由旧 Atomic 结果供数。
|
|
|
+
|
|
|
+**8. 如何查看失败原因？** 进入 KPI Master → 计算配置 / 维度配置 → 运行日志。
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 第十一章 管理员操作注意事项
|
|
|
+
|
|
|
+1. 不在已发布版本上直接修改；
|
|
|
+2. 修改必须复制新版本；
|
|
|
+3. Validate 成功不代表业务公式已获业务确认；
|
|
|
+4. Preview 只读执行；
|
|
|
+5. Publish 后仍需 Activate 才成为 Current；
|
|
|
+6. 一个 KPI 只能有一个 Current；
|
|
|
+7. 不随意回切历史版本；
|
|
|
+8. 激活前检查 Summary/Dimension 绑定；
|
|
|
+9. 不为出数补假数据；
|
|
|
+10. 不把 NULL 改成 0；
|
|
|
+11. 不给人效 KPI 分摊人数；
|
|
|
+12. 不删除历史版本与运行日志；
|
|
|
+13. 正常情况下使用自动跑批；
|
|
|
+14. 手工 Run 前确认日期、租户与版本；
|
|
|
+15. 发生错误先查看运行日志，不直接改库。
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 第十二章 数据同步与 NO_DATA 说明
|
|
|
+
|
|
|
+### 12.1 三个人效 KPI
|
|
|
+
|
|
|
+当前人数数据来源：`mdp_std_t8_sys_pelist`（按岗位统计的月度在职人数）。
|
|
|
+
|
|
|
+当开发/测试租户没有匹配的在职仓管或生产人员时：
|
|
|
+
|
|
|
+```
|
|
|
+headcount = 0 → aggregateValue = null → 页面显示 —
|
|
|
+```
|
|
|
+
|
|
|
+**这属于数据状态，不属于程序故障。**
|
|
|
+
|
|
|
+### 12.2 上游数据到位后的行为
|
|
|
+
|
|
|
+当 T8 人员数据正常同步后：
|
|
|
+
|
|
|
+```
|
|
|
+refresh → Summary 自动计算 → Dimension 自动计算 → 看板自动出值
|
|
|
+```
|
|
|
+
|
|
|
+**无需改代码或修改配置。**
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 附录
|
|
|
+
|
|
|
+### 附录 A：9 个 KPI 编码表
|
|
|
+
|
|
|
+| 编码 | 名称 | 模块 | 层级 | 单位 |
|
|
|
+|---|---|---|---|---|
|
|
|
+| `S5_L1_001` | 物料上线周期 | S5 | L1 | 天 |
|
|
|
+| `S5_L1_002` | 物料上线满足率 | S5 | L1 | % |
|
|
|
+| `S5_L1_003` | 物料仓储人效 | S5 | L1 | 个/人 |
|
|
|
+| `S5_L1_004` | 品类物料库存周转 | S5 | L1 | 天 |
|
|
|
+| `S6_L2_002` | 工单制造满足率 | S6 | L2 | % |
|
|
|
+| `S6_L2_003` | 工单制造人效 | S6 | L2 | 个/人 |
|
|
|
+| `S7_L1_001` | 订单发货周期 | S7 | L1 | 天 |
|
|
|
+| `S7_L1_002` | 订单发货满足率 | S7 | L1 | % |
|
|
|
+| `S7_L1_003` | 成品仓储人效 | S7 | L1 | 个/人 |
|
|
|
+
|
|
|
+### 附录 B：维度字段中英文对照
|
|
|
+
|
|
|
+| 字段 | 中文 |
|
|
|
+|---|---|
|
|
|
+| `value_date` | 日期 |
|
|
|
+| `biz_month` | 月份 |
|
|
|
+| `material_code` | 物料编码 |
|
|
|
+| `work_order_no` | 工单号 |
|
|
|
+| `category_code` | 品类编码 |
|
|
|
+| `order_no` | 订单号 |
|
|
|
+
|
|
|
+### 附录 C：配置状态对照
|
|
|
+
|
|
|
+| 状态 | 含义 |
|
|
|
+|---|---|
|
|
|
+| `DRAFT` | 草稿 |
|
|
|
+| `PUBLISHED` | 已发布（只读） |
|
|
|
+| `RETIRED` | 已退役（只读、不供数） |
|
|
|
+| Current | 当前生效（唯一） |
|
|
|
+
|
|
|
+### 附录 D：运行状态对照
|
|
|
+
|
|
|
+| 状态 | 含义 |
|
|
|
+|---|---|
|
|
|
+| `SUCCESS` | 运行成功 |
|
|
|
+| `NO_DATA` | 运行成功但无数据 |
|
|
|
+| `FAILED` | 运行失败 |
|
|
|
+
|
|
|
+### 附录 E：错误处理流程
|
|
|
+
|
|
|
+```
|
|
|
+页面异常
|
|
|
+→ 确认筛选条件
|
|
|
+→ 查看 capability / 状态提示
|
|
|
+→ 查看配置版本（绑定汇总 vs 当前汇总）
|
|
|
+→ 查看运行日志
|
|
|
+→ 确认数据同步
|
|
|
+→ 联系管理员或开发人员
|
|
|
+```
|
|
|
+
|
|
|
+### 附录 F：文档截图清单
|
|
|
+
|
|
|
+> 见同目录 `screenshot-index.md`。
|
YY968XX
