feat(#92): [M5] UAT 计划与执行支撑（用例集/准入准出/缺陷管理/排期/风险+一致性核对脚本）

2026-08-05 04:31:34 +08:00
parent e2d24f1839
commit 11f2c14ee3
3 changed files with 237 additions and 0 deletions
@@ -0,0 +1,89 @@
+# -*- coding: utf-8 -*-
+"""UAT 计划与执行支撑文档（docs/UAT计划与执行支撑.md，issue #92）一致性检查。
+
+检查项：
+1. 必备章节齐全（目标/角色/准入/用例集/执行计划/缺陷/准出/交付物/风险）；
+2. 验收流程六节点关键词存在（PRD §10：自测→内部评审→客户UAT→上线→质保观察→闭环）；
+3. NFR 量化指标齐全（PRD §9：P99≤1.8s / 丢失率≤0.02% / 可用性≥99.8% / 路由≥96.5% / 首屏≤2s）；
+4. 用例覆盖三类场景（监控A/优化B/LLM C）+ NFR + 移动端；
+5. 引用配套资产路径存在（部署手册/采集网隔离文档/healthz 探针）。
+
+用法：python _check_uat_plan.py
+"""
+import os
+import sys
+
+HERE = os.path.dirname(os.path.abspath(__file__))
+DOC_PATH = os.path.join(HERE, "UAT计划与执行支撑.md")
+
+REQUIRED_SECTIONS = [
+    "## 1. 目标与范围",
+    "## 2. 角色与职责（RACI）",
+    "## 3. 准入条件（Entry Criteria）",
+    "## 4. UAT 测试用例集",
+    "## 5. 执行计划与排期",
+    "## 6. 缺陷管理（Bug Triage）",
+    "## 7. 准出条件（Exit Criteria / 放行）",
+    "## 8. 交付物清单（UAT 阶段）",
+    "## 9. 风险与缓解",
+]
+
+# PRD §10 验收流程六节点
+FLOW_KEYWORDS = ["自测", "内部评审", "客户 UAT", "上线", "质保观察", "闭环"]
+
+# PRD §9 NFR 量化底线
+NFR_KEYWORDS = ["1.8s", "0.02%", "99.8%", "96.5%", "2s"]
+
+# 用例场景覆盖（用例编号前缀）
+SCENARIO_PREFIXES = ["UAT-A-", "UAT-B-", "UAT-C-", "UAT-N-", "UAT-M-"]
+
+# 必须存在的配套资产路径（相对仓库根）
+# 注：部署手册（issue #91）随其 PR 合并后存在；本脚本校验本仓库主干已具备的资产。
+ASSET_PATHS = [
+    "docs/产品设计文档_iAOP.md",          # PRD（UAT 用例依据来源）
+    "docs/采集网只读隔离与网闸配置.md",    # UAT-N-05 网络只读验证依据
+    "deploy/k8s/healthz/probe_availability.py",  # UAT-N-02 可用性探针
+]
+
+
+def main() -> int:
+    failures = []
+    repo_root = os.path.dirname(HERE)
+
+    if not os.path.isfile(DOC_PATH):
+        print("FAIL\n - UAT 计划文档不存在：UAT计划与执行支撑.md")
+        return 1
+
+    text = open(DOC_PATH, "r", encoding="utf-8").read()
+
+    for sec in REQUIRED_SECTIONS:
+        if sec not in text:
+            failures.append(f"缺少必备章节：{sec}")
+
+    for kw in FLOW_KEYWORDS:
+        if kw not in text:
+            failures.append(f"缺少验收流程节点关键词：{kw}")
+
+    for kw in NFR_KEYWORDS:
+        if kw not in text:
+            failures.append(f"缺少 NFR 量化指标关键词：{kw}")
+
+    for prefix in SCENARIO_PREFIXES:
+        if prefix not in text:
+            failures.append(f"用例未覆盖场景前缀：{prefix}")
+
+    for rel in ASSET_PATHS:
+        if not os.path.isfile(os.path.join(repo_root, *rel.split("/"))):
+            failures.append(f"配套资产缺失：{rel}")
+
+    if failures:
+        print("FAIL")
+        for f in failures:
+            print(" -", f)
+        return 1
+    print("OK: UAT 计划章节/流程节点/NFR指标/场景覆盖/配套资产校验通过")
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())