From a9845eb2cfbf9fae4eb74aa7e73c28ab2c7d2735 Mon Sep 17 00:00:00 2001 From: Hermes CI Fix Date: Thu, 20 Aug 2026 15:39:09 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20KPI=E8=AE=BE=E8=AE=A1=E8=A7=84=E8=8C=83?= =?UTF-8?q?(=E4=BA=94=E6=AD=A5=E6=B3=95/=E4=BA=94=E8=A7=84=E5=88=99/?= =?UTF-8?q?=E4=B8=89=E8=B7=AF=E5=BE=84)=20=E2=80=94=20CMA=E6=96=B9?= =?UTF-8?q?=E6=B3=95=E8=AE=BA=E5=B1=82=E7=AC=AC2=E4=BB=BD=E8=A7=84?= =?UTF-8?q?=E8=8C=83?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 第2份方法论文档, 与科目≠KPI规范(第1份, 数据层)互引形成双层治理闭环 - 五步法: 职责→客户→需求→成果→五因素(时/量/质/成/险) - 五规则: ≤6个/权重5%-30%取5%倍数/定量定性/SMART/部门差异化 - 三路径: 自上而下战略分解/自下而上职责提取/BSC四维平衡 - 四层链: 战略地图→O→KPI→科目(呼应本体三支柱) --- docs/kpi-account-governance-rule.md | 81 ++++++++++++++++++++++++ docs/kpi-design-rule.md | 96 +++++++++++++++++++++++++++++ 2 files changed, 177 insertions(+) create mode 100644 docs/kpi-account-governance-rule.md create mode 100644 docs/kpi-design-rule.md diff --git a/docs/kpi-account-governance-rule.md b/docs/kpi-account-governance-rule.md new file mode 100644 index 00000000..a4fa51e0 --- /dev/null +++ b/docs/kpi-account-governance-rule.md @@ -0,0 +1,81 @@ +# CMA数据治理规范：科目≠KPI（参考数据与衍生指标分离） + +> 建立：2026-08-17 | 触发：修复财务维度失衡（287→86个KPI） +> 背景：ERP导入的201个会计科目（EXT_xxx）混入KPI字典，导致财务维度虚高到80%，工作台/维度分析/因果链全被科目噪声干扰 + +## 一、核心原则 + +``` +科目（account）= 参考数据（reference data） + → 记账用的原始科目（库存现金/应收账款/固定资产...） + → 描述"账怎么记"，不是考核目标 + +KPI（Key Performance Indicator）= 衍生指标（derived metric） + → 考核用的业务指标（净利润/交付及时率/客户满意度...） + → 描述"目标是什么、做到没有" + +两者不可混用 —— 混用 = 数据字典污染 = 统计失真 +``` + +## 二、判定标准 + +| 特征 | 科目（account） | KPI（指标） | +|:----|:--------------|:-----------| +| 用途 | 记账/核算 | 考核/管理 | +| 粒度 | 科目级（EXT_xxx） | 指标级（F_/C_/P_/L_前缀） | +| 编码 | EXT_开头（ERP导入） | 语义编码（F_REVENUE等） | +| 变化 | 随记账增减 | 有目标值/阈值 | +| 责任人 | 会计 | 业务负责人 | + +**快速判定**：有 target_value（目标值）和红黄绿阈值的是KPI；只有余额/发生额的是科目。 + +## 三、操作规范（强制） + +### 1. 新KPI录入 +``` +✅ 必须：语义编码（F_财务 / C_客户 / P_流程 / L_学习）+ 目标值 + 阈值 + 责任人 +❌ 禁止：把ERP科目直接复制进KPI字典 +``` + +### 2. ERP数据导入 +``` +✅ 科目数据走独立通道（账户余额表/财务报表，不进KPI字典） +❌ 禁止：ERP科目导入时自动创建KPI记录（2026-08-17前发生过，EXT_xxx×201） +``` + +### 3. 发现混入的科目 +``` +处置：status → archived（归档，保留数据可查，不参与统计） +步骤：备份 → 检查关联（kpi_alerts/action_plans/alert_rules）→ 归档 → 验证分布 +参考：2026-08-17 方案A执行记录（备份 /tmp/kpi_definitions_backup_20260817.sql） +``` + +## 四、本次修复记录（2026-08-17） + +``` +问题：EXT_xxx科目201个混入KPI字典（174个活跃），财务维度80% +根因：ERP科目导入未做类型区分，直接落KPI表 + ↓ +修复： + ① 备份 kpi_definitions（117KB） + ② 归档174个活跃EXT_科目（status→archived） + ③ 检查关联：kpi_alerts(0)/action_plans(0)/alert_rules(0)，无副作用 + ④ 补录6个真KPI（客户+4：复购/转介绍/投诉/响应时长；学习+2：知识沉淀/认证通过） + ↓ +结果：财务80%→35%，四维度 36/35/15/14 均衡 +``` + +## 五、长期建议 + +``` +① 建独立表 account_subjects（科目表），ERP导入只写此表 +② KPI字典加 kpi_type 字段（kpi/account）做硬性区分 +③ 数据质量检查（consistency-check）增加：KPI字典中不允许出现科目编码（EXT_前缀） +④ 与CDGA备考联动：这是"参考数据管理"+"数据标准"的实战案例 +``` + +## 六、关联 + +- 知识库：token-governance-methodology.md（数据治理方法论） +- CDGA：参考数据管理 / 数据质量管理 / 元数据管理章节 +- **KPI设计规范（第2份）**：`kpi-design-rule.md`（五步法/五规则/三路径——KPI从哪来、怎么设计好；本文档管KPI入库后的纯净） diff --git a/docs/kpi-design-rule.md b/docs/kpi-design-rule.md new file mode 100644 index 00000000..7738937f --- /dev/null +++ b/docs/kpi-design-rule.md @@ -0,0 +1,96 @@ +# CMA数据治理规范：KPI设计规范（五步法/五规则/三路径） + +> 建立：2026-08-20 | 触发：战略地图归档（strategy-map-kpi-source.md）——CMA有功能层缺方法论层 +> 定位：**第2份方法论规范**（第1份 = kpi-account-governance-rule.md 科目≠KPI，数据层规范） +> 用途：让客户/实施顾问按方法论建 KPI，不裸奔——CMA 从"能存 KPI"升级为"能指导 KPI 设计" + +## 一、KPI提取五步法（自下而上：从岗位职责提取） + +``` +① 明确岗位职责 → 这个岗位存在的价值是什么？（职责/使命） +② 分析客户是谁 → 服务对象：内部客户（上级/下游部门）+ 外部客户（终端/渠道） +③ 分析客户需求 → 客户对这个岗位的期望标准是什么？（要什么结果） +④ 确定成果输出 → 岗位需要产出什么可交付成果？（可观察/可衡量） +⑤ 五因素设计指标 → 对每个成果输出，从5个因素设计考核指标： + 时间（多快）数量（多少）质量（多好）成本（多省）风险（多稳） +``` + +**应用示例**（销售岗位）： +| 步骤 | 内容 | +|:--|:--| +| ① 职责 | 开拓客户、达成销售目标 | +| ② 客户 | 外部客户（新签/续约）+ 内部客户（交付/财务） | +| ③ 需求 | 快速响应、签单、回款可控 | +| ④ 成果 | 新增客户数、签约金额、回款额 | +| ⑤ 五因素 | 时间=响应时长 / 数量=新签客户数 / 质量=客户满意度 / 成本=获客成本 / 风险=坏账率 | + +## 二、指标设计五规则 + +| # | 规则 | 说明 | +|:--:|:--|:--| +| ① | **数量不超过6个** | 单一岗位/目标 KPI ≤6，聚焦关键成功因素（KPI太多=无重点） | +| ② | **权重5%-30%、取5%倍数** | 单指标权重下限5%上限30%，以5%为档（10%/15%/20%...） | +| ③ | **定量与定性兼顾** | 核心成果尽量定量（可衡量），过程/能力类允许定性（如满意度、胜任度） | +| ④ | **符合SMART原则** | S具体 / M可衡量 / A可实现 / R相关性 / T有时限 | +| ⑤ | **部门差异化** | 不同职能用不同KPI语言：产品→新品定义/上市周期；研究院→研发周期/专利；市场→线索转化率；销售→回款/毛利 | + +## 三、三条分解路径 + +``` +路径A 自上而下：战略地图 → 关键成功因素 → KPI + 从BSC四层（学习成长→内部流程→客户→财务）提取关键成功因素， + 落到具体KPI（战略地图是KPI分解的战略源头） + ↓ +路径B 自下而上：岗位职责 → 成果输出 → KPI + 用五步法从每个岗位提取（本文档"一"的方法） + ↓ +路径C BSC维度平衡审视：四维检查 + 财务/客户/流程/学习四个维度是否均衡？有没有过度偏向某一维？ + （参照 bsc_layer_config 各企业四层权重配置） +``` + +**完整分解链（四层链）**： +``` +战略地图（为什么做）→ OKR的O（做什么）→ KPI（怎么量）→ 科目（记什么） + BSC因果链 objectives表 kpi_definitions subjects表 +``` +这与本体三支柱互联（科目↔KPI↔OKR）呼应——战略地图正是 O 的上游源头。 + +## 四、与传统规范的关系（双层治理闭环） + +| 规范 | 层 | 管什么 | 文件 | +|:--|:--|:--|:--| +| 科目≠KPI | **数据层** | 参考数据与衍生指标分离（科目不许混入KPI字典） | `kpi-account-governance-rule.md` | +| KPI设计规范 | **设计层** | KPI怎么设计好（五步法/五规则/三路径） | 本文档 | + +``` +设计层（本文档）：怎么定好KPI → 五步法/五规则/三路径 + ↓ 产出 +数据层（科目≠KPI）：KPI入库后保证纯净 → 语义编码/阈值/责任人 + ↓ 闭环 +双层治理 = 设计有方法 + 数据有规矩 +``` + +**引用关系**： +- 本文档引用 `kpi-account-governance-rule.md`（KPI入库后的数据规范） +- `kpi-account-governance-rule.md` 引用本文档（KPI从哪来、怎么设计） + +## 五、执行检查清单（新建KPI时） + +``` +□ 五步法走完了吗？（职责/客户/需求/成果/五因素） +□ 数量 ≤6？ +□ 权重在5%-30%、5%倍数？ +□ 定量为主、定性为辅？ +□ SMART？（有时限：哪一期考核？） +□ 与战略地图/目标O有对应关系？ +□ 不是科目（参考科目≠KPI规范）？ +□ 有目标值/阈值/责任人（入库硬性要求）？ +``` + +## 六、关联 + +- 战略地图归档：`/root/WB_WS/_wisdom/reference/strategy-map-kpi-source.md`（方法论来源） +- 第1份规范：`kpi-account-governance-rule.md`（科目≠KPI，数据层） +- 系统内：`strategic_maps` / `map_objectives`（战略层）、`objectives`（目标层）、`kpi_definitions`（指标层）、`subjects` + `kpi_subject_map`（数据层） +- 本体三支柱：`docs/ontology-trilogy-done.md`（三层互联交付）