## 项目概述

芋道管理后台（yudao-ui-admin-vue3）是一个基于 Vue3 + Element Plus 的开源中后台前端解决方案，由 yudaocode 开发维护。项目以开发者为中心，致力于打造中国第一流的快速开发平台，所有代码全部开源，个人与企业可 100% 免费使用。它支持 RBAC 动态权限、数据权限、SaaS 多租户、Flowable 工作流、三方登录、支付、短信、商城、CRM、ERP、MES、IM、AI 大模型、IoT 物联网等功能，适合快速构建企业级业务系统。

## 核心功能

- **系统管理**：用户、角色、菜单、部门、岗位、字典、租户、短信、邮件、站内信、操作日志、登录日志、错误码、通知公告、敏感词、应用管理（SSO）、地区管理等。
- **工作流程**：基于 Flowable 构建，支持仿钉钉/飞书设计器与 BPMN 设计器，涵盖会签、或签、依次审批、抄送、驳回、转办、委派、加签、减签、撤销、终止、表单权限、超时审批、自动提醒、父子流程、条件分支、并行分支、包容分支、路由分支、触发节点、延迟节点等。
- **支付系统**：支持支付宝、微信等支付渠道，提供应用信息、支付订单、退款订单、回调通知、接入示例等功能。
- **基础设施**：代码生成、系统接口（Swagger）、数据库文档、表单构建、配置管理、定时任务、文件服务（S3、本地、FTP等）、WebSocket、API 日志、MySQL/Redis 监控、消息队列、Java 监控、链路追踪、日志中心、服务保障（分布式锁、幂等、限流）、日志服务、单元测试。
- **数据报表**：报表设计器（数据报表、图形报表、打印设计）、大屏设计器（拖拽生成数据大屏，内置几十种图表组件）。
- **业务系统**：商城、会员中心、ERP、WMS、CRM、MES、AI 大模型、IoT 物联网、IM 即时通讯、微信公众号管理等。

## 适用与不适用场景

- **适用场景**：适合需要快速搭建企业级中后台管理系统的团队，尤其是需要 RBAC 权限、多租户、工作流、支付、商城、CRM、ERP 等复杂业务模块的场景。也适合作为学习 Vue3 + Element Plus 最佳实践的参考项目。
- **不适用场景**：不适合对前端体积要求极高的轻量级项目，因为项目功能丰富、依赖较多；也不适合需要完全自定义 UI 风格且不打算使用 Element Plus 的项目。

## 技术架构与依赖

- **前端框架**：Vue 3.3.8
- **构建工具**：Vite 4.5.0
- **UI 组件库**：Element Plus 2.4.2
- **语言**：TypeScript 5.2.2
- **状态管理**：Pinia 2.1.7
- **路由**：Vue Router 4.2.5
- **工具集**：VueUse 10.6.1
- **国际化**：Vue I18n 9.6.5
- **原子 CSS**：UnoCSS 0.57.4
- **图标库**：Iconify 3.1.1
- **富文本编辑器**：WangEditor 5.1.23
- **后端架构**：支持 Spring Boot 单体架构和 Spring Cloud 微服务架构（后端仓库未提供，但文档中提及）。

## 安装与快速开始

- **环境要求**：Node.js > 16.18.0，pnpm > 8.6.0（强制使用 pnpm）。
- **安装依赖**：在项目根目录执行 `pnpm install`。
- **启动开发服务器**：执行 `pnpm dev`。
- **构建生产版本**：执行 `pnpm build`。
- **演示地址**：<http://dashboard-vue3.yudao.iocoder.cn>（Vue3 + Element Plus）。
- **启动文档**：<https://doc.iocoder.cn/quick-start/>。

## 典型使用方法

- **登录系统**：使用管理员账号登录，进入首页。
- **配置权限**：在“系统管理”中创建用户、角色、菜单，分配权限。
- **创建流程**：在“工作流程”中使用设计器创建审批流程，配置表单和节点。
- **管理商城**：在“商城系统”中管理商品、订单、会员等。
- **使用 AI 大模型**：在“AI 大模型”模块中配置模型、创建应用。
- **集成支付**：在“支付系统”中配置支付渠道，接入支付和退款。

## 配置与部署要点

- **环境变量**：项目使用 `.env` 文件管理环境变量，需配置后端 API 地址等。
- **后端对接**：需部署配套的后端服务（Spring Boot 或 Spring Cloud），并配置接口地址。
- **多租户**：启用 SaaS 多租户时，需在租户管理中配置租户和套餐。
- **部署**：构建后可将静态文件部署到 Nginx 等 Web 服务器，并配置反向代理到后端。
- **数据库**：需准备 MySQL、Redis 等基础设施，具体配置参考官方文档。

## 限制、风险与许可证

- **许可证**：MIT License，允许自由使用、修改和分发。
- **限制**：项目功能庞大，学习曲线较陡；部分高级功能可能需要后端支持，前端单独使用受限。
- **风险**：依赖较多，升级时需注意版本兼容性；开源项目维护依赖社区，未来更新频率不确定。

## 官方链接

- **GitHub 仓库**：<https://github.com/yudaocode/yudao-ui-admin-vue3>
- **演示地址**：<http://dashboard-vue3.yudao.iocoder.cn>
- **文档中心**：<https://doc.iocoder.cn>
- **视频教程**：<https://doc.iocoder.cn/video/>

## 信息来源和分析时间

- **信息来源**：GitHub 仓库 README、仓库元数据、最新 Release 信息。
- **分析时间**：2026年8月1日（基于最新 Release 日期推断）。