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 环境)。
| 步骤断言汇总 |
预期结果 |
实际结果 |
| 建单 |
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 需记录现象并转对应任务修复后复测。