概览

本章文档只覆盖管理后台前端（admin/，Vue 3），不包含 PC 端（Nuxt）与 UniApp。

技术栈

技术	用途
Vue 3 + TypeScript	页面与类型
Vite	开发与构建
Element Plus	UI 组件库
Pinia	状态管理
Vue Router	路由与动态菜单
UnoCSS	原子化样式
Axios	HTTP（经 myRequest 封装）
vue-i18n	多语言

开发

cd admin
pnpm install
pnpm dev

开发服务器端口取 VITE_APP_PORT，未设置时回退 5174（admin/vite.config.ts）。/adminapi、/storage、/static 代理到 VITE_APP_API_URL，未设置时回退 http://test.com；/ws 代理到 VITE_APP_WS_TARGET，未设置时回退 ws://127.0.0.1:8001。

请先启动后端 php start.php start，再开管理端，否则接口与静态资源代理会失败。

构建

cd admin
pnpm build

admin/vite.config.ts 将产物输出到 server/public/admin/（base: '/admin/'），部署时与后端同域即可访问 /admin/。

目录速览

admin/src/
├── api/           # 按业务拆分的接口函数
├── components/    # 公共组件（自动注册）
├── hooks/         # Composables
├── layout/        # 后台布局
├── router/        # 路由实例、常量路由、守卫
├── store/         # Pinia stores
├── views/         # 页面（动态路由按路径加载）
├── directives/    # 自定义指令
└── utils/         # request、theme、auth 等

后续篇章依次说明架构、路由、权限、请求、组件、Composables、Store 与主题。