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)
This commit is contained in:
commit
02762400fb
174 files changed
+28059
No files matched your search
@@ -0,0 +1,143 @@
|
||||
# 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 需记录现象并转对应任务修复后复测。
|
||||
Reference in new issue
Block a user