51 lines
2.1 KiB
Markdown
51 lines
2.1 KiB
Markdown
|
# 云超服 · 运营管理平台（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`
|
|||
|
|
|
|||
|
|
## 启动
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
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`）。
|