Files
Sisyphus (主代理) 02762400fb chore: 项目基线提交 - 拼豆图纸生成器 V1.0 核心代码
- 前端: React+Vite 首页/AI专区, 算法库(MARD色板/量化/背景去除), API对接
- 后端: Express+SQLite, 兑换码/订单/支付/chibi生成, 风控+云端同步
- CI/CD: GitHub Actions + Docker + nginx 配置
- 文档: PRD/DESIGN/LAUNCH/ROADMAP/E2E/竞品对照等 15 份
- 工程: 任务看板(taskboard) + 健康巡检(agent-health) + Git流程(gitflow)
2026-08-13 21:40:27 +08:00

144 lines
8.2 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# PERLER LAB 待验收任务验收用例(TEST-PLAN.md)
> 版本: 1.0 | 用途: 对最近交付的 6 项成果执行验收 | 执行环境: 本地开发(服务端口 8788)
> 说明: 执行人逐条测试后填写"实际结果"列,通过则填「PASS」,失败填「FAIL + 现象描述」
---
## 1. 验收范围
| 任务编号 | 交付物 | 位置 |
|---|---|---|
| T-024 | 支付模块(建单/查单/模拟支付回调 + 自动发码) | perler-lab-server/src/payment/ |
| T-026 | chibi 提示词模板(5 大类 × 多细分 + 参考图/构图/细节) | perler-lab-server/src/chibi/prompts.ts |
| T-040 | DESIGN.md(设计规范) | docs/DESIGN.md |
| T-041 | LAUNCH.md(上线运营方案) | docs/LAUNCH.md |
| T-042 | copy-library.md(竞品文案库) | competitor-analysis/copy-library.md |
| T-029 | CI/CD 流水线 deploy.yml | .github/workflows/deploy.yml |
**用例总数:22 条**(含 1 条端到端冒烟测试 TC-22)
---
## 2. 支付模块(T-024)
| 用例ID | 验收项 | 测试步骤 | 预期结果 | 实际结果 |
|---|---|---|---|---|
| TC-01 | 创建订单 | `POST /api/orders`,body `{"packageName":"常用包","paymentMethod":"wechat"}` | 返回 200;`order.status="pending"`、`order.amountCents=1290`、`order.orderNo` 以 `PL` 开头;`payment` 含模拟支付参数 | |
| TC-02 | 非法套餐/支付方式校验 | `POST /api/orders`,body `{"packageName":"不存在","paymentMethod":"wechat"}`;再测 `paymentMethod="cash"` | 两次均返回 400,中文错误「套餐不存在」/「不支持的支付方式」,且不落订单 | |
| TC-03 | 支付回调成功并发码 | 对 TC-01 订单执行 `POST /api/orders/{orderNo}/pay-callback` | 返回 200;`order.status="paid"`、`order.access_code` 非空;`GET /api/orders?orderNo={orderNo}` 可见 paid 状态 | |
| TC-04 | 支付回调幂等 | 对 TC-03 同一订单重复执行 pay-callback 2 次 | 第 2、3 次仍返回 200 `{ok:true}`,不重复生成新兑换码(订单 access_code 不变) | |
---
## 3. chibi 提示词模板(T-026)
| 用例ID | 验收项 | 测试步骤 | 预期结果 | 实际结果 |
|---|---|---|---|---|
| TC-05 | 5 大分类模板完整 | 查看 `prompts.ts`,遍历 `landscape/person/pet/object/food` 五个分类 | 每个分类均有≥2 个细分模板,模板含中文描述、风格词、负面提示词结构完整 | |
| TC-06 | 生成接口接受分类+细分 | `POST /api/chibi/generate`,body 含 `category:"pet","subtype":"<有效细分>","image":"<base64>","gridSize":64,"colorCount":24,"composition":"主体特写"` | 返回 200,含 `image`、`access`、`downloadGrant`;有效兑换码时消耗 1 次 | |
| TC-07 | 非法分类/细分拦截 | 同 TC-06,但 `category:"dragon"`;再测合法分类 + 不存在的 subtype | 两次均返回 400,中文错误「未知的分类」/「未知的模板类型」,不扣次数 | |
| TC-08 | 参考图与自定义提示词 | 同 TC-06 且带 `referenceImage:"<base64>"`、`detailTags:["露珠"]`、`customPrompt:"Q版风"` | 返回 200 且生成成功;无 referenceImage 时可省略不报错 | |
---
## 4. DESIGN.md(T-040)
| 用例ID | 验收项 | 测试步骤 | 预期结果 | 实际结果 |
|---|---|---|---|---|
| TC-09 | 设计规范完整性 | 阅读 docs/DESIGN.md | 含色彩体系(主色/辅色/语义色)、字号层级、间距、圆角、阴影等核心规范章节 | |
| TC-10 | 规范与产品实现一致 | 抽查前端 `perler-lab/src` 中首页/生成页的关键样式(主色、按钮圆角、标题字号)对照 DESIGN.md | 页面取值与规范一致,无重大偏离 | |
| TC-11 | 无障碍与可读性 | 按规范检查正文/按钮前景背景对比度 | 正文与主要 UI 文本对比度 ≥4.5:1,提示文案不依赖单一颜色表达 | |
---
## 5. LAUNCH.md(T-041)
| 用例ID | 验收项 | 测试步骤 | 预期结果 | 实际结果 |
|---|---|---|---|---|
| TC-12 | 定价三档一致 | 对照 LAUNCH.md §3.1 与代码 `PACKAGE_DEFINITIONS`(代理200/500/1000)及个人包(体验 4.9/3次、常用 12.9/10次、进阶 29.9/30次) | 价格、次数全部一致,无一处冲突 | |
| TC-13 | 话术可直接使用 | 阅读 §3.3 微信私聊版与社群版话术 | 两份话术均含产品卖点、报价、转化引导,复制后可直接发送 | |
| TC-14 | FAQ 覆盖核心场景 | 核对 §4 客服 FAQ | 覆盖兑换/权益/下载/AI 生成/其他 ≥15 条,且答案与代码行为一致(如"失败不扣费") | |
---
## 6. copy-library.md(T-042)
| 用例ID | 验收项 | 测试步骤 | 预期结果 | 实际结果 |
|---|---|---|---|---|
| TC-15 | 代理价目表对齐 | 检索 copy-library.md 中代理套餐价格 | 含 ¥139/200次、¥299/500次、¥499/1000次,与 LAUNCH.md §3.1 一致 | |
| TC-16 | 文案条目可复用性 | 抽查 3 条文案(如首屏卖点、套餐说明、FAQ 话术) | 每条均为可直接复用的完整话术,非碎片笔记 | |
| TC-17 | 竞品口径标注 | 检查文案来源/用途标注 | 关键条目注明适用渠道或用途(小红书/社群/客服),便于运营取用 | |
---
## 7. CI/CD 流水线(T-029)
| 用例ID | 验收项 | 测试步骤 | 预期结果 | 实际结果 |
|---|---|---|---|---|
| TC-18 | Workflow 语法有效 | 本地执行 `npx actionlint .github/workflows/deploy.yml`(或 yamllint) | 无语法错误 | |
| TC-19 | 触发条件正确 | 阅读 workflow `on:` 配置 | 含 push 到 main(或 tag)触发;PR 不触发生产部署 | |
| TC-20 | 构建+测试阶段完整 | 检查 job 步骤 | 前端 `perler-lab` 与后端 `perler-lab-server` 均执行构建;后端运行 `vitest` 测试且失败即中断 | |
| TC-21 | 部署动作真实 | 检查部署步骤 | 使用 docker/build-push(构建镜像)并按 DEPLOY.md 目标服务器/服务执行部署,含健康检查或 SSM 校验 | |
---
## 8. 端到端冒烟测试(TC-22):建单→支付→redeem→consume
> 前置条件:服务已启动(`cd perler-lab-server && npm run dev`,监听 8788);数据库可写。
> 下方命令可直接复制执行(PowerShell 环境)。
```powershell
$base = "http://localhost:8788"
# Step 1 建单:创建常用包订单
$order = Invoke-RestMethod -Method Post -Uri "$base/api/orders" `
-ContentType "application/json" `
-Body '{"packageName":"常用包","paymentMethod":"wechat"}'
# 断言: $order.order.status == "pending" 且 amountCents == 1290
$orderNo = $order.order.orderNo
Write-Host "订单号: $orderNo, 状态: $($order.order.status)"
# Step 2 支付:触发模拟支付回调
$pay = Invoke-RestMethod -Method Post -Uri "$base/api/orders/$orderNo/pay-callback"
# 断言: $pay.ok == $true 且 $pay.order.status == "paid"
$code = $pay.accessCode
Write-Host "支付完成, 兑换码: $code, 次数: $($pay.order.totalUses)"
# Step 3 redeem:兑换兑换码
$redeem = Invoke-RestMethod -Method Post -Uri "$base/api/codes/redeem" `
-ContentType "application/json" `
-Body (@{ code = $code } | ConvertTo-Json)
# 断言: $redeem.access.remainingUses == 10 且 packageType == "常用包"
Write-Host "兑换成功, 剩余: $($redeem.access.remainingUses)/$($redeem.access.totalUses)"
# Step 4 consume:消耗 1 次
$consume = Invoke-RestMethod -Method Post -Uri "$base/api/codes/consume" `
-ContentType "application/json" `
-Body (@{ code = $code } | ConvertTo-Json)
# 断言: $consume.access.remainingUses == 9 且 freeDownload == $true
Write-Host "消耗 1 次, 剩余: $($consume.access.remainingUses)"
# Step 5 复核:状态查询(可选)
$status = Invoke-RestMethod -Method Get -Uri "$base/api/codes/status?code=$code"
Write-Host "状态复核, 剩余: $($status.access.remainingUses)"
```
| 步骤断言汇总 | 预期结果 | 实际结果 |
|---|---|---|
| 建单 | 200,status=pending,amountCents=1290,orderNo 以 PL 开头 | |
| 支付回调 | 200,ok=true,status=paid,accessCode 非空,totalUses=10 | |
| redeem | 200,access.remainingUses=10,packageType=常用包 | |
| consume | 200,access.remainingUses=9,freeDownload=true | |
| 全链路 | 四步全部 PASS 即端到端验收通过 | |
---
## 9. 执行记录
| 执行日期 | 执行人 | 通过/失败 | 备注 |
|---|---|---|---|
| (待填写) | | | |
> 通过标准:TC-01~TC-22 全部 PASS;任一 FAIL 需记录现象并转对应任务修复后复测。