# UmayShop 文档平台原型页面清单

权威输入：根目录 PRD v0.5；本轮不修改 PRD。平台 `web` / `admin`；Ant Design Web 语义。设计读判：文档阅读优先，连续正文与表格，不采用仪表盘卡片布局。`VARIANCE=2 / MOTION=1 / DENSITY=7`：低变体、低动效、偏紧凑管理区，正文保留阅读行距。

## 页面及跳转

| ID | 页面 | 文件 | 模式 | 入口与回流 | 主要组件及私有实现 |
|---|---|---|---|---|---|
| P-01 | 文档工作区 | `admin/docs.html` | mixed | 一级菜单；搜索结果；审阅回流 | page-header, breadcrumb, button, tag, tab-bar, modal, drawer；目录树、正文、图表、页内目录 |
| P-02 | 搜索结果 | `admin/search.html` | list | 顶栏搜索；结果定位 P-01 章节 | filter-bar, input, button, tag, empty-state；连续结果列表 |
| P-03 | 更新审阅 | `admin/review.html` | detail | P-01 修改稿；P-04 来源任务 | tab-bar, textarea, button, tag, alert-strip, modal, drawer；源码差异对照 |
| P-04 | 同步任务 | `admin/sync-runs.html` | list | 一级菜单；详情抽屉进入 P-03 | filter-bar, table, tag, button, drawer, empty-state |
| P-05 | 文档覆盖与缺口 | `admin/coverage.html` | list | 一级菜单；缺口抽屉回流 P-01/P-06 | filter-bar, table, tag, button, drawer |
| P-06 | 接入与模板配置 | `admin/settings.html` | mixed | 一级菜单；P-05 缺口 | tab-bar, input, textarea, descriptions, button, modal |

共享 sidebar-menu / user-menu；搜索和审阅不作为一级菜单。没有第七个业务页面。目录的 14 个分类均提供完整中文和英文模板示例正文；原 Mobile 多语言演示仅保留旧链接兼容，移除侧栏和顶部入口。所有模板为虚构示例，不冒充真实技术文档已完成。

## 交互、字段与异常

- P-01：文档 r12；中文、英文 r12；俄文历史原文 r11。语言切换后正文与下载选择绑定。历史、证据、图表放大、下载为浮层。所有来源和接口示例仅演示；App `dev` 不代表生产部署。含图 Markdown 以 ZIP 封装 `.md + assets/`；PDF 为离线示例，不执行真实导出任务。译文标为演示机器稿，俄文下载须选择历史版本。
- P-02：关键词、模块、语言；静态结果过滤、无结果、空查询、索引错误演示，链接定位章节。范围只有预置演示数据，不声称实现真实权限过滤。
- P-03：基准/目标修订、空 diff 缺口、原文/译文、人工补充、退回原因；缺口未消除不得确认发布。保存仅演示，刷新不保留。退回须填写原因；退回后不能直接批准。
- P-04：任务类型、来源、状态、时间；失败、部分完成、成功；重试只显示已排队演示，原失败任务不被抹除；导出超时、译文失败、源差异不全用独立抽屉说明。
- P-05：5 个根项目候选，不等于 5 个在用模块；2/5 等所有完成率均为演示值；3 项候选缺口；后端/WMS 来源作为另列证据缺口，不捏造为已发现仓库。排除 CIS 全子树。
- P-06：来源、分支、排除项、模板、语言、访问策略；不输入真实凭据，不调用接口。App 分支锁定 `dev`，CIS 排除锁定。修改模板只演示保存反馈，不实际应用；连接结果标为模拟。

## 权限与业务边界

演示查看者/维护者不等于已确认生产权限。真实发布策略尚未启用；不开放实际发布、接入、同步或权限修改。按钮禁用、无权限状态只是交互示例，不能作为安全验证。无交易执行，无资金闭环，无新增审批层级。图片文字自动识别重制未实现；可编辑 SVG 提供示例，不能宣称完成真实自动翻译。

## 未决事项（沿用 PRD，不阻断静态原型）

- [待确认: D-01 在用仓库、后端/WMS 来源、各模块负责人及旧站去留]
- [待确认: D-02 正式发布和退回权限、人工确认规则]
- [待确认: D-03 除 App dev 外的版本策略、环境和生产映射]
- [待确认: D-04 登录、内容分级、访问策略与代码外发批准]
- [待确认: D-05 时限、容量、重试阈值、预算和导出有效期]
- [待确认: D-06 平台、部署、模型、含图 Markdown 封装及 PDF 字体方案]
- [待确认: D-07 人员、英俄校对责任和验收签认人]
- [待确认: D-08 截止日期按 2026-10-19，具体时点需确认]
- [待确认: D-09 机器译文正式发布与校对规则]
- [待确认: D-10 是否识别并重制截图内中文]

## 2026-10-01 真实项目验证增补

保持 6 页不变。P-01 增加“Web 真实验证”视图，与 Mobile 演示文档互斥；该视图隐藏演示下载/编辑/历史操作，使用真实报告下载入口。P-04/P-06 增加真实只读快照摘要，与下方演示任务/配置明确隔离。P-05 覆盖率仍为演示，不因一次单项目采集自动改变为真实覆盖率。

只读取 `umay/website0813`；该 Web 仓库默认分支为 `master`，不改变 `umay/app=dev` 的既有约定。所有真实结论绑定提交 SHA；完整文档、责任人、正式发布和真实多语翻译仍未验收。

## 同期 Issue 参考资料增补

P-01 的 Web 真实验证视图增加同期需求资料区：数量摘要、需求分歧、23 条可展开 Issue 摘录入口、两个已取得的文档正文、三个原附件访问缺口及索引下载。沿用 `button`、`tag`、`table` 和原生语义化展开区，不新增第七页，不新增原型权限或审批流程。

来源扩展为 doc-and-issues 的需求/评论/文档引用；website0813 的源码采集边界不变。使用 Issue 当前快照而非虚构历史正文，关联只标候选，关闭状态不代表实现。

## 2026-10-02 模板正文集成

| 来源 | 操作 | 目标 / 承载方式 | 状态与边界 |
| --- | --- | --- | --- |
| P-01 左侧 14 分类 | 模板示例正文 | 同页 `#template-01` 至 `#template-14` | 每次只显示一篇；当前目录高亮 |
| P-01 正文 | 页内目录 / 相关文档 / 前后篇 | 同页章节或对应模板 | 地址可复制、刷新、返回；正文静态生成 |
| P-01 模板阅读区 | 下载本篇 / 空白模板 / 全套含图包 | 本地 MD / MD / ZIP | 对应当前文档；英俄和 PDF 暂未生成 |
| P-01 模板阅读区 | 填写与核验规则 | 同页规则弹窗 | Escape 关闭并回焦 |
| P-02 搜索 | 关键词全文过滤 | 14 模板 + 原 6 片段，定位 P-01 | 数量与可见结果一致；模板标未核验 |
| P-01 视图切换 | 模板示例正文 / Web 真实验证 | `#template-01` / `#web-validation` | 旧 `#overview` 保留链接兼容，不再提供侧栏或顶部入口；下载、语言状态和编辑操作继续隔离 |

组件：沿用 sidebar-menu、button、tag、alert-strip、table 和 modal；正文采用连续排版，宽表局部滚动，不新增卡片、权限或审批功能。模板 01/02/03/08/10 显示对应架构/流程 SVG，保留同版本图源。


## 2026-10-02 英文接入与界面语言区分

| 能力 | 页面 / 来源 | 约束 |
|---|---|---|
| 14 类完整英文正文 | P-01，`#template-01-en`～`#template-14-en` | 与中文同模块，保留原文修订和虚构标识；不是已核实业务事实 |
| 正文中英切换 | P-01 的“正文语言”按钮 | 保留当前章节；目录、相关页、前后篇继续当前语言 |
| 英文检索 | P-02，14 篇英文全文 | 静态过滤，命中回到英文正文；加中文及旧片段共 34 条预置结果 |
| 英文下载 | P-01，单篇 Markdown / 含图 ZIP | 字节对应所选语言，单篇 Markdown 不包含图片；14篇示例暂不提供 PDF/俄文全文 |
| 英文图表 | 7 张 SVG 及对应 Mermaid | 标签翻译，连接间距适配英文；保持节点、箭头与含义 |
| 顶部界面语言模拟 | 六页共用 dropdown | 不透明白底、只勾选当前语言；刷新恢复中文，不做整站国际化 |

本轮未增加页面、角色或真实同步任务。PRD v0.6 的产品跳转、状态和验收条款是后续研发约束，当前原型中的静态演示不能作为生产实现证据。第 10 章为主 PRD 唯一决策台账，此文件不改变其状态与待确认日期。


## 2026-10-02 导航精简

移除 `data-sample-link` 侧栏入口和 `data-document="sample"` 顶部按钮。第 05 类 Mobile 模板正文及中英版本继续保留；旧演示深链仍有效，未删除内容和资源。页面数量仍为六页。