Mycontent/scripts/test/功能测试流程.md

Soul 创业派对 - 功能测试流程

测试工程师产出。按流程执行，成功项打 ☑️，失败项列出问题，最后输出报告。

---

一、测试流程总览

环境准备 → 自动化用例执行 → 手工功能验证 → 问题汇总 → 输出报告

---

二、环境准备

步骤	内容	结果
1	soul-api 已启动（local 时）或测试服已部署	☐ / 问题：_____
2	配置 .env.test（SOUL_TEST_ENV 或 SOUL_API_BASE）	☐ / 问题：_____
3	管理端可访问，默认账号 admin/admin123 可登录	☐ / 问题：_____
4	小程序可访问（真机或开发者工具）	☐ / 问题：_____

环境信息记录：

• 执行日期：__________
• 测试环境：local / souldev / soulapi
• API 地址：__________

---

三、自动化用例执行

在 scripts/test 下执行：

cd scripts/test
$env:SOUL_TEST_ENV="local"   # 或 souldev
pytest -v

3.1 小程序接口（miniapp）

用例	验证点	结果	问题（若失败）
test_config_public	GET /api/miniprogram/config 返回 prices、features、mpConfig	☐
test_dev_login_as	POST /api/miniprogram/dev/login-as 按 userId 登录	☐

3.2 管理端接口（web）

用例	验证点	结果	问题（若失败）
test_admin_login	POST /api/admin 登录成功	☐
test_admin_check_with_token	GET /api/admin 带 token 鉴权通过	☐
test_admin_check_without_token	GET /api/admin 无 token 返回 401	☐

3.3 流程测试（process）

用例	验证点	结果	问题（若失败）
test_health	GET /health 返回 200	☐
test_person_ensure_*	@某人 创建 Person + 存客宝计划	☐
test_article_mention_*	文章保存自动创建 Person	☐
test_backfill_persons_ckb_api_key	从存客宝补齐 ckb_api_key	☐

---

四、手工功能验证

4.1 小程序端

场景	验证点	结果	问题（若失败）
登录	微信登录、手机号授权、token 持久化	☐
首页	书籍列表、搜索栏（searchEnabled 控制）	☐
目录	章节列表、购买状态展示	☐
阅读	阅读页、购买章节/全书、支付流程	☐
我的	找伙伴、推广、搜索入口（featureConfig 控制）	☐
VIP	开通、资料填写、头像上传、保存	☐
推荐	扫码/分享带 ref、绑定、分润展示	☐

4.2 管理端

场景	验证点	结果	问题（若失败）
登录	账号密码登录、token 持久化	☐
仪表盘	数据统计展示	☐
用户管理	列表、搜索、分页、详情、行为轨迹 Tab	☐
订单管理	列表、状态、筛选	☐
内容管理	书籍/章节 CRUD	☐
提现	申请列表、审核、状态流转	☐
提现测试接口	GIN_MODE=release 时返回 404	☐

4.3 接口与数据流

场景	验证点	结果	问题（若失败）
路径隔离	小程序只调 /api/miniprogram/*	☐
鉴权	需登录接口带 token，401 正确跳转	☐
支付回调	下单→支付→回调→分润	☐

---

五、问题汇总（失败项）

将上述所有未打 ☑️ 的项在此列出：

序号	模块	场景/用例	问题描述	严重程度
1				高/中/低
2
…

---

六、测试报告（最终输出）

6.1 执行摘要

项目	内容
执行日期
测试环境
执行人

6.2 结果统计

类型	总数	通过 ☑️	失败	通过率
自动化用例	12
手工-小程序	7
手工-管理端	7
手工-接口	3
合计	29

6.3 结论

• 通过：所有关键项 ☑️，无高/中严重问题
• 有条件通过：存在低严重问题，可上线但需跟进
• 不通过：存在高/中严重问题，需修复后复测

6.4 问题清单（若有）

序号	问题	严重程度	建议
1
2

---

七、使用说明

1. 执行前：复制本文档或新建一份，填写环境信息。
2. 执行中：逐项验证，成功打 ☑️，失败在「问题」列填写。
3. 执行后：汇总失败项到「五、问题汇总」，填写「六、测试报告」。
4. 归档：报告保存为 scripts/test/测试报告-YYYY-MM-DD.md，便于追溯。