# master-admin-vue3

**Repository Path**: panday94/master-admin-vue3

## Basic Information

- **Project Name**: master-admin-vue3
- **Description**: MasterAdminVue3是一款使用vue3+ts+vite+pinia+arco-design框架搭建的后台管理项目，全新界面风格，搭配master-fast或master-boot使用。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://gitee.com/panday94
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 4
- **Created**: 2025-01-16
- **Last Updated**: 2025-06-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## Master-Admin-Vue3

<p>
    <a href="#联系我们"><img src="https://img.shields.io/badge/%E5%85%AC%E4%BC%97%E5%8F%B7-%E5%A4%A7%E5%B8%88%E5%AD%A6Java-blue" alt="公众号"></a>
</p>

> 声明：此项目只发布于码云和GitHub，基于 MIT 协议，免费且作为开源学习使用，禁止转卖、谨防受骗。如需商用必须保留版权信息，请自觉遵守。确保合法合规使用，在运营过程中产生的一切任何后果自负，与作者无关。

# 项目简介

MasterAdminVue3一款使用Vue3、Vite、TypeScript、Arco Design框架、Pinia、搭建的web管理端项目，配合后台[master-fast](https://gitee.com/panday94/master-fast)使用，快速上手开发项目。如CMS系统、CRM系统、ERP系统等。

使用Master-Admin搭建的AI对话系统[ChatMaster](https://gitee.com/panday94/chat-master)，基于AI大模型api实现的ChatOwner服务，支持一键切换ChatGPT、月之暗面、文心一言、通义千问、讯飞星火、智谱清言、DeepSeek等主流模型，及本地模型工具。

该项目正在打造master生态圈，包含Vue2、Vue3版本及其为支持更多的语言，方便大家快速搭建系统，欢迎小伙伴或有合作意向一起加入交流群[添加微信](#联系我们)或提Issues。

* Vue2管理端，请移步[mast-admin](https://gitee.com/panday94/master-admin)
* Vue2移动端，请移步[master-uniapp](https://gitee.com/panday94/master-uniapp.git)
* Vue3移动端，请移步[master-uniapp-vue3](https://gitee.com/panday94/master-uniapp-vue3.git)

* 阿里云折扣场：[点我进入](https://www.aliyun.com/minisite/goods?userCode=iqguofg4)，腾讯云秒杀场：[点我进入](https://curl.qcloud.com/11y0ob0f)&nbsp;&nbsp;
* 阿里云优惠券：[点我领取](https://www.aliyun.com/daily-act/ecs/activity_selection?userCode=iqguofg4)，腾讯云优惠券：[点我领取](https://curl.qcloud.com/EUbjrCcu)&nbsp;&nbsp;

## 演示

<table>
    <tr>
        <td><img src="./docs/demo/1.png"/></td>
        <td><img src="./docs/demo/2.png"/></td>
    </tr>
    <tr>
        <td><img src="./docs/demo/3.png"/></td>
        <td><img src="./docs/demo/4.png"/></td>
    </tr>
        <tr>
        <td><img src="./docs/demo/5.png"/></td>
        <td><img src="./docs/demo/6.png"/></td>
    </tr>
</table>

## 功能介绍
- 工作台
- 数据中心
- 配置中心
    - 广告配置（用于移动端首页栏目配置）
    - 应用配置（用于移动端或网站信息配置及系统参数如微信参数、支付参数、oss参数、短信参数等配置）
- 系统管理
    - 用户管理（添加账号信息）
    - 角色管理（添加系统角色用于权限管理）
    - 部门管理（添加部门/管理部门）
    - 岗位管理（添加岗位/管理岗位）
    - 菜单管理（管理系统菜单后台配置）
    - 字典管理（添加系统字典信息）
    - 参数设置（系统参数设置）
    - 通知公告（系统公告添加显示）
- 系统监控
    - 在线用户
    - 定时任务
    - 数据监控
    - 服务监控
    - 缓存监控
    - 缓存列表
    - 日志列表
        - 操作日志
        - 登录日志
- 系统工具
    - 表单构建
    - 代码生成

## 前置要求

### Node
开发前请先阅读[开发文档](https://gitee.com/yoli9/master-admin-vue3)或按照如下要求进行启动/部署。

`node` 建议18^版本，使用 [nvm](https://github.com/nvm-sh/nvm) 可管理本地多个 `node` 版本，进行下载安装node环境。

```shell
nvm install 18
node -v
v18.20.3
```
### 注意事项
1、为兼容Vue3代码，菜单图标如不显示请注意sys_resource表中icon字段，`icon-settings`为vue3 Arco图标，`system`为vue2 Element图标

2、工作台和数据中台报错是因为用的mock数据，因启用mock会导致上传文件content-type会被篡改，所以注释掉/src/main.ts中的import './mock'，如需开启mock请将注释取消。

## 开发

```bash
# 克隆项目
git clone https://gitee.com/panday94/master-admin-vue3

# 进入项目目录
cd master-admin-vue3

# 安装依赖
npm install -g pnpm
pnpm install

# 建议不要直接使用 cnpm 安装依赖，会有各种诡异的 bug。可以通过如下操作解决 npm 下载速度慢的问题
npm install --registry=https://registry.npmmirror.com

# 启动服务
pnpm dev
```

浏览器访问 http://localhost:5173

## 发布

```bash
# 构建测试环境
cp .env.development .env.stage
# 修改测试环境配置信息 
pnpm build:stage

# 构建生产环境
cp .env.development .env.production
# 修改生成环境配置信息
pnpm build:prod
```

## 参与贡献

贡献之前请先阅读 [贡献指南](./CONTRIBUTING.md) [版本记录](./CHANGELOG.md)

个人的力量始终有限，任何形式的贡献都是欢迎的，包括但不限于贡献代码，优化文档，提交 issue 和 PR 等。
感谢所有做过贡献的人!

## 赞助

如果你觉得这个项目对你有帮助，并且情况允许的话，可以给我一点点支持，总之非常感谢支持～

接定制开发，欢迎老板下单！

<div style="display: flex; gap: 20px;">
    <div style="text-align: center">
        <img style="max-width: 100%" src="./docs/wepay.jpg" alt="微信" />
        <p>WeChat Pay</p>
    </div>
</div>

## 联系我们
<div style="display: flex;">
    <img style="width: 100%" src="./docs/wechat.png" alt="微信" />
</div>

## 许可证
MIT © [Master](./license)

Copyright (c) 2023 曜栋网络科技工作室 Limited All rights reserved