08_归档04_VOZEB任务卡
VOZEB UI Migration M41 — 管理后台主壳与概览内层
状态：LOCAL_IMPLEMENTATION_CANDIDATE / CANDIDATE_EVIDENCE / NOT_FORMAL_TEST
Task packet
Task ID: VOZEB-UI-MIGRATION-02-M41-ADMIN-SHELL
目标用户结果: 管理员在后台主壳、侧边栏、概览指标、图表和 dashboard-level 弹层中看到统一的 Ocean Air / Liquid Glass 视觉，同时保留既有后台操作。
Feature / Atomic Requirement IDs: ADMIN-P0-001（仅视觉承载）；既有 overview 与 admin section navigation
Base SHA: af90409e5273499eb9d0326c1aac80c1236579a
必须阅读: VOZEB-UI-FOUNDATION-01.md；VOZEB-UI-MIGRATION-02.md；admin-page.module.css；后台主壳与概览现有组件/测试
允许修改: web/src/components/admin/admin-dashboard.tsx；web/src/components/admin/admin-dashboard-elements.tsx；web/src/components/admin/admin-overview.tsx；web/src/components/admin/admin-section-nav.tsx；web/src/components/admin/admin-shell.module.css；本任务定向测试；本任务文档
禁止修改: channels/help/settings 及其它页面文件、API/server/store、Go、数据库、manifest、背景/WebGL、生成文件、retail-platform 与其它 worktree
范围: 主壳 header、移动抽屉 backdrop、侧边栏导航、概览指标/资源/分布/趋势图、设置/财务 helper surface、dashboard-level Ant Modal 内层材质
非目标: 不改变 activeSection、权限过滤、section lazy loading、preload intent、移动抽屉/桌面折叠、刷新/操作回调、表单字段、数据/路由、可访问性语义或业务状态
已冻结契约与数据模型: 既有 AdminDashboard controller、AdminSectionKey/adminSectionGroups、AdminOverview props、AdminBillingSummary/GenerationOverviewSummary 与 helper props 保持不变
安全与数据限制: 只修改本地 DOM/CSS；不新增凭据、API、持久化、真实上游调用或生产写入
验收命令: 定向 Vitest（admin-shell-layout、admin-section-nav、admin-section-preload）；pnpm exec tsc --noEmit --pretty false；pnpm exec eslint；pnpm exec prettier --check；pnpm run build；git diff --check；桌面/390px 浏览器检查及 fallback 规则核对
人工决策点: 正式 Testing、Operations、Gate 1 与生产发布另行授权
交付物: 管理后台主壳与概览 Ocean Glass 视觉候选、响应式/降级契约和可复核测试证据实现边界
- 既有
admin-dashboard-shell、admin-section-nav、admin-dashboard-header等 DOM 标记保留，局部 CSS module 只补充 Ocean Air/Liquid Glass material；路由级admin-page.module.css仍是页面背景 owner。 - 导航继续通过
canAccessAdminSection过滤分区；指针/焦点预加载、active group 展开、移动关闭、桌面折叠和所有回调保持原实现。 - 概览继续使用既有
Metric、Panel、PanelHeader、账务/生成摘要和 SVG 图表数据；本切片仅替换嵌套白底、zinc/stone/cyan 外观、重复硬边框与假高光。 - 正文颜色统一为
--ocean-air-text*；primary 只表达主动作、焦点、进度和图形，成功/警告保留语义色；不在正文使用蓝色文字。 prefers-reduced-motion移除过渡，prefers-reduced-transparency、forced-colors: active与不支持backdrop-filter时使用不透明 Ocean/System Canvas fallback；390px 下主内容不产生横向溢出，导航列表保留真实滚动。- Modal 使用现有 Ant Portal 与回调，仅通过
className/rootClassName与内层 class 接入玻璃材质，不创建第二个背景或动画循环。
本地候选验收记录
pnpm exec vitest run ...admin-shell-layout.test.ts ...admin-section-nav.test.tsx ...admin-section-preload.test.ts：3 files / 3 tests passed；admin 相关回归合计 17 files / 45 tests passed。pnpm test -- --reporter=dot：554 files passed、4 skipped；2,445 tests passed、9 skipped。pnpm exec tsc --noEmit --pretty false、直属文件 ESLint、直属文件与本任务文档 Prettier、git diff --check：均通过。pnpm run build：Next.js production build compiled successfully，静态页 66/66；构建后已恢复并核对生成文件，worktree clean。- 浏览器尝试使用独立本地端口；未初始化管理员会话时
/admin按既有安全路由重定向/install，首次开发编译期间 CDP 导航超时，因此未宣称已登录后台视觉 E2E。
该候选只表示本地实现与候选证据，不代表正式 Design、Development、Testing、Operations、Gate 1、发布或部署完成。