# stitch_soul P0 测试清单

> 测试人员按此清单验证 P0 功能。

---

## 一、开发完成情况

| 阶段 | 状态 | 说明 |
|------|------|------|
| **P0** | ✅ 完成 | 首页/目录 + NEW + 精选推荐算法 |
| P1 | 未开始 | 会员落地页 |
| P2 | 未开始 | 导师 + 预约 |
| P3 | 未开始 | 资料编辑扩展 |

---

## 二、P0 接口测试

**前提**：soul-api 已启动，数据库已执行 `add-chapters-is-new.sql`。

### 2.1 后端接口（可用 PowerShell 脚本或 curl 验证）

```powershell
# 在 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 章」配置。

---

*测试完成后可更新本文件，标注通过/失败及问题。*