短剧 Web 端
研发交付 PRD
以已冻结的阶段二高保真原型为唯一产品真值，明确页面行为、后台配置、状态边界、埋点与验收；技术实现方式由研发评审签字。
§0.1文档说明 · 变更日志
本文件是阶段三独立交付物。本次依据用户明确授权，将新增变动同步到阶段一 v1.1.4、阶段二现行原型与本研发契约；任何实现争议先对照当前阶段二原型，再对照阶段一 REQ 与本文件的技术边界和验收。
| 项目 | 现行值 |
|---|---|
| 交付对象 | 前端、后端、测试、数据与运营配置研发 |
| 真值基线 | 短剧Web端-阶段二高保真原型-v1.0.html，SHA-256：f9ecb56eba4bce865b34a0950220a4b69f25397d89a6a2a6bc8cac1e12c0e523 |
| 线上核对 | https://s-1skkr09r.pages.dev/；已复核资源上传纠偏后的生产版本 |
| 参考外壳 | delivery-prd-builder/SKILL.md 的 §0.x＋C/O/A/X 组件契约 |
变更日志
| 版本 | 日期 | 变更 |
|---|---|---|
v1.6 | 2026-08-08 | 新增 A-06 配置历史日志契约，统一覆盖全部弹窗、全部 Banner 与应用中心广告位；成功写入后记录不可变的前后快照、操作人和时间，补齐查询、失败边界与验收。 |
v1.5 | 2026-08-06 | 轻松一刻取消子分类控件并改为指定范围作品混合随机；最火改为全局随机且首页默认最火；新增最新／最火互斥角标与分类内手动置顶，多个置顶按置顶配置时间倒序。 |
v1.4 | 2026-08-06 | 同步一级／二级分类研发契约：首页读取全部启用一级分类，一级分类页只读取当前父级下的启用二级分类；“轻松一刻”限制为一个一级分类及其 1—3 个不重复的启用二级分类，并补齐接口字段、保存门禁、埋点与验收。 |
v1.3 | 2026-07-31 | 完成新增变动的三阶段同步：Swift Web 短剧品牌变体、Feed 中插 Banner、精品应用与全局页脚、播放器广告容器与 3 秒关闭规则、播放控制与手势边界、自有服务器视频上传、三项核心指标，以及“取消后台页面原型、改交付能力开发说明”的实现边界。 |
v1.2 | 2026-07-31 | 明确播放手势双分支接入原则：现有前端框架支持则接入，不支持则暂缓；当前 Swift Web／SwVideoPlayer 不支持，因此维持暂缓。播放器规则编号由重复的 M-12 调整为 M-16。 |
v1.1 | 2026-07-31 | 核查 Swift Web／SwVideoPlayer 组件包后确认未提供正式播放手势协议；手势功能暂缓，不由业务层自行扩展，待框架提供能力后再接入。 |
v1.0 | 2026-07-30 | 首次从冻结阶段二原型逆向生成研发交付契约；短剧资源新增按本地文件上传至自有服务器，不接受外部视频地址。 |
§0.2真值顺序 · 怎么读
01阶段二冻结原型定义当前可见行为、入口、状态和运营配置。
02Swift Web · 短剧海风放映室定义 Sw* 组件结构、语义 Token、尺寸、响应式与无障碍基线。
03阶段一 PRD v1.1.4定义现行 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 | 页脚与应用配置 |
| 后台开发说明 | backend-spec／A-01～A-06 | 只定义能力、配置、校验、状态与验收；权限与接口标识待研发确认 |
§0.5全局规则 · 合规边界
R-001游客无需登录即可浏览和播放已上架且资源有效的内容。
R-002站内链接走内部页面标识；外链只接受 http/https，新窗口打开并使用安全关系属性。
R-003渠道短链必须指向已审核真实页面，不得隐藏落地内容或绕过平台规则。
R-004首页默认“最火”；最火对当前结果集随机排序并在单次列表会话内稳定，新列表会话重新随机；“最新”按发布时间倒序。
R-005最新／最火角标由后台手动配置且只能二选一；角标不参与排序，均未配置时回退内容状态。
R-006筛选结果为空保留条件并给出清除入口，不展示空白画布。
R-013手动置顶仅在作品所属一级分类列表中生效；同一分类多个置顶按置顶配置时间由晚到早，非置顶继续遵守当前排序。
R-007同一时刻只展示一个广告层；剧中广告暂停正片，关闭后从原进度恢复。
R-008开屏可立即关闭；前贴与剧中广告均铺满播放器容器，展示满 3 秒后才可关闭。
R-009无有效跳转地址的 Banner 或广告禁止启用。
R-010无真实数据时显示“待接入／暂无数据”，不得编造增长率、趋势或目标值。
R-011访问来源依次读取渠道参数、外部引荐；均为空记“直接访问”。
R-012所有 Banner 与广告事件携带配置编号和素材编号。
R-014全部弹窗、全部 Banner 与应用中心广告位仅在配置成功写入后生成不可变历史；失败校验不产生新版本，配置历史与用户行为统计分开存储。
§0.6内容资源 · 运营配置契约
| 资源 | 必填内容 | 保存门禁 | 待研发签字 |
|---|---|---|---|
| 短剧 | 剧名、简介、一级分类、该父级下的二级分类、封面、集数、上下架状态 | 基础字段完整且分类父子关系有效 | 字段长度与封面规格 |
| 分类树 | 一级分类、二级分类唯一父级、排序、启停状态 | 二级分类必须归属一个有效一级分类；被短剧或运营配置引用时按现有后台规则提示影响范围 | 分类标识、缓存刷新与停用策略 |
| 轻松一刻 | 一个启用一级分类、1—3 个不重复的启用二级分类、启用状态 | 二级分类全部属于所选一级分类；前台不下发子分类控件，只混合随机展示命中范围作品 | 配置接口标识与生效时延 |
| 排序／角标／置顶 | defaultSort=hot、randomSessionId、featuredBadge=latest|hot|null、manualPinned、manualPinnedAt | 角标互斥；置顶仅对所属一级分类生效；多个置顶按 manualPinnedAt 降序 | 随机种子生成与列表会话边界 |
| 剧集视频 | 本地视频文件，上传至自有服务器资源库 | 未上传、上传中、格式不符、失败均禁止保存；编辑可沿用既有有效资源 | 分片、断点续传、大小上限、转码与资源标识 |
| Banner | 图片、标题、按钮、跳转、页面、排序、开关 | 跳转地址合法且绑定页面有效 | 素材规格与缓存刷新 |
| 广告 | 类型、素材、文案、跳转、频率、时间或集数规则 | 硬性关闭规则不可被后台覆盖 | 频控存储与跨端一致性 |
| 页脚／应用 | 显示文字、项目内图标路径、站内标识或 http/https 跳转 | 图标限项目 assets/；跳转校验通过 | 发布生效策略 |
| 配置历史日志 | historyLogId、resourceType、resourceId、placementId、operationType、beforeSnapshot、afterSnapshot、operatorId、operatedAt，可选 changeReason | 只在配置成功写入后生成；普通后台角色不可编辑、覆盖或删除 | 接口标识与权限接入沿用现有后台架构 |
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 条件变更 | 切换排序或状态 | 页面、排序、状态、结果数、会话 | 诊断 |
EP-018 | 分类条件变更 | 选择首页一级分类或分类页二级分类；轻松一刻无用户筛选动作 | 页面、一级分类、二级分类、入口类型、结果数、会话 | 诊断 |
用户从双推荐位、分层分类筛选、混排“轻松一刻”、作品 Feed 或搜索联想选择短剧；首页默认最火并展示一级分类，一级分类页展示当前父级下的二级分类及分类内置顶结果。
primaryCategoryId、secondaryCategoryId、sortMode 与 randomSessionId，返回 featuredBadge、manualPinned、manualPinnedAt；分类树、轻松一刻配置、搜索联想、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首页分类下拉只展示全部启用一级分类；进入一级分类页后，下拉只展示当前一级分类下的启用二级分类，默认“全部二级分类”。
M-05搜索按剧名、简介、分类标签模糊匹配，200ms 防抖，支持键盘联想；不保存历史、不展示热门搜索。
M-06所有长内容背景由内容高度驱动，首屏以下至页脚前不得露出舞台背景。
M-18每部短剧必须返回一个一级分类及该父级下一个二级分类；请求切换一级分类时清空不属于新父级的二级分类条件，服务端同时校验父子关系。
M-19轻松一刻只消费一个启用一级分类及其 1—3 个不重复的启用二级分类；前台不渲染子分类名称、标签、按钮或筛选控件，将命中任一指定子分类的作品合并随机展示。
M-20首页默认 sortMode=hot；最火使用 randomSessionId 对当前结果集生成稳定随机序列，新列表会话重新随机；最新按发布时间倒序。
M-21featuredBadge 只接受 latest、hot 或空值，最新与最火互斥且不参与列表排序。
M-22manualPinned 仅在作品所属一级分类列表内生效；多个置顶按 manualPinnedAt 由晚到早，非置顶沿用当前排序。
| 状态 | 触发 | C01 落地 |
|---|---|---|
| 加载中 | Feed／搜索请求中 | Feed 或联想骨架，不闪空结果 |
| 空数据 | 组合条件无作品 | 保留条件＋“清除状态筛选” |
| 断网 | 请求不可达 | 保留当前结果，提示网络异常 |
| 错误 | 列表／搜索失败 | 就地错误＋重试 |
| 重连 | 网络恢复 | 按当前条件重新请求 |
| 超限 | 关键词超产品限制 | 停止提交并说明输入限制；具体上限待研发签字 |
| 登录态 | 游客访问 | 不弹登录墙 |
| 审核拦截 | 配置内容被下架 | 从结果移除，不保留假入口 |
用户查看短剧详情和剧集列表，选择已上架剧集后进入播放器；正片按用户操作开始，支持上一集、下一集、快进 10 秒、进度与倍速控制，结束后存在下一集则自动切换。
M-07游客无需登录；只有已上架且自有服务器资源有效的剧集可进入播放。
M-08正片按用户播放动作开始；页面进入不自动高码率播放。
M-09自然播放结束且存在下一集时自动切换；最后一集结束后停止，不循环回第一集。
M-10选集页 Banner 固定 7:1，背景画布页面级全宽，内部 Banner 与首页 Feed 内容线对齐。
M-11播放页 Banner 独立配置，不与前贴或剧中广告叠加。
M-16播放手势动作的功能接入：如果现有前端框架支持就接入，如果没有就暂缓。当前 Swift Web／SwVideoPlayer 组件包没有正式手势协议，因此本期暂缓；业务层不得自行绑定单击、双击、滑动、长按或覆盖底层播放器事件。
M-17播放器固定提供上一集、播放／暂停、下一集、快进 10 秒、进度控制，以及 0.75×、1.0×、1.25×、1.5×、2.0× 倍速选项。
| 状态 | 触发 | C02 落地 |
|---|---|---|
| 加载中 | 详情／媒体加载 | 详情骨架；播放器显示加载状态 |
| 空数据 | 无有效剧集 | 剧集区说明“暂无可播放剧集” |
| 断网 | 播放中断网 | 暂停并保留当前集与进度 |
| 错误 | 资源／解码失败 | 记录 EP-008，提供重试或返回选集 |
| 重连 | 连接恢复 | 从可恢复进度继续，具体能力待技术签字 |
| 超限 | 频控／资源限制 | 说明限制，不伪装为播放失败 |
| 登录态 | 游客播放 | 不拦截、不弹登录层 |
| 审核拦截 | 剧集被下架 | 阻止新播放；播放中处置待运营与研发签字 |
REQ-016／REQ-017：精品应用页与所有前台页脚共享同一运营配置，页面只保留一个主标题；主内容与页脚使用同一连续背景画布。
M-12精品应用页与页脚共用五项应用配置；图标始终 1:1，Web 五列，H5 两列。
M-13全局页脚包含精品应用、友情链接、网站地图、品牌说明、版权／备案五段。
M-14页脚外层继承页面 --bg 且不增加分段边界；内部必要分隔保留。
M-15图标路径仅接受项目 assets/；非法链接回退首页且不得静默打开未知协议。
| 状态 | 触发 | C03 落地 |
|---|---|---|
| 加载中 | 配置读取中 | 保留标题和网格骨架 |
| 空数据 | 应用配置为空 | 隐藏应用网格，页脚其他段继续展示 |
| 断网 | 配置不可达 | 展示最近有效配置或明确错误；缓存策略待签字 |
| 错误 | 图标／跳转失败 | 单项降级，不破坏整页 |
| 重连 | 网络恢复 | 刷新失败项 |
| 超限 | 配置超项 | 后台阻止保存；具体上限待签字 |
| 登录态 | 游客点击 | 不要求登录 |
| 审核拦截 | 外链未审核 | 不展示或禁止启用 |
三类广告共享互斥、跳转与埋点约束：开屏为页面级居中模态；前贴与剧中广告都铺满播放器容器，并固定展示满 3 秒后才允许关闭。
O-开屏同一访问会话展示一次，可立即关闭；与首页进入弹窗共用运营位，不重复展示。
O-前贴正片前位于播放器内；倒计时满 3 秒才允许关闭，关闭、结束或加载失败均进入正片。
O-剧中按播放进度或指定集触发；铺满播放器容器，展示时暂停，满 3 秒后允许关闭，关闭后从原进度继续；点击活动不额外显示 Toast。
| 状态 | 触发 | O01 落地 |
|---|---|---|
| 加载中 | 素材加载 | 前贴与剧中显示 3 秒倒计时；开屏保留立即关闭路径 |
| 空数据 | 无有效配置 | 不展示广告，继续主流程 |
| 断网 | 广告请求失败 | 不阻断浏览；前贴进入正片 |
| 错误 | 素材／跳转失败 | 记录诊断并保持关闭路径 |
| 重连 | 连接恢复 | 不在同一触发点重复弹出，具体频控待签字 |
| 超限 | 频控达到上限 | 本次不展示 |
| 登录态 | 游客操作 | 不要求登录 |
| 审核拦截 | 素材或跳转未通过 | 配置不可启用 |
A-01内容与分类管理
- 支持维护一级分类及二级分类的唯一父级、名称、排序、启停状态；二级分类不能脱离有效父级保存。
- 支持新增短剧、维护剧名／简介／一级分类／二级分类／封面、添加剧集、上下架与搜索筛选；二级分类候选项随一级分类联动。
- 轻松一刻配置字段为
primaryCategoryId、secondaryCategoryIds、启用状态；二级分类数组长度必须为 1—3，前台只消费作品范围，不渲染子分类控件。 - 服务端保存与启用均校验：一级分类有效、二级分类无重复且全部属于该一级分类；跨父级、0 个、超过 3 个或停用项返回字段级错误。
- 新增资源选择本地
video/*文件并上传至自有服务器；不提供外部视频地址输入。 - 上传状态为未开始／上传中／完成／失败；只有完成可保存，编辑既有短剧可沿用有效资源。
- 角标字段
featuredBadge只接受latest、hot或空值，最新与最火只能二选一；不配置回退内容状态。 - 置顶字段为
manualPinned与服务器写入的manualPinnedAt；置顶只在作品所属一级分类内生效，多个置顶按时间降序。 - 保存记录操作人、服务器资源状态与版本；资源上传、角标与置顶配置不计用户行为埋点，但必须进入后台操作日志。
| 验收编号 | Given | When | Then |
|---|---|---|---|
AC-A01-1 | 新增短剧未完成视频上传 | 点击保存 | 保存被阻止，文件字段显示就地错误 |
AC-A01-2 | 选择非视频文件 | 文件变更 | 拒绝上传并提示格式不符 |
AC-A01-3 | 编辑既有短剧且不替换资源 | 保存其他字段 | 沿用原有效资源，不强制重复上传 |
AC-A01-4 | 短剧选择一级分类“都市” | 打开二级分类字段 | 只返回“都市”下的启用二级分类；提交其他父级子项时服务端拒绝保存 |
AC-A01-5 | 运营配置轻松一刻 | 选择 0 个、超过 3 个、重复、停用或跨父级二级分类并保存／启用 | 操作被阻止并返回对应字段错误；有效配置只下发作品范围，前台不生成子分类控件 |
AC-A01-6 | 运营配置作品角标 | 同时提交 latest 与 hot 或提交未知值 | 服务端拒绝保存并返回 featuredBadge 字段错误；合法单值与空值可保存 |
AC-A01-7 | 运营开启手动置顶 | 保存成功 | 服务端写入 manualPinnedAt，仅在作品所属一级分类列表中进入置顶组 |
AC-A01-8 | 同一分类存在多个置顶 | 分类列表请求成功 | 置顶组按 manualPinnedAt 降序；时间相同按作品编号稳定兜底，非置顶组保持当前排序 |
A-02Banner 管理
- 支持新增、修改、绑定首页／分类／选集／播放页面、调整排序和控制开关。
- 首页 Feed 中插与分类 Feed 中插使用独立 7:1 素材；分类顶部为 7:2，选集为 7:1。
- 跳转接受站内标识或 http/https；无效地址禁止启用。
- 每次曝光与点击携带配置编号、素材编号、页面和位置。
- 首页顶部、分类顶部、首页 Feed 中插、分类 Feed 中插、选集页和播放页的每次成功配置变更均写入 A-06 配置历史。
| 验收编号 | Given | When | Then |
|---|---|---|---|
AC-A02-1 | 跳转地址无效 | 运营尝试启用 | 开关不生效并标出无效字段 |
AC-A02-2 | 同页面多条 Banner | 运营调整排序 | 前台按保存后的顺序展示且事件仍能区分配置编号 |
A-03广告管理
- 分别维护类型、素材、文案、跳转、展示规则与启用状态。
- 前贴与剧中广告关闭门槛均固定为展示满 3 秒，后台不能延长、缩短或取消。
- 剧中广告支持播放时长或指定集数触发；同一时刻命中多条只展示一次。
- 开关只影响启用状态，不改变产品硬规则。
- 开屏、前贴和剧中弹窗的新增、修改、启停、排序或资源替换成功后均写入 A-06 配置历史。
| 验收编号 | Given | When | Then |
|---|---|---|---|
AC-A03-1 | 运营编辑前贴配置 | 尝试将关闭时间小于 3 秒 | 保存被阻止或固定回 3 秒，具体控件实现待研发确认 |
AC-A03-2 | 剧中多规则同时命中 | 播放器到达触发点 | 只展示一个剧中广告层 |
A-04页脚与应用
- 维护页脚标题与说明、友情链接、网站地图、版权与备案。
- 维护五项应用名称、项目内图标路径与跳转地址。
- 保存后精品应用页与所有前台页脚读取同一配置源。
- 项目内图标路径限
assets/；跳转只接受站内标识或 http/https。 - 精品应用页与全局页脚应用卡作为应用中心广告位，成功配置变更后写入 A-06 配置历史。
| 验收编号 | 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 | 用户只关闭广告未跳转 | 事件入库 | 不增加“广告点击跳转”，只保留诊断操作事件 |
A-06配置历史日志
M-23配置历史覆盖全部弹窗、全部 Banner 与应用中心广告位；应用中心广告位包含精品应用页和全局页脚应用卡。- 资源类型使用
popup、banner、app_center_ad，具体位置由placementId区分。 - 日志字段为
historyLogId、resourceType、resourceId、placementId、operationType、beforeSnapshot、afterSnapshot、operatorId、operatedAt，changeReason可选。 - 新增、修改、启停、排序或资源替换成功写入后，以服务端最终落库值生成一条不可变记录；首次创建的
beforeSnapshot为空。 - 支持按资源类型、配置／资源编号、广告位、操作人和时间范围查询，详情展示完整前后快照。
- 普通后台角色只能查询，不能编辑、覆盖或删除；配置历史与 EP 用户行为数据分开存储。
- 字段校验、资源校验或写入失败时不生成新配置版本和历史日志；通用错误日志可记录失败原因。
| 验收编号 | Given | When | Then |
|---|---|---|---|
AC-A06-1 | 任一弹窗、Banner 或应用中心广告位配置有效 | 新增、修改、启停、排序或资源替换成功写入 | 生成一条不可变日志，包含资源与广告位标识、变更前后快照、操作人和操作时间 |
AC-A06-2 | 已存在多类配置历史 | 按资源类型、配置编号、广告位、操作人或时间范围查询并打开详情 | 列表只返回匹配记录，详情完整展示变更前后快照 |
AC-A06-3 | 配置字段、资源或写入校验失败 | 提交保存 | 不生成新配置版本和历史日志，现行有效配置保持不变 |
X-1逻辑漏洞审查
现象资源新增若存在外部地址入口，会绕过自有资源库的上传状态。
风险资源不可控、状态不可追溯，且保存门禁失效。
决议以阶段二为准：video/* 本地文件上传至自有服务器，完成后才可保存。
现象开屏、前贴、剧中规则可能在同一会话连续命中。
风险浮层叠加、正片状态错乱和重复计数。
决议全局广告互斥；同一时刻只展示一个广告层。
现象运营可配置站内和外部跳转。
风险未知协议、无效地址或未审核页面造成安全与合规问题。
决议只接受站内标识或 http/https；无效或未审核配置不可启用。
现象当前原型没有真实统计数据。
风险虚构指标会误导产品验收与运营判断。
决议显示“待接入／暂无数据”；只有真实采集值可进入报表。
现象产品已锁定上传路径，但文件大小、分片、转码、重试与清理参数未定。
风险大文件失败、重复资源或孤儿文件。
决议产品只锁定状态与保存门禁；具体上传实现、资源标识及失败清理由研发评审签字。
现象剧集播放过程中可能被运营下架。
风险强制中断与继续播放的口径不一致。
决议阻止新播放已锁定；对正在播放会话的处置由运营与研发联调前确认。
现象当前 Swift Web／SwVideoPlayer 组件包没有声明可复用的播放手势协议。
风险业务层直接绑定触摸或指针事件会覆盖 Artplayer 运行时行为，并造成 Web、H5 控制不一致。
决议播放手势动作的功能接入：如果现有前端框架支持就接入，如果没有就暂缓。当前核查为不支持，本期不自行实现；框架后续提供正式能力时再由前端评审接入。
现象首页、一级分类页和轻松一刻使用不同层级的分类入口，若只传统一分类值会混入其他父级子项。
风险前台筛选结果、后台配置与埋点维度无法对应，跨父级轻松一刻配置也可能被错误启用。
决议接口分离 primaryCategoryId 与 secondaryCategoryId(s)；服务端是父子关系最终校验方。轻松一刻只允许同一一级分类下 1—3 个二级分类，并只下发作品范围，不下发前台子分类控件。
现象冷启动阶段没有可靠热度数据，同时运营需要角标和分类内重点作品控制。
风险继续依赖点击量会固化早期偏差；角标双选或全局置顶会造成口径冲突和跨分类污染。
决议最火使用列表会话稳定随机并作为首页默认；角标为互斥枚举；置顶仅在所属一级分类生效，多个置顶按服务器记录的配置时间降序。
现象通用操作日志只能说明发生过操作，无法还原弹窗、Banner 与应用中心广告位变更前后的完整配置。
风险运营配置异常时无法定位具体字段、广告位、责任人与生效版本，也无法证明失败提交未覆盖线上配置。
决议新增 A-06 统一配置历史：仅成功写入后保存不可变的前后快照、操作人和时间；失败校验不生成新版本，且与用户行为统计分开存储。
X-2验收清单 · Definition of Done
| 编号 | 验收项 | 通过条件 |
|---|---|---|
DOD-01 | 阶段边界 | 本轮只修改已授权的阶段一 v1.1、阶段二现行原型、阶段三交付文档与 HANDOFF；历史 v1.0、设计系统源文件和真值契约哈希保持不变 |
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–018 可追溯；三项核心指标不混入诊断事件 |
DOD-09 | 真实数据纪律 | 无来源指标、趋势与目标值为 0 |
DOD-10 | 运行态 | 文档真实渲染无重叠、裁切或横向溢出；目录、搜索、下载、返回顶部可用 |
DOD-11 | 手势能力边界 | 阶段一、阶段二与阶段三均明确“现有前端框架支持则接入，不支持则暂缓”；当前不支持，业务层手势监听为 0，现有按钮、进度和倍速控制保持可用 |
DOD-12 | 既有三阶段一致性 | REQ-016／REQ-017、前贴与剧中广告 3 秒关闭、自有服务器视频上传、三项核心指标、后台无页面原型和 Swift Web 品牌变体在三阶段均可追溯且无冲突旧口径 |
DOD-13 | 分类层级 | 首页只展示启用一级分类；一级分类页只展示当前父级下的启用二级分类；短剧与接口字段同时保存父级和子级标识 |
DOD-14 | 轻松一刻与三阶段同步 | 阶段一 REQ-018、阶段二 EASY_MOMENT_CONFIG／页面说明、阶段三 M-19／A-01／AC 均锁定“一个一级分类＋同父级 1—3 个二级分类＋前台无子分类控件＋作品混合随机” |
DOD-15 | 排序、角标与置顶 | 三阶段均锁定首页默认最火、最火列表会话稳定随机、最新／最火角标互斥、置顶仅限所属一级分类、多个置顶按置顶配置时间倒序；不存在点击量排序或角标双选旧口径 |
DOD-16 | 配置历史日志 | 阶段一 REQ-020／R-019、阶段二第 07 能力模块／DocPanel、阶段三 R-014／A-06／L-10 均覆盖全部弹窗、全部 Banner 与应用中心广告位；成功写入后记录不可变前后快照，失败不产生新版本，普通后台角色不可覆盖 |