init

.codebuddy/rules/00-project-overview.md

@@ -18,7 +18,7 @@ alwaysApply: true
 | 构建 | Vite 5+ | |
 | UI 库 | Element Plus | 主题色、组件尺寸统一在应用入口配置 |
 | 脚手架基线 | `vue3-element-admin` | 目录结构、请求封装、权限方案以该模板为基准 |
-| 状态管理 | Pinia | 使用 setup store 语法 |
+| 状态管理 | Pinia + pinia-plugin-persistedstate | 使用 setup store 语法，按需声明 persist 路径 |
 | 路由 | Vue Router 4 | 动态路由 + 权限守卫 |
 | HTTP | Axios | 统一封装于 `src/utils/request.ts` |
 | 图标 | `@element-plus/icons-vue` + 本地 svg sprite | |
@@ -66,3 +66,4 @@ pnpm type-check   # vue-tsc 类型检查
 ## 环境
 - 环境变量文件：`.env.development` / `.env.production`，变量必须以 `VITE_` 开头。
 - 接口地址统一走 `VITE_APP_BASE_API`，本地通过 Vite `server.proxy` 解决跨域，**不允许在代码里硬编码域名或端口**。
+- 后端未就绪时开启 `VITE_USE_MOCK=true`（仅 dev 生效），由 `mock/plugin.ts` 中间件拦截 `/api/v1` 返回模拟数据，不引入任何 mock 依赖。后端联调时置为 `false`，直接走代理。