一、页面概述

本文档基于「运维运营管理平台」直播预约记录与直播观看记录两个功能模块的原型图,整理字段定义、搜索条件、统计指标及交互逻辑,供前后端开发参考。

两个模块均为**只读查询页面**,不支持新增/编辑/删除,提供列表筛选、数据统计汇总及数据导出能力。


二、直播预约记录

2.1 页面说明

展示所有用户对养生直播场次的预约记录,支持多条件筛选,页面顶部展示预约转化率汇总指标,支持导出当前筛选结果。

2.2 搜索 / 筛选条件

筛选项 类型 匹配方式 备注
用户电话 文本输入框 模糊匹配 输入手机号或部分号码进行搜索
课程名称 文本输入框 模糊匹配 输入直播课程名称关键词
直播分类 下拉选择 精确匹配 全部 / 各课程分类;默认「全部」
直播状态 下拉选择 精确匹配 全部 / 未开始 / 直播中 / 已结束;默认「全部」
是否观看直播 下拉选择 精确匹配 全部 / 是 / 否;默认「全部」;筛选预约后是否实际观看
预约时间 日期范围选择 起止区间 格式:开始时间 ~ 结束时间;对应字段 reserve_time
  • 重置:清空所有筛选条件,重新加载默认列表
  • 搜索:按当前条件查询并刷新列表,分页重置至第 1 页

2.3 统计汇总

列表上方展示当前筛选结果的汇总指标:

指标名称 计算公式 备注
预约转化率 观看直播人数 ÷ 预约总数 【产品批注】实际观看直播的人数除以预约总人数,随筛选条件动态计算

2.4 列表展示字段

字段名 字段说明 类型 备注
序号 列表行号 int 按预约时间倒序排列,前端自动计算行号
用户 用户头像 + 昵称 relation 展示头像缩略图及用户昵称;匿名用户显示"-"
电话 用户手机号 string 脱敏展示,格式:1476905
课程名称 预约的直播课程名称 string 关联 live_course 表
所属分类 课程所属分类 string 关联课程分类
开播时间 该场次的直播开始时间 datetime 格式:YYYY-MM-DD HH:mm
直播状态 该场次当前直播状态 enum tag 未开始 / 直播中 / 已结束
预约时间 用户完成预约的时间 datetime 格式:YYYY-MM-DD HH:mm:ss
是否观看直播 该用户预约后是否实际观看了直播 boolean 是 / 否

2.5 导出说明

  • 导出按钮:点击「导出」按钮,将当前筛选条件下的全量列表数据导出为 Excel 文件
  • 导出字段:与列表展示字段一致(序号、用户昵称、电话、课程名称、所属分类、开播时间、直播状态、预约时间、是否观看直播)
  • 【产品批注】:导出列表字段,按当前筛选条件全量导出,不受分页限制

2.6 分页规则

  • 默认每页 10 条,支持切换每页条数
  • 展示总记录数,如「共 800 条」

三、直播观看记录

3.1 页面说明

展示所有用户对养生直播场次的实际观看记录,支持多条件筛选,页面顶部展示完播率与有效观看率汇总指标,支持导出当前筛选结果。

3.2 搜索 / 筛选条件

筛选项 类型 匹配方式 备注
诊所区域 下拉选择 精确匹配 全部 / 各区域;默认「全部」;关联用户所属诊所区域
诊所 文本输入框 模糊匹配 输入诊所名称关键词
用户电话 文本输入框 模糊匹配 输入手机号或部分号码进行搜索
课程名称 文本输入框 模糊匹配 输入直播课程名称关键词
直播分类 下拉选择 精确匹配 全部 / 各课程分类;默认「全部」
是否预约 下拉选择 精确匹配 全部 / 是 / 否;默认「全部」;筛选观看前是否已预约
完整观看直播 下拉选择 精确匹配 全部 / 是 / 否;默认「全部」;是否完整看完直播
有效观看直播 下拉选择 精确匹配 全部 / 是 / 否;默认「全部」;观看时长是否超过 10 分钟
观看时间 日期范围选择 起止区间 格式:开始时间 ~ 结束时间;对应字段 watch_time
  • 重置:清空所有筛选条件,重新加载默认列表
  • 搜索:按当前条件查询并刷新列表,分页重置至第 1 页

3.3 统计汇总

列表上方展示当前筛选结果的汇总指标:

指标名称 计算公式 备注
完播率 完整观看直播人数 ÷ 总观看人数 【产品批注】完整看完直播的人数除以总观看人数,随筛选条件动态计算
观看有效率 观看直播超过 10 分钟人数 ÷ 总观看人数 【产品批注】观看时长大于 10 分钟的人数除以总观看人数,随筛选条件动态计算

3.4 列表展示字段

字段名 字段说明 类型 备注
序号 列表行号 int 按观看时间倒序排列,前端自动计算行号
用户 用户头像 + 昵称 relation 展示头像缩略图及用户昵称;匿名用户显示"-"
电话 用户手机号 string 脱敏展示,格式:1476905
关联诊所 用户所属诊所名称 string 关联用户档案中的诊所信息;无归属诊所显示"-"
诊所区域 用户所属诊所的区域 string 格式:省>市>区,如「四川省>成都市>金牛区」
课程名称 观看的直播课程名称 string 关联 live_course 表
所属分类 课程所属分类 string 关联课程分类
开播时间 该场次的直播开始时间 datetime 格式:YYYY-MM-DD HH:mm
是否预约 该用户观看前是否已预约 boolean 是 / 否
观看时间 用户开始观看直播的时间 datetime 格式:YYYY-MM-DD HH:mm:ss
完整观看直播 该用户是否完整观看了直播全程 boolean 是 / 否

3.5 导出说明

  • 导出按钮:点击「导出」按钮,将当前筛选条件下的全量列表数据导出为 Excel 文件
  • 导出字段:与列表展示字段一致(序号、用户昵称、电话、关联诊所、诊所区域、课程名称、所属分类、开播时间、是否预约、观看时间、完整观看直播)
  • 【产品批注】:导出列表字段,按当前筛选条件全量导出,不受分页限制

3.6 分页规则

  • 默认每页 10 条,支持切换每页条数
  • 展示总记录数,如「共 800 条」

四、业务规则

  1. 只读页面:两个模块均为数据查询页面,不支持新增、编辑、删除操作。
  2. 统计指标动态计算:完播率、有效观看率、预约转化率均基于当前筛选条件的全量数据实时计算,不受分页影响。
  3. 用户手机号脱敏:列表和导出文件中手机号均采用中间 4 位星号脱敏处理。
  4. 完整观看判定:用户观看直播全程(从开始到结束)方可标记为「完整观看」。
  5. 有效观看判定:用户累计观看时长超过 10 分钟方可标记为「有效观看」。
  6. 去重观看计数:同一用户多次进入同一场直播,观看人数仍计为 1 人,但观看时长累计计算。
  7. 导出数据量:导出为当前筛选条件下的全量数据,不受列表分页限制,建议后端异步生成文件后提供下载链接。

五、原型图

直播观看记录

![页面 1](/Users/mitao/code/tcm-training-admin/doc/直播预约记录 & 直播观看记录模块 — 字段说明与原型需求描述.assets/页面 1.png)

直播预约记录

![页面 1](/Users/mitao/code/tcm-training-admin/doc/直播预约记录 & 直播观看记录模块 — 字段说明与原型需求描述.assets/页面 1-4061658.png)