TX社区
完整迭代产品需求文档

1. 项目背景

TX社区已具备 Web/H5 内容浏览、视频播放、频道分发、热门搜索、图文发布和举报反馈基础能力，本次迭代在现网基线上补齐竖屏内容、短剧消费与精细化运营能力。

本期同时统一频道与热搜排序、增强图文排版和站外跳转、完善 sitemap 更新时间、强化首页举报入口与举报记录，并优化 Web 宽屏内容承载。

2. 目标与成功指标

3. 用户与场景

核心场景

• 用户打开视频素材，播放器按素材宽高自动选择横屏或竖屏展示。
• 用户进入短剧详情，查看剧集简介、选择集数并连续播放。
• 运营配置全局加精或标签分区加精，并设置生效时间。
• 运营发布活动图文或兄弟站点分享内容，对局部文字设置字号并插入外部链接。
• 用户从作品详情或首页跑马灯进入共用举报页，并在“我的”查看举报处理结果。

4. 问题分析

设计原则

1. 现网承继：未涉及的功能、交互和视觉保持现状。
2. 服务端判定：排序、状态和时间由服务端提供，客户端不写死业务枚举。
3. 对象明确：举报始终绑定具体作品与入口来源，不扩大到评论、信息流或用户主页。
4. 安全优先：外链和富文本必须经过协议及标签过滤。

5. 产品方案

5.1 功能架构

graph TD
  A["TX社区 v2.1.2"] --> B["内容消费"]
  A --> C["内容分发"]
  A --> D["内容生产与 SEO"]
  A --> E["举报治理"]
  A --> F["Web 内容宽度"]
  B --> B1["横竖屏自动识别"]
  B --> B2["短剧播放器 / 选集 / 简介 / 连播"]
  C --> C1["频道排序与两级加精"]
  C --> C2["热门搜索加精 + 随机"]
  C --> C3["TX往期按发布时间倒序"]
  D --> D1["图文五档字号 + 外链"]
  D --> D2["sitemap lastmod"]
  E --> E1["作品详情举报"]
  E --> E2["举报与反馈共用页"]
  E --> E3["首页跑马灯入口"]
  E --> E4["举报记录与处理结果"]
        

5.2 评审需求清单目录

5.3 内容消费

REQ-204 播放器横竖屏自动识别

• 读取当前素材有效宽高；高度大于宽度判为竖屏，其余判为横屏。
• 竖屏素材按原始比例完整展示，默认不裁切；横屏素材沿用现网播放行为。
• 宽高元数据缺失时使用后台素材方向标记；仍缺失则按横屏兜底并记录异常。
• 切集、重播、全屏与退出全屏后重新校验当前素材方向。

REQ-205 短剧详情架构重构

• 详情包含当前集播放器、剧名、剧集简介、更新状态和选集信息。
• 用户可选择任一可用集数；当前集、已看集与不可用集状态明确区分。
• 连播默认开启，用户可关闭；登录用户按账号记忆，游客按本设备记忆。
• 非末集结束后自动播放下一集；资源不可用时停止并提示稍后重试。
• 末集结束后停止，不自动进入其他短剧。

5.4 内容分发

REQ-206 频道排序与加精

• 适用频道的排序入口全局统一展示“推荐 / 最新 / 热门”；不得继续展示“随机”作为用户可见排序项。
• 除首页外的一级分类同步首页三种排序语义；首页与非首页使用同一字段和同一比较口径。
• 推荐频道不适用分类筛选；其他二级频道沿用短视频模式或短剧模式配置。
• 推荐：沿用频道后台配置的默认分发策略；内部可继续使用现有推荐或稳定随机能力，但客户端仅展示“推荐”，不自行计算。
• 最新：普通内容按首次发布时间 first_published_at 降序；同一时间按 content_id 降序保证稳定。
• 热门：沿用后台现有热度值 heat_score 降序，不新建热度计算模型；同热度时按 first_published_at 降序，仍相同时按 content_id 降序。
• 统一优先级：有效全局加精 ＞ 有效标签分区加精 ＞ 推荐/最新/热门基础排序。
• 两类加精都必须配置开始和结束时间，过期自动回到原排序池。
• 同一加精层级按加精时间由晚到早，再按 content_id 降序；展示位置由后台配置计算，不写死客户端序号。
• 缺少 first_published_at 或 heat_score 的普通内容排在对应有值内容之后，再按 content_id 降序。
• 一次分页请求链使用同一排序快照或稳定游标；刷新可获取新顺序，已加载列表不因热度或时间值变化实时跳位。
• 频道“热门”只作用于频道内容列表，不改变热门搜索的“加精后随机”规则，也不改变TX往期的首次发布时间倒序规则。

REQ-208 热门搜索展示逻辑

• 有效手动加精条目置顶，同为加精时按加精时间由晚到早。
• 非加精条目整体随机，同一次响应内顺序固定，重新请求允许变化。
• 用户端不展示热度值及热度视觉分级，后台可保留热度数据用于分析。
• 加精过期后自动进入随机池。

REQ-209 TX往期全部最新

• 覆盖全部处于可展示状态的往期内容，不只展示精选子集。
• 按首次发布时间由晚到早；发布时间相同时按内容 ID 倒序。
• 允许分页或分批加载，不要求首屏一次性加载全部记录。

5.5 内容生产与 SEO

REQ-207 图文富文本增强

• 运营可选择文字或段落，设置 14、16、18、20、24px 五档字号。
• 字号仅作用于选中范围；取消格式后恢复默认；粘贴内容归一化到允许档位。
• 支持任意 HTTP/HTTPS 外部链接，用于活动详情和兄弟站点分享。
• 外链在新窗口打开并增加安全隔离；非法协议、空地址或无法解析地址不得发布。
• 保存前过滤脚本、事件属性及不在白名单内的富文本标签。

REQ-210 sitemap 时间戳

• 每个内容 URL 增加 lastmod，取内容最后更新时间并使用 ISO 8601 格式。
• 最后更新时间缺失时回退首次发布时间；两者都缺失时不输出时间字段并记录异常。
• 标题、正文、媒体和上下架状态变化更新时间；浏览量等实时计数不更新时间。

5.6 举报治理

REQ-201 作品详情举报入口

• Web 与 H5 作品详情提供举报入口，进入 REQ-203。
• 携带作品 ID、内容类型、作者 ID、平台和入口来源。
• 共用页展示当前举报对象，提交后返回原作品详情位置。
• 信息流、评论和用户主页不新增举报入口。

REQ-202 “我的”菜单合并

• Web 头像入口、“我的”侧栏及 H5 菜单统一展示“举报与反馈”。
• 旧“问题反馈”和“举报”不再并列；旧链接进入共用页。

REQ-203 举报与反馈共用页

REQ-211 首页跑马灯举报入口

• 首页跑马灯区域新增醒目的“举报与反馈”入口，不改变其他内容顺序。
• 进入共用页，来源记录为 home_marquee；无具体对象时按综合举报与反馈处理。

REQ-213 举报记录与处理进度

• “我的”菜单新增“举报记录”，与“举报与反馈”并列；只覆盖举报类提交。
• 列表展示提交时间、举报对象摘要、举报类型和当前处理状态，按提交时间倒序。
• 详情展示举报对象、类型、描述、附件、提交时间、处理状态、处理结果和最后更新时间。
• 状态名称和处理结果由运营后台返回，客户端不写死状态枚举。
• 同步异常时保留最近一次成功同步的状态和结果，不清空、不回退。

5.7 Web 页面宽度

REQ-212 左右留白优化

• Web 主内容区采用水平居中的限宽布局：常规桌面最大宽度 1200px，超宽屏最大宽度 1440px。
• 两档宽度切换所采用的超宽屏断点不在本需求中预设。Web 前端给出建议数值与兼容说明，评审确认后，UI 根据确认数值出图。
• 视口未达到对应最大宽度时，主内容区流式收缩且不产生横向滚动；是否将左右两侧设为同一安全边距，以及左右各多少像素，由 Web 前端给出方案，评审确认。
• 顶栏是否与主内容区共用 1200px/1440px 限宽规则，待前端反馈并由评审确认。
• H5、存量组件尺寸和内部列比例不变。

5.8 产品视觉承继

6. 策略与规则

6.1 排序决策矩阵

6.2 加精生命周期

stateDiagram-v2
  [*] --> 待生效: 配置开始与结束时间
  待生效 --> 生效中: 到达开始时间
  生效中 --> 已过期: 超过结束时间
  待生效 --> 已取消: 运营取消
  生效中 --> 已取消: 运营取消
  已过期 --> 原排序池: 自动回落
  已取消 --> 原排序池: 立即回落
        

6.3 播放与连播

• 切换剧集时终止上一集播放任务，再加载新剧集方向和进度。
• 连播关闭时，任一集结束后停留在当前集结束状态。
• 连播开启但下一集不可用、资源错误或网络中断时，不跨剧跳转。

6.4 举报处理状态

• 客户端展示后台返回的状态名称、处理结果和最后更新时间。
• 状态同步成功后覆盖本地展示；同步失败时保留最近一次成功值。
• 本期不提供申诉、催办、撤回、补充材料或联系方式。

6.5 外链与时间

• 外链仅允许 HTTP/HTTPS，保存与渲染均执行安全过滤。
• 加精时间、首次发布时间和最后更新时间由服务端生成，客户端不参与排序判定。
• 外链埋点只记录目标域名，不记录查询参数中的潜在敏感信息。

7. 数据与实验

7.1 数据事件

7.2 观察方案

8. 优先级与排期

里程碑

1. 数据字段与接口协议冻结。
2. 运营后台和用户端并行开发。
3. 五个工作流分别联调。
4. 全量回归、埋点验收及单批发布。

9. 风险与边界

明确不做

• 不新增信息流、评论或用户主页举报入口。
• 举报记录不包含“问题反馈/其他”，不提供申诉、催办、撤回、补充材料或联系方式。
• 不让竖屏素材旋转为横屏，不在剧终后自动跳转其他短剧。
• 不允许脚本协议或未经安全过滤的富文本 HTML。
• 不重做热度计算模型，热度数据仅在用户端隐藏。
• 不把“展示全部往期”实现为首屏一次性加载全部记录。
• 不调整 H5 页面宽度，不借 Web 留白优化改变存量组件。

10. 上线准备

1. 数据协议：确认素材宽高、加精范围/时间、首次发布时间、现有热度值、稳定游标、更新时间和举报来源字段。
2. 排序用例：覆盖推荐、最新、热门、全局加精、标签加精、过期、缺失排序值和跨页稳定性组合。
3. 素材矩阵：准备横屏、竖屏、缺元数据、下一集缺失和末集五类资源。
4. 安全测试：验证合法外链、非法协议、脏样式粘贴和脚本注入拦截。
5. 数据验收：确认 EP-201～EP-213 均能正确回传并支持 14 天观察。

验收标准