Files
plm-test-service/m5-api-endpoints.md
admin fdd744d870 feat: M5自动化测试框架完整代码
- tests/v1/: 产品/项目/文档/工作流/报表测试用例
- fixtures/: 认证和数据fixtures
- helpers/: 校验工具
- config/: 测试配置
- scripts/: 运行和报告生成脚本
- requirements.txt: 依赖清单

推送人: 运营官(yunying) 统一推送
2026-04-08 18:25:59 +08:00

4.9 KiB
Raw Permalink Blame History

M5 模块 API 端点推断列表

说明:基于 PLM 系统 M0-M4 阶段已知模块,推断 M5 测试可能涉及的 API 端点。 实际端点需以测试工程师提供的文档为准。


1. 产品管理 (Products)

Method Path 功能 状态
GET /api/v1/products 获取产品列表 ⚠️ 已测试
POST /api/v1/products 创建产品 ⚠️ 已测试
GET /api/v1/products/{id} 获取产品详情 ⚠️ 已测试
PUT /api/v1/products/{id} 更新产品 ⚠️ 已测试
DELETE /api/v1/products/{id} 删除产品 ⚠️ 已测试

待补充M5 重点):

  • GET /api/v1/products?category=xxx — 分类筛选
  • GET /api/v1/products?price_min=xx&price_max=xx — 价格范围筛选
  • GET /api/v1/products?search=xxx — 关键字搜索
  • GET /api/v1/products/{id}/versions — 产品版本历史
  • GET /api/v1/products/{id}/projects — 关联项目查询

2. 项目管理 (Projects)

Method Path 功能 状态
GET /api/v1/projects 获取项目列表 ⚠️ 已测试
POST /api/v1/projects 创建项目 ⚠️ 已测试
GET /api/v1/projects/{id} 获取项目详情 ⚠️ 已测试
PUT /api/v1/projects/{id} 更新项目 ⚠️ 已测试
DELETE /api/v1/projects/{id} 删除项目 ⚠️ 已测试

待补充M5 重点):

  • GET /api/v1/projects?status=xxx — 状态筛选
  • GET /api/v1/projects?start_date=xx&end_date=xx — 日期范围
  • GET /api/v1/projects/{id}/members — 项目成员
  • GET /api/v1/projects/{id}/products — 关联产品

3. 文档管理 (Documents)

Method Path 功能 状态
GET /api/v1/documents 获取文档列表 ⚠️ 已测试
POST /api/v1/documents 创建文档 ⚠️ 已测试
GET /api/v1/documents/{id} 获取文档详情 ⚠️ 已测试
PUT /api/v1/documents/{id} 更新文档 ⚠️ 已测试
DELETE /api/v1/documents/{id} 删除文档 ⚠️ 已测试

待补充M5 重点):

  • PUT /api/v1/documents/{id}/version — 创建新版本
  • GET /api/v1/documents/{id}/history — 版本历史
  • GET /api/v1/documents?search=xxx — 文档搜索
  • POST /api/v1/documents/{id}/upload — 附件上传

4. 流程管理 (Workflows)

Method Path 功能 状态
GET /api/v1/workflows 获取流程列表 ⚠️ 已测试
POST /api/v1/workflows 创建流程 ⚠️ 已测试
GET /api/v1/workflows/{id} 获取流程详情 ⚠️ 已测试
PUT /api/v1/workflows/{id} 更新流程 ⚠️ 已测试
DELETE /api/v1/workflows/{id} 删除流程 ⚠️ 已测试

待补充M5 重点):

  • POST /api/v1/workflows/{id}/submit — 提交流程
  • POST /api/v1/workflows/{id}/approve — 审批流程
  • GET /api/v1/workflows/{id}/nodes — 流程节点
  • GET /api/v1/workflows/templates — 流程模板

5. 报表分析 (Reports)

Method Path 功能 状态
GET /api/v1/reports 获取报表列表 ⚠️ 已测试
GET /api/v1/reports/{id} 获取报表详情 ⚠️ 已测试
POST /api/v1/reports/generate 生成报表 ⚠️ 已测试
GET /api/v1/reports/{id}/download 下载报表 ⚠️ 已测试

待补充M5 重点):

  • POST /api/v1/reports/scheduled — 定时报表任务
  • GET /api/v1/reports/{id}/data — 报表数据JSON
  • POST /api/v1/reports/export/csv — 导出 CSV
  • POST /api/v1/reports/export/pdf — 导出 PDF

6. 用户与权限 (Users & ACL)

Method Path 功能
GET /api/v1/users 用户列表
POST /api/v1/users 创建用户
GET /api/v1/users/{id} 用户详情
PUT /api/v1/users/{id} 更新用户
DELETE /api/v1/users/{id} 删除用户

M5 重点:

  • GET /api/v1/users/{id}/permissions — 用户权限
  • POST /api/v1/acl/check — 权限校验

7. 认证与安全 (Auth & Security)

Method Path 功能
POST /api/v1/auth/login 登录
POST /api/v1/auth/logout 登出
GET /api/v1/auth/me 当前用户
POST /api/v1/auth/refresh 刷新 Token

📊 总结

模块 基础用例 待补充 预估端点数
产品 5 5+ ~15
项目 5 4+ ~12
文档 5 4+ ~12
流程 5 4+ ~12
报表 4 4+ ~10
用户 5 1+ ~8
认证 3 - ~5
合计 32 26+ ~74+

目标100+ API 端点自动化测试


最后更新2026-04-07 08:58
负责人:后端工程师 (backend-dev)