# HUIZHI-witos-cloud 慧知开源多租户Saas快速开发平台
**Repository Path**: zencke/witos-platform
## Basic Information
- **Project Name**: HUIZHI-witos-cloud 慧知开源多租户Saas快速开发平台
- **Description**: HUIZHI-Witos-cloud是一款基于先进多租户架构的SaaS应用快速开发平台。我们致力于为开发者和企业提供一套开箱即用、功能强大、可弹性扩展的底层解决方案，大幅降低多租户SaaS系统的开发难度、成本与时间投入。
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 2
- **Created**: 2025-12-31
- **Last Updated**: 2025-12-31
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
当前版本：1.0.8
[🔥 witos 慧知开源Saas多租户开发平台 后端源码](https://github.com/roinli/HUIZHI-Witos-cloud)（当前）
[🔥 witos 慧知开源Saas多租户开发平台 前端源码](https://github.com/roinli/HUIZHI-Witos-ui)
## 平台简介
witos-platform 慧知开源多租户Saas快速开发平台
基于Ruoyi-Cloud版本改造的的多租户SaaS开发框架。
- 首先感谢若依提供的开源支持!请大家继续关注若依项目!
- 本项目基于 [RuoYi-Cloud](https://gitee.com/y_project/RuoYi-Cloud) 进行二次开发的租户版本,主要致力于租户模式和服务治理相关的部分。
- 本项目主要针对企业租户场景开发，脚手架功能同步更新 [RuoYi-Cloud](https://gitee.com/y_project/RuoYi-Cloud) 项目。
- 采用`MIT开源协议`，完全免费给个人及企业使用。
#### 友情链接 [若依/RuoYi-Cloud](https://gitee.com/y_project/RuoYi-Cloud) Element UI版本。
star 别忘点上 :kissing_heart:
## 项目地址
Gitee: https://github.com/roinli/HUIZHI-witos-cloud
GitHub: https://github.com/roinli/HUIZHI-witos-cloud
## 演示地址
PS:目前已经升级服务器,修改为阿里云3M的服务器,请大家请勿恶心访问刷新,如果官网出现问题请邮件联系我!
- http://witos.platform.huizhidata.com
- 账号密码 admin/admin123
- 目前演示地址权限全开,请勿随意删除相关数据,本人只做了初始化数据库备份,如果出现异常情况,会选择直接回滚初始版本
## 文档地址
- http://witos.doc.huizhidata.com
## 个人blog
- https://wenhui.huizhidata.com
## 公众号-witos
- witos 全新公众号
## 有问题请issues有限提问,每天会定时处理!
## 交流
- +V: jinglidream
## 主要添加模块
- 1.添加了租户功能,包含自定义租户套餐,租户到期禁用登陆等功能
- 2.替代mybatis为mybatis-plus模块
- 3.添加了邮件通知功能
- 4.添加了自定义监控模块,暂时代替monitor模块
- 5.去除定时任务模块,选择了xxl-job,目前没有加入代码库
- 6.优化代码生成模块-代码生成默认集成mybatis-plus的CRUD模块
- 7.添加通知模块,和OSS存储模块,已经集成阿里云短信,后续会集成七牛云和腾讯等第三方
- 8.集成xxl-job到系统,重构定时任务管理界面,账号权限通用
- 9.优化文件服务
- 10.单体运行模块
## 后续开发任务
- 1.继续同步RuoYi-Cloud相关版本性更新
- 2.优化租户增删改查时候的数据处理逻辑,以及租户到期提前一星期通知功能(完成)
- 3.完善租户模式下的数据权限问题(完成)
- 4.集成阿里云,腾讯云等短信服务,并接入第三方登陆系统,增加短信登陆功能(已完成)
- 5.集成七牛云等云存储
- 6.租户添加自定义Logo和系统名称,后续考虑集成二级域名登陆租户系统
- 7.监控功能添加数据库监控和表监控
- 8.集成K8S环境
- 9.集成链路追踪
- 10.集成普罗米修斯
## 新增单体模块说明
#### 单体模块是独立于整体项目的一个demo,它只是集成了部分witos common模块里的公共组件
#### 设立此模块的初衷是因为部门公司场景下,快速开发平台需要提供为相应的二级部门使用,但是又不希望完全暴露平台代码
#### 所以单体模块相当于一个二开模块的抽离,平台开发组只要将 witos框架整体打包成镜像或者Jar提供给二开部门即可
#### 这样既避免了源码的泄露,又给予二级使用部门一定的开发权限
#### 单体模块我只是做了一个例子,后续的使用需要根据各个公司的实际情况去进行二次订制
#### 目前前端还没有做组件级封装,后续封装完成后会上传代码
## 启动说明
### 请参考保姆级教程 - [witos项目启动教程](https://http://witos.wenhui.huizhidata.com/archives/witos-xiang-mu-qi-dong-jiao-cheng)
### 其他细节说明
### 最新更新,项目已内置Nacos,直接启动即可
#### 1.如果nacos自行运行 如果是 M1的芯片 会出现内核报错 采用下方nacos镜像即可 docker pull zhusaidong/nacos-server-m1:2.0.3
- 运行指令如下
docker run --name nacos-standalone -e MODE=standalone -e JVM_XMS=512m -e JVM_XMX=512m -e JVM_XMN=256m -p 8848:8848 -d zhusaidong/nacos-server-m1:2.0.3
- 非M1芯片或者非docker环境请自行参考文档里的相关部署说明
### 以下非必须，如果感觉修改host比较麻烦，可以自行都修改为127.0.0.1
#### 2.mysql,redis等自行安装根据需求修改配置文件里的端口和连接,目前nacos初始化的配置文件里写的地址都是host映射的地址,如果需要指定指定地址请自行修改
- Windows处于 C:\Windows\System32\drivers\etc
- Linux和Mac都属于 /etc/hosts下
主要添加以下几个部分,不理解的自行百度,其中127.0.0.1为你自己的本机ip
127.0.0.1 witos-platform
127.0.0.1 witos-nginx
127.0.0.1 witos-nacos
127.0.0.1 witos-mysql
127.0.0.1 witos-gateway
127.0.0.1 witos-auth
127.0.0.1 witos-system
127.0.0.1 witos-file
127.0.0.1 witos-gen
127.0.0.1 witos-monitor
127.0.0.1 witos-redis
127.0.0.1 witos-job
127.0.0.1 witos-demo
#### 3.前后端启动说明
- 1.nacos和mysql以及redis正常运行后 优先启动gateway网关和 auth服务,其他的就可以同时启动了
- 2.前段部分,记得修改vue.config里的后端接口地址
## 一键式体验(要求linux环境)
##### 1.docker安装和docker-compose安装请参考文档里的-应用容器部署模块进行安装
##### 2.安装完成后下载项目到任意文件夹目录,自行安装 maven,jdk,node环境 下面简单提供三个教程链接仅供参考
- [Centos7安装JDK8](https://http://witos.wenhui.huizhidata.com/archives/centos7-an-zhuang-jdk18-tu-wen-jiao-cheng)
- [Centos7安装maven](https://http://witos.wenhui.huizhidata.com/archives/centos7-an-zhuang-maven)
- [Centos7安装nodejs14](https://http://witos.wenhui.huizhidata.com/archives/centos7-an-zhuang-nodejs14)
##### 3.脚本执行
- 1.cd ./docker 目录下 执行 copy.sh 脚本会自动进行打包编译和copy
- 2.首先执行 sh deploy.sh base 命令进行 nacos,mysql,redis的初始化,初始化完成后建议等待10秒后执行查下一步
- 3.后面执行 项目脚本 sh deploy.sh modules ,如果防火墙没有关闭 还可以执行port指令请自行研究脚本
- 4.执行copy脚本前可以根据自己的需求自行替换相关变量 比如初始变量设置了 192.168.200.188这个虚拟机ip 可以根据需要自行全局替换
## 功能截图
## 系统模块
~~~
com.witos
├── witos-ui // 前端框架 [80]
├── witos-gateway // 网关模块 [38080]
├── witos-auth // 认证中心 [39200]
├── witos-api // 接口模块
│ └── witos-api-system // 系统接口
├── witos-demo // 样例代码模块 [39203]
├── witos-common // 通用模块
│ └── witos-common-core // 核心模块
│ └── witos-common-datascope // 权限范围
│ └── witos-common-datasource // 多数据源
│ └── witos-common-log // 日志记录
│ └── witos-common-redis // 缓存服务
│ └── witos-common-security // 安全模块
│ └── witos-common-swagger // 系统接口
│ └── witos-common-message // 消息通知
│ └── witos-common-mybatisplus // mybatis租户增强组件
│ └── witos-common-seata // seata组件(未启用)
├── witos-modules // 业务模块
│ └── witos-system // 系统模块 [39201]
│ └── witos-gen // 代码生成 [39202]
│ └── witos-file // 文件服务 [39300]
│ └── witos-job // 定时任务服务 [39024]
├── witos-visual // 图形化管理模块
│ └── witos-visual-monitor // 监控中心 [39100]
├──pom.xml // 公共依赖
~~~
## 内置功能
1. 租户管理：配置系统租户，支持 SaaS 场景下的多租户功能。
2. 配置租户套餐：自定每个租户的菜单、操作、按钮的权限。
3. 用户管理：用户是系统操作者，该功能主要完成系统用户配置。
4. 部门管理：配置系统组织机构（公司、部门、小组），树结构展现支持数据权限。
5. 岗位管理：配置系统用户所属担任职务。
6. 菜单管理：配置系统菜单，操作权限，按钮权限标识等。
7. 角色管理：角色菜单权限分配、设置角色按机构进行数据范围权限划分。
8. 字典管理：对系统中经常使用的一些较为固定的数据进行维护。
9. 参数管理：对系统动态配置常用参数。
10. 通知公告：系统通知公告信息发布维护。
11. 操作日志：系统正常操作日志记录和查询；系统异常信息日志记录和查询。
12. 登录日志：系统登录日志记录查询包含登录异常。
13. 在线用户：当前系统中活跃用户状态监控。
14. 代码生成：前后端代码的生成（java、html、xml、sql）支持CRUD下载 。
15. 系统接口：根据业务代码自动生成相关的api接口文档。
16. 服务监控：监视当前系统CPU、内存、磁盘、堆栈等相关信息。
17. 在线构建器：拖动表单元素生成相应的HTML代码。