最新公开刊物与个人报告详情
路由:/reports/[reportId]。角色:公开读者 / 报告所属用户。范围:当前主流程。依据:当前页面和调用组件(代码基线 67df5ab1,本轮仅修复根元素 hydration 并移除无调用旧 header 插槽)。以下数量是现有读取策略,不是实际业务记录数,也不是容量或服务承诺。
源码入口:page.tsx · edition-content.tsx · edition-sections.ts · public-edition-reader.tsx · edition-state.tsx 。
用户任务与当前操作
作为公开读者 / 报告所属用户,我需要阅读最新公开日周月刊或自己的固定报告。当前操作围绕下表的数据完成;不从旧表和旧接口的存在反推新增产品需求。页面存在不等于来源、模型、送达或长期运行已通过真实验收。
页面需要的数据
| 区域/操作 | 实际展示或输入字段 | 展示数量/读取方式 | 是否持久化及最小存储 |
|---|---|---|---|
| 公开最新刊物分支 | daily/weekly/monthly、最新key、title、lead、sections、entries、window、revision | 目录最多6期,取最新详情和前后期;元数据另取最新1期 | 复用固定刊期,不存latest正文 |
| 个人报告分支 | report UUID、topic_name、version、body_markdown、citations、window | 单报告详情及显式导出 | reports与已有导出服务,强制当前用户 |
接口与业务落点
下列为本页业务读取/提交入口。全局会话、头像、站点元信息和共享组件中未在本页触发的导出函数不算新增页面能力。请求类型、响应与错误以生成客户端和后端为准。
| 页面调用 | 方法和路径 | 请求 → 响应合同 | 实现依据 |
|---|---|---|---|
listPublicEditionCatalogue | GET /api/publication/catalogue/editions | listPublicEditionCatalogueParams → PublicEditionCatalogueView | 客户端 · 后端 |
getPublicEdition | GET /api/publication/editions/{kind}/{key} | getPublicEditionParams → PublicEditionView | 客户端 · 后端 |
getPublicEditionNavigation | GET /api/publication/catalogue/editions/{kind}/navigation/{key} | getPublicEditionNavigationParams → PublicEditionNavigationView | 客户端 · 后端 |
getReport | GET /api/reports/{report_id} | getReportParams → ReportDetailView | 客户端 · 后端 |
createReportExport | POST /api/reports/{report_id}/exports | createReportExportParams, ReportExportInput → ExportView | 客户端 · 后端 |
getReportExport | GET /api/report-exports/{export_id} | getReportExportParams → ExportView | 客户端 · 后端 |
downloadReportExport | GET /api/report-exports/{export_id}/download | downloadReportExportParams → string | 客户端 · 后端 |
数据落点:report_editions、reports、publication_records、report_exports。这是当前依赖定位,不代表这些表均为重新设计时必须新建;详细字段/键/关系及保留原因见页面数据库设计。
收敛与替换
保留同路由的两种资源分支,但共享渲染;不能因路由相同把私有报告改成公开。
实现时先复用上述合同。确有缺口须描述具体控件、输入、输出、当前失败和最小修复,不能直接把历史扩展方案列为前置。公开分发、付费供应商、海外新来源与 Flutter 继续受冻结范围和其他生效决策约束。
验收与非功能要求
- 主路径:daily等固定关键字只进公开分支;另一个用户的UUID返回拒绝;没有刊期是空态。
- 数据边界:上表数量、字段和统计范围要能从响应核对;未知、未分析、无权限和真实零值不同。筛选、页签与选择不创建持久业务副本。
- 状态:有远程读取的区域分别验证正常、零数据、加载、失败和撤权;静态说明的业务空态/无权限写不适用,不伪造验收。
- 写入:有保存/运行/发布时保留可恢复输入,版本冲突先重读;请求结果未知按现有接口查询或复用原幂等键,不新增全局操作账本。
- 交互:1440px与390px下主动作可见;Tab/Enter/Escape和适用的方向键可操作,弹层关闭返回触发点。凭据只按现有认证流程传递,不进入日志/URL/本机持久存储。