测试套件概述

本测试套件面向文生文的自动化测试套件生成器的三个核心组件：Parser、RequirementValidator、TemplateRenderer。目标是在单元测试级别覆盖正常、边界、异常路径，验证：

• Parser：正确解析中文标题、有序列表、嵌套小节，以及边界输入（空列表、超长标题）。
• RequirementValidator：正确校验 User 模型必填字段（email）、邮箱规则（必须包含 @）、中文 name 合法性，并输出明确错误提示。
• TemplateRenderer：将内部模型稳定渲染为 YAML/JSON，重点验证 YAML 缩进一致性（每层 2 空格）、关键文本片段的出现与行数一致性。

测试用例采用 Given/When/Then 的步骤表达，并按模块分层组织、统一中文短句命名，确保同一输入产生稳定用例编号。函数级覆盖率目标不低于 85%。

测试环境要求

• 语言与运行时：
  • Node.js >= 18（推荐）或等效运行时
• 测试框架与工具：
  • Jest >= 29（或 Vitest），并启用覆盖率统计
  • js-yaml（YAML 解析与验证）
  • prettier 或 eslint（可选，用于快照文本规范）
• 依赖与接口假设（可根据实际代码适配）：
  • Parser.parse(input: string): ParsedModel
  • RequirementValidator.validate(model: ParsedModel | UserModel): ValidationResult { errors: string[], priority: '高' | '中' | '低' }
  • TemplateRenderer.render(model: ParsedModel, options: { format: 'YAML' | 'JSON', indent: number }): string
• 快照测试建议：
  • 使用 Jest 的 toMatchSnapshot() 对 YAML/JSON 文本进行快照（并配合结构性断言，避免纯快照脆弱）

测试用例列表

测试数据说明

• 基础输入文本（用于 Parser 正常路径）：
  • 文本 A（中文标题与基本键值对）：
    • 标题 用户故事\n模块 Parser\n规则 邮箱校验\n输出格式 YAML\n优先级 高
  • 文本 B（有序列表与嵌套）：
    • 标题 用户故事\n## 子节 A\n### 子节 A.1\n1. 条目一\n2. 条目二\n- 要点
  • 文本 C（空列表边界）：
    • 标题 用户故事\n模块 Parser\n有序列表:\n 或仅 1. 后换行
  • 文本 D（超长标题边界）：
    • 标题 + 重复中文字符至长度 130 以上
• User 模型数据：
  • 完整：{id: "u1", name: "张三", email: "zhangsan@example.com"}
  • 缺失 email：{id: "u2", name: "李四"}
  • 非法 email：{id: "u3", name: "王五", email: "abc#example.com"}
  • 中文 name：{id: "u4", name: "测试工程师", email: "tester@example.com"}
• 渲染器输入模型（示例结构，需与 Parser 输出一致）：
  • cases: 数组，每项包含：
    • caseName: 中文短句
    • 前置条件: 文本或对象
    • 步骤与断言: 数组，元素为字符串或 {Given|When|Then} 分段
  • modules: "Parser" | "RequirementValidator" | "TemplateRenderer"
  • priority: "高"

示例用例片段（YAML，渲染期用于断言关键片段与缩进）：

- caseName: 中文标题解析
  前置条件: 标题 用户故事；模块 Parser；规则 邮箱校验
  步骤与断言:
    - Given 输入上述文本
    - When 调用 Parser.parse
    - Then 第一章节标题为“用户故事”，不抛异常

缩进约定：每层 2 空格；不得出现制表符；同层级缩进宽度必须一致。

执行建议

• 执行顺序：
  1. 先跑 Parser 相关用例（PAR-001 至 PAR-005），确保模型结构稳定；
  2. 再跑 RequirementValidator（VAL-001 至 VAL-004），使用 Parser 产出的模型或直传 User；
  3. 最后跑 TemplateRenderer（REN-001 至 REN-004），并对 YAML/JSON 进行结构与快照断言。
• 注意事项：
  • 为满足“同输入产生稳定用例编号”，测试文件命名与用例 ID 固定：parser/ PAR-001..005，validator/ VAL-001..004，renderer/ REN-001..004；避免基于时间或随机数的行为。
  • 对 YAML/JSON 进行双重校验：结构性断言（键、缩进、行数）+ 快照，降低文本微变更导致的误报。
  • 覆盖率目标 ≥ 85%：对异常路径（空列表、非法邮箱）必须有断言；对边界（超长标题）需校验不崩溃。
  • 若 Parser 支持的语法与此处示例不同（如非 Markdown 风格层级），请在测试前统一正则或语法规则，以保证嵌套小节解析断言可落地。
  • 对渲染器设置固定 indent=2 并禁用 Tab；必要时对渲染结果执行正则检查：/^\s{2}(caseName|前置条件|步骤与断言):/m。
  • 错误提示文案建议固化为常量，测试断言使用完全匹配或包含匹配，以保证长期稳定。

通过以上组织与断言策略，可实现对 Parser、RequirementValidator、TemplateRenderer 的正常、边界、异常路径的全面单元测试覆盖，满足 85%+ 函数级覆盖率与可维护性要求。