endorphin-tabularium-docs/design/verification/collection-ui/README.md

文档 UI 验收 · 2026-10-28

参考 Supabase Database Overview 与 AI Tools 的桌面界面：共用排版，分别维护文档标识、局部目录与顶部上下文。保留 Tabularium 品牌与现有文档路径。

实现

• 顶部切换文档，显示当前选中项。左侧显示当前文档名称、图标、独立目录和返回入口；面包屑连接该文档入口。
• 文档中心按合集提供入口，不把所有章节铺成卡片。原有筛选、分页和全文搜索保留；阅读页搜索提示显示当前文档范围。
• 移除导航、卡片、提示、代码、表格和上下篇等区域的多数边框，以留白、浅色表面和轻渐变建立层次。不同文档使用克制的强调色。
• 入口提供 hover 浮起和箭头反馈；选中项、链接和搜索有过渡；正文及对话框有短暂进入效果。系统设置减少动态效果时关闭动画和过渡。

验证

• ESLint、类型检查、Next.js webpack 生产构建通过。认证单元测试 3/3 通过。
• 对最终生产构建运行原有 auth-cli verify：全部文档、搜索索引、附件、静态资源、404 和认证边界通过。
• 浏览器开发预览：1440×900 桌面检查首页、Pretext、语言设计；顶部点击切换后局部目录和搜索提示更新。搜索 nonlocal 返回本合集两篇文章，方向键与 Enter 能打开章节。
• 390×844 检查正文、顶部横向文档切换和本地目录展开；截图未见正文横向溢出。
• 下图为开发预览截图，左下角 Next.js 开发按钮不进入生产产物。生产产物已完成 HTTP 验收；额外的生产浏览器截图因原开发标签页关闭后连接失效未保存。
• 不代表远程 CI 已完成，也不代表 PR 已合并或生产环境已部署。