Web 管理后台

路径：packages/web

Web 端是 薄壳应用，业务逻辑全部在 @xichen-full-stack/admin。

在线演示

项	地址
脚手架 Web 演示	https://web.tsanyang.top/

默认账号：admin / admin123

入口

packages/web/src/main.ts：

import { bootstrapAdminApp } from '@xichen-full-stack/admin'

await bootstrapAdminApp({
  baseURL: import.meta.env.VITE_API_BASE_URL ?? 'http://localhost:8080',
  base: import.meta.env.BASE_URL,
})

环境变量

.env.development（推荐开发配置）：

# 留空：请求走 Vite 代理 /api → http://localhost:8080（无 CORS）
VITE_API_BASE_URL=

直连后端（生产或需跨域时 Gateway 须配置 CORS）：

VITE_API_BASE_URL=http://localhost:8080

Vite 代理与 API 地址

main.ts 使用 ?? 而非 ||：空字符串表示 同源相对路径，axios 请求 /api/v1/... 由 dev server 代理：

// vite.config.ts
server: {
  proxy: {
    '/api': { target: 'http://localhost:8080', changeOrigin: true },
  },
}

若 VITE_API_BASE_URL=http://localhost:8080，axios 直连 Gateway，绕过代理，需后端 CORS（micro-java Gateway 已配置 GatewayCorsConfig）。

启动

pnpm --filter @xichen-full-stack/types build
pnpm --filter @xichen-full-stack/auth build
pnpm --filter @xichen-full-stack/api-client build
pnpm --filter web dev

构建

pnpm --filter web build

产物在 packages/web/dist/。

Vite 8 使用 Rolldown，构建时可能出现 @vueuse/core 的 [INVALID_ANNOTATION] 警告，可忽略，见 常见问题。

依赖版本由根目录 pnpm-workspace.yaml 的 catalog 统一维护。

相关文档

• admin 包
• Monorepo — Catalog
• 快速开始