AiDOPWarehouse/doc/_bid_ch5.py

# -*- coding: utf-8 -*-
"""附件五 技术方案 第 5 章 UAT 测试与质量保障（3 分）。

对应评分要素：测试策略、业务场景覆盖、诊断模型验证、用例设计、缺陷管理、验收标准。
"""

BLOCKS_CH5 = [
    ("p", "本章按评分要素依次给出测试策略、业务场景覆盖、诊断模型验证方法、"
          "用例设计、缺陷管理与验收标准。"
          "本项目的测试工作以采购人主导的 UAT 验收测试为核心，"
          "我方承担测试方案编制、用例设计、环境准备、缺陷修复与回归验证，"
          "并向采购人提交完整的测试记录作为验收依据。"),

    ("h2", "5.1　测试策略"),
    ("h3", "5.1.1　测试体系与阶段划分"),
    ("p", "测试体系按左右对应的原则组织：需求确认、功能设计、技术设计、"
          "配置与开发四个建设环节，"
          "分别对应 UAT 验收测试、系统集成测试、接口与数据测试、"
          "单元与配置自测四个验证环节。"
          "每个建设环节的产出即为对应验证环节的判定基准，"
          "不存在无基准的测试。"),
    ("fig", ("fig_test_v", "测试体系与阶段交付物")),
    ("h3", "5.1.2　各阶段测试职责"),
    ("p", "四个阶段的测试主体、依据与准出条件如下表。"
          "阶段之间设置准出条件，"
          "未达到准出条件不进入下一阶段——"
          "这是避免问题层层向后传递、"
          "最终在 UAT 阶段集中爆发的关键控制点。"),
    ("table", ("测试阶段划分与职责",
               ["测试阶段", "主体", "测试依据", "准出条件"],
               [["单元与配置自测", "我方开发与实施人员",
                 "功能设计说明、配置清单",
                 "配置项自检清单全部通过；自测缺陷全部关闭"],
                ["接口与数据测试", "我方技术人员 + 采购人 IT",
                 "接口文档、数据映射表、指标口径确认书",
                 "接口联调通过；数据行数与金额与源系统对账一致"],
                ["系统集成测试", "我方测试人员",
                 "业务流程说明、跨模块场景清单",
                 "全部业务场景执行通过；致命与严重缺陷关闭"],
                ["UAT 验收测试", "采购人业务部门主导，我方支持",
                 "业务需求清单、UAT 用例集、验收标准",
                 "用例通过率达标；缺陷达到上线门槛；采购人签署验收结论"]],
               [2.2, 2.6, 3.2, 4.4], ["l", "l", "l", "l"])),
    ("h3", "5.1.3　测试环境与数据"),
    ("p", "项目使用开发、测试、验收、生产四套环境。"
          "验收环境与生产环境的软件版本、配置参数、集成通道设置保持一致，"
          "数据按脱敏规则从生产或源系统同步，"
          "使 UAT 阶段发现的问题具有生产代表性。"),
    ("p", "测试数据分两类：一类是采购人提供的真实历史业务数据，"
          "用于验证数据加工、指标计算与诊断结论是否符合实际；"
          "另一类是为覆盖边界条件而构造的用例数据，"
          "例如超期订单、零库存物料、检验不合格批次等，"
          "用于验证异常路径。"
          "两类数据配合使用，兼顾真实性与覆盖度。"),

    ("h2", "5.2　业务场景覆盖"),
    ("h3", "5.2.1　场景设计原则"),
    ("p", "业务场景以端到端可交付的业务价值为单位设计，"
          "而不是以单个功能页面为单位。"
          "原因是制造业的运营问题大多发生在环节交接处——"
          "单个功能各自都能正常操作，"
          "但订单信息传到生产环节时口径变了、"
          "采购到货信息回流到齐套判断时时点错了。"
          "只有按端到端场景测试，才能暴露这类问题。"),
    ("h3", "5.2.2　场景清单"),
    ("p", "本项目规划的 UAT 业务场景如下表，"
          "覆盖采购需求涉及的全部核心业务过程与智能运营能力。"
          "场景清单在项目启动后与采购人确认并可按实际业务补充。"),
    ("table", ("UAT 业务场景清单",
               ["序号", "业务场景", "覆盖模块", "验证要点"],
               [["1", "主数据建立与批量导入",
                 "S0", "编码规则生效、批量导入校验、变更全链路同步"],
                ["2", "合同评审到订单评审",
                 "S0、S1", "评审周期规则、交期测算依据、评审流转与留痕"],
                ["3", "订单下达到工单生成",
                 "S1、S2", "订单与工单关联、优先级传递、批次号写入"],
                ["4", "排程到可执行日计划",
                 "S2", "产能约束生效、工作日历与加班、排产异常记录"],
                ["5", "物料需求计划到采购订单",
                 "S3", "BOM 多层展开、净需求扣减、前置期反推下单时点"],
                ["6", "齐套判定与欠料预警",
                 "S3、S5", "齐套字段计算、欠料定位、异常自动生成"],
                ["7", "采购交货到来料检验入库",
                 "S4、S5", "交期回复、发货单流转、IQC 检验与入库"],
                ["8", "生产执行与过程检验",
                 "S6", "工序流转、IPQC 录入与审核、扩展表写入不改源单"],
                ["9", "成品入库到发货交付",
                 "S7、S1", "FQC 检验、入库、发货实绩回流订单交付状态"],
                ["10", "采购退货与质量追溯",
                 "S4、S5、S6", "退货流转、批次追溯链、责任定位"],
                ["11", "订单交付全景追踪",
                 "S1、S8", "八页签数据一致、节点时效预警、链路全景展示"],
                ["12", "异常发现到闭环验证",
                 "S8", "规则触发、自动派单、超时升级、验证不通过退回"],
                ["13", "智能诊断与根因定位",
                 "S9", "诊断结论可解释、维度下钻、措施与责任推荐"],
                ["14", "指标计算与看板下钻",
                 "S9", "指标口径一致、L1–L4 下钻到明细、口径版本留痕"],
                ["15", "ChatBI 自然语言取数",
                 "S9", "取数结果与看板一致、语义解析准确性"],
                ["16", "移动端四类场景",
                 "移动端", "生产执行、仓储物流、质量管理、协同决策"],
                ["17", "供应商门户协同",
                 "S4", "外部账号隔离、数据权限、交期回复与发货通知"],
                ["18", "集成通道与断点续传",
                 "集成", "六种接入方式、实时时延、网络中断恢复不重不漏"],
                ["19", "权限与数据可见范围",
                 "平台", "角色权限、数据权限、越权访问拦截"],
                ["20", "性能与并发",
                 "平台", "页面与查询响应、并发用户、夜间批量处理时长"]],
               [0.9, 3.4, 1.9, 6.2], ["c", "l", "l", "l"])),

    ("h2", "5.3　诊断模型验证"),
    ("h3", "5.3.1　验证的必要性"),
    ("p", "诊断模型与普通功能的测试方式不同。"
          "普通功能的正确性可以通过输入输出比对判定，"
          "而诊断模型输出的是判断结论，"
          "需要验证的是「这个结论是否符合业务实际」，"
          "无法仅靠程序逻辑核对。"
          "因此本项目为诊断模型单独设计验证方法。"),
    ("h3", "5.3.2　三种验证方法"),
    ("p", "第一种是历史数据回溯验证。"
          "取采购人过去一段时期的真实业务数据导入验收环境，"
          "让诊断引擎重新分析，"
          "把系统给出的问题清单与根因判断，"
          "与采购人当时实际发生的问题及事后查明的原因进行比对。"
          "命中一致的说明模型有效，"
          "漏报与误报的逐条分析原因并调整规则与阈值。"),
    ("p", "第二种是业务专家评审验证。"
          "由采购人的计划、采购、生产、质量各环节业务骨干"
          "对系统输出的诊断结论逐条评议，"
          "判断结论是否成立、根因是否指向正确、建议措施是否可执行。"
          "评议意见形成记录，"
          "作为规则与措施库调整的依据。"),
    ("p", "第三种是构造用例验证。"
          "针对每类诊断场景构造明确应当触发与明确不应触发的边界数据，"
          "验证规则的触发条件是否准确、"
          "阈值边界是否符合预期、"
          "多条件组合规则的逻辑是否正确。"
          "这一方法覆盖的是模型的技术正确性，"
          "与前两种方法验证的业务有效性互为补充。"),
    ("h3", "5.3.3　验证指标与通过标准"),
    ("p", "诊断模型的验证以量化指标判定，标准如下表。"
          "指标的具体目标值在项目启动后结合采购人数据质量情况协商确定，"
          "下表为我方建议值。"),
    ("table", ("诊断模型验证指标与建议标准",
               ["验证指标", "含义", "建议标准", "验证方法"],
               [["规则命中准确率", "系统报出的问题中确实成立的比例",
                 "≥ 90%", "历史回溯 + 专家评审"],
                ["问题漏报率", "实际发生但系统未报出的问题比例",
                 "≤ 10%", "历史回溯比对"],
                ["根因指向正确率", "根因判断与事后查明原因一致的比例",
                 "≥ 80%", "历史回溯 + 专家评审"],
                ["措施可执行率", "建议措施经业务确认可直接执行的比例",
                 "≥ 80%", "业务专家评审"],
                ["边界条件正确率", "构造用例的触发判定与预期一致的比例",
                 "100%", "构造用例验证"],
                ["结论可追溯性", "诊断结论可下钻到支撑明细的比例",
                 "100%", "抽样下钻核对"]],
               [2.4, 4.4, 1.8, 3.2], ["l", "l", "c", "l"])),
    ("p", "对于统计模型输出的提示类结论，"
          "不适用命中准确率的硬性标准，"
          "改以「提示是否有业务参考价值」由业务专家定性评价，"
          "并通过调整敏感度控制提示数量在业务可承受的范围内。"
          "这一区别处理源于统计方法的固有特点，"
          "在测试方案中予以明确以避免验收争议。"),

    ("h2", "5.4　用例设计"),
    ("h3", "5.4.1　用例编号与三联对照"),
    ("p", "测试用例编号采用 TC-Sn-nnn 格式，"
          "与业务需求编号 REQ-Sn-nnn、功能设计编号 FUNC-Sn-nnn 形成三联对照。"
          "验收时按编号逐项核对："
          "每条需求由哪个功能实现、由哪条用例验证、验证结果如何，"
          "全部有据可查，"
          "不会出现需求与测试对不上号的情况。"),
    ("h3", "5.4.2　用例要素与设计方法"),
    ("p", "每条用例包含用例编号、所属场景、关联需求与功能编号、"
          "前置条件、测试数据、操作步骤、预期结果、实际结果与判定结论九项要素。"
          "预期结果必须写成可客观判定的表述，"
          "不使用「显示正常」「功能可用」这类无法判定的描述。"),
    ("p", "用例设计方法按功能特性选择："
          "数据录入类功能采用等价类划分与边界值分析，"
          "覆盖必填校验、格式校验、长度边界与重复校验；"
          "流程类功能采用状态迁移分析，"
          "覆盖正常流转、驳回、撤回与并发操作；"
          "计算类功能采用判定表，"
          "覆盖各条件组合下的计算结果；"
          "查询类功能覆盖单条件、多条件组合、无结果与大数据量分页。"),
    ("h3", "5.4.3　用例规模与覆盖要求"),
    ("p", "用例覆盖要求如下表。"
          "覆盖率的计算基准是本项目确认的需求清单与功能清单，"
          "在项目启动后随需求确认结果最终确定。"),
    ("table", ("用例覆盖要求",
               ["覆盖对象", "覆盖要求", "说明"],
               [["业务需求", "100%",
                 "每条需求至少对应一条用例，需求与用例双向可追溯"],
                ["功能页面", "100%",
                 "167 项功能逐项设计基本操作与关键校验用例"],
                ["业务场景", "100%",
                 "20 个端到端场景全部设计场景用例"],
                ["接口", "100%",
                 "每个接口覆盖正常、异常、超时、重复调用四类情形"],
                ["指标", "100%",
                 "每个指标核对计算口径与下钻明细一致性"],
                ["诊断场景", "100%",
                 "每类诊断场景设计应触发与不应触发的边界用例"],
                ["异常路径", "关键路径 100%",
                 "权限越界、数据缺失、外部系统不可用等异常分支"]],
               [2.0, 2.2, 6.4], ["l", "c", "l"])),

    ("h2", "5.5　缺陷管理"),
    ("h3", "5.5.1　缺陷流程与分级"),
    ("p", "缺陷统一在缺陷管理工具中登记与流转，"
          "流程为提出、确认、修复、回归、关闭五步，"
          "回归不通过退回修复。"
          "缺陷按致命、严重、一般、轻微四级分类，"
          "各级的判定标准与响应修复时限如下图。"),
    ("fig", ("fig_defect_flow", "缺陷管理流程与分级标准")),
    ("h3", "5.5.2　缺陷登记要求"),
    ("p", "缺陷登记必须包含所属模块与功能编号、关联用例编号、"
          "复现步骤、实际结果与预期结果、发生环境、"
          "以及截图或数据证据。"
          "登记信息不完整的缺陷不进入修复流程，"
          "由确认环节退回补充——"
          "这一要求看似增加了提出成本，"
          "实际上避免了大量「无法复现」造成的来回沟通。"),
    ("h3", "5.5.3　缺陷过程管理"),
    ("p", "缺陷情况纳入项目周报，"
          "统计新增数、修复数、关闭数、重开数、"
          "各级剩余数与平均修复时长，"
          "并按模块分布分析。"
          "每周质量例会上逐项过一遍未关闭的致命与严重缺陷，"
          "确认责任人与解决时点。"),
    ("p", "重开率是我方内部重点关注的指标。"
          "缺陷反复重开通常说明修复只处理了表象，"
          "或者回归验证不充分。"
          "对重开两次以上的缺陷，"
          "要求技术负责人参与分析根本原因，"
          "并检查是否存在同类问题尚未暴露。"),

    ("h2", "5.6　验收标准"),
    ("h3", "5.6.1　上线门槛"),
    ("p", "系统上线须同时满足以下条件："
          "致命与严重缺陷全部关闭；"
          "一般缺陷关闭率不低于 95%；"
          "剩余轻微缺陷列入遗留清单并明确责任人与解决版本，"
          "经采购人书面确认；"
          "UAT 用例通过率不低于 98%，"
          "未通过用例均属轻微问题且已列入遗留清单；"
          "性能测试指标达到采购需求约定值；"
          "上线检查单与回滚预案完成确认。"),
    ("h3", "5.6.2　验收指标"),
    ("p", "项目验收以下表指标判定，"
          "各项均可客观核查，"
          "避免以主观感受作为验收依据。"),
    ("table", ("项目验收指标",
               ["验收维度", "验收指标", "标准"],
               [["功能完整性", "确认需求清单实现率", "100%"],
                ["功能完整性", "UAT 用例通过率", "≥ 98%"],
                ["数据准确性", "指标计算结果与人工核算一致率", "100%（抽样核对）"],
                ["数据准确性", "同步数据与源系统对账一致率", "100%"],
                ["集成完整性", "集成通道联调通过率", "100%"],
                ["诊断有效性", "诊断规则命中准确率", "≥ 90%"],
                ["诊断有效性", "诊断结论可追溯性", "100%"],
                ["性能", "常规页面与查询响应", "≤ 30 秒"],
                ["性能", "复杂查询与多图联动", "≤ 60 秒"],
                ["性能", "并发能力", "约 1000 人在线、400 人并发"],
                ["缺陷", "致命与严重缺陷剩余数", "0"],
                ["缺陷", "一般缺陷关闭率", "≥ 95%"],
                ["培训", "培训考核通过率", "≥ 95%"],
                ["交付物", "交付物清单完整性", "100% 签收"]],
               [2.2, 4.4, 3.8], ["l", "l", "l"])),
    ("h3", "5.6.3　交付物清单"),
    ("p", "项目验收时提交的文档与交付物如下表，"
          "均按统一模板编制、版本受控，"
          "并随系统变更同步更新。"),
    ("table", ("项目交付物清单",
               ["类别", "交付物", "用途"],
               [["系统与源码", "系统软件安装包与部署脚本", "上线部署与后续重建"],
                ["系统与源码", "全部源代码及编译说明", "采购人自主维护与二次开发"],
                ["需求与设计", "业务需求说明书（REQ 编号）", "需求确认与验收基准"],
                ["需求与设计", "功能设计说明（FUNC 编号）", "功能实现依据"],
                ["需求与设计", "业务蓝图设计方案（分模块）", "业务流程与方案说明"],
                ["需求与设计", "指标口径确认书", "指标验收与考核基准"],
                ["技术文档", "系统架构与部署说明", "运维与后续扩展依据"],
                ["技术文档", "数据库设计与数据字典", "数据理解与二次开发"],
                ["技术文档", "接口文档与数据映射表", "集成对接与自行开发"],
                ["测试文档", "测试方案与用例集（TC 编号）", "测试执行依据"],
                ["测试文档", "测试执行记录与测试报告", "验收依据"],
                ["测试文档", "缺陷清单与遗留问题清单", "上线判定与后续跟踪"],
                ["运维文档", "系统管理员手册", "日常运维操作"],
                ["运维文档", "备份恢复与应急处置手册", "故障应对"],
                ["培训资料", "业务操作手册（分岗位）", "操作培训与新人自学"],
                ["培训资料", "智能诊断与数据分析手册", "专项能力培训"],
                ["培训资料", "培训课件与录像", "复训与人员流动后自学"],
                ["验收文件", "阶段确认书与验收报告", "阶段准出与项目结项"]],
               [1.8, 4.6, 4.0], ["l", "l", "l"])),
    ("p", "综上，本项目的测试与质量保障方案在测试策略、场景覆盖、"
          "诊断模型验证、用例设计、缺陷管理与验收标准六个方面均有明确安排，"
          "各项标准可客观核查。"
          "我方承诺按本章方案执行，"
          "并在项目启动后一周内向采购人提交正式的测试方案供确认。"),
]