## ADDED Requirements ### Requirement: 元素类单元测试 系统 SHALL 为所有元素类(TextElement、ImageElement、ShapeElement、TableElement)提供单元测试。 #### Scenario: TextElement 创建验证 - **WHEN** 创建 TextElement 实例 - **THEN** box 参数被验证为包含 4 个数字的列表 - **AND** 无效的 box 会引发 ValueError #### Scenario: TextElement 颜色验证 - **WHEN** TextElement 的 font.color 格式无效 - **THEN** validate() 返回包含 INVALID_COLOR_FORMAT 错误的 ValidationIssue 列表 #### Scenario: TextElement 字体大小验证 - **WHEN** TextElement 的 font.size 小于 8pt - **THEN** validate() 返回包含 FONT_TOO_SMALL 警告的 ValidationIssue 列表 #### Scenario: ImageElement 创建验证 - **WHEN** 创建 ImageElement 实例 - **THEN** src 参数必须非空 - **AND** 空的 src 会引发 ValueError #### Scenario: ShapeElement 类型验证 - **WHEN** ShapeElement 的 shape 类型不支持 - **THEN** validate() 返回包含 INVALID_SHAPE_TYPE 错误的 ValidationIssue 列表 #### Scenario: TableElement 数据验证 - **WHEN** TableElement 的 data 行列数不一致 - **THEN** validate() 返回包含 TABLE_INCONSISTENT_COLUMNS 错误的 ValidationIssue 列表 #### Scenario: 元素工厂函数 - **WHEN** 调用 create_element() 并传入不同 type - **THEN** 返回对应类型的元素对象 - **AND** 不支持的 type 会引发 ValueError ### Requirement: 模板系统单元测试 系统 SHALL 为模板系统(Template 类)提供单元测试。 #### Scenario: 模板初始化验证 - **WHEN** Template 初始化时未指定 templates_dir - **THEN** 引发 YAMLError #### Scenario: 模板名称验证 - **WHEN** Template 初始化时模板名称包含路径分隔符 - **THEN** 引发 YAMLError #### Scenario: 变量解析 - **WHEN** 调用 resolve_value() 并包含变量引用 - **THEN** 返回解析后的值 - **AND** 未定义的变量会引发 YAMLError #### Scenario: 条件渲染评估 - **WHEN** 调用 evaluate_condition() 并传入条件表达式 - **THEN** 返回正确的布尔值 #### Scenario: 模板渲染 - **WHEN** 调用 render() 并提供变量值 - **THEN** 返回渲染后的元素列表 - **AND** 缺少必需变量会引发 YAMLError ### Requirement: 验证器单元测试 系统 SHALL 为所有验证器提供单元测试。 #### Scenario: 几何验证器 - 元素边界检查 - **WHEN** 元素超出页面边界 - **THEN** GeometryValidator 返回 ELEMENT_OUT_OF_BOUNDS 警告 #### Scenario: 几何验证器 - 完全在页面外 - **WHEN** 元素完全在页面外 - **THEN** GeometryValidator 返回 ELEMENT_COMPLETELY_OUT_OF_BOUNDS 警告 #### Scenario: 资源验证器 - 图片检查 - **WHEN** 图片文件不存在 - **THEN** ResourceValidator 返回 IMAGE_FILE_NOT_FOUND 错误 #### Scenario: 资源验证器 - 模板检查 - **WHEN** 模板文件不存在 - **THEN** ResourceValidator 返回 TEMPLATE_FILE_NOT_FOUND 错误 #### Scenario: 主验证器协调 - **WHEN** Validator.validate() 执行 - **THEN** 调用所有子验证器 - **AND** 按级别分类问题(ERROR/WARNING/INFO) ### Requirement: YAML 加载器单元测试 系统 SHALL 为 YAML 加载器提供单元测试。 #### Scenario: 文件不存在 - **WHEN** 加载不存在的文件 - **THEN** 引发 YAMLError 并包含 "文件不存在" 消息 #### Scenario: YAML 语法错误 - **WHEN** 加载包含语法错误的 YAML 文件 - **THEN** 引发 YAMLError 并包含错误行号信息 #### Scenario: 演示文稿结构验证 - **WHEN** data 缺少 slides 字段 - **THEN** validate_presentation_yaml() 引发 YAMLError #### Scenario: 模板结构验证 - **WHEN** 模板 data 缺少 elements 字段 - **THEN** validate_template_yaml() 引发 YAMLError ### Requirement: 工具函数单元测试 系统 SHALL 为工具函数提供单元测试。 #### Scenario: 颜色转换 - 完整格式 - **WHEN** 调用 hex_to_rgb() 并传入 #RRGGBB 格式 - **THEN** 返回正确的 (R, G, B) 元组 #### Scenario: 颜色转换 - 短格式 - **WHEN** 调用 hex_to_rgb() 并传入 #RGB 格式 - **THEN** 返回正确的 (R, G, B) 元组 #### Scenario: 颜色转换 - 无效格式 - **WHEN** 调用 hex_to_rgb() 并传入无效格式 - **THEN** 引发 ValueError #### Scenario: 颜色格式验证 - **WHEN** 调用 validate_color() 并传入有效颜色 - **THEN** 返回 True - **AND** 无效颜色返回 False