# 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":"","gridSize":64,"colorCount":24,"composition":"主体特写"` | 返回 200,含 `image`、`access`、`downloadGrant`;有效兑换码时消耗 1 次 | | | TC-07 | 非法分类/细分拦截 | 同 TC-06,但 `category:"dragon"`;再测合法分类 + 不存在的 subtype | 两次均返回 400,中文错误「未知的分类」/「未知的模板类型」,不扣次数 | | | TC-08 | 参考图与自定义提示词 | 同 TC-06 且带 `referenceImage:""`、`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 需记录现象并转对应任务修复后复测。