opc-backup/.claude/memory/ports/admin-portal.md

admin-portal 记忆

角色

云超服运营管理平台（新，独立仓库 Pine/admin-portal）。React18 + TS(strict) + Vite6 + Tailwind4 + shadcn/ui（依 design/installation.md）。接入 server-core（/auth、/admin/*）。

进度 / 现状（2026-08-24，脚手架+骨架完成，npm run build 通过）

结构（锚点）

文件	说明
package.json / vite.config.ts / tsconfig*.json / components.json / index.html	脚手架（vite 代理 /auth /admin → :8090）
src/index.css	Tailwind4 主题（亮/暗变量，--mascot-accent）
src/lib/utils.ts	cn()
src/components/ui/*	shadcn 组件（radix-ui 单片 + lucide + cva）
src/lib/auth.tsx	认证上下文(localStorage)
src/lib/rbac.tsx	八端口导航过滤 + 权限
src/api/client.ts	fetch + token + 401 登出
src/api/resources.ts	用户/课程/活动/报名/测评/算力/园区
src/components/layout/AppShell.tsx	侧边栏+顶栏+身份切换
src/App.tsx	RequireAuth + RoleRoute(operator/carrier)
src/pages/{login,overview,users,courses,activities,bookings,tests,compute,park}	登录+总览+7 管理页

已知问题 / 待办

• 部分 /admin/*（courses/activities/bookings/tests/park）server-core 未实现，页面已优雅降级（提示「暂未接入」），需阶段2 供电。
• 算力页 ping/provision 已对应 server-core 阶段0-1，可直接联调。
• esbuild 首次构建有 allow-scripts 提示（构建已验证可用）。

仓库状态（已初始化 → 提交）

• 独立仓库已 git init -b main + 首提交 258bccf（Pine/admin-portal，origin=infoepoch，另有 infoepoch_lan 副远端）。本地 clean，未推送。

下一步

• 用户验收（npm run dev + 登录）。
• 推送远端（git push -u origin main，见 MASTER 上线由用户/确认后）。
• 阶段2 后端端点补齐后接入真数据。