BRD 转 UAT 测试用例文档生成器

将大型业务需求文档（BRD）解析并转化为标准化、高覆盖率、可直接投入执行的UAT测试用例文档。

输入规范

• 文件格式：Word (.docx)
• 文件大小：100-200页
• 内容结构：包含业务流程、功能描述、字段说明、业务规则、计算逻辑、权限控制等

第一阶段：全局架构扫描

1.1 文档结构解析

读取BRD文档，提取以下结构信息：
- 章节目录层级（通常3-4级）
- 业务模块划分
- 角色权限矩阵
- 系统接口定义

import docx
doc = docx.Document(file_path)
# 提取段落和表格
paragraphs = [p.text.strip() for p in doc.paragraphs if p.text.strip()]
tables = [table for table in doc.tables]

1.2 业务模块识别

按以下维度识别业务模块：
- 功能模块（如：客户管理、订单管理、报表查询）
- 业务流程（如：审批流、支付流、退货流）
- 数据实体（如：客户、订单、产品）
- 接口集成（如：与CRM对接、与支付系统对接）

1.3 角色权限提取

提取文档中定义的所有用户角色及其权限：
- 角色名称（如：销售代表、财务人员、系统管理员）
- 功能权限（可访问哪些模块）
- 数据权限（可查看哪些数据）
- 操作权限（增删改查权限）

1.4 非功能性验收准则提取

识别并提取以下非功能性需求：
- 性能要求（响应时间、并发数）
- 安全要求（权限控制、数据加密）
- 兼容性要求（浏览器、分辨率）
- 可用性要求（操作流程、提示信息）

第二阶段：端到端业务流提取

2.1 主流程识别

对每个业务模块，识别以下主流程：
- 正向主流程（Happy Path）
- 业务状态流转（如：草稿→待审批→已审批→已完成）
- 数据生命周期（创建→修改→查询→删除）

2.2 分支流程识别

识别主流程中的分支：
- 条件分支（如：金额>10000需要总经理审批）
- 角色分支（如：不同角色看到不同界面）
- 状态分支（如：不同状态下可执行不同操作）

2.3 异常流程识别

识别以下异常场景：
- 必填项为空
- 格式错误（手机号、邮箱、身份证号等）
- 超出范围（金额上限、日期范围等）
- 权限不足
- 并发冲突
- 网络异常
- 系统异常

2.4 边界条件识别

识别以下边界条件：
- 数值边界（最小值、最大值、零值、负值）
- 日期边界（今天、过去、未来、跨年）
- 长度边界（最短、最长、空值）
- 集合边界（空列表、单条、多条、上限）

第三阶段：UAT测试用例设计

3.1 用例设计原则

遵循以下原则设计测试用例：

1. 基于场景设计：每个用例对应一个完整的业务场景，而非单一按钮点击
2. 角色驱动：明确每个用例的执行角色
3. 数据具象化：测试数据必须给出符合业务逻辑的具体示例值
4. 可验证性：预期结果必须具体到可验证的系统响应

3.2 禁止的表述

严禁使用以下模糊表述：
- "输入有效数据" → 必须给出具体值，如"输入11位手机号：13800138000"
- "系统运行正常" → 必须给出具体响应，如"页面显示'保存成功'提示，列表新增一条记录"
- "以此类推" → 必须逐条列出
- "后续省略" → 必须全量转换
- "输入相关数据" → 必须明确每个字段的值

3.3 Excel物理列定义

输出的Excel文件必须包含以下14列，列顺序固定：

3.4 优先级定义

3.5 用例覆盖率要求

对每个功能模块，必须覆盖以下维度：

第四阶段：Excel文件生成

4.1 运行转换脚本

python ~/.workbuddy/skills/uniproud-brd-uat/scripts/convert_to_excel.py <md_file> <excel_file>

4.2 Excel格式规范

工作表规范

• Sheet命名格式：序号_模块名称（如 01_客户管理模块）
• Sheet数量：每个功能模块一个Sheet
• 首行冻结：冻结表头行，滚动时始终可见
• 打印设置：横向打印，适合页面宽度

表头样式

• 字体：微软雅黑，加粗，11号，白色
• 背景色：#4472C4（蓝色）
• 对齐：水平居中，垂直居中，自动换行
• 行高：35像素

数据行样式

• 字体：微软雅黑，10号
• 对齐：左对齐，垂直居中，自动换行
• 行高：60像素
• 交替行颜色：奇数行白色，偶数行#D9E2F3（浅蓝色）

列宽设置

数据验证规则

优先级列（D列）：
- 类型：列表
- 选项：P0, P1, P2
- 错误提示：请选择有效的优先级：P0, P1, P2

测试结论列（J列）：
- 类型：列表
- 选项：Pass, Fail, Blocked, Skip
- 错误提示：请选择有效的测试结论：Pass, Fail, Blocked, Skip

测试日期列（L列）：
- 类型：日期
- 格式：YYYY-MM-DD

条件格式规则

优先级列（D列）：
- P0：背景色 #FFC7CE（浅红色），字体色 #9C0006（深红色）
- P1：背景色 #FFEB9C（浅黄色），字体色 #9C6500（深黄色）
- P2：背景色 #C6EFCE（浅绿色），字体色 #006100（深绿色）

测试结论列（J列）：
- Pass：背景色 #C6EFCE（浅绿色），字体色 #006100（深绿色）
- Fail：背景色 #FFC7CE（浅红色），字体色 #9C0006（深红色）
- Blocked：背景色 #FFEB9C（浅黄色），字体色 #9C6500（深黄色）
- Skip：背景色 #D9D9D9（浅灰色），字体色 #595959（深灰色）

4.3 自适应折行

• 所有数据单元格启用自动换行
• 操作步骤列：每个步骤一行，格式为"1. xxx\n2. xxx"
• 预期结果列：每个验证点一行，格式为"1. xxx\n2. xxx"
• 测试数据列：每个字段一行，格式为"字段名：值"

输出文件

运行完成后生成以下文件：

1. brd_function_points.md - BRD功能点清单（中间产物）
2. uat_test_cases.md - Markdown格式测试用例（中间产物）
3. *_UAT测试用例.xlsx - Excel格式测试用例（最终交付物）

质量检查清单

生成完成后，必须检查以下项目：

• [ ] 所有功能模块均已覆盖
• [ ] 每个功能模块至少有1条P0用例
• [ ] 所有必填字段均有对应的校验用例
• [ ] 所有业务规则均有对应的验证用例
• [ ] 测试数据均为具体值，无模糊表述
• [ ] 预期结果均为可验证的系统响应
• [ ] Excel文件包含14列，列顺序正确
• [ ] 数据验证规则已配置（优先级、测试结论下拉）
• [ ] 条件格式已配置（优先级、测试结论高亮）
• [ ] 首行已冻结
• [ ] 交替行颜色已设置