---
description: vue-element-plus-admin-mini 项目上下文，避免每次会话重复分析
alwaysApply: true
---

# 项目上下文

## 项目概况

基于 [vue-element-plus-admin](https://github.com/kailong321200875/vue-element-plus-admin) 的中后台集成方案，非精简模板。

## 技术栈

- Vue 3.4 + TypeScript + Vite 5 + Element Plus 2.5
- Pinia（含 pinia-plugin-persistedstate）
- Vue Router 4、Axios
- UnoCSS、Less
- pnpm 包管理，Node >= 18

## 目录结构

| 目录 | 说明 |
|------|------|
| `src/api/` | 接口层：login、version、table 等 |
| `src/store/modules/` | Pinia：user、permission、app、locale、tagsView、lock |
| `src/router/` | 路由与动态权限 |
| `src/views/` | 页面：Login、Version、Error、Redirect |
| `src/components/` | 二次封装组件：Table、Form、Dialog、Search、Descriptions、Menu 等 |
| `src/hooks/web/` | 通用 hooks |
| `src/utils/` | 工具函数 |
| `mock/` | vite-plugin-mock 的 Mock 接口 |

## 关键约定

- 常量：`src/constants/index.ts`，`SUCCESS_CODE = 200`
- 登录 API：`/mock/user/login`，退出 `/mock/user/loginOut`
- Mock 用户：`admin/admin` 全权限，`test/test` 前端控制权限
- 默认首页：`/version/version`
- 主路由：`/version` 下有 `version_server`、`test` 等子路由
- 构建：`pnpm dev`、`pnpm build:pro`，多环境 base/pro/dev/test/gitee