fix(h2-forecast): 对外 KPIValue 残余读路径统一实测区口径（7 处）

任总 2026-10-02 11:35 直令「对外 /api/cma/** 读 KPIValue 默认只取实测区；
预估禁进趋势序列 / 禁作预警与预算依据」的同族残余读路径收口。

7 处逐处改（均引 app/utils/kpi_value_scope.actual_only_clause，不新写字面量口径）：
- kpis.py:604            GET /kpis/{id} 详情历史值（预估禁进趋势序列）
- ai_analysis.py:363     GET /ai/kpi-analysis/{id} 趋势序列/LLM 上下文
- thresholds.py:132      GET /thresholds/suggest/{id} 阈值推荐依据
- budget_generate.py:94  GET /budget/kpi-budget-candidates 预算候选最新值
- budget.py:1380         POST /budget/apply-method 派生基数（预算依据）
- maps.py:657            GET /maps/{id}/review 地图节点最新值
- data_quality.py:363    GET /data-quality/stats 缺失判定（仅预估行不算有实际值）

证据：同脚本双树 A/B 11/11（改前 3/11 FAIL）+ pytest 3 failed/1529 passed 与基线逐条同 ID。
不 push / 不部署 / 不重启 / 不写库。

backend/app/api/budget_generate.py

@@ -9,6 +9,7 @@ from app.deps import get_entity_id
 from app.auth_middleware import require_auth, require_role
 from app.models import KPIDefinition, BudgetPlan, KPIValue, OperationLog
 from app.utils.oplog import log_op, SCOPE_BATCH
+from app.utils.kpi_value_scope import actual_only_clause
 import json
 import logging
 from datetime import datetime
@@ -92,7 +93,9 @@ def get_kpi_budget_candidates(
     latest_values = {}
     for kpi in kpis:
         v = db.query(KPIValue).filter(
-            KPIValue.kpi_id == kpi.id
+            KPIValue.kpi_id == kpi.id,
+            # 实测区口径：预估行禁作预算生成依据（kpi_value_scope.actual_only_clause）
+            actual_only_clause(),
         ).order_by(KPIValue.calculated_at.desc()).first()
         if v:
             latest_values[kpi.id] = v.actual_value