Soul 创业派对 - 测试报告（环境与用例清单）

测试人员产出。环境就绪后执行 pytest -v 并填写结果。

一、测试环境

配置方式：

运行命令：

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

用例	验证点	前置条件
test_config_public	GET /api/miniprogram/config 返回 200，含 prices、features、mpConfig	无
test_dev_login_as	POST /api/miniprogram/dev/login-as 按 userId 登录成功	SOUL_MINIPROGRAM_DEV_USER_ID 已配置；APP_ENV=development

用例	验证点	前置条件
test_admin_login	POST /api/admin 登录成功，返回 token、user	无
test_admin_check_with_token	GET /api/admin 带 token 鉴权通过	admin 登录成功
test_admin_check_without_token	GET /api/admin 无 token 返回 401	无
test_upload_post_success	POST /api/upload 上传图片成功，返回 url、data	无
test_upload_post_with_admin_token	POST /api/upload 带 token 可上传	admin 登录
test_upload_post_no_file	POST /api/upload 无 file 返回 400	无
test_upload_post_invalid_type	POST /api/upload 非图片格式返回 400	无
test_upload_delete_local	DELETE /api/upload 删除本地文件（先上传再删）	无
test_upload_delete_no_path	DELETE /api/upload 无 path 返回 400	无

用例	验证点	前置条件
test_health	GET /health 返回 200	soul-api 已启动
test_person_ensure_creates_ckb_plan_when_not_exists	@某人不存在时 POST /api/db/persons 创建 Person + 存客宝计划	admin 登录；CKB 配置正确
test_person_ensure_returns_existing_when_name_exists	相同 name 返回已有 Person，不重复创建	同上
test_person_ensure_rejects_empty_name	空 name 被拒绝	同上
test_article_mention_flow_persons_list_contains_new	文章保存后 persons 列表含新人物	同上
test_new_article_save_auto_creates_person_and_ckb	新文章保存自动创建 Person 与存客宝计划	同上
test_backfill_persons_ckb_api_key	从存客宝补齐 persons.ckb_api_key	admin 登录；CKB 配置；persons 有 ckb_plan_id

以下为 2026-03-17 源码质量优化后的建议回归项，自动化用例未覆盖：

场景	验证点
支付流程	read 页购买章节/全书 → 微信支付 → 回调更新购买状态
管理端用户详情	用户列表点击详情 → 行为轨迹 Tab 展示（调用 /api/admin/user/track）
我的页	找伙伴、推广、搜索入口根据 featureConfig 显示/隐藏
首页/目录	搜索栏根据 searchEnabled 显示/隐藏
提现测试接口	GIN_MODE=release 时 GET/POST /api/admin/withdraw-test 返回 404

执行日期	环境	通过	失败	跳过	备注
2026-03-17	local	16	0	2	含新增文件上传 6 用例；2 跳过（dev_login、backfill 需配置）
（待填写）	local / souldev	-	-	-	-

用例	错误信息	处理
-	-	-

执行测试前请确认：