fix(caliber): 流动/速动比率改「倍」口径 + 判定层同量纲直判（ASK-20260924-11 任总放行）

- caliber_units: F_CURRENT_RATIO/F_QUICK_RATIO 由 FACTOR_PERCENT(×100) 退场为 FACTOR_IDENTITY；declared_unit=倍 / caliber=倍（无量纲）/ evidence 改引 v2.1 锚；F_GROSS_MARGIN 保持 ×100 不动 - 引用面同步 7 文件：alert_generator / kpi_unit_crosscheck / migrate_...20260916 横幅 / 三个测试套件；self-test 两条改倍口径期望 yellow 口径: CMA-CALIBER-v2.1/kpi-unit@2026-09-24 取代 2a 之两项；其余比率类仍按裁定2a 百分比口径
2026-09-25 10:39:18 +08:00
parent c3ff345d0a
commit a8391a03da
7 changed files with 101 additions and 63 deletions
@@ -18,7 +18,10 @@ from app.database import get_session_local
 from app.models import KPIDefinition, KPIValue, KPIAlert, ActionPlan, OperationLog
 from app.utils.oplog import log_op
 from app.utils.threshold_parser import eval_threshold, LEVEL_PRIORITY
-# 裁定2a（2026-09-17 财务口径）：比率类指标统一「百分比(%)」口径（取数×100），
+# 口径双轨（唯一事实源 app/utils/caliber_units.RATIO_CALIBER_TABLE）：
+#   · `CMA-CALIBER-v2.1/kpi-unit@2026-09-24`（wecom-finance/reports/CMA_口径裁定_20260924_比率类单位口径_取代2a两指标.md）：
+#     `F_CURRENT_RATIO` / `F_QUICK_RATIO` 改「倍」（无量纲、同量纲直判，**不再 ×100**）；
+#   · 裁定2a（2026-09-17 财务口径，wecom-finance/reports/CMA_口径裁定_20260917.md）：其余比率类仍「百分比(%)」（取数×100）；
 # 未核对/疑似单位错配的项降级待核（不落预警、不推送）
 from app.utils.caliber_units import resolve_caliber
 # 裁定 R1/R2/R3（2026-09-19 财务口径）：账套范围（demo 排除）/ 期间窗口 / 规整月期间
@@ -142,11 +145,13 @@ def run_alert_check(db_session, period: Optional[str] = None, dry_run: bool = Fa
                    stats: Optional[dict] = None, now: Optional[datetime] = None) -> int:
    """检查所有KPI的实际值是否触发预警，返回（将）新生成的预警数

-    2026-09-17 财务口径裁定 2a/2b：
+    2026-09-17 财务口径裁定 2a/2b（2a 的两项已由 `CMA-CALIBER-v2.1/kpi-unit@2026-09-24` 取代为倍口径）：
      · **期间（2b）**：period=None → 每个 KPI 回落「最近可用期间」（自己的最新 YYYY-MM，
        排除 H1/H2 伪期间），不再硬编码当月（当月无值 → 永久 0 新预警）；
-      · **单位（2a）**：判定前经 resolve_caliber() 归一到「百分比(%)」口径（取数×100，
-        与阈值 150/80 同量纲）；**未核对/疑似单位错配**的项降级待核 → 不落预警、不推送；
+      · **单位口径**：判定前经 resolve_caliber()（唯一事实源 `RATIO_CALIBER_TABLE`）——
+        `F_CURRENT_RATIO`/`F_QUICK_RATIO` 按 `CMA-CALIBER-v2.1/kpi-unit@2026-09-24` **倍口径同量纲直判**
+        （factor=1，与 DB 新阈值 2.0/1.0 与 1.0/0.5 同量纲）；其余比率类仍按裁定2a 归一到「百分比(%)」（取数×100）；
+        **未核对/疑似单位错配**的项降级待核 → 不落预警、不推送；
      · dry_run=True → 只计算不写库（抽查复核与放行前证据用）。

    2026-09-19 财务口径裁定 R1/R2/R3（`alert_entity_scope` 单一事实源）：
@@ -232,7 +237,7 @@ def run_alert_check(db_session, period: Optional[str] = None, dry_run: bool = Fa
            st["no_value"] += 1
            continue

-        # 单位口径（裁定2a）：取数归一 + 疑似错配降级门
+        # 单位口径（v2.1 倍口径直判 / 2a 归一）：resolve_caliber 单一入口 + 疑似错配降级门
        cal = resolve_caliber(latest.actual_value, kpi)
        if cal["status"] == "dimension_suspect":
            st["dimension_suspect"] += 1
@@ -410,7 +415,7 @@ def generate_and_push(db_session, period: Optional[str] = None, dry_run: bool =
                      now: Optional[datetime] = None) -> dict:
    """生成预警并推送，返回统计

-    2026-09-17 财务口径裁定 2a/2b：
+    2026-09-17 财务口径裁定 2a/2b（2a 的两项已由 `CMA-CALIBER-v2.1/kpi-unit@2026-09-24` 取代为倍口径）：
      · **period=None** → 判定期间 = 各 KPI「最近可用期间」（裁定2b，不再硬编码当月）；
        显式给出 period → 固定该期间（抽查复核用）；
      · **dry_run=True** → 零写入、零推送：返回将生成的预警清单与口径证据（放行前抽查复核）。
@@ -490,7 +495,7 @@ def generate_and_push(db_session, period: Optional[str] = None, dry_run: bool =
            "push_skipped_no_channel": push_skipped_no_channel,
            "cleaned_green": cleaned, "rule_engine": rule_stats,
            "coverage": coverage,
-            # 裁定2a 口径证据
+            # 口径证据（v2.1 倍口径直判 / 2a 归一；唯一事实源 caliber_units.RATIO_CALIBER_TABLE）
            "normalized": st.get("normalized", 0), "normalized_kpis": st.get("normalized_kpis", []),
            "dimension_suspect": st.get("dimension_suspect", 0), "suspect_kpis": st.get("suspect_kpis", []),
            # 期间/取值覆盖明细
@@ -550,7 +555,7 @@ def coverage_note(result: dict) -> str:
 if __name__ == "__main__":
    import argparse

-    ap = argparse.ArgumentParser(description="预警生成与推送（2026-09-17 口径裁定 2a/2b）")
+    ap = argparse.ArgumentParser(description="预警生成与推送（口径：2a + 2026-09-24 v2.1 取代两项）")
    ap.add_argument("--dry-run", action="store_true", help="只计算不写库不推送（抽查复核/放行前证据）")
    ap.add_argument("--period", default=None, help="固定判定期间 YYYY-MM（缺省=各 KPI 最近可用期间，裁定2b）")
    ap.add_argument("--json", action="store_true", help="JSON 输出完整证据（含将生成的预警清单）")
@@ -1,8 +1,14 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*-
-"""比率类 KPI 单位对照表（只读）—— 财务口径裁定 裁定2a 的产出器
+"""比率类 KPI 单位对照表（只读）—— 口径 = 裁定2a + 2026-09-24 v2.1（取代两项）
+
+依据：`wecom-finance/reports/CMA_口径裁定_20260924_比率类单位口径_取代2a两指标.md`
+     （`CMA-CALIBER-v2.1/kpi-unit@2026-09-24`）—— 取代 `wecom-finance/reports/CMA_口径裁定_20260917.md`
+     §2a 中的 `F_CURRENT_RATIO` / `F_QUICK_RATIO` **两项**（改「倍」、无量纲直判、不再 ×100）；
+     其余比率类指标仍按 20260917 裁定2a（百分比 %）执行。

 用途：逐个比率类 KPI 核对「定义 / 声明单位 / 阈值量纲 / 实测值量纲」，出对照表。
+      两类口径在表里分栏可见：`factor=1` + `unit=倍` = 倍口径同量纲直判；`factor=100` = 裁定2a 百分比归一。
      判定侧的事实源是 `app/utils/caliber_units.RATIO_CALIBER_TABLE`（本脚本只核对与呈现，
      不写库、不改阈值）。

@@ -80,7 +86,7 @@ def main():
        print(json.dumps(out, ensure_ascii=False, indent=1, default=str))
        return 0

-    print("=== 比率类 KPI 单位对照表（只读；裁定2a）===")
+    print("=== 比率类 KPI 单位对照表（只读；口径 = 2a + v2.1 取代两项）===")
    print("%-4s %-8s %-22s %-6s %-10s %-12s %-8s %-6s %s" % (
        "eid", "code", "name", "unit", "latest", "actual", "status", "factor", "thresholds"))
    for x in out:
@@ -2,15 +2,20 @@
 # -*- coding: utf-8 -*-
 """阈值单位口径修正 + 量纲守卫装配（迁移脚本·准备态）

-⚠️ **已被取代，不得执行（2026-09-17）**：
+⚠️ **已被取代，不得执行（2026-09-17 首次判定；2026-09-24 复判并补新锚）**：
   本脚本基于 2026-09-16 的口径草案（**把阈值改成「倍」写法** >=2.0/>=1.0/<1.0）。
-   2026-09-17 财务**正式裁定**（`wecom-finance/reports/CMA_口径裁定_20260917.md` 裁定2a）
-   采用**相反方向**：比率类统一「百分比(%)」口径、**阈值保持不变**（150/80），
-   在**取数层** ×100 归一（实现：`app/utils/caliber_units.py` + `scripts/alert_generator.py`）。
-   ⇒ 执行本脚本会把口径反向切回「倍」，与现行裁定冲突；假红灯 586/587 在新口径下
-   **是合法红灯**（流动比率 1.29=129% < 150，与「流动性偏紧」一致），**不得作废**。
-   保留本文件仅为审计链（历史草案）——如未来另有阈值单位新裁定，须先改 `PLAN` 与
-   `--resolve-false-reds` 的语义再执行。
+   **状态更新（2026-09-24）**：
+   · 现行有效裁定 = `wecom-finance/reports/CMA_口径裁定_20260924_比率类单位口径_取代2a两指标.md`
+     （口径标识 `CMA-CALIBER-v2.1/kpi-unit@2026-09-24`；任总 2026-09-24 16:38 放行 ASK-20260924-11）。
+     该件**只取代** `CMA_口径裁定_20260917.md` §2a 中的 **`F_CURRENT_RATIO` / `F_QUICK_RATIO`**
+     两项（改「倍」、无量纲直判）；**其余比率类仍按 20260917 裁定2a（百分比 %）执行**。
+   · 本脚本 `PLAN` 里这两项的「倍」方向**与 v2.1 一致**，但**已由 ASK-20260924-11 单以受控路径落地**
+     （DB 写经受控脚本 + 判定层 `app/utils/caliber_units.py` 同量纲直判 + 代码测试发布），
+     **不得再执行本脚本**；本脚本 `PLAN` 另含 **`F_DEBT_RATIO`（不在 v2.1 取代范围内）**，
+     执行会越界改动他项 ⇒ 仅保留作审计链（历史草案）。
+   · `--resolve-false-reds` 的旧语义（586/587 按「口径错误」**作废**）**已作废**：v2.1 下该两条按
+     **口径变更改判**（1.29 倍 → 黄、0.54 倍 → 黄），留痕写明「口径变更所致」，**不删历史行**。
+   · 如未来另有阈值单位新裁定，须先改 `PLAN` 与 `--resolve-false-reds` 的语义再执行。

 原依据：财务口径裁定 finance-20260916-cma-caliber-ruling.md v1.0 §四（裁定③）+ §3.3/§3.4
  · 4.1 单位规范：偿债能力比率=**倍**（无量纲）；资产负债率等=%；返利率=%