08_归档04_VOZEB任务卡
VOZEB-UI-MIGRATION-02-M16 — 公共作品广场 Ocean Foundation 视觉切片
Task ID: VOZEB-UI-MIGRATION-02-M16-GALLERY
目标用户结果: 访客能在统一 Ocean Air / Abyss 视觉中浏览、筛选、分页并打开公开作品
Feature ID / Atomic Requirement IDs: HOME-P0-001;EXEC-P0-001..003(仅承载公共作品浏览视觉)
Base SHA: a4cadddddb1822242bdf1a8777ad3fda38a72f4d
必须阅读: VOZEB-UI-FOUNDATION-01.md;VOZEB-UI-MIGRATION-02.md;gallery-data.ts;gallery-view.tsx;gallery-layout.test.ts
允许修改: 本任务包;web/src/app/gallery/page.tsx;web/src/app/gallery/gallery-page.module.css;web/src/app/gallery/gallery-layout.test.ts
禁止修改: gallery-data.ts;gallery-view.tsx;gallery-theme-toggle.tsx;gallery-publish-link.tsx;components/works/**;services/api/**;API routes;stores;共享 Ocean/UI 组件;其它页面和后台代码
范围: 将公共作品入口的品牌栏、状态摘要、GalleryView 外壳、筛选控件与公开作品网格接入 Ocean Glass 视觉,并补齐窄屏与无障碍降级
非目标: 不改变服务端加载、分类/关键词/标签/排序/精选筛选、分页游标、发布入口、主题切换、作品预览、创作者弹窗、点赞、权限或数据语义;不新增 AppWorkspaceShell、页面背景、WebGL/canvas、业务状态或 runtime TSX
已冻结契约与数据模型: GalleryFilters、GalleryResult、loadGallery、parseGalleryFilters、GalleryView 的 /gallery 边界和 PublicWorkGalleryCard / PreviewModal 交互保持不变
安全与数据限制: 仅使用服务端公开作品与现有会话;不读取或输出 Secret,不写浏览器业务持久化,不触发真实上游、账务或生产写入
验收命令: pnpm exec vitest run src/app/gallery/gallery-layout.test.ts;pnpm exec tsc --noEmit --pretty false;pnpm exec eslint src/app/gallery/page.tsx src/app/gallery/gallery-layout.test.ts --quiet;pnpm exec prettier --check docs/oceanway/VOZEB-UI-MIGRATION-02-M16-GALLERY.md src/app/gallery/page.tsx src/app/gallery/gallery-page.module.css src/app/gallery/gallery-layout.test.ts;pnpm run build;git diff --check
人工决策点: LOCAL_IMPLEMENTATION_CANDIDATE / CANDIDATE_EVIDENCE / NOT_FORMAL_TEST;公共分享页、创作者主页与社区工作区另按队列迁移
交付物: 公共作品广场 Ocean Glass 页面壳、状态/筛选/空态材质、公开作品网格响应式覆盖、布局契约测试与候选任务包验收边界
/gallery继续由根布局提供页面基底;本切片不挂载AppWorkspaceShell,也不新增OceanAmbientBackground、WebGL renderer 或第二个页面级背景。GalleryView仍是查询、筛选、分页、作品预览、作者弹窗、点赞和发布入口的行为所有者;页面只提供 Ocean Glass 外壳、状态摘要和局部 CSS 适配。- 标题、说明、作者与元数据使用 Ocean Air/Abyss 中性文字;主题色只承担焦点、图形和明确动作,不用蓝色作为正文。
- 公开作品图片/视频继续使用现有
PublicWorkGalleryCard、LazyMediaImage和真实媒体比例;不改变媒体 URL、作品治理或互动语义。 - 390px、430px 与窄桌面保持无横向溢出;
prefers-reduced-motion、prefers-reduced-transparency和forced-colors下内容仍可读可操作。 - 本切片只登记候选实现,不提升正式 Development、Testing 或 Operations 状态;页面行为与公共数据仍需后续独立验证。