Files
vben-web/README.zh-CN.md
T
vben aa8f8952bd 修改移动端技术栈,尝试uni-app x
修改移动端技术栈,尝试uni-app x 

Signed-off-by: vben <fohozq@163.com>
2025-11-29 15:39:39 +00:00

10 KiB
Raw Blame History

🍿 项目简介

码云Gitee License

vben-web 是vben系列框架的统一WEB前端,基于玲娜贝er大佬的 ruoyi-plus-vben5 改造,将Ant Design Vue版本改造成Element Plus版本。

vben5 使用了最新前端技术栈,提供丰富的组件和模板以及N种偏好设置组合方案, 应用层可自由选择UI框架(Element Plus,Ant Design Vue,Native UI)

🍟 相关地址

⚡ 快速启动

java后端

  • 准备工作:1. 准备java17及以上版本,修改pom.xml对应java.version 2. 根据application-dev.yml配置文件准备一个空的数据库,默认为vben-java的mysql数据库,账号root,密码123456 3. 开启redis 默认密码为空

  • 数据库初始化:启动VbenSetup,程序会自动创建数据库表与初始化表数据,生成完成后VbenSet应用会自动关闭

  • 启动后台API:启动VbenAdmin,也可启动VbenJpa或VbenMybatis查看相应DEMO示例

.net后端

  • 准备工作:1. 准备.NET8(.NET10)环境,修改.csproj对应TargetFramework 2. 根据web.Development.json配置文件准备一个空的数据库,默认为vben-net的mysql数据库,账号root,密码123456 3. 开启redis 默认密码为空

  • 启动后台API:启动VbenAdmin,系统会根据SqlSugar CodeFirst自动生成数据库表结构,另外会根据Init相关服务生成数据库初始化数据。也可启动VbenFurion或VbenNative查看相应DEMO示例

web前端

  • 准备工作:准备Node.js 20.15.0以上环境,全局安装pnpm:npm install -g pnpm

  • 启动前台WEB:1. 使用pnpm install安装依赖 2. 使用pnpm dev:ele运行项目 3.访问 http://localhost:5666/ 预览

🍄 主要特色

  • 后端项目中抽离并拆分了公共功能,以插件化与扩展包的方式组织,结构解耦且易于扩展。
  • 后端项目业务模块以多基础模块与多应用方式组织,可实现多个应用共用相同基础模块,方便实现基础模块共享
  • 工作流模块不依赖其他工作流引擎,全部自行实现,易于扩展,实现复杂工作流
  • 统一的命名风格,数据库表主键统一用ID命名,表字段采用SAP风格(后端手册里有详细介绍)

🍖 内置功能

以下表格列出了各后台API功能的支持度。

业务模块 功能说明 JAVA版本 .NET版本
用户管理 用户的管理配置 如:新增用户、分配用户所属部门、角色、岗位等 √ √
部门管理 配置系统组织机构(公司、部门、小组) 树结构展现支持数据权限 √ √
岗位管理 配置系统用户所属担任职务 √ √
菜单管理 配置系统菜单、操作权限、按钮权限标识等 √ √
角色管理 角色根据部门、用户、岗位、群组分配权限 √ √
字典管理 对系统中经常使用的一些较为固定的数据进行维护 √ √
参数管理 对系统动态配置常用参数 √ √
通知公告 系统通知公告信息发布维护 √ × 待支持
客户端管理 系统内对接的所有客户端管理 如: pc端、小程序端等,支持动态授权登录方式 如: 短信登录、密码登录等 支持动态控制token时效 √ × 待支持
操作日志 系统正常操作日志记录和查询 系统异常信息日志记录和查询 √ √
登录日志 系统登录日志记录查询包含登录异常 √ √
文件管理 同时支持本地文件存储于分布式对象存储。系统文件展示、上传、下载、删除等管理 √ √
在线用户管理 已登录系统的在线用户信息监控与强制踢出操作 √ × 待支持
定时任务 运行报表、任务管理(添加、修改、删除)、日志管理、执行器管理等 √ √
代码生成 前后端代码的生成(c#、vue、sql)支持CRUD下载 √ ×
系统接口 根据业务代码自动生成相关的api接口文档 √ 通过Apifox支持 √ 通过swagger-ui支持
服务监控 监视系统CPU、内存、磁盘、堆栈、在线日志等 √ √
缓存监控 对系统的缓存信息查询,命令统计等 √ √
在线构建器 拖动表单元素生成相应的HTML代码 √ √
使用案例 系统的一些功能案例 √ √
工作流 前端流程图采用BPMN.js,表单采用FromCreate(FormDesigner),后端自行实现流程引擎 √ 持续扩展 × 待java版本稳定

💐 特别鸣谢

🏀 浏览器支持

最低适配应该为Chrome 88+以上浏览器 详见 css - where

本地开发推荐使用Chrome 最新版本浏览器

支持现代浏览器,不支持 IE

 Edge
IE
 Edge
Edge
Firefox
Firefox
Chrome
Chrome
Safari
Safari
not support last 2 versions last 2 versions last 2 versions last 2 versions