文档
08_归档04_VOZEB任务卡

VOZEB UI Migration 02 · M40 Admin help center

状态:LOCAL_IMPLEMENTATION_CANDIDATE / CANDIDATE_EVIDENCE / NOT_FORMAL_TEST

任务边界

  • Task ID:M40-ADMIN-HELP
  • Base SHA:af90409e5273499eb9d0326c1aac80c1236579a8(codex/vozeb-retail-next-migration)
  • 目标用户结果:管理员帮助中心在桌面与 390px 窄屏下使用统一 Ocean Air / Liquid Glass 内层材质,阅读、搜索和跳转保持清晰。
  • 允许修改:web/src/components/admin/admin-help-section.tsx、web/src/components/admin/admin-help-section.module.css、本文档及帮助中心定向测试。
  • 非目标:API、管理员权限、路由、文章内容、搜索/选择回调、后台导航、生成文件、账务和其它页面。

实现说明

  • 旧 cyan/zinc/white utility palette 替换为 Ocean Air 与 Liquid Glass token;正文、标题和说明使用中性 text / muted / quiet token,主题色仅保留给语义图标、焦点环和状态提示。
  • 帮助中心根节点登记 data-ocean-component="admin-help-section";搜索结果、目录项、文章头部和相关页面目标使用单层低对比边框、连续圆角、轻量 blur 与克制阴影,不叠加左上角假高光或多重外框。
  • 保留文章搜索、延迟查询、目录/移动端选择、scrollIntoView、内部 section 回调、Next Link 跳转、空态和全部文章语义。
  • 提供 prefers-reduced-motion、prefers-reduced-transparency、forced-colors 与不支持 backdrop-filter 时的可读不透明回退;窄屏下目录改为既有移动选择器,不引入额外滚动容器。

验收证据

  • 定向静态契约测试:admin-help-section.test.ts 与既有 admin-help-content.test.ts。
  • TypeScript、ESLint、Prettier、生产构建与 git diff --check:以本候选提交交接结果为准。

本切片未执行真实管理员写入、权限变更或正式 Testing/Operations 验收;候选状态不提升为 Gate 通过。

On this page