短剧 Web 端
研发交付 PRD
以已冻结的阶段二高保真原型为唯一产品真值，明确页面行为、后台配置、状态边界、埋点与验收；技术实现方式由研发评审签字。
§0.1文档说明 · 变更日志
本文件是阶段三独立交付物，不回写阶段一 PRD，也不改动阶段二原型。任何实现争议先对照冻结原型，再对照本文件的边界与验收。
| 项目 | 现行值 |
|---|---|
| 交付对象 | 前端、后端、测试、数据与运营配置研发 |
| 真值基线 | 短剧Web端-阶段二高保真原型-v1.0.html，SHA-256：850c357e49f4969c1c080be7bd3398f202dfd82bbe75df173defc3de85628aca |
| 线上核对 | https://s-1skkr09r.pages.dev/；已复核资源上传纠偏后的生产版本 |
| 参考外壳 | delivery-prd-builder/SKILL.md 的 §0.x＋C/O/A/X 组件契约 |
变更日志
| 版本 | 日期 | 变更 |
|---|---|---|
v1.0 | 2026-07-30 | 首次从冻结阶段二原型逆向生成研发交付契约；短剧资源新增按本地文件上传至自有服务器，不接受外部视频地址。 |
§0.2真值顺序 · 怎么读
01阶段二冻结原型定义当前可见行为、入口、状态和运营配置。
02设计系统定义颜色、字体、尺寸、响应式与无障碍基线。
03阶段一 PRD仅用于追溯原始 REQ/EP；与原型冲突时不覆盖现行实现。
研发阅读路径
| 角色 | 先读 | 再读 |
|---|---|---|
| 前端 | C/O 页面流程、矩阵、8 态 | §0.5、§0.7、AC |
| 后端 | §0.6、A 后台配置 | §0.8、X-1 待签字项 |
| 测试 | 各卡 AC | X-2 完整验收清单 |
| 数据 | §0.8 Event Plan | A-05 指标口径 |
§0.3当前交付范围
| 范围 | 现行契约 | 优先级 |
|---|---|---|
| 用户端 | 首页、分类、搜索联想、选集、播放、精品应用、全局页脚；Web 与 H5 同一产品适配 | P0 |
| 运营位 | 页面 Banner、Feed 中插 Banner、开屏、前贴、剧中广告 | P0 |
| 基础后台 | 短剧、Banner、广告、页脚与应用、数据概览 | P0 |
| 核心指标 | UV、PV、广告点击并发起跳转；其他事件只用于诊断与拆分 | P0 |
§0.4信息架构 · 路由总览
| 视图 | 前台标识 | 后台依赖 |
|---|---|---|
| 首页／分类 | home / category | 短剧、Banner、广告、页脚与应用 |
| 选集／播放 | detail / player | 短剧资源、Banner、前贴与剧中广告 |
| 精品应用 | apps | 页脚与应用配置 |
| 运营后台 | admin-* | 运营权限与接口标识均待研发确认 |
§0.5全局规则 · 合规边界
R-001游客无需登录即可浏览和播放已上架且资源有效的内容。
R-002站内链接走内部页面标识；外链只接受 http/https，新窗口打开并使用安全关系属性。
R-003渠道短链必须指向已审核真实页面，不得隐藏落地内容或绕过平台规则。
R-004“最新”按发布时间倒序；“最火”按短剧点击量倒序，同量时按发布时间倒序。
R-005最新／最火由后台手动配置；双选只显示最火；均未配置时回退内容状态。
R-006筛选结果为空保留条件并给出清除入口，不展示空白画布。
R-007同一时刻只展示一个广告层；剧中广告暂停正片，关闭后从原进度恢复。
R-008开屏可立即关闭；前贴满 3 秒后才可关闭；剧中广告可立即关闭。
R-009无有效跳转地址的 Banner 或广告禁止启用。
R-010无真实数据时显示“待接入／暂无数据”，不得编造增长率、趋势或目标值。
R-011访问来源依次读取渠道参数、外部引荐；均为空记“直接访问”。
R-012所有 Banner 与广告事件携带配置编号和素材编号。
§0.6内容资源 · 运营配置契约
| 资源 | 必填内容 | 保存门禁 | 待研发签字 |
|---|---|---|---|
| 短剧 | 剧名、简介、分类、封面、集数、上下架状态 | 基础字段完整 | 字段长度与封面规格 |
| 剧集视频 | 本地视频文件，上传至自有服务器资源库 | 未上传、上传中、格式不符、失败均禁止保存；编辑可沿用既有有效资源 | 分片、断点续传、大小上限、转码与资源标识 |
| Banner | 图片、标题、按钮、跳转、页面、排序、开关 | 跳转地址合法且绑定页面有效 | 素材规格与缓存刷新 |
| 广告 | 类型、素材、文案、跳转、频率、时间或集数规则 | 硬性关闭规则不可被后台覆盖 | 频控存储与跨端一致性 |
| 页脚／应用 | 显示文字、项目内图标路径、站内标识或 http/https 跳转 | 图标限项目 assets/；跳转校验通过 | 发布生效策略 |
video/* 文件，收到自有服务器上传成功状态后才允许保存配置。§0.7通用 8 态 · 边界异常规范
| 状态 | 统一触发 | 统一表现 | 恢复路径 |
|---|---|---|---|
| 加载中 | 页面、列表、资源或配置请求未完成 | 结构化骨架或明确进度；不闪空白 | 成功替换内容；失败转错误态 |
| 空数据 | 有效请求返回 0 条 | 说明当前条件与原因 | 清除筛选、返回上级或创建配置 |
| 断网 | 网络不可用 | 保留当前上下文，停止假成功 | 网络恢复后重试 |
| 错误 | 接口、播放器、上传或跳转失败 | 就地错误，不清空已有有效数据 | 重试或返回稳定状态 |
| 重连 | 网络或媒体连接恢复 | 从可恢复节点继续 | 恢复后关闭提示 |
| 超限 | 文件大小、频次或内容上限 | 说明具体超限项 | 更换文件或调整输入 |
| 登录态 | 用户端：不适用；后台：会话失效 | 前台不弹登录墙；后台停止写操作 | 后台重新认证后回到原模块 |
| 审核拦截 | 内容、素材或跳转不符合运营规则 | 禁止启用／上架并说明被拦字段 | 修订后重新提交 |
§0.8全局埋点总览
| 编号 | 事件 | 触发 | 关键属性 | 口径 |
|---|---|---|---|---|
EP-001 | 页面访问 | 页面进入完成 | 页面、来源、终端、会话 | PV；UV 按筛选周期去重 |
EP-002 | 短剧曝光 | 卡片进入可视区 | 短剧、页面、位置、来源 | 诊断 |
EP-003 | 短剧选择 | 进入选集页 | 短剧、入口、排序、筛选、结果位置 | 最火点击量单源 |
EP-004/005 | 搜索提交／联想选择 | 提交或选择结果 | 关键词、结果数、短剧、页面 | 诊断 |
EP-006/007/008 | 播放启动／结束／失败 | 媒体状态变化 | 短剧、剧集、时长、错误类型、终端 | 诊断 |
EP-009/010 | Banner 曝光／点击 | 可视或发起跳转 | 配置、素材、页面、位置、跳转 | 点击并跳转归核心广告跳转 |
EP-011–016 | 三类广告曝光／操作 | 展示、点击、关闭或结束 | 配置、素材、类型、短剧、剧集、进度、操作 | 点击并跳转归核心广告跳转 |
EP-017 | Feed 条件变更 | 切换分类、排序或状态 | 页面、条件、结果数、会话 | 诊断 |
用户从双推荐位、分类筛选、作品 Feed 或搜索联想选择短剧；首页与分类页共享筛选逻辑，但使用独立页面 Banner。
M-01首页精选推荐固定两位，一行两列，均为横向 16:9；Web 显示标题、简介和文字按钮，H5 收敛标题＋44px 图标按钮。
M-02首页 Feed 为 20 部模拟作品，推荐区另 4 部；Web 4 列、24px 间距，H5 2 列、16px 间距。
M-03首页 Feed 第两整行后插 7:1 Banner；分类 Feed 第四整行后插同款 Banner，结果不足对应整行不展示。
M-04分类／排序／状态三个下拉组合生效；分类页下拉同步切换分类内容与独立 Banner。
M-05搜索按剧名、简介、分类标签模糊匹配，200ms 防抖，支持键盘联想；不保存历史、不展示热门搜索。
M-06所有长内容背景由内容高度驱动，首屏以下至页脚前不得露出舞台背景。
| 状态 | 触发 | C01 落地 |
|---|---|---|
| 加载中 | Feed／搜索请求中 | Feed 或联想骨架，不闪空结果 |
| 空数据 | 组合条件无作品 | 保留条件＋“清除状态筛选” |
| 断网 | 请求不可达 | 保留当前结果，提示网络异常 |
| 错误 | 列表／搜索失败 | 就地错误＋重试 |
| 重连 | 网络恢复 | 按当前条件重新请求 |
| 超限 | 关键词超产品限制 | 停止提交并说明输入限制；具体上限待研发签字 |
| 登录态 | 游客访问 | 不弹登录墙 |
| 审核拦截 | 配置内容被下架 | 从结果移除，不保留假入口 |
用户查看短剧详情和剧集列表，选择已上架剧集后进入播放器；正片按用户操作开始，结束后存在下一集则自动切换。
M-07游客无需登录；只有已上架且自有服务器资源有效的剧集可进入播放。
M-08正片按用户播放动作开始；页面进入不自动高码率播放。
M-09自然播放结束且存在下一集时自动切换；最后一集结束后停止，不循环回第一集。
M-10选集页 Banner 固定 7:1，背景画布页面级全宽，内部 Banner 与首页 Feed 内容线对齐。
M-11播放页 Banner 独立配置，不与前贴或剧中广告叠加。
| 状态 | 触发 | C02 落地 |
|---|---|---|
| 加载中 | 详情／媒体加载 | 详情骨架；播放器显示加载状态 |
| 空数据 | 无有效剧集 | 剧集区说明“暂无可播放剧集” |
| 断网 | 播放中断网 | 暂停并保留当前集与进度 |
| 错误 | 资源／解码失败 | 记录 EP-008，提供重试或返回选集 |
| 重连 | 连接恢复 | 从可恢复进度继续，具体能力待技术签字 |
| 超限 | 频控／资源限制 | 说明限制，不伪装为播放失败 |
| 登录态 | 游客播放 | 不拦截、不弹登录层 |
| 审核拦截 | 剧集被下架 | 阻止新播放；播放中处置待运营与研发签字 |
精品应用页与所有前台页脚共享同一运营配置，页面只保留一个主标题；主内容与页脚使用同一连续背景画布。
M-12精品应用页与页脚共用五项应用配置；图标始终 1:1，Web 五列，H5 两列。
M-13全局页脚包含精品应用、友情链接、网站地图、品牌说明、版权／备案五段。
M-14页脚外层继承页面 --bg 且不增加分段边界；内部必要分隔保留。
M-15图标路径仅接受项目 assets/；非法链接回退首页且不得静默打开未知协议。
| 状态 | 触发 | C03 落地 |
|---|---|---|
| 加载中 | 配置读取中 | 保留标题和网格骨架 |
| 空数据 | 应用配置为空 | 隐藏应用网格，页脚其他段继续展示 |
| 断网 | 配置不可达 | 展示最近有效配置或明确错误；缓存策略待签字 |
| 错误 | 图标／跳转失败 | 单项降级，不破坏整页 |
| 重连 | 网络恢复 | 刷新失败项 |
| 超限 | 配置超项 | 后台阻止保存；具体上限待签字 |
| 登录态 | 游客点击 | 不要求登录 |
| 审核拦截 | 外链未审核 | 不展示或禁止启用 |
三类广告共享互斥、跳转与埋点约束，但关闭规则和承载层不同：开屏居中模态、前贴位于播放器内、剧中广告铺满产品浏览器可见容器。
O-开屏同一访问会话展示一次，可立即关闭；与首页进入弹窗共用运营位，不重复展示。
O-前贴正片前位于播放器内；倒计时满 3 秒才允许关闭，关闭、结束或加载失败均进入正片。
O-剧中按播放进度或指定集触发；铺满产品浏览器可见容器，展示时暂停，关闭后从原进度继续；点击活动不额外显示 Toast。
| 状态 | 触发 | O01 落地 |
|---|---|---|
| 加载中 | 素材加载 | 前贴显示倒计时状态；开屏／剧中不阻塞可关闭规则 |
| 空数据 | 无有效配置 | 不展示广告，继续主流程 |
| 断网 | 广告请求失败 | 不阻断浏览；前贴进入正片 |
| 错误 | 素材／跳转失败 | 记录诊断并保持关闭路径 |
| 重连 | 连接恢复 | 不在同一触发点重复弹出，具体频控待签字 |
| 超限 | 频控达到上限 | 本次不展示 |
| 登录态 | 游客操作 | 不要求登录 |
| 审核拦截 | 素材或跳转未通过 | 配置不可启用 |
A-01短剧管理
- 支持新增短剧、维护剧名／简介／分类／封面、添加剧集、上下架与搜索筛选。
- 新增资源选择本地
video/*文件并上传至自有服务器；不提供外部视频地址输入。 - 上传状态为未开始／上传中／完成／失败；只有完成可保存，编辑既有短剧可沿用有效资源。
- “最新／最火”支持单选、双选或不配置；双选前台只显示最火，不配置回退内容状态。
- 保存记录操作人、服务器资源状态与版本；资源上传与角标配置不计用户行为埋点。
| 验收编号 | Given | When | Then |
|---|---|---|---|
AC-A01-1 | 新增短剧未完成视频上传 | 点击保存 | 保存被阻止，文件字段显示就地错误 |
AC-A01-2 | 选择非视频文件 | 文件变更 | 拒绝上传并提示格式不符 |
AC-A01-3 | 编辑既有短剧且不替换资源 | 保存其他字段 | 沿用原有效资源，不强制重复上传 |
A-02Banner 管理
- 支持新增、修改、绑定首页／分类／选集／播放页面、调整排序和控制开关。
- 首页 Feed 中插与分类 Feed 中插使用独立 7:1 素材；分类顶部为 7:2，选集为 7:1。
- 跳转接受站内标识或 http/https；无效地址禁止启用。
- 每次曝光与点击携带配置编号、素材编号、页面和位置。
| 验收编号 | Given | When | Then |
|---|---|---|---|
AC-A02-1 | 跳转地址无效 | 运营尝试启用 | 开关不生效并标出无效字段 |
AC-A02-2 | 同页面多条 Banner | 运营调整排序 | 前台按保存后的顺序展示且事件仍能区分配置编号 |
A-03广告管理
- 分别维护类型、素材、文案、跳转、展示规则与启用状态。
- 前贴关闭门槛固定 3 秒，后台不能延长或取消；剧中广告始终可立即关闭。
- 剧中广告支持播放时长或指定集数触发；同一时刻命中多条只展示一次。
- 开关只影响启用状态，不改变产品硬规则。
| 验收编号 | Given | When | Then |
|---|---|---|---|
AC-A03-1 | 运营编辑前贴配置 | 尝试将关闭时间小于 3 秒 | 保存被阻止或固定回 3 秒，具体控件实现待研发确认 |
AC-A03-2 | 剧中多规则同时命中 | 播放器到达触发点 | 只展示一个剧中广告层 |
A-04页脚与应用
- 维护页脚标题与说明、友情链接、网站地图、版权与备案。
- 维护五项应用名称、项目内图标路径与跳转地址。
- 保存后精品应用页与所有前台页脚读取同一配置源。
- 项目内图标路径限
assets/；跳转只接受站内标识或 http/https。
| 验收编号 | Given | When | Then |
|---|---|---|---|
AC-A04-1 | 运营修改应用名称 | 保存配置 | 应用页与全局页脚同步更新，无双源差异 |
AC-A04-2 | 图标路径不属于 assets | 点击保存 | 保存被阻止并显示就地错误 |
A-05数据概览
- 三张等权指标卡只展示 UV、PV、广告点击并发起跳转。
- UV 按筛选周期对独立访客去重；PV 按页面进入累计。
- 广告跳转仅在点击并发起跳转时累计；曝光、关闭、播放作为诊断事件。
- 日期与来源用于筛选；页面、短剧、剧集、运营位作为拆分维度。
- 未接入真实数据时显示“待接入／暂无数据”，不展示虚构趋势。
| 验收编号 | Given | When | Then |
|---|---|---|---|
AC-A05-1 | 数据接口尚未接入 | 进入数据概览 | 三项指标显示待接入，不出现数字或趋势 |
AC-A05-2 | 用户只关闭广告未跳转 | 事件入库 | 不增加“广告点击跳转”，只保留诊断操作事件 |
X-1逻辑漏洞审查
现象资源新增若存在外部地址入口，会绕过自有资源库的上传状态。
风险资源不可控、状态不可追溯，且保存门禁失效。
决议以阶段二为准：video/* 本地文件上传至自有服务器，完成后才可保存。
现象开屏、前贴、剧中规则可能在同一会话连续命中。
风险浮层叠加、正片状态错乱和重复计数。
决议全局广告互斥；同一时刻只展示一个广告层。
现象运营可配置站内和外部跳转。
风险未知协议、无效地址或未审核页面造成安全与合规问题。
决议只接受站内标识或 http/https；无效或未审核配置不可启用。
现象当前原型没有真实统计数据。
风险虚构指标会误导产品验收与运营判断。
决议显示“待接入／暂无数据”；只有真实采集值可进入报表。
现象产品已锁定上传路径，但文件大小、分片、转码、重试与清理参数未定。
风险大文件失败、重复资源或孤儿文件。
决议产品只锁定状态与保存门禁；具体上传实现、资源标识及失败清理由研发评审签字。
现象剧集播放过程中可能被运营下架。
风险强制中断与继续播放的口径不一致。
决议阻止新播放已锁定；对正在播放会话的处置由运营与研发联调前确认。
X-2验收清单 · Definition of Done
| 编号 | 验收项 | 通过条件 |
|---|---|---|
DOD-01 | 阶段边界 | 阶段一、阶段二文件哈希未变化；阶段三文件独立存在 |
DOD-02 | 组件契约 | §0.1–§0.8、C/O 7 段、A 模块组、X-1/X-2、目录与文档交互齐全 |
DOD-03 | 用户主流程 | 首页／分类／搜索 → 选集 → 播放；游客无登录墙 |
DOD-04 | 资源上传 | 新增短剧只接受本地视频上传至自有服务器；四类失败状态阻止保存 |
DOD-05 | 广告规则 | 开屏、前贴、剧中承载与关闭规则一致；全局互斥 |
DOD-06 | 响应式 | Web/H5 无横向滚动；H5 主要触达区不小于 44px |
DOD-07 | 状态与错误 | 通用 8 态在 C/O 卡有对应落地；错误均有恢复路径 |
DOD-08 | 埋点与数据 | EP-001–017 可追溯；三项核心指标不混入诊断事件 |
DOD-09 | 真实数据纪律 | 无来源指标、趋势与目标值为 0 |
DOD-10 | 运行态 | 文档真实渲染无重叠、裁切或横向溢出；目录、搜索、下载、返回顶部可用 |