zentao-api 0.6.8 → 0.7.0

package/README.md

@@ -419,6 +419,19 @@ bun run check             # 完整 CI：测试、类型检查、注册表、构
 
 `bun run test:real` 会依次读取 `.env.local` 和 `env.local`，需要配置 `ZENTAO_URL`（或 `ZENTAO_BASE_URL`），以及 `ZENTAO_TOKEN` 或 `ZENTAO_ACCOUNT` / `ZENTAO_PASSWORD`。使用 `bun run test:real -- --keep-test-data` 可保留测试创建的数据。
 
+测试创建和更新项目时会复用现有 Scrum 项目的有效项目流程，也可通过 `ZENTAO_WORKFLOW_GROUP` 显式指定流程 ID。没有可复用流程时默认使用开源版的 `0`；付费版需要指定有效的流程 ID。
+
+真实环境测试按场景执行，覆盖以下流程：
+
+- 产品、项目集、项目、执行、计划，以及用户和团队成员维护。
+- 研发需求、业务需求、用户需求、任务、Bug、测试用例和模块目录的增删改查、状态流转，以及产品/项目/执行范围的列表。
+- 应用查询和修改、构建、测试单、发布、反馈、工单、转化操作和待办。
+- 个人、团队、产品、项目四类文档空间中的文档库、目录、文档，以及个人工作列表；可用时还会测试会议和自定义合同工作流。
+
+测试使用唯一名称创建临时数据，按依赖顺序清理；使用 Token 时仍需设置 `ZENTAO_ACCOUNT` 或 `ZENTAO_REVIEWER`，供负责人、成员和评审人字段使用。`--keep-test-data` 会保留新增场景的数据；原有生命周期场景中的“删除第二个任务”仍会执行。
+
+每次运行会输出接口统计并写入 `coverage/real-env.json`（已被 Git 忽略），列出已执行、成功、失败、排除原因、尚未测试的动作及实际访问的不同路径，同时记录退出码、耗时和清理错误。动作只要出现一次失败就归入失败，即使另一组参数调用成功；动作统计不能替代场景断言结果。只有探测到明确缺失的可选服务端模块才跳过对应测试；权限、SQL、缺失控制器方法、HTML 错误页和断言失败仍会让命令以非零状态退出。没有删除 API 的问题/风险写入和额外应用创建不自动执行；应用修改只使用临时产品自动生成的应用。
+
 模块注册表由 `data/zentao-openapi.json` 生成。请勿手动编辑 `src/modules/generated.ts`；更新规范后运行：
 
 ```sh