Apache DevLake 新增 QA 领域支持及 CSV 导入功能解析

Apache DevLake 作为一款开源的 DevOps 数据湖平台，近期在其领域层中新增了对 QA（质量保证）领域的支持，并扩展了自定义插件以支持 CSV 格式的数据导入。这一重要更新为开发团队提供了更全面的软件开发生命周期指标分析能力。

QA 领域层设计

在最新版本中，DevLake 引入了专门的 QA 领域层，包含以下核心实体：

1. QaProject：表示测试项目或范围，将通过测试用例数据隐式创建
2. QaApi（可选）：用于存储 API 元数据，支持覆盖率指标计算
3. QaTestCase：记录单个测试用例，包括类型（功能测试或 API 测试）以及与 API 和项目的关联
4. QaTestCaseExecution：保存测试用例执行记录，包含时间戳和执行状态等关键信息

这种设计抽象了不同测试工具（如 Jira、Zephyr、TestRail 等）的数据模型，使团队能够统一分析来自各种来源的测试数据。

自定义插件增强

为了支持灵活的数据导入，DevLake 扩展了其自定义插件功能，新增了针对 QA 领域的 CSV 导入接口：

1. qa_apis.csv（可选）：导入 API 元数据
2. qa_test_cases.csv：导入测试用例及相关项目、API 信息
3. qa_test_case_executions.csv：导入测试执行记录

每个接口都遵循 RESTful 设计，通过 POST 请求接收 CSV 文件并自动映射到对应的领域实体。系统会使用 CSV 中的 id 字段作为主键，支持增量导入和重复数据处理。

CSV 格式规范

为了确保数据导入的准确性，DevLake 定义了严格的 CSV 格式要求：

1. 测试用例文件(qa_test_cases.csv)：

   • 必填字段：id、name、create_time、creator_name、type
   • 可选字段：api_id、api_name、api_create_time、api_creator_name
   • 项目关联字段：qa_project_id、qa_project_name

2. 测试执行文件(qa_test_case_executions.csv)：

   • 必填字段：id、qa_test_case_id、qa_project_id
   • 时间字段：create_time、start_time、finish_time
   • 状态字段：status（支持 PENDING、IN_PROGRESS、SUCCESS、FAILED 等值）

3. API 元数据文件(qa_apis.csv)：

   • 必填字段：id、name、create_time、creator_name、qa_project_id

技术实现细节

在实现过程中，开发团队特别注意了以下技术要点：

1. 账户系统集成：所有 creator_name 字段都会自动关联到 accounts 表，确保用户引用的完整性
2. 模块化设计：不同类型的 QA 数据通过独立接口导入，保持系统的高内聚低耦合
3. 数据一致性：通过严格的主键约束和关联验证，保证导入数据的质量

这一功能的加入使得 DevLake 能够更好地支持测试数据的收集和分析，帮助团队全面掌握软件质量状况，为持续改进提供数据支撑。对于使用 MeterSphere 等测试管理工具的用户，现在可以方便地将测试数据导入 DevLake，与其他开发数据一起进行综合分析。

未来，随着用户反馈的积累，DevLake 团队可能会进一步扩展 QA 领域的功能，如增加测试批次分析等高级特性，以满足更复杂的质量分析需求。