Skip to content

管理后台概览 ​

管理后台使用 Vue 3、TypeScript、Vite、Element Plus、Pinia、Vue Router 和 Axios。

技术版本 ​

依赖当前范围
Vue~3.4.0
Pinia2.2.4
Vue Router~4.4.0
Element Plus^2.13.1
Vite^7.3.0
TypeScript~5.9.3

项目优先保持依赖兼容,不盲目升级到最新大版本。修改版本后应重新执行类型检查、Lint 和生产构建。

已实现页面 ​

  • 登录、首页、个人中心。
  • 用户、角色、资源管理。
  • 组织、岗位、字典管理。
  • 地区、文件、存储管理。
  • 系统日志、系统参数。
  • 404、500 错误页面。

页面结构 ​

列表页一般包含:

text
搜索区
  ↓
页面操作区
  ↓
表格 / 树表
  ↓
分页或详情区域

交互约定:

  • 搜索输入框按 Enter 执行查询。
  • 下拉选择后按 Enter 执行查询,不重新弹出下拉框。
  • 操作按钮在同一水平线并保持统一间距。
  • 详情和编辑使用明确标题,内部方法名不直接展示给用户。
  • 新增弹窗打开前恢复默认值,关闭动画结束后再清理表单。
  • 批量删除优先提交选中记录 ID。
  • 写操作完成后只刷新真正受影响的数据。

开发命令 ​

bash
npm install
npm run dev
npm run type-check
npm run lint
npm run build

生产结果位于 dist/。

API 地址 ​

开发模式固定使用 /api,由 Vite 代理到本机后端并去掉前缀。生产模式读取 VITE_API_BASE_URL;未配置时会使用代码默认地址。

推荐生产环境仍使用同源 /api,减少跨域、Cookie 和证书配置复杂度。

当前端与 API 必须跨来源时,后端可通过 yeah-boot.cors 配置允许的来源、请求头和方法;管理后台使用 Bearer Token,通常不需要浏览器凭证模式。详细配置见运行配置。

导航布局 ​

管理后台支持左侧导航和顶部导航,共用后端动态资源树、权限结果、外链校验、页签与面包屑。全局模式由公开系统参数 admin.layout.navigation-mode 控制:side 为默认左侧导航,top 为顶部横向导航。

路由进入主布局前会读取该参数并缓存到浏览器;刷新时重新读取服务端配置,读取失败时使用上次缓存。侧栏折叠状态使用独立本地缓存,不属于全局系统参数。

组件开发原则 ​

  • 业务请求集中在 src/api。
  • 请求与响应类型集中在 src/types。
  • 资源类型、状态值等集中在 src/constants。
  • 通用下载、会话和权限逻辑放在 src/utils 或 composable。
  • 页面只实现业务交互,不重复实现全局 401 和 Token 注入。