产品需求文档（PRD）- 观看历史页模块

一、模块概述

“观看历史”页用于记录用户已观看的剧集内容及进度，方便用户随时续播、查找曾看过的短剧，提升用户粘性与回访率。

二、页面入口

• 来源路径：个人中心 > 观看历史
• 页面标题：观看历史
• 左上角返回按钮：返回上一页面
• 右上角：排序/筛选按钮（功能待扩展）

三、内容结构说明

每个观看历史记录以卡片列表形式展示，内容包含：

元素	描述
封面图	剧集封面图
剧集名称	剧名，如《亡国倒计时，小公主心声拯救皇帝》
标签	多个剧情标签（如“甜宠”、“逆袭”、“重生”）
播放进度	当前观看进度：第X集 / 总Y集
收藏图标	用户是否收藏（红色实心/白色空心书签）

• 列表按最新观看时间倒序排序；
• 点击卡片跳转至对应剧集播放页；
• 若该剧已被下架，可提示“该剧已下架”。

四、交互逻辑

操作	说明
点击卡片	跳转至对应剧集上次播放集数
收藏图标点击	切换收藏状态，调用接口更新状态
下拉刷新	重新拉取观看历史数据列表
向下滑动	分页加载更多历史数据

五、异常处理

• 无历史记录：展示空状态页面，文案建议：“您还没有观看记录～”，并推荐剧集按钮；
• 网络异常：Toast 提示“加载失败，请检查网络”。

六、接口需求（示意）

• GET /api/history/list
  参数：user_id, page, limit
  返回：剧集信息列表（含观看进度）

• POST /api/history/delete
  参数：history_id
  功能：删除单条历史记录（预留）

• POST /api/favorite/toggle
  参数：drama_id
  功能：添加/取消收藏

七、埋点建议

埋点事件	描述
history_card_click	用户点击某个历史卡片
history_load	历史页曝光成功
history_collect_toggle	收藏按钮点击