Files
perler-lab/docs/TEST-PLAN.md
T
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

8.2 KiB
Raw Blame History

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 环境)。

$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 需记录现象并转对应任务修复后复测。