跳至正文

公开资讯阅读

路由:/items/[contentId]。角色:公开读者。范围:当前主流程。依据:当前页面和调用组件(代码基线 67df5ab1,本轮仅修复根元素 hydration 并移除无调用旧 header 插槽)。以下数量是现有读取策略,不是实际业务记录数,也不是容量或服务承诺。

源码入口:page.tsx  · item-reader.tsx  · local-reading.tsx  · local-state.ts 。

用户任务与当前操作

作为公开读者,我需要阅读全文或合法摘要并保留出处。当前操作围绕下表的数据完成;不从旧表和旧接口的存在反推新增产品需求。页面存在不等于来源、模型、送达或长期运行已通过真实验收。

页面需要的数据

区域/操作实际展示或输入字段展示数量/读取方式是否持久化及最小存储
文章与许可id/revision、标题/原题、摘要、来源、原文、许可名称/URL、正文模式、媒体、引用帖单条正文;目录由正文生成publication投影决定可读内容,正文复用版本
阅读状态收藏、已读、滚动位置、修订号单条交互;滚动位置按id+revision在本机保存localStorage,不写阅读行为数据库
上下文关联事件、事实报道、引用内容按需读取关联组,每批20已有关系和公开查询

接口与业务落点

下列为本页业务读取/提交入口。全局会话、头像、站点元信息和共享组件中未在本页触发的导出函数不算新增页面能力。请求类型、响应与错误以生成客户端和后端为准。

页面调用方法和路径请求 → 响应合同实现依据
getSitePublicationItemGET /api/publication/items/{content_id}/sitegetSitePublicationItemParams → PublicItemDetailView客户端  · 后端 
getPublicFactReportsGET /api/publication/facts/{fact_id}/reportsgetPublicFactReportsParams → PublicFactReportsPage客户端  · 后端 
getPublicStoryDevelopmentsGET /api/publication/stories/{event_id}/developmentsgetPublicStoryDevelopmentsParams → PublicDevelopmentsPage客户端  · 后端 

数据落点:publication_records、publication_revisions、publication_policy_versions、content_versions、content_rendered_materials、publication_media_files。这是当前依赖定位,不代表这些表均为重新设计时必须新建;详细字段/键/关系及保留原因见页面数据库设计。

收敛与替换

不另存站内正文副本、个人阅读会话或云阅读进度;撤回时不得依靠本机缓存继续下载。

实现时先复用上述合同。确有缺口须描述具体控件、输入、输出、当前失败和最小修复,不能直接把历史扩展方案列为前置。公开分发、付费供应商、海外新来源与 Flutter 继续受冻结范围和其他生效决策约束。

验收与非功能要求

  • 主路径:摘要许可只显示摘要;改修订不恢复旧段落位置;撤回后再次读取拒绝正文。
  • 数据边界:上表数量、字段和统计范围要能从响应核对;未知、未分析、无权限和真实零值不同。筛选、页签与选择不创建持久业务副本。
  • 状态:有远程读取的区域分别验证正常、零数据、加载、失败和撤权;静态说明的业务空态/无权限写不适用,不伪造验收。
  • 写入:有保存/运行/发布时保留可恢复输入,版本冲突先重读;请求结果未知按现有接口查询或复用原幂等键,不新增全局操作账本。
  • 交互:1440px与390px下主动作可见;Tab/Enter/Escape和适用的方向键可操作,弹层关闭返回触发点。凭据只按现有认证流程传递,不进入日志/URL/本机持久存储。

测量和跨页场景统一见非功能要求、验收场景。这里只定义判据,执行进度仍只在 BACKLOG。

原始 Markdown