AI软件测试智能体产品系统

• 面向企业内部的自动化测试管理平台
• 同时支持 UI 自动化测试 和 API 自动化测试。
• 通过统一的平台来管理测试用例、执行计划、执行记录和结果分析。

• 典型用户角色
• 测试工程师 / 测试开发：编写和维护自动化测试（Magnitude 脚本、API 场景），在平台上配置项目、服务、测试阶段，执行和查看结果。
• 开发 / 项目负责人：通过“执行管理”“历史查询”等功能，快速了解某个项目最近几次测试的质量情况。
• 核心业务场景
• 测试用例与场景管理
• 管理 API 场景（场景管理），包括项目、服务、测试阶段、请求参数、断言等。
• 管理 UI 自动化脚本（如 Magnitude .mag.ts），并与具体业务模块（例如“设备管理”“备件库存管理”）绑定。
• 测试执行与编排
• 在平台中配置“执行管理”（API 执行批次），每次执行会生成一条 test_executions 记录。
• 支持 执行模式选择：本地 Agent / 服务端执行；服务端执行还支持 分组或批量执行多条用例。
• 已支持与 Jenkins 集成：在 Jenkins 上触发平台的一次 API 执行，通过接口轮询结果，用于 CI/CD 流水线中的自动化测试环节。
• 执行结果与历史追溯
• “执行管理”中主要看 当前最新执行批次（按项目+服务+阶段分组）。
• “历史查询”中按项目维度，查询最近 N（当前为 5）次执行批次，并能进一步查看每次批次下的历史用例执行记录，方便做 回溯和对比。
• “场景管理”也具备历史执行记录查询（场景运行历史），并支持分页查询，适合多项目、多服务、多场景场景下的日常使用。

语言与运行时
• 主要语言：TypeScript（前后端都用 TS）
• 服务端运行时：Node.js（后端 package.json 里要求 node >=18，并且是 type: "module" 的 ESM 模式）
• 前端构建：Vite（配合 tsc 类型检查）
整体架构（分层 + 前后端）
• 前后端分离的单体应用形态：前端是一个 SPA，通过后端的 Express 提供 REST API；生产环境下后端也会直接静态托管前端构建产物
• API + 实时两类通信：
• REST API：业务数据增删改查走 express 路由（统一在 /api/*）
• WebSocket：用于测试执行“边跑边推日志/输出”，客户端按 executionId 订阅（后端通过 ws 实现，见 src/realtime.ts 和 src/server.ts）
• 服务端路由分模块：src/server.ts 里把 auth/projects/api-tests/api-test-scenarios/test-executions/... 等路由拆开注册