研发交付规格 · 当前版本

TX社区迭代
研发交付级 PRD

以已完成的 Web/H5 阶段二原型为视觉与交互真值,将 REQ-201 至 REQ-213 结构化为研发可照建、测试可验收、运营可配置的现行契约。

项目性质:既有产品迭代端别:Web / H5优先级:P0产物:独立 HTML 文档

§0.1 文档说明 · 现行契约

本文件仅描述本版本的研发交付合同。阶段一负责需求定义,阶段二提供运行态真值,本文件负责业务输入输出语义、状态与验收,不复制上游背景论证。

读取顺序先读 §0.5 至 §0.8 的全局约束,再按 C/O/A 卡开发,最后用 X-2 逐项验收。
信任源用途冲突处理
阶段二原型页面结构、交互、状态与视觉运行态优先
现行 PRDREQ 与业务边界原型未承载时补规格
阶段三专属决议游客登录、联系方式、触达与结果同步只作用本文件,不回写上游

§0.2 真值与追溯方法

每个需求通过 REQ 编号映射到页面或后台责任,通过 AC 编号映射到可执行验收。后端技术设计、接口形态与实现安排由开发侧自行决定;产品侧仅定义业务目标、输入输出语义、权限边界和可验收结果。文中的逻辑能力名与字段仅用于需求追溯,不构成 API、数据模型或基础设施方案要求。

01

作品详情举报入口

Web/H5 作品详情进入举报与反馈共用页,并携带作品对象。

02

“我的”菜单合并

将问题反馈与举报统一为“举报与反馈”。

03

举报与反馈共用页

统一承载类型、问题描述、附件、提交及结果提示。

04

播放器横竖屏自动识别

按素材有效宽高自动选择横屏或竖屏展示,元数据异常时按横屏兜底。

05

短剧详情架构重构

整合播放器、选集、剧集简介、更新状态与可控连播。

06

频道排序与加精

统一推荐/最新/热门,并支持全局/标签分区加精及稳定分页。

07

图文富文本增强

支持五档字号与经安全校验的 HTTP/HTTPS 外部链接。

08

热门搜索逻辑优化

手动加精置顶且按加精时间倒序,其余随机展示,用户端隐藏热度值。

09

TX往期全部最新

全部可展示往期内容按首次发布时间倒序排列。

10

sitemap 时间戳

为内容 URL 输出最后更新时间,缺失时按既定规则回退。

11

首页跑马灯举报入口

首页跑马灯新增举报与反馈入口,并透传入口来源。

12

Web 左右留白优化

主内容区采用 1200/1440px 两档限宽,断点、顶栏范围和安全边距待评审。

13

举报记录与处理进度

提供举报记录列表、详情、后台状态和处理结果同步。

§0.3 交付范围

本版交付不纳入
内容消费首页分发、短剧、帖子详情、搜索历史短剧外页面整体重构
举报治理作品举报、共用提交、举报记录、阶段三触达与同步信息流/评论/主页举报;申诉、催办、撤回、补充材料
运营与服务端配置责任、字段、排序、触达、sitemap 与结果同步后台界面设计与技术架构预设
当前前置条件REQ-212 的超宽屏断点、顶栏限宽和左右安全边距在需求评审中由 Web 前端讨论并给出确认值;确认前不得成为研发验收常量。

§0.4 信息架构 · 路由总览

Web / H5 进入TX社区
首页推荐或短剧频道
用户任务
消费内容 → 搜索、帖子、短剧
治理反馈 → 举报与反馈、记录
服务端返回内容、配置、状态与结果
完成消费或治理闭环

§0.5 全局规则

身份与范围4 条
G-01

Web/H5 共用业务语义;平台差异只体现在布局、附件类型和交互模式。

G-02

状态名称、内容顺序、筛选选项和展示位置由服务端或后台配置返回,客户端不维护生产枚举。

G-03

本文件保持研发文档身份,不接入会改变媒介分类的宿主协议。

G-04

阶段一与阶段二继续冻结;本文件发现的差异只在 X-1 登记。

治理与安全3 条
G-05

富文本只允许五档字号与 HTTP/HTTPS 链接;过滤脚本、事件属性与不允许标签。

G-06

举报附件最多 3 个、单个不超过 2MB;Web 支持图片/视频,H5 支持图片。

G-07

缺失描述、附件或处理结果使用明确空态,不生成替代内容。

§0.6 身份 · 联系方式 · 触达

阶段三专属决议6 条
I-01

受限入口沿用现行登录链路,本版不改。

I-02

提交记录能关联已注册或已登录账号时,不要求重复填写联系方式。

I-03

无法关联账号时,邮件/TG至少填写一项;不存在“已认证账号”口径。

I-04

邮件和TG均填写时,邮件和TG两个渠道都触达。

I-05

单渠道发送失败由运营处理,产品侧不新增自动补偿,以运营已回复作为完成口径。

I-06

“我的反馈”同步展示处理状态和处理结果;状态名称由运营后台配置,客户端不写死。同步异常时保留最近一次成功的状态与结果,不清空、不回退。

§0.7 通用 8 态边界异常规范

状态触发统一表现恢复
加载首屏、翻页、详情请求结构骨架或行内加载,不清空稳定内容成功替换;失败进入错误态
合法请求无数据说明空因并提供唯一下一步筛选改变或重新提交
断网网络不可用保留已加载数据,禁用提交网络恢复后用户重试
错误请求失败或数据不可解析显示失败提示与重试,不伪造结果成功后恢复
重连网络恢复或长连接恢复增量刷新,不让列表跳位合并成功数据
超限附件、字数、频率越界字段旁明确说明限制用户修正后重试
登录态受限入口或会话失效沿用现行登录链路,本版不改沿用既有行为
审核拦截内容或链接命中规则阻止发布/提交并说明可修正项修正后重新校验

§0.8 需求验收追溯

REQ-201 至 REQ-213 先在 §0.2 确认交付落点,再按对应 C/O/A 章节验证业务规则、状态与业务结果,最后汇总到 X-2 完成验收。

来源验收位置通过条件
§0.2 需求清单对应 C/O/A 章节每个 REQ 均有唯一交付责任,无悬空编号
C/O 用户流程卡内 AC 与 §0.7主流程、关键分支和通用 8 态均可执行验证
A 后台责任业务语义与 X-2业务输入输出、权限边界、配置结果和异常结果可验收;技术设计由开发侧自行完成
待评审项X-1 与 X-2评审完成前保持待评审,不写入生产常量
C-01首页分发与筛选P0

承载 REQ-206、REQ-208、REQ-209、REQ-211、REQ-212:频道切换、稳定排序、短剧三列 Feed、热门搜索、TX往期和举报入口。

触发入口
Web TX首页/短剧;H5 首页现有频道
逻辑接口
content_feed_query featured_config
输入/输出
channel_id、sort_type、filter、cursor → 内容、排序来源、稳定游标
运行流程图 · C01 首页分发
进入首页
推荐或短剧
推荐 → 仅排序
短剧 → 四类下拉
加精层优先,再执行基础排序
稳定分页展示
页面图 · C01 短剧三列 Feed
原型真实证据
短剧频道目标态 · 从阶段二原型定向导出(非示意)
排序与筛选5 条
D-01

有效全局加精 > 有效标签分区加精 > 推荐/最新/热门基础排序。

D-02

最新按 first_published_at、content_id 降序;热门按 heat_score、first_published_at、content_id 降序。

D-03

一次分页链锁定快照或稳定游标;刷新可更新,已加载列表不实时跳位。

D-04

热门搜索为加精后随机;TX往期按首次发布时间倒序,两者不继承频道热门排序。

D-05

Web 推荐仅展示排序;短剧展示排序、分类、观看权限、更新状态。

状态本页落地
加载保留框架,Feed 使用骨架
说明当前筛选无内容,可重置筛选
断网保留已加载列表
错误列表区提示重试
重连增量刷新,不跳位
超限分页结束不再请求
登录态浏览免登录;受限动作沿用现行登录链路,本版不改
审核拦截不可展示内容不进入结果
AC-C01-1 · 稳定排序
Given用户选择“热门”并翻页
When热度值在翻页期间变化
Then当前分页链不重排已加载内容,刷新后才获取新顺序
闭环校验频道、加精、基础排序和分页形成同一条可复核链路。
C-02帖子详情与举报入口P0

Web/H5 作品详情保留内容消费结构,新增唯一作品举报入口,透传对象与来源后进入 O-01。

触发入口
Web #reportPostBtn;H5 #mReportBtn
上下文
post_id、post_title、author_id、author_name、source_view、source_channel、filter_state、scroll_top
排除范围
信息流、评论、用户主页不新增举报入口
运行流程图 · C02 作品举报
作品详情点击举报
收集对象与来路
进入 O-01 共用页
提交结果
成功 → 返回原位置
失败 → 保留输入
提交完成并按来路返回
页面图 · C02 双端详情真值
对象与返回5 条
R-01

共用页必须显示当前举报对象;无对象的首页入口按综合举报与反馈处理。

R-02

提交成功返回原作品详情和原阅读位置;取消返回也不得丢失位置。

R-03

原型序号仅为设计演示,生产展示位置由配置返回。

R-04

进入详情前保存来源视图、频道、筛选状态和滚动位置;详情返回优先恢复来路,无有效上下文时 Web 回 feed,H5 回 home。

R-05

举报页返回详情与详情返回内容板块分层处理,两个返回上下文不得互相覆盖。

状态本页落地
加载标题与正文骨架
作品不存在时给出返回入口
断网保留缓存正文,举报入口提示离线
错误对象加载失败不可提交举报
重连恢复对象后保持阅读位置
超限不适用
登录态按 O-01 身份规则处理
审核拦截已下架内容保留治理入口策略由服务端返回
AC-C02-1 · 对象透传与返回
Given用户从作品详情的举报入口进入
When完成提交
Then记录绑定正确作品,页面返回进入前的阅读位置
闭环校验入口、对象、提交、记录与返回锚点可串联追踪。
C-03短剧详情P0

播放器按素材方向选择竖屏或横屏容器,选集、连播、不可用下一集和剧终停止保持一致。

触发入口
短剧 Feed 卡片、历史访问
读取字段
drama_id、episode_id、media_width、media_height、orientation_flag、availability
记忆
登录用户按账号,游客按设备;只记连播开关与当前剧上下文
运行流程图 · C03 方向与连播
加载当前集
有效宽高
高>宽 → 9:16 完整展示
其他 → 16:9
播放完成检查连播、下一集和资源
下一集不可用时停止并提示
末集停止,不跨剧
页面图 · C03 阶段二短剧验收画布
原型真实证据
阶段二短剧入口与内容流验收画布;播放器规则以本节为准
方向、选集与连播4 条
P-01

元数据缺失时读取后台方向标记;仍缺失按横屏兜底并记录异常。

P-02

切集、重播、全屏和退出全屏后重新校验当前素材方向。

P-03

当前集、已看集、不可用集状态必须可区分;不可用集不可启动播放。

P-04

连播默认开启,用户可关闭;末集结束停止,不进入其他短剧。

状态本页落地
加载播放器骨架与当前集信息
无可用集时说明暂不可播
断网停止连播,保留当前集
错误单集错误可重试,不自动跨集
重连从当前剧上下文恢复
超限不适用
登录态记忆介质按身份切换
审核拦截下架集不可播放且不进入下一集
AC-C03-1 · 末集与不可用资源
Given连播开启
When当前集完成且下一集不可用或当前为末集
Then播放器停止,不跨剧;不可用场景给出重试提示
闭环校验方向识别、播放状态、用户选择和下一集判断均有事件记录。
C-04搜索历史P0

Web 使用产品层居中弹层,H5 使用独立搜索页;热门搜索遵循加精后随机,不向用户展示热度分级。

入口
Web 搜索框;H5 搜索按钮
数据
keyword_id、keyword、is_featured、featured_at、content_id、request_seed;用户侧不返回 heat_score
动作
回填、清空、搜索、返回;清空只作用当前身份或设备
运行流程图 · C04 搜索历史
打开搜索
加载历史与热门词
选择动作
历史/热门词 → 回填并搜索
清空 → 清除历史
展示搜索结果
页面图 · C04 Web/H5 搜索目标态
原型真实证据
双端目标状态从阶段二原型定向导出(非示意)
热门词排序4 条
S-01

is_featured=true 的手动置顶词优先;置顶组按 featured_at DESC,时间相同按 content_id ASC。

S-02

非置顶词随机;同一次请求和分页会话复用 request_seed,重新请求允许变化。

S-03

置顶失效或取消后进入随机池,不保留历史位置。

S-04

用户侧不返回 heat_score,不展示热度值或热度视觉分级。

状态本页落地
加载热门区骨架,历史区可先展示本地值
历史为空仍展示热门词
断网保留本地历史并提示热门词不可用
错误热门区可重试
重连刷新热门词,不覆盖输入
超限输入长度沿用现网限制
登录态身份变化后切换历史数据域
审核拦截受限关键词按服务端规则处理
AC-C04-1 · 响应内稳定随机
Given非加精热门词已随机返回
When用户在同一搜索页停留并操作历史
Then热门词不重新跳位;重新请求时允许获得新顺序
闭环校验搜索入口、历史动作、热门词规则和结果展示均有明确落点。
C-05举报记录列表P0

只展示举报类提交,按提交时间倒序;状态文案直接使用后台返回值。

逻辑接口
report_record_list
请求
account_id、cursor、page_size、record_kind=report
响应
record_id、submitted_at、object_summary、report_type、status_label、next_cursor
运行流程图 · C05 举报记录列表
从标题栏或 H5 菜单进入
仅查询 report 记录
有记录?
→ 倒序列表
→ 空态
点击进入 C-06
页面图 · C05 Web 同框架记录页
原型真实证据
阶段二 Web 举报记录同框架目标态(非示意)
列表数据3 条
RR-01

过滤问题反馈/其他,只接收 record_kind=report。

RR-02

按 submitted_at 倒序;同时间按 record_id 稳定倒序。

RR-03

status_label 原样展示,客户端不推断已完成。

状态本页落地
加载列表行骨架,aria-busy=true
说明暂无举报记录
断网保留最近成功列表
错误显示重试按钮
重连从首游标刷新
超限无更多数据停止请求
登录态游客沿用现行登录链路,本版不改
审核拦截不适用
AC-C05-1 · 列表纯度
Given账号同时有举报与问题反馈记录
When打开举报记录
Then列表只出现举报记录,状态文案与后台返回一致
闭环校验入口来源、列表曝光、记录点击和详情来路均可追踪。
C-06举报记录详情P0

只读展示对象、类型、描述、附件、提交时间、后台状态、处理结果和最后更新时间,返回时恢复列表位置。

逻辑接口
report_record_detail
请求
account_id、record_id
响应
report_object、report_type、description、attachments、submitted_at、status_label、result、last_updated_at
运行流程图 · C06 举报记录详情
从 C-05 点击记录
保存列表滚动位置
同步是否成功
成功 → 展示新值
失败 → 保留最近成功值
返回恢复列表位置
页面图 · C06 举报记录详情框架
原型真实证据
阶段二共享框架验收图;详情字段以运行态为准
字段与同步4 条
RD-01

空描述、空附件、空结果分别显示“未填写问题描述”“未提交附件”“暂未返回处理结果”。

RD-02

同步异常时保留最近一次成功的状态、结果与更新时间,并提示当前为最近一次成功结果。

RD-03

不新增申诉、催办、撤回、补充材料或联系方式。

RD-04

返回列表恢复进入详情前的滚动位置。

状态本页落地
加载字段骨架,不清空缓存
按字段显示明确空态
断网展示最近成功值与提示
错误保留稳定值,可重试
重连成功后更新字段与时间
超限附件超出展示能力时提供文件信息
登录态会话失效沿用现行登录链路,本版不改
审核拦截敏感附件按权限返回可见状态
AC-C06-1 · 同步失败保值
Given详情已有一次成功同步结果
When下一次同步失败
Then状态、结果和更新时间不清空、不回退,并显示同步提示
闭环校验字段来源、失败保值、详情状态与返回位置均可验收。
O-01举报与反馈提交P0

统一承接作品举报、“我的”入口与首页跑马灯入口;阶段三增加按账号关联结果决定联系方式的规则。

逻辑接口
report_submit
请求
type、description、attachments、post_id、post_title、author_id、author_name、source_view、account_link、email、tg
返回
submission_id、record_kind、received_at、contact_channels
运行流程图 · O01 提交
进入共用页
能否关联账号
→ 联系方式免填
不能 → 邮件/TG 至少一项
校验类型、附件与渠道
提交结果
成功 → 提示并返回
失败 → 保留输入
页面图 · O01 共用页与记录入口
原型真实证据
阶段二 Web 共用页真值;联系方式为阶段三差异,按本节规则新增
提交与触达6 条
F-01

类型必选;描述选填;附件最多 3 个、单个不超过 2MB。

F-02

无法关联账号时,邮件/TG至少填写一项;能关联账号时不强制联系方式。

F-03

两项都填时两个渠道都触达;单渠道发送失败由运营处理,产品侧不新增自动补偿。

F-04

运营回复后,“我的反馈”同步展示处理状态和处理结果。

F-05

状态名称由运营后台配置,客户端不写死。

F-06

问题描述中建议注明帖子标题、作者,并上传相应帖子截图。备注为填写建议,不增加必填校验;系统对象绑定不得依赖用户手填。

状态本页落地
加载提交按钮进入 loading 且防重复
类型未选时不提交
断网保留表单与附件选择信息
错误说明失败并可重试
重连用户主动重试,不自动重复提交
超限附件数量/大小就地提示
登录态按账号关联结果决定联系方式
审核拦截高危类型进入优先治理队列
AC-O01-1 · 联系方式与双渠道
Given提交无法关联账号且邮件、TG均已填写
When提交成功
Then两个渠道都进入触达任务;其中一路失败不触发产品侧自动补偿
闭环校验提交、身份关联、渠道触达、运营回复和用户侧结果同步形成闭环。

A-00 后台与服务端协作总览

复用现有后台界面;本版不做后台 UI 优化。本板块仅定义配置、字段、权限与服务端逻辑责任,不改变现有后台页面结构、路由和组件位置。

职责边界
复用现有后台界面
以下为本版配置与逻辑增量,不代表 UI 改造
  • 运营后台负责配置与操作留痕。
  • 服务端负责稳定排序、状态同步、触达与数据权限。
  • Web/H5 只消费配置与结果,不维护生产枚举。
  • 接口 URL、Method、鉴权、数据模型、队列、存储、幂等与错误码等实现方案由开发侧自行安排。

A-1x 内容分发

加精与排序配置
复用现有内容分发配置界面
本版仅调整配置字段与排序逻辑
  • featured_config:content_id、scope、tag_id、start_at、end_at、operator_id。
  • content_feed_query:按全局加精、标签加精、基础排序返回稳定游标。
  • 热门沿用 heat_score,不新增热度模型;缺值内容置后。
  • 所有配置变更保留操作人和时间。
热门搜索与往期
复用现有热门搜索与往期配置界面
本版仅调整置顶、随机池与排序逻辑
  • 热门词支持加精开始/结束时间;非加精词进入随机池。
  • 热门搜索响应包含 keyword_id、keyword、is_featured、featured_at、content_id、request_seed;用户侧不返回 heat_score。
  • 置顶组按 featured_at DESC、content_id ASC;非置顶组使用 request_seed 随机且同请求稳定;置顶失效或取消后进入随机池。
  • TX往期覆盖全部可展示内容,按首次发布时间倒序。
  • 展示位置由响应计算,客户端不写死序号。

A-2x 内容生产

富文本与外链
复用现有内容编辑界面
本版仅调整字段能力与安全校验逻辑
  • 允许 14、16、18、20、24px 五档字号,只作用选中范围。
  • 外链仅允许 HTTP/HTTPS,新窗口打开并启用安全隔离。
  • 非法协议、空地址、无法解析地址不得发布。
  • 保存前过滤脚本、事件属性和非白名单标签。

A-3x SEO 与 sitemap

内容时间戳
复用现有 SEO 配置界面
本版仅调整 sitemap 输出与异常记录逻辑
  • sitemap_item 输出 loc 与 lastmod。
  • lastmod 取内容最后更新时间,格式为 ISO 8601。
  • 最后更新时间缺失时回退首次发布时间;两者均缺失则省略并记异常。
  • 标题、正文、媒体、上下架状态更新 lastmod;浏览量不更新。

A-4x 治理运营

举报与反馈处理
复用现有举报与反馈处理界面
本版仅调整状态、触达与结果同步逻辑
  • report_submit 创建举报或反馈记录并绑定对象、来源、身份关联和联系方式。
  • 帖子举报绑定 post_id、post_title、author_id、author_name、source_view;用户补充标题、作者和截图不替代系统对象绑定。
  • feedback_reply_sync 接收运营通过邮件/TG完成回复后的状态、结果与更新时间。
  • 无法关联账号且两个渠道都填写时同时触达。
  • 单渠道失败进入运营处理,不生成产品侧自动补偿任务。
  • 客户端同步失败保留最近成功值。
状态与权限
复用现有状态与权限配置界面
本版仅调整配置文案、数据权限与附件可见性
  • status_label 为后台配置文案,不要求客户端枚举。
  • 举报记录接口只返回当前账号有权查看的 report 记录。
  • 敏感附件按权限返回可见状态,不暴露内部审核信息。

X-1 逻辑决议

L-01 · 联系方式条件已决议
现象

身份关联与联系方式强制条件容易混淆。

风险

已登录用户重复填写,游客缺少触达渠道。

决议

能关联账号免填;无法关联时邮件/TG至少一项。

L-02 · 双渠道失败已决议
现象

邮件与 TG 可同时填写。

风险

客户端自行补偿会造成重复触达。

决议

两路同时触达;单路失败交运营,不自动补偿。

L-03 · 结果同步已决议
现象

运营在站外渠道回复,客户端仍需显示结果。

风险

多端状态不一致或失败时清空稳定值。

决议

运营回复后同步;失败保留最近成功状态、结果和时间。

L-04 · REQ-212 参数待评审
现象

原型有演示断点与边距。

风险

演示值被误写为生产常量。

决议

当前 1200/1440px 仅为阶段二原型演示值;超宽屏断点、顶栏限宽和左右安全边距在需求评审中由 Web 前端讨论并给出确认值,确认后再固化。

L-05 · 状态文案已决议
现象

运营处理阶段可能调整命名。

风险

客户端枚举造成显示不一致。

决议

status_label 原样展示,完成判断不由客户端推断。

L-06 · 排序稳定性已决议
现象

热度和加精可在分页过程中变化。

风险

重复、漏项和列表跳位。

决议

分页链锁定快照或稳定游标,刷新才获取新顺序。

L-07 · 产物身份已决议
现象

状态托管曾隐式改变原型媒介类型。

风险

产品原型被宿主识别为其他产物。

决议

阶段三文档只使用自身目录与浏览器状态,不接入其他媒介保留协议。

X-2 验收清单 · DoD

验收项责任
需求追溯REQ-201 至 REQ-213 均映射到 C/O/A 卡,无悬空编号产品 / 测试
交互Web/H5 主流程、返回链、焦点、44px 触控和空态通过前端 / 测试
状态每张 C/O 卡按 §0.7 验证 8 态前端 / 服务端 / 测试
后端实现开发侧自行完成技术设计与实现安排,产品侧按业务结果验收开发负责人 / 测试
治理身份关联、联系方式、双渠道、状态配置和失败保值通过治理运营 / 服务端
热门搜索双端零热度值;置顶顺序正确;非置顶可随机且同请求稳定;失效置顶回随机池服务端 / 前端 / 测试
举报上下文双端备注可见但不触发必填;系统对象字段完整;截图沿用既有附件限制服务端 / 前端 / 测试
页面返回返回恢复原板块、筛选与滚动位置;无上下文按端兜底;举报返回与详情返回互不覆盖前端 / 测试
安全富文本净化、外链协议、附件限制与权限通过安全 / 测试
REQ-212需求评审中由 Web 前端给出三项确认值,UI 按确认值出图并完成实现验收Web 前端 / UI / 测试
后台界面复用现有后台界面;仅验收本版配置、字段、权限和服务端逻辑,不验收 UI 改造运营后台 / 服务端 / 测试
发布全量回归通过后同批上线,观察 14 天再回填真实基线项目负责人
交付状态文档业务合同完整;REQ-212 三项参数按既定评审路径确认。后端技术方案不作为产品侧评审阻断。