sumulige-claude 1.1.2 → 1.2.0

package/tests/manual/phase3-test-cases.md

@@ -0,0 +1,309 @@
+# Phase 3 E2E Test Cases
+
+> **版本**: 1.0
+> **日期**: 2026-01-17
+> **状态**: ✅ 已完成
+
+---
+
+## 测试概述
+
+本文档定义了 Phase 3（规划阶段）的端到端测试用例。
+
+### 测试范围
+
+| 模块 | 测试内容 |
+|------|----------|
+| Phase 3 CLI | next 命令自动进入 Phase 3 |
+| PRD Generation | PRD 文档生成 |
+| Task Plan Generation | TASK_PLAN.md 生成 |
+| Prototype Structure | prototype/ 目录创建 |
+| Planning Validator | PRD 和任务计划质量检查 |
+
+---
+
+## TC-301: Phase 3 启动
+
+### 描述
+验证从 Phase 2 进入 Phase 3 的完整流程。
+
+### 前置条件
+- Phase 2 需求文档已生成
+
+### 测试步骤
+
+```bash
+# 使用 next 命令自动进入下一阶段
+smc workflow next
+
+# 检查 phase3 目录是否创建
+ls development/projects/proj_xxx/phase3/
+
+# 查看生成的文件
+cat development/projects/proj_xxx/phase3/PRD.md | head -50
+cat development/projects/proj_xxx/phase3/TASK_PLAN.md | head -50
+```
+
+### 预期结果
+
+| 步骤 | 预期输出 |
+|------|----------|
+| 1 | `✅ Phase 3 initialized!` |
+| 2 | `phase3/` 目录包含 PRD.md, TASK_PLAN.md, prototype/ |
+| 3 | PRD 包含以下章节：<br>- Document Control<br>- Executive Summary<br>- Product Overview<br>- System Architecture<br>- Data Model<br>- API Design<br>- Testing Strategy |
+
+### 状态
+- [x] 通过
+
+---
+
+## TC-302: 工作流状态查询
+
+### 描述
+验证 `smc workflow status` 正确显示 Phase 3 状态。
+
+### 前置条件
+- 至少有一个项目已进入 Phase 3
+
+### 测试步骤
+
+```bash
+smc workflow status
+```
+
+### 预期结果
+
+| 字段 | 说明 |
+|------|------|
+| Phase Icon | 📐 (Phase 3) |
+| Phase Number | 3 - Planning |
+| Phase 1 Status | ✅ Phase 1: feasibility-report.md |
+| Phase 2 Status | ✅ Phase 2: requirements.md |
+| Phase 3 Status | ✅ Phase 3: PRD.md |
+
+### 状态
+- [x] 通过
+
+---
+
+## TC-303: PRD 文档验证
+
+### 描述
+验证 PRD 文档质量检查功能。
+
+### 前置条件
+- PRD 文档已生成
+
+### 测试步骤
+
+```bash
+# 验证 PRD
+smc workflow validate development/projects/proj_xxx/phase3/PRD.md
+```
+
+### 预期结果
+
+| 场景 | 预期输出 |
+|------|----------|
+| 完整 PRD | `✅ PASSED` - 6项检查全部通过 |
+| 模板 PRD | `❌ FAILED` - 列出需要填充的部分 |
+
+### PRD 验证检查项
+
+1. **PRD Overview** - 产品概述
+2. **Architecture Design** - 系统架构设计
+3. **Data Model** - 数据模型
+4. **API Design** - API 设计
+5. **Task Breakdown** - 任务分解
+6. **Milestones** - 里程碑
+
+### 状态
+- [x] 通过
+
+---
+
+## TC-304: Task Plan 生成
+
+### 描述
+验证任务计划文档的生成。
+
+### 前置条件
+- Phase 3 已启动
+
+### 测试步骤
+
+```bash
+# 查看任务计划
+cat development/projects/proj_xxx/phase3/TASK_PLAN.md
+```
+
+### 预期结果
+
+任务计划应包含：
+- **Overview** - 项目概述
+- **Task Breakdown** - 5 个 Sprint 的任务分解
+- **Task Dependencies** - 任务依赖关系图
+- **Milestones** - 项目里程碑
+- **Time Estimates** - 时间估算
+
+### 状态
+- [x] 通过
+
+---
+
+## TC-305: Prototype 目录创建
+
+### 描述
+验证原型开发目录的创建。
+
+### 前置条件
+- Phase 3 已启动
+
+### 测试步骤
+
+```bash
+# 查看 prototype 目录
+ls -la development/projects/proj_xxx/phase3/prototype/
+cat development/projects/proj_xxx/phase3/prototype/README.md
+```
+
+### 预期结果
+
+`prototype/` 目录应包含：
+- `README.md` - 说明文件
+
+### 状态
+- [x] 通过
+
+---
+
+## TC-306: 自动阶段推进
+
+### 描述
+验证 `next` 命令能自动检测并推进到下一阶段。
+
+### 前置条件
+- 有多个项目处于不同阶段
+
+### 测试步骤
+
+```bash
+# 创建一个新的 Phase 1 项目
+smc workflow start "测试项目"
+
+# 使用 next 命令
+smc workflow next
+```
+
+### 预期结果
+
+1. 第一个 `next` 将推进到 Phase 2
+2. 第二个 `next` 将推进到 Phase 3
+
+### 状态
+- [x] 通过
+
+---
+
+## TC-307: 多阶段项目状态
+
+### 描述
+验证状态命令能正确显示多阶段项目。
+
+### 测试步骤
+
+```bash
+smc workflow status | grep -E "proj_mkh4y2qk_9lm8z|Phase:"
+```
+
+### 预期结果
+
+应显示：
+```
+📐 proj_mkh4y2qk_9lm8z
+   Phase: 3 - Planning
+   ✅ Phase 1: feasibility-report.md
+   ✅ Phase 2: requirements.md
+   ✅ Phase 3: PRD.md
+```
+
+### 状态
+- [x] 通过
+
+---
+
+## TC-308: PRD 内容继承
+
+### 描述
+验证 PRD 从 Phase 2 需求中正确提取信息。
+
+### 前置条件
+- Phase 2 需求包含完整信息
+
+### 测试步骤
+
+```bash
+# 检查 PRD 中的 Phase 1 摘要
+grep -A 10 "Phase 1 Summary" development/projects/proj_xxx/phase3/PRD.md
+```
+
+### 预期结果
+
+PRD 应包含从 Phase 1 和 Phase 2 继承的信息：
+- Original Idea
+- Functional Requirements
+- Success Metrics
+
+### 状态
+- [x] 通过
+
+---
+
+## 测试执行记录
+
+### 测试环境
+
+| 项目 | 值 |
+|------|-----|
+| 操作系统 | macOS Darwin 23.6.0 |
+| Node.js 版本 | v22.x |
+| CLI 版本 | 1.1.2 |
+
+### 执行日期
+2026-01-17
+
+### 结果汇总
+
+| 用例编号 | 用例名称 | 状态 | 备注 |
+|----------|----------|------|------|
+| TC-301 | Phase 3 启动 | ✅ 通过 | |
+| TC-302 | 工作流状态查询 | ✅ 通过 | 正确显示 Phase 3 |
+| TC-303 | PRD 文档验证 | ✅ 通过 | 验证器正确工作 |
+| TC-304 | Task Plan 生成 | ✅ 通过 | 5 Sprint 任务分解 |
+| TC-305 | Prototype 目录创建 | ✅ 通过 | |
+| TC-306 | 自动阶段推进 | ✅ 通过 | next 命令正常工作 |
+| TC-307 | 多阶段项目状态 | ✅ 通过 | |
+| TC-308 | PRD 内容继承 | ✅ 通过 | 从 Phase 2 继承信息 |
+
+### 通过率
+100% (8/8)
+
+---
+
+## 快速测试命令
+
+```bash
+# 完整 Phase 3 流程测试
+smc workflow start "测试想法"    # Phase 1
+smc workflow next                 # Phase 2
+smc workflow next                 # Phase 3
+
+# 验证 PRD
+smc workflow validate development/projects/*/phase3/PRD.md
+
+# 查看状态
+smc workflow status
+
+# 查看生成的文件
+ls -la development/projects/*/phase3/
+```

package/tests/manual/phase4-test-cases.md

@@ -0,0 +1,414 @@
+# Phase 4 E2E Test Cases
+
+> **版本**: 1.0
+> **日期**: 2026-01-17
+> **状态**: ✅ 已完成
+
+---
+
+## 测试概述
+
+本文档定义了 Phase 4（开发执行阶段）的端到端测试用例。
+
+### 测试范围
+
+| 模块 | 测试内容 |
+|------|----------|
+| Phase 4 CLI | next 命令自动进入 Phase 4 |
+| Source Generation | 项目脚手架生成 |
+| Package Configuration | package.json 配置 |
+| Directory Structure | src/, tests/, docs/ 目录 |
+| Test Setup | Jest 配置和示例测试 |
+| Development Validator | 开发质量检查 |
+
+---
+
+## TC-401: Phase 4 启动
+
+### 描述
+验证从 Phase 3 进入 Phase 4 的完整流程。
+
+### 前置条件
+- Phase 3 任务计划已生成
+
+### 测试步骤
+
+```bash
+# 使用 next 命令自动进入下一阶段
+smc workflow next
+
+# 检查 phase4 目录是否创建
+ls development/projects/proj_xxx/phase4/
+
+# 查看生成的文件
+cat development/projects/proj_xxx/phase4/source/package.json
+cat development/projects/proj_xxx/phase4/TASKS.md
+cat development/projects/proj_xxx/phase4/DEVELOPMENT_LOG.md
+```
+
+### 预期结果
+
+| 步骤 | 预期输出 |
+|------|----------|
+| 1 | `✅ Phase 4 initialized!` |
+| 2 | `phase4/` 目录包含 source/, TASKS.md, DEVELOPMENT_LOG.md |
+| 3 | source/ 目录包含完整项目结构 |
+
+### 状态
+- [x] 通过
+
+---
+
+## TC-402: 工作流状态查询
+
+### 描述
+验证 `smc workflow status` 正确显示 Phase 4 状态。
+
+### 前置条件
+- 至少有一个项目已进入 Phase 4
+
+### 测试步骤
+
+```bash
+smc workflow status
+```
+
+### 预期结果
+
+| 字段 | 说明 |
+|------|------|
+| Phase Icon | 💻 (Phase 4) |
+| Phase Number | 4 - Development |
+| Phase 1 Status | ✅ Phase 1: feasibility-report.md |
+| Phase 2 Status | ✅ Phase 2: requirements.md |
+| Phase 3 Status | ✅ Phase 3: PRD.md |
+| Phase 4 Status | ✅ Phase 4: source/ |
+
+### 状态
+- [x] 通过
+
+---
+
+## TC-403: 项目脚手架结构
+
+### 描述
+验证生成的项目脚手架结构完整。
+
+### 前置条件
+- Phase 4 已启动
+
+### 测试步骤
+
+```bash
+# 查看 source 目录结构
+ls -la development/projects/proj_xxx/phase4/source/
+ls -la development/projects/proj_xxx/phase4/source/src/
+ls -la development/projects/proj_xxx/phase4/source/tests/
+```
+
+### 预期结果
+
+`source/` 目录应包含：
+```
+source/
+├── package.json           # 依赖配置
+├── .gitignore            # Git 忽略规则
+├── .env.example          # 环境变量模板
+├── README.md             # 项目说明
+├── src/
+│   ├── index.js          # 应用入口
+│   └── routes/
+│       └── index.js      # API 路由
+└── tests/
+    ├── jest.config.js    # Jest 配置
+    └── health.test.js    # 示例测试
+```
+
+### 状态
+- [x] 通过
+
+---
+
+## TC-404: package.json 配置
+
+### 描述
+验证 package.json 包含正确的依赖和脚本。
+
+### 前置条件
+- Phase 4 已启动
+
+### 测试步骤
+
+```bash
+# 查看 package.json
+cat development/projects/proj_xxx/phase4/source/package.json
+```
+
+### 预期结果
+
+package.json 应包含：
+
+| 字段 | 预期值 |
+|------|--------|
+| name | 项目名称 |
+| version | 0.1.0 |
+| main | src/index.js |
+| scripts.start | node src/index.js |
+| scripts.test | jest |
+| scripts.lint | eslint src/**/*.js |
+| dependencies | express, dotenv |
+| devDependencies | jest, eslint, prettier, nodemon |
+
+### 状态
+- [x] 通过
+
+---
+
+## TC-405: 主应用文件
+
+### 描述
+验证主应用文件 (src/index.js) 包含基本 Express 配置。
+
+### 前置条件
+- Phase 4 已启动
+
+### 测试步骤
+
+```bash
+# 查看主应用文件
+cat development/projects/proj_xxx/phase4/source/src/index.js
+```
+
+### 预期结果
+
+index.js 应包含：
+- Express 应用初始化
+- JSON 中间件
+- CORS 中间件
+- 健康检查端点 `/health`
+- 404 处理器
+- 错误处理中间件
+
+### 状态
+- [x] 通过
+
+---
+
+## TC-406: 开发文档
+
+### 描述
+验证开发相关文档已生成。
+
+### 前置条件
+- Phase 4 已启动
+
+### 测试步骤
+
+```bash
+# 查看 README.md
+cat development/projects/proj_xxx/phase4/source/README.md
+
+# 查看 TASKS.md
+cat development/projects/proj_xxx/phase4/TASKS.md
+
+# 查看 DEVELOPMENT_LOG.md
+cat development/projects/proj_xxx/phase4/DEVELOPMENT_LOG.md
+```
+
+### 预期结果
+
+| 文档 | 内容 |
+|------|------|
+| README.md | 安装说明、开发命令、项目结构 |
+| TASKS.md | 任务跟踪表格 |
+| DEVELOPMENT_LOG.md | 开发会话记录 |
+
+### 状态
+- [x] 通过
+
+---
+
+## TC-407: 开发验证
+
+### 描述
+验证 `smc workflow validate` 对 Phase 4 项目的质量检查。
+
+### 前置条件
+- Phase 4 已启动
+
+### 测试步骤
+
+```bash
+# 验证 Phase 4 项目
+smc workflow validate proj_xxx
+```
+
+### 预期结果
+
+| 场景 | 预期输出 |
+|------|----------|
+| 完整脚手架 | `✅ PASSED` - 6项检查全部通过 |
+| 空目录 | `❌ FAILED` - 列出缺失项 |
+
+### 开发验证检查项
+
+1. **Source Directory** - 源码目录存在
+2. **Main Application File** - 主应用文件存在
+3. **Package Configuration** - package.json 存在
+4. **Documentation** - README.md 存在
+5. **Test Directory** - 测试目录存在
+6. **Git Configuration** - .gitignore 存在
+
+### 状态
+- [x] 通过
+
+---
+
+## TC-408: 自动阶段推进
+
+### 描述
+验证 `next` 命令能自动检测并推进到 Phase 4。
+
+### 前置条件
+- 有项目处于 Phase 3
+
+### 测试步骤
+
+```bash
+# 确认项目在 Phase 3
+smc workflow status | grep "proj_.*Phase 3"
+
+# 执行 next
+smc workflow next
+
+# 确认已进入 Phase 4
+smc workflow status | grep "proj_.*Phase 4"
+```
+
+### 预期结果
+
+`next` 命令应自动检测项目已准备好进入 Phase 4，并执行 Phase 4 初始化。
+
+### 状态
+- [x] 通过
+
+---
+
+## TC-409: 环境配置文件
+
+### 描述
+验证环境配置文件正确生成。
+
+### 前置条件
+- Phase 4 已启动
+
+### 测试步骤
+
+```bash
+# 查看 .env.example
+cat development/projects/proj_xxx/phase4/source/.env.example
+
+# 查看 .gitignore
+cat development/projects/proj_xxx/phase4/source/.gitignore
+```
+
+### 预期结果
+
+**.env.example** 应包含：
+```
+PORT=3000
+NODE_ENV=development
+```
+
+**.gitignore** 应包含：
+- node_modules/
+- .env
+- logs/
+- coverage/
+- .DS_Store
+
+### 状态
+- [x] 通过
+
+---
+
+## TC-410: API 路由脚手架
+
+### 描述
+验证 API 路由脚手架正确生成。
+
+### 前置条件
+- Phase 4 已启动
+
+### 测试步骤
+
+```bash
+# 查看路由文件
+cat development/projects/proj_xxx/phase4/source/src/routes/index.js
+```
+
+### 预期结果
+
+路由应包含：
+- GET /api/v1/resources - 列表
+- POST /api/v1/resources - 创建
+- GET /api/v1/resources/:id - 详情
+- PUT /api/v1/resources/:id - 更新
+- DELETE /api/v1/resources/:id - 删除
+
+### 状态
+- [x] 通过
+
+---
+
+## 测试执行记录
+
+### 测试环境
+
+| 项目 | 值 |
+|------|-----|
+| 操作系统 | macOS Darwin 23.6.0 |
+| Node.js 版本 | v22.x |
+| CLI 版本 | 1.1.2 |
+
+### 执行日期
+2026-01-17
+
+### 结果汇总
+
+| 用例编号 | 用例名称 | 状态 | 备注 |
+|----------|----------|------|------|
+| TC-401 | Phase 4 启动 | ✅ 通过 | |
+| TC-402 | 工作流状态查询 | ✅ 通过 | 正确显示 Phase 4 |
+| TC-403 | 项目脚手架结构 | ✅ 通过 | 目录结构完整 |
+| TC-404 | package.json 配置 | ✅ 通过 | 依赖正确 |
+| TC-405 | 主应用文件 | ✅ 通过 | Express 配置完整 |
+| TC-406 | 开发文档 | ✅ 通过 | |
+| TC-407 | 开发验证 | ✅ 通过 | 验证器正常工作 |
+| TC-408 | 自动阶段推进 | ✅ 通过 | next 命令正常工作 |
+| TC-409 | 环境配置文件 | ✅ 通过 | |
+| TC-410 | API 路由脚手架 | ✅ 通过 | RESTful 路由完整 |
+
+### 通过率
+100% (10/10)
+
+---
+
+## 快速测试命令
+
+```bash
+# 完整 Phase 4 流程测试
+smc workflow start "测试想法"    # Phase 1
+smc workflow next                 # Phase 2
+smc workflow next                 # Phase 3
+smc workflow next                 # Phase 4
+
+# 验证 Phase 4 项目
+smc workflow validate proj_xxx
+
+# 查看状态
+smc workflow status
+
+# 查看生成的文件
+ls -la development/projects/proj_xxx/phase4/source/
+```