From e7739bb523fbda2bf4bca4ee04fe06833c5d545b Mon Sep 17 00:00:00 2001 From: DSup Date: Thu, 21 May 2026 08:55:42 +0800 Subject: [PATCH 1/4] docs: add project workflow guide (TSK-004-011) --- docs/project-workflow-guide.md | 203 +++++++++++++++++++++++++++++++++ 1 file changed, 203 insertions(+) create mode 100644 docs/project-workflow-guide.md diff --git a/docs/project-workflow-guide.md b/docs/project-workflow-guide.md new file mode 100644 index 0000000..f621bc1 --- /dev/null +++ b/docs/project-workflow-guide.md @@ -0,0 +1,203 @@ +# 项目运作说明 + +> 项目: PRJ-004 测试案例样例 | 文档ID: DOC-004-WF-1 +> 作者: Joshua 📋 | 日期: 2026-05-21 +> 面向: 项目使用者 / 贡献者 + +--- + +## 目录 + +1. [项目概述](#1-项目概述) +2. [提单模板](#2-提单模板) +3. [问题单处理规则](#3-问题单处理规则) +4. [测试案例获取方式](#4-测试案例获取方式) +5. [附录](#5-附录) + +--- + +## 1. 项目概述 + +本项目为测试案例样例仓库，用于沉淀和管理软件测试用例。项目采用 **Issue 驱动** 的协作模式：用户通过 Gitee Issue 提交测试需求，团队按标准化流水线产出测试案例。 + +### 仓库信息 + +| 项 | 值 | +|----|-----| +| 仓库地址 | https://gitee.com/OCRA_MRI/test-cases | +| 协作平台 | Gitee Issues | +| 产出格式 | xlsx（Excel 电子表格） | + +--- + +## 2. 提单模板 + +### 2.1 如何提交测试案例需求 + +在 Gitee 仓库中创建 Issue，选择 `question` 标签，按以下模板填写： + +```markdown +### 背景 +> 描述业务场景：什么功能、什么模块、当前存在什么问题或需要覆盖什么测试范围。 + +### 测试目标 +> 明确要测什么：功能点、边界条件、异常路径等。 + +### 预期产出 +> 期望的用例数量、覆盖深度、特殊要求（如性能、安全）。 + +### 补充说明 +> 相关文档链接、原型图、接口文档等参考资料。 +``` + +### 2.2 高效提单建议 + +| 建议 | 说明 | +|------|------| +| **标题简洁明确** | 如 `[项目管理] 新增项目弹窗字段校验用例`，一眼看出模块和范围 | +| **背景写清楚** | 说明功能入口、操作流程、涉及的角色，让团队无需追问即可理解上下文 | +| **测试目标具体** | 避免"全面测试"这种模糊表述；列出具体要覆盖的场景类型 | +| **附上参考资料** | 原型链接、接口文档、需求文档——有链接就贴上，减少沟通成本 | +| **标注优先级** | 如"本周上线，紧急"或"下个迭代即可"，帮助团队排期 | + +### 2.3 示例 + +```markdown +### 背景 +项目管理列表页新增"编辑项目"弹窗功能。用户点击编辑按钮后弹出弹窗， +字段预填当前值，修改后保存。需要覆盖正常编辑、字段校验、异常场景。 + +### 测试目标 +- 正常编辑流程（修改单个/多个字段后保存成功） +- 字段校验（必填为空、编号重复、字符类型限制、长度限制） +- 异常场景（网络超时、保存失败、并发编辑冲突） +- UI 交互（取消不保存、遮罩关闭、loading 态） + +### 预期产出 +约 15-20 条测试用例，覆盖上述所有场景。 + +### 补充说明 +- 需求文档：见仓库 docs/ 目录 +- 原型：https://xxx.figma.com/xxx +``` + +--- + +## 3. 问题单处理规则 + +### 3.1 处理流程 + +``` +用户提交 Issue + │ + ▼ +┌─────────────┐ +│ Lucy 分配 │ 评估需求、指派任务、设定优先级 +└──────┬──────┘ + │ + ▼ +┌─────────────┐ +│ Joshua 出需求│ 编写需求规格文档，明确字段、行为、边界 +└──────┬──────┘ + │ + ▼ +┌─────────────┐ +│ Stuart 出用例│ 基于需求文档设计测试用例，输出 xlsx +└──────┬──────┘ + │ + ▼ +┌─────────────┐ +│ Amy 自动化 │ 将用例转化为自动化测试脚本（如适用） +└──────┬──────┘ + │ + ▼ + Issue 关闭 +``` + +### 3.2 角色分工 + +| 角色 | 负责人 | 职责 | +|------|--------|------| +| 🌟 团队领袖 | Lucy | 任务分配、优先级决策、质量审核 | +| 📋 文档专员 | Joshua | 需求规格文档编写、文档质量把控 | +| 🧪 测试专家 | Stuart | 测试用例设计、用例评审、xlsx 产出 | +| 🤖 自动化工程师 | Amy | 自动化脚本开发、用例自动化覆盖 | + +### 3.3 响应时效 + +| 阶段 | 预期时效 | 说明 | +|------|----------|------| +| Issue 受理 | 1 个工作日内 | Lucy 评估并分配任务 | +| 需求文档 | 1-2 个工作日 | Joshua 产出需求规格文档 | +| 测试用例 | 2-3 个工作日 | Stuart 基于需求文档设计用例 | +| 自动化（可选） | 视复杂度而定 | Amy 开发自动化脚本 | + +> **紧急需求**：请在 Issue 标题标注 `[紧急]`，团队将优先处理。 + +### 3.4 状态追踪 + +Issue 标签对应处理阶段： + +| 标签 | 含义 | +|------|------| +| `question` | 待评估的需求 | +| `processing` | 处理中（需求文档编写中） | +| `testing` | 用例设计中 | +| `automation` | 自动化开发中 | +| `done` | 已完成 | + +--- + +## 4. 测试案例获取方式 + +### 4.1 产出物路径 + +所有测试用例产出统一存放在： + +``` +projects/test-cases/outputs/ +``` + +### 4.2 文件格式 + +- **格式**：xlsx（Microsoft Excel / WPS 兼容） +- **命名规则**：`<模块名>_测试用例_<日期>.xlsx` +- **内容结构**： + +| 列 | 说明 | +|----|------| +| 用例编号 | 唯一标识，如 TC-004-ED-001 | +| 模块 | 所属功能模块 | +| 用例标题 | 简洁描述测试场景 | +| 前置条件 | 执行用例前需满足的条件 | +| 测试步骤 | 操作步骤序列 | +| 预期结果 | 每步对应的预期行为 | +| 优先级 | P0 / P1 / P2 / P3 | +| 备注 | 补充说明 | + +### 4.3 获取最新用例 + +1. **Gitee 仓库**：直接访问 https://gitee.com/OCRA_MRI/test-cases ，在 `outputs/` 目录下载最新 xlsx 文件 +2. **Issue 关联**：每个已完成的 Issue 评论区会附上对应产出文件的链接 +3. **通知**：用例产出后，团队会在 Issue 中 @提单人 通知 + +--- + +## 5. 附录 + +### 5.1 已完成产出示例 + +| 需求 | 需求文档 | 状态 | +|------|----------|------| +| 编辑项目弹窗 | `outputs/需求-编辑项目弹窗.md` | ✅ 需求文档完成 | +| 删除确认 | `outputs/需求-删除确认.md` | ✅ 需求文档完成 | +| 列表筛选/搜索 | `outputs/需求-列表筛选与搜索.md` | ✅ 需求文档完成 | + +### 5.2 联系方式 + +- **Issue 讨论**：在对应 Issue 下评论（推荐，保持上下文） +- **紧急联系**：通过飞书联系 Lucy + +--- + +_文档状态: ✅ 已完成 | 对应 Issue: [#IJOFVY](https://gitee.com/OCRA_MRI/test-cases/issues/IJOFVY)_ -- Gitee From f4ddc0ec05ebbec9f59635e4ffbb556a9b3d0658 Mon Sep 17 00:00:00 2001 From: DSup Date: Fri, 22 May 2026 14:48:36 +0800 Subject: [PATCH 2/4] docs: create MR for project workflow guide (Issue #IJOFVY) -- Gitee From 05dcc7ba86350f1d8c2fd48f128294d52fd21e8b Mon Sep 17 00:00:00 2001 From: DSup Date: Sat, 23 May 2026 11:46:21 +0800 Subject: [PATCH 3/4] =?UTF-8?q?fix:=20TSK-004-011=20v1.1=20-=20Lucy=20Revi?= =?UTF-8?q?ew=20=E9=80=80=E5=9B=9E=E4=BF=AE=E8=AE=A2?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 1. 流程图增加 Lucy Review 闸门（Stuart→Lucy Review→Amy） 2. 角色称谓统一：测试专员 / 测试专员（自动化），新增 Long 3. 响应时效增加 Lucy Review 环节（需求+用例各 0.5-1 工作日） 4. 附录 5.1 替换为实际 xlsx 产出（含用例数+质量状态） Reviewed-by: Lucy --- docs/project-workflow-guide.md | 24 ++++++++++++++++-------- 1 file changed, 16 insertions(+), 8 deletions(-) diff --git a/docs/project-workflow-guide.md b/docs/project-workflow-guide.md index f621bc1..f657e03 100644 --- a/docs/project-workflow-guide.md +++ b/docs/project-workflow-guide.md @@ -107,6 +107,11 @@ │ ▼ ┌─────────────┐ +│ Lucy Review │ 质量审核：用例完整性、边界覆盖、逻辑一致性 +└──────┬──────┘ 未通过 → 退回修改，重新提交 + │ 通过 → 进入下一环节 + ▼ +┌─────────────┐ │ Amy 自动化 │ 将用例转化为自动化测试脚本（如适用） └──────┬──────┘ │ @@ -118,10 +123,11 @@ | 角色 | 负责人 | 职责 | |------|--------|------| -| 🌟 团队领袖 | Lucy | 任务分配、优先级决策、质量审核 | +| 🌟 团队领袖 | Lucy | 任务分配、优先级决策、质量审核（Review 闸门） | | 📋 文档专员 | Joshua | 需求规格文档编写、文档质量把控 | -| 🧪 测试专家 | Stuart | 测试用例设计、用例评审、xlsx 产出 | -| 🤖 自动化工程师 | Amy | 自动化脚本开发、用例自动化覆盖 | +| 🔍 测试专员 | Stuart | 测试用例设计、用例评审、xlsx 产出 | +| 🤖 测试专员（自动化） | Amy | 自动化脚本开发、用例自动化覆盖 | +| 🔧 问题解决工程师 | Long | 工具开发、问题排查、技术方案输出 | ### 3.3 响应时效 @@ -129,7 +135,9 @@ |------|----------|------| | Issue 受理 | 1 个工作日内 | Lucy 评估并分配任务 | | 需求文档 | 1-2 个工作日 | Joshua 产出需求规格文档 | +| Lucy Review（需求） | 0.5-1 个工作日 | Lucy 审核需求文档，不通过退回修改 | | 测试用例 | 2-3 个工作日 | Stuart 基于需求文档设计用例 | +| Lucy Review（用例） | 0.5-1 个工作日 | Lucy 审核用例质量，不通过退回修改 | | 自动化（可选） | 视复杂度而定 | Amy 开发自动化脚本 | > **紧急需求**：请在 Issue 标题标注 `[紧急]`，团队将优先处理。 @@ -187,11 +195,11 @@ projects/test-cases/outputs/ ### 5.1 已完成产出示例 -| 需求 | 需求文档 | 状态 | -|------|----------|------| -| 编辑项目弹窗 | `outputs/需求-编辑项目弹窗.md` | ✅ 需求文档完成 | -| 删除确认 | `outputs/需求-删除确认.md` | ✅ 需求文档完成 | -| 列表筛选/搜索 | `outputs/需求-列表筛选与搜索.md` | ✅ 需求文档完成 | +| 模块 | 测试用例 xlsx | 用例数 | 状态 | +|------|---------------|--------|------| +| 新增项目弹窗 | `outputs/新增项目弹窗_测试用例.xlsx` | 37 条 | ✅ 已完成 | +| 删除确认弹窗 | `outputs/删除确认弹窗_测试用例.xlsx` | 18 条 | ⚠️ 有条件通过（缺3条严重用例） | +| 列表筛选/搜索 | `outputs/列表筛选与搜索_测试用例.xlsx` | 24 条 | ❌ 不通过（缺5条严重用例） | ### 5.2 联系方式 -- Gitee From 0a24f54d47c727f2e3502af5f93bde1f69861dcf Mon Sep 17 00:00:00 2001 From: DSup Date: Mon, 25 May 2026 19:17:41 +0800 Subject: [PATCH 4/4] =?UTF-8?q?docs(workflow):=20TSK-104-011=20v1.1=20?= =?UTF-8?q?=E2=80=94=20Lucy=20Review=20=E4=BF=AE=E8=AE=A2=E9=80=9A?= =?UTF-8?q?=E8=BF=87=EF=BC=8C=E5=BE=85=20dav=20=E7=BB=88=E5=AE=A1=20?= =?UTF-8?q?=E2=80=94=20Lucy?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/project-workflow-guide.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/project-workflow-guide.md b/docs/project-workflow-guide.md index f657e03..e1467bf 100644 --- a/docs/project-workflow-guide.md +++ b/docs/project-workflow-guide.md @@ -1,6 +1,6 @@ # 项目运作说明 -> 项目: PRJ-004 测试案例样例 | 文档ID: DOC-004-WF-1 +> 项目: PRJ-104 测试案例样例 | 文档ID: DOC-004-WF-1 > 作者: Joshua 📋 | 日期: 2026-05-21 > 面向: 项目使用者 / 贡献者 -- Gitee