2.8 KiB
2.8 KiB
stitch_soul P0 测试清单
测试人员按此清单验证 P0 功能。
一、开发完成情况
| 阶段 | 状态 | 说明 |
|---|---|---|
| P0 | ✅ 完成 | 首页/目录 + NEW + 精选推荐算法 |
| P1 | 未开始 | 会员落地页 |
| P2 | 未开始 | 导师 + 预约 |
| P3 | 未开始 | 资料编辑扩展 |
二、P0 接口测试
前提：soul-api 已启动，数据库已执行 add-chapters-is-new.sql。
2.1 后端接口（可用 PowerShell 脚本或 curl 验证）
# 在 soul-api 目录下执行
cd e:\Gongsi\Mycontent\soul-api
.\scripts\test-p0-endpoints.ps1
或手动验证：
| 接口 | 期望 |
|---|---|
GET /api/miniprogram/book/all-chapters |
success: true，data 为数组，每项含 isNew 字段 |
GET /api/miniprogram/book/recommended |
success: true，data 为 1～3 条，每项含 tag（热门/推荐/精选） |
GET /api/miniprogram/book/latest-chapters |
success: true，data 为数组（按 updated_at 降序） |
GET /api/miniprogram/book/hot |
success: true，data 为数组（按阅读量或兜底排序） |
2.2 管理端测试
| 步骤 | 操作 | 期望 |
|---|---|---|
| 1 | 登录 soul-admin | 成功 |
| 2 | 进入「内容管理」 | 章节列表正常 |
| 3 | 点击某一节「编辑」 | 弹出编辑框 |
| 4 | 勾选「标记 NEW」并保存 | 保存成功，无报错 |
| 5 | 刷新列表，再次编辑同一节 | 「标记 NEW」保持勾选 |
2.3 小程序测试
| 步骤 | 操作 | 期望 |
|---|---|---|
| 1 | 打开小程序首页 | 加载正常 |
| 2 | 查看「最新更新」Banner | 显示一条章节，点击可进入阅读 |
| 3 | 查看「精选推荐」 | 显示 3 条，带 热门/推荐/精选 标签 |
| 4 | 查看「最新新增」 | 有 isNew 的章节在此展示 |
| 5 | 进入「目录」页 | 从服务端加载，按篇章聚合 |
| 6 | 在目录中查看标记 NEW 的章节 | 显示 NEW 标签 |
| 7 | 查看免费/¥1 显示 | 免费节显示「免费」，付费节显示「¥1」 |
三、联调验证
| 验证点 | 说明 |
|---|---|
| 管理端标记 NEW → 小程序展示 | 在管理端勾选某节 NEW，小程序目录/首页「最新新增」应出现 |
| 精选推荐排除序言/尾声/附录 | 若 part_title 含「序言」「尾声」「附录」，不应出现在 recommended/hot |
| 阅读量兜底 | 无 reading_progress 数据时，hot/recommended 应返回 updated_at 排序的兜底结果 |
四、已知限制
- 阅读量：当前依赖
reading_progress表，新环境无数据时会走兜底（按 updated_at）。 - 固定 3 章兜底：若连章节列表都拿不到，会返回空；未实现「预设固定 3 章」配置。
测试完成后可更新本文件，标注通过/失败及问题。