agile-admin: A Vue repository from jiang-gary

文档 | 预览

Java + Vue 有很多优秀的后台管理系统，但是为了可以高效的开发后台权限管理系统，作者就自己开发出 agile-admin。本项目中未曾过度使用样式，目的是为了方便开发者可以方便修改成自己需要的样式
agile-admin 是一个基于 Vue3 + Element-plus + Java 的多企业后台权限管理系统，提供了完善的权限体系，让开发者把注意力集中到具体业务当中，降低开发成本，提高项目效率。可以用于网站管理后台、SAAS、CMS、CRM、OA、ERP等，企业和个人都可以免费使用。欢迎提交PR（需求），若开发中遇到问题可以上 Github 提 Issues。

如果觉着还不错，请点个 ⭐star 支持一下吧，这将是对我最大的支持和鼓励！

由于有部分开发者需要完整后端代码，目前开始完成捐赠即可获得完整后端代码。开发者可以翻到 `联系方式` 栏目添加作者微信，具体的私聊！

About the author

Hi there, I'm Slipper（拖孩）👋. Thank you for your attention ⭐! I'm a code enthusiast who has been working in the IT industry for many years. I like open source and all interesting things and want to try to do it. I want to be an interesting person and create something that can be remembered by others. If you want to write code with me, you can contact me for internal promotion.

🔭 I’m currently working on 万店掌
📫 How to reach me: 🐧1240235512 🛰️Gy1240235512 📪gumingchen@foxmail.com
🌏 How to follow me: Github Gitee 掘金简书
❤️ I like playing 🎮, sleeping in 🛌 and coding 👨‍💻.

内置功能

分支

master 多租户完整功能版本：多租户后台管理。持续维护分支
dev 多租户完整功能开发分支。持续维护分支
vite-pinia 该分支是多租户概念，使用的是vite + pinia 实现的功能，使用的是vue组合式api的 setup 标签。持续维护分支
webpack-vuex-enterprise 该分支是企业概念版本内容，使用的是webpack + vuex 实现的功能，使用的是vue组合式api。
vite-pinia-enterprise 该分支是企业概念版本内容，使用的是vite + pinia 实现的功能，使用的是vue组合式api的 setup 标签。
base 多企业基础版本：多企业基于 RBAC 的权限功能-仅包含 菜单管理、企业管理、企业角色管理、企业管理员管理、企业菜单管理、角色管理、管理员管理、操作日志、登录日志，对应后端java-spring-boot-adminmaster分支
single 单企业完整功能版本：单企业后台管理，已停止维护
single-base 单企业基础功能版本：单个企业基于 RBAC 的权限功能-仅包含 菜单管理、角色管理、用户管理，已停止维护
composition-api 内置__Type Script、I18n__，已停止维护可以参考相关的配置
class-style 使用 class 风格开发，内置__Type Script、I18n__，已停止维护可以参考相关的配置
说明: 持续维护分支是 master、dev、vite-pinia。其他分支是作者开发时使用的分支, 由于作者不断优化、重构、版本迭代的原因，composition-api 和 class-style 没有同步迭代更新，所以建议这两个分支作为参考学习。

环境需求

Node => 16.0.0
Vue-Cli => 5.0.0
JDK = 1.8.x
Mysql >= 8.0.0

项目结构

vue3-src
├─api 接口模块
│
├─assets 静态资源模块
│  ├─font 字体
│  └─sass 样式
│ 
├─common 通用
│  ├─constants 常量
│  ├─enums 枚举
│  └─utils 工具
│ 
├─components 通用组件
│  ├─global 全局组件
│  │  ├─container 布局组件
│  │  ├─date-range-picker 日期选择组件（二次封装）
│  │  ├─dict-radio 字典radio组件（二次封装）
│  │  ├─dict-select 字典select组件（二次封装）
│  │  ├─iconfont 使用阿里图库图标的组件
│  │  ├─page 分页组件
│  │  ├─view 视图组件（二次封装router-view）
│  │  └─index 统一全局注册
│  ├─collapse 折叠组件
│  ├─container-custom 自定义布局组件
│  ├─container-sidebar 左右布局组件
│  ├─count-to 计数组件
│  ├─editor 富文本组件
│  ├─icon-select-input 阿里图库图标选择组件
│  ├─region 区域级联选择组件
│  ├─tenant-sidebar 租户侧栏
│  ├─upload 上传组件
│  └─upload-image 单图片上传组件
│ 
├─directive 全局自定义指令
│ 
├─hooks 钩子
│  ├─bind-exposed 导出绑定
│  ├─dict 字典
│  └─model 双向绑定
│ 
├─router 动态路由
│ 
├─stores pinia
│  ├─modules
│  │  ├─adminer 管理员信息模块
│  │  ├─auth 登录凭证信息模块
│  │  ├─dict 数据字典模块
│  │  ├─menu 菜单模块
│  │  ├─notice 通知模块
│  │  ├─tabs 标签页模块
│  │  ├─theme 主题模块
│  │  └─websocket 消息推送模块
│  ├─index 动态加载模块
│  └─root 根模块
│
├─views 视图模块
│  ├─constant 通用页面
│  │  ├─401 401页面
│  │  ├─404 404页面
│  │  ├─500 500页面
│  │  └─login 登录页面
│  ├─layout
│  │  ├─components
│  │  │  ├─headbar 顶部导航
│  │  │  ├─navigation 导航布局组件
│  │  │  ├─sidebar 侧边栏
│  │  │  ├─tabsbar 标签页
│  │  │  └─websocket 消息推送组件
│  │  └─index 布局入口页面
│  └─modules 页面模块

开发

# 克隆项目
git clone https://github.com/gmingchen/agile-admin.git

# 进入项目目录
cd agile-admin

# 安装依赖
npm install

# 若执行 npm install 报错，可能由于node版本太高原因导致，可执行一下命令
npm install --legacy-peer-deps

# 启动服务
npm run dev   # 开发环境
npm run prod  # 正式环境
npm run test  # 测试环境

# 发布
npm run build:dev   # 开发环境
npm run build:prod  # 正式环境
npm run build:test  # 测试环境