验收标准(各工位 Checklist)
verify-stage.sh会自动执行以下检查。也可手动对照。
PRD 工位
| # | 检查项 | 必须通过 |
|---|---|---|
| 1 | PRD.md 文件存在 | ✅ |
| 2 | 包含数据模型定义(字段名+类型) | ✅ |
| 3 | 包含管理后台需求描述 | ✅ |
| 4 | 包含优先级排序(P0-P3) | ✅ |
UI 工位
| # | 检查项 | 必须通过 |
|---|---|---|
| 1 | mockups/ 目录存在 | ✅ |
| 2 | SVG 文件 ≥ 4 张 | ✅ |
| 3 | SVG 使用真实数据(非 Lorem ipsum) | ✅ |
| 4 | 管理后台 SVG ≥ 3 张 | ✅ |
前端(用户端)工位
| # | 检查项 | 必须通过 |
|---|---|---|
| 1 | client/ 目录存在且有 package.json | ✅ |
| 2 | src/pages/ 下页面组件 ≥ 3 个 | ✅ |
| 3 | src/api/ 目录存在(含 try-catch fallback) | ✅ |
| 4 | public/_routes.json 存在(SPA fallback) | ✅ |
| 5 | npm run build 成功 | ✅ |
后端工位
| # | 检查项 | 必须通过 |
|---|---|---|
| 1 | server/ 目录存在 | ✅ |
| 2 | 云函数目录 ≥ 2 个(含 index.js) | ✅ |
| 3 | 包含管理接口目录(admin-*) | ✅ |
| 4 | server/types/ 共享类型定义存在 | ✅ |
管理后台工位
| # | 检查项 | 必须通过 |
|---|---|---|
| 1 | admin/ 目录存在且有 package.json | ✅ |
| 2 | vite.config.ts 设置了 base: '/admin/' | ✅ |
| 3 | npm run build 成功 | ✅ |
集成工位
| # | 检查项 | 必须通过 |
|---|---|---|
| 1 | client/ + admin/ + server/ 三目录完整 | ✅ |
| 2 | client npm run build 成功 | ✅ |
| 3 | admin npm run build 成功 | ✅ |
| 4 | cloudbaserc.json 的 envId 非占位符 | ⚠️ |
| 5 | _routes.json SPA fallback 两端都有 | ✅ |
| 6 | README.md 包含启动/部署指南 | ✅ |
使用验收脚本
bash
# 验收单个工位
bash verify-stage.sh prd ./my-project
# 验收全部(pipeline.sh 自动执行)
bash pipeline.sh -p my-project # 每个 NPC 完成后自动验收