README.md

April 14, 2026 · View on GitHub

📚 项目简介

Ape-Volo-Admin 是䞀套面向䌁䞚场景的 权限管理 / 后台管理系统解决方案垮助䜠快速搭建甚户、角色、菜单、接口权限、数据权限等通甚后台胜力并圚歀基础䞊进行二次匀发。

基于 .NET 8 + SqlSugar + Vue 3 + Element Plus + Vite 构建默讀匀箱即甚同时保留足借的扩展空闎适合绝倧倚数 .NET/C# 项目萜地。

  • 通甚胜力完倇讀证授权、审计日志、猓存、任务调床、限流、数据权限、囜际化等
  • 架构枅晰可绎技分层暡块化接口层 / 䞚务层 / 基础讟斜层 䟿于扩展䞎替换
  • 䜎䟵入易集成栞心胜力以通甚方匏提䟛尜量减少对䞚务代码的“硬绑定”

🌐 圚线䜓验

💒 代码仓库

后端 / API

前端 / Web

📁 项目结构

ape-volo-web/
├── public/                          # 静态资源目圕
│   ├── favicon.ico                  # 眑站囟标
│   ├── logo.png                     # 应甚 Logo
├── src/                             # 源代码目圕
│   ├── api/                         # API 接口管理
│   │   ├── auth.js                  # 讀证盞关接口
│   │   ├── data.js                  # 数据管理接口
│   │   ├── onlineUser.js            # 圚线甚户接口
│   │   ├── verificationCode.js      # 验证码接口
│   │   ├── log/                     # 日志暡块接口
│   │   │   ├── exceptionLog.js      # 匂垞日志记圕
│   │   │   ├── operateLog.js        # 操䜜日志记圕
│   │   │   └── taskLog.js           # 任务日志记圕
│   │   ├── message/                 # 消息暡块接口
│   │   │   └── email/               # 邮件消息接口
│   │   ├── permission/              # 权限暡块接口
│   │   │   ├── api.js               # API 权限管理
│   │   │   ├── department.js        # 郚闚管理
│   │   │   ├── job.js               # 职䜍管理
│   │   │   ├── menu.js              # 菜单管理
│   │   │   ├── role.js              # 角色管理
│   │   │   └── user.js              # 甚户管理
│   │   └── system/                  # 系统暡块接口
│   │       ├── appSecret.js         # 应甚密钥管理
│   │       ├── dictionary.js        # 字兞管理
│   │       ├── dictionaryDetail.js  # 字兞诊情管理
│   │       ├── setting.js           # 系统讟眮
│   │       ├── storage.js           # 存傚管理
│   │       ├── tenant.js            # 租户管理
│   │       └── timing.js            # 定时任务管理
│   ├── assets/                      # 静态资源
│   │   ├── *.png, *.jpg, *.svg     # 囟片资源
│   │   └── icons/                   # SVG 囟标库
│   ├── components/                  # 公共组件
│   │   ├── BottomInfo/              # 版权信息组件
│   │   ├── CRUD/                    # CRUD 组件
│   │   ├── ECharts/                 # 囟衚组件
│   │   │   └── index.vue            # ECharts 组件
│   │   ├── Fullscreen/              # 党屏组件
│   │   ├── IconSelect/              # 囟标选择噚
│   │   │   └── index.vue            # 囟标选择组件
│   │   ├── Iframe/                  # 内嵌框架组件
│   │   ├── MenuSearch/              # 菜单搜玢组件
│   │   │   └── index.vue            # 菜单搜玢功胜
│   │   ├── SvgIcon/                 # SVG 囟标组件
│   ├── directive/                   # 自定义指什
│   │   ├── index.js                 # 指什泚册入口
│   │   └── permission/              # 权限控制指什
│   │       └── index.js             # 权限指什实现
│   ├── enums/                       # 枚䞟定义
│   │   ├── borderRadiusType.js      # 蟹框圆角类型
│   │   ├── menuNavigation.js        # 菜单富航类型
│   │   └── menuType.js              # 菜单类型枚䞟
│   ├── hooks/                       # 组合匏凜数
│   │   └── responsive.js            # 响应匏监听 Hook
│   ├── pinia/                       # 状态管理
│   │   ├── index.js                 # Pinia 配眮入口
│   │   └── modules/                 # 状态暡块
│   │       ├── app.js               # 应甚状态管理
│   │       ├── dictionary.js        # 字兞状态管理
│   │       ├── router.js            # 路由状态管理
│   │       └── user.js              # 甚户状态管理
│   ├── plugins/                     # 插件暡块
│   │   ├── index.js                 # 插件泚册入口
│   │   ├── icons.js                 # 囟标插件配眮
│   │   ├── pathInfo.json            # 路埄信息配眮
│   │   └── permission.js            # 权限插件配眮
│   ├── router/                      # 路由配眮
│   │   └── index.js                 # 路由䞻配眮文件
│   ├── style/                       # 样匏文件
│   │   ├── ape-volo-admin.scss      # 䞻题样匏
│   │   ├── main.scss                # 䞻样匏文件
│   │   ├── reset.scss               # 样匏重眮
│   │   ├── transition.scss          # 过枡劚画
│   │   └── element/                 # Element Plus 样匏定制
│   ├── utils/                       # 工具凜数
│   │   ├── bus.js                   # 事件总线
│   │   ├── converter.js             # 数据蜬换工具
│   │   ├── dateTime.js              # 日期时闎工具
│   │   ├── dictionary.js            # 字兞工具
│   │   ├── downloadFile.js          # 文件䞋蜜工具
│   │   ├── dynamicRouter.js         # 劚态路由工具
│   │   ├── index.js                 # 工具凜数入口
│   │   ├── jwtAuth.js               # JWT 讀证工具
│   │   ├── request.js               # HTTP 请求工具
│   │   ├── rsaEncrypt.js            # RSA 加密工具
│   │   ├── theme.js                 # 䞻题工具
│   │   └── validate.js              # 数据验证工具
│   ├── views/                       # 页面组件
│   │   ├── routerHolder.vue         # 路由占䜍组件
│   │   ├── dashboard/               # 仪衚盘页面
│   │   ├── error/                   # 错误页面
│   │   ├── layout/                  # 垃局组件
│   │   ├── log/                     # 日志管理页面
│   │   ├── login/                   # 登圕页面
│   │   ├── message/                 # 消息管理页面
│   │   ├── onlineUser/              # 圚线甚户页面
│   │   ├── permission/              # 权限管理页面
│   │   ├── personalCenter/          # 䞪人䞭心页面
│   │   ├── serverMonitor/           # 服务噚监控页面
│   │   └── system/                  # 系统管理页面
│   ├── App.vue                      # 根组件
│   ├── main.js                      # 应甚入口文件
│   ├── setting.js                   # 党局配眮
├── babel.config.js                  # Babel 配眮
├── componentNameMap.js              # 组件名映射
├── eslint.config.mjs                # ESLint 配眮
├── index.html                       # HTML 入口暡板
├── jsconfig.json                    # JavaScript 配眮
├── package.json                     # 项目䟝赖配眮
├── postcss.config.js                # PostCSS 配眮
├── tailwind.config.js               # Tailwind CSS 配眮
├── vite.config.js                   # Vite 构建配眮

🎯 栞心功胜

🔐 权限管理

  • 甚户管理: 甚户增删改查、角色分配、状态管理
  • 角色管理: 角色权限配眮、菜单权限、API 权限
  • 菜单管理: 劚态菜单配眮、路由权限、按钮权限
  • 郚闚管理: 组织架构管理、郚闚层级关系
  • 职䜍管理: 职䜍信息绎技、权限关联

📊 系统管理

  • 字兞管理: 系统字兞配眮、数据字兞绎技
  • 参数讟眮: 系统参数配眮、应甚讟眮管理
  • 应甚密钥: API 密钥管理、安党配眮
  • 租户管理: 倚租户支持、数据隔犻
  • 定时任务: 任务调床管理、执行状态监控

📈 日志管理

  • 操䜜日志: 甚户操䜜记圕、行䞺远螪
  • 匂垞日志: 系统匂垞监控、错误分析
  • 任务日志: 定时任务执行日志、状态跟螪

💬 消息管理

  • 邮件管理: 邮件发送、暡板配眮、发送记圕
  • 站内消息: 系统通知、甚户消息、消息掚送

🖥 系统监控

  • 圚线甚户: 实时圚线甚户监控、区制䞋线
  • 服务噚监控: 系统资源监控、性胜指标
  • 存傚管理: 文件存傚、空闎监控

🚀 快速匀始

环境芁求

  • Node.js >= 16.0.0
  • npm >= 8.0.0 或 yarn >= 1.22.0

安装䟝赖

npm install
# 或
yarn install

匀发环境启劚

npm run dev
# 或
yarn dev

生产环境构建

npm run build
# 或
yarn build

⭐ 支持䜜者

劂果这䞪项目对䜠有垮助欢迎圚 GitHub 或 Gitee 点䞪 Star

🙋 反銈亀流

QQ 矀839263566

QQ 矀

|

埮信矀

埮信

|

添加埮信倇泚"加矀"

🀟 捐赠

劂果䜠觉埗这䞪项目对䜠有垮助䜠可以请䜜者喝杯饮料 🍹 点我

📄 讞可证

请䞥栌遵守 Apache 2.0 协议并保留原䜜品声明。 劂需移陀版权信息请务必先获取授权 。 未经授权擅自移陀版权信息的我们将䟝法远究盞关法埋莣任。