云超服 · 运营管理平台（admin-portal）

React 18 + TypeScript + Vite 6 + Tailwind v4 + shadcn/ui（radix-ui，严格遵循 design/installation.md）。面向云超服所有管理功能（运营/政务/企业/载体/服务商/投资人/OPC）。 前端接入 server-core（/auth、/admin/*），经统一身份与八端口 RBAC 隔离。

技术栈 / 规范

• Vite 6、React 18、TypeScript（strict）
• Tailwind v4（@tailwindcss/vite）+ shadcn 组件（components.json、src/components/ui/*、cn()）
• Radix UI（radix-ui 单片）+ lucide 图标 + class-variance-authority
• React Router 7；认证经 /auth/login + /auth/select-identity

启动

cd code/admin-portal
npm install
cp .env.example .env   # 如需覆盖后端地址
npm run dev            # 默认 http://localhost:5175（/auth /admin 代理到 :8090）
npm run build          # 类型检查 + 产物

目录

src/
  api/          client.ts(fetch+token) · auth.ts · resources.ts(业务模块)
  components/   ui/(shadcn) · generic/(DataTable/PageHeader/StatusBadge/useResource) · layout/AppShell
  lib/          utils.ts(cn) · auth.tsx(认证上下文) · rbac.tsx(八端口导航/权限)
  pages/        login · overview · users · courses · activities · bookings · tests · compute · park
  types.ts

身份与权限

• 登录：账号密码 → 返回多端口身份 → 多身份时进入「选择身份」。
• 路由按 identity.role 守卫（RoleRoute）；侧边栏导航由 navForRole 过滤。
• 需要 operator（部分 carrier）身份访问管理页。

与后端现状

部分 /admin/* 端点（课程/活动/报名/测评/园区）仍在 server-core 阶段2-3 建设中，本次前端已铺好 列表/详情/审核骨架并优雅降级（未实现时提示「暂未接入」，后端补齐即自动生效）。算力页 ping/provision 已在 server-core 阶段0-1 落地，可直接联调。

约定

• 端点路径集中在 src/api/resources.ts；后端路径调整仅改该文件。
• 前端 UI 基调沿用仓库主基调（shadcn + 云超服品牌 --mascot-accent）。