# wemirr-platform **Repository Path**: gitcrazy/wemirr-platform ## Basic Information - **Project Name**: wemirr-platform - **Description**: 最优秀、最简单、最漂亮的开源SAAS、多租户、SpringCloud2023、Mysql、Mybatis-Plus、Spring Cloud Alibaba2022 、Oauth2.1 、有BUG第一时间修复 - **Primary Language**: Java - **License**: Apache-2.0 - **Default Branch**: vben_jdk17 - **Homepage**: http://cloud.battcn.com - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 718 - **Created**: 2024-08-11 - **Last Updated**: 2024-08-11 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # wemirr-platform [![个人信息](https://img.shields.io/badge/author-唐亚峰-blue.svg)](http://blog.battcn.com/) [![项目交流群](https://img.shields.io/badge/chat-项目交流群-yellow.svg)](https://qm.qq.com/cgi-bin/qm/qr?k=7HSbjhK2b23CyodXUX2tR_ldigjrAlPT&jump_from=webapi) ![JDK Version](https://img.shields.io/badge/JAVA-JDK8+-red.svg) ![Total visits](https://visitor-badge.laobi.icu/badge?page_id=wemirr-platform&title=total%20visits) [![Total lines](https://tokei.rs/b1/github/battcn/wemirr-platform?category=lines)](https://tokei.rs/b1/github/battcn/wemirr-platform?category=lines) [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg?label=license)](https://www.codacy.com/gh/battcn/wemirr-platform/dashboard?utm_source=github.com&utm_medium=referral&utm_content=battcn/wemirr-platform&utm_campaign=Badge_Grade) [![Stars](https://img.shields.io/github/stars/battcn/wemirr-platform.svg?label=Stars&tyle=flat&logo=GitHub)](https://github.com/battcn/wemirr-platform/stargazers) [![Stars](https://gitee.com/battcn/wemirr-platform/badge/star.svg?theme=gvp)](https://gitee.com/battcn/wemirr-platform/stargazers) [![Spring Boot](https://img.shields.io/maven-central/v/org.springframework.boot/spring-boot-dependencies.svg?label=Spring%20Boot&logo=Spring)](https://search.maven.org/artifact/org.springframework.boot/spring-boot-dependencies) [![Spring Cloud](https://img.shields.io/maven-central/v/org.springframework.cloud/spring-cloud-dependencies.svg?label=Spring%20Cloud&logo=Spring)](https://search.maven.org/artifact/org.springframework.cloud/spring-cloud-dependencies) [![Spring Cloud Alibaba](https://img.shields.io/maven-central/v/com.alibaba.cloud/spring-cloud-alibaba-dependencies.svg?label=Spring%20Cloud%20Alibaba&logo=Spring)](https://search.maven.org/artifact/com.alibaba.cloud/spring-cloud-alibaba-dependencies) **WP的使命：打破假开源，做全网最优秀、最简单、最漂亮的开源SAAS、多租户云平台架构。从开源中来,到开源中去,让大家有更多时间`摸鱼`、`学习`、`陪伴家人`、`锻炼身体`、`找对象`** **项目代码全部开源,非阉割版,有`Spring Cloud` 工作经验的 无需付费协助一样可以玩转项目** > JDK8 - JDK11 的请使用 vben 分支（后续只提供BUG修复） > JDK17+SCA2022+SC2023 请使用 vben_jdk17 分支（强烈推荐使用这个版本,因为作者后期重心在它，同时新功能特性也会基于该版本进行开发发布） > 开发文档 [开发文档 WP-DOC](https://docs.battcn.com) **本项目反馈BUG和运行报错提供无偿技术支持（包括远程协助排查问题）** > 付费功能 **对于 `wemirr-platform` 开源永远是第一位，业务模块企业想偷懒可以考虑付费购买降低企业成本** **可以进微信群交流和提需求（提了不一定做,请理性付费，合理的需求提交ISSUE或者添加作者微信沟通也一样）** **模块定制化开发、远程支持、协助私有化部署** **图文或者远程处理技术难题 188 一次，解决后收费** **购买 BPM、TMS、WMS商用的业务模块** > 赞赏 - 敬请期待（**微信： battcn2022**） ## 演示地址 [演示地址](https://cloud.battcn.com/) > 平台账号 0000 账号 admin 密码 123456 > 租户账号 8888 账号 admin 密码 123456 ## 软件架构 > 技术交流Q群： 789517089 Vue、Spring Cloud Alibaba 2022、Spring Cloud 2022、Nacos、Sentinel、 Nepxion、Mybatis-Plus、多租户、灰度、Oauth2.1、Spring Security、Redis、Mysql、 ### 特点 - 链路追踪：支持 `skywalking`、`zikpin`、`pinpoint` 等多种链路追踪（案例采用 `skywalking`） - 布局优雅：简洁、多套主题以及导览模式任意组合搭配 - 功能齐全：SAAS/多租户/RBAC权限控制全都具备，下载代码开箱即用 - 消息推送：内置基于WebSocket、Redis实现的分布式消息 - 服务治理：整合 `Nepxion` 框架可以快速实现蓝绿/灰度/服务治理 等强大功能 - 动态网关：支持页面配置(`Redis`)与 `Nacos` 两种推送方式、动态开启关闭网关路由 - 网关管理：支持流量控制、拉黑名单等 - 消息总线：使用 `RabbitMq` 做总线用于支持`动态数据`源消息广播 - 插拔组件：除去必要工程，可选的都在 `options` 按需使用 - 大道至简：代码优雅、简短、不管是开发前端还是后端,快就完事了，下面给出一个简单的示例 - 性能高效：集成链路追踪在2M网络环境下接口最慢不超过 `300毫秒` 普遍 `10-150 毫秒` 之间 - 标准文档：集成标准的 `SpringDoc => Swagger V3` 功能更强大,UI更优美 - 分布式任务：整合 `xxl-job` 提供分布式调度任务功能 - 工作流：集成 `camunda-bpm` 工作流（暂未实现UI nepxion 已提供工作流案例） > Vue 开发只需要几行简短的代码即可完成单表的CRUD，大大提升开发效率 ``` vue ``` ## 效果图 ![监控-1](./images/skywalking.png) ![监控-2](./images/skywalking-2.png) ![分配用户](./images/binding_user.png) ![分配权限](./images/binding_res.png) ![黑白名单](./images/blacklist.png) ![限流配置](./images/limit.png) ![菜单管理](./images/menu.png) ![监控管理](./images/monitor.png) ![操作日志](./images/opt_log.png) ![发布消息](./images/publish_message.png) ![用户列表](./images/users.png) ![定时任务](./images/xxl-job.png) ![监控配置](./images/skywalking-config.png) ![监控配置](./images/springdoc.png) ## 介绍 开源里面UI最好、最容易上手的、中台 、SAAS 、 多租户功能、最最少的代码实现功能 [配套前端](https://gitee.com/battcn/wemirr-platform-ui) 配套的 UI [Nepxion-Discovery](https://github.com/battcn/wemirr-platform) 蓝绿、灰度、流量保护 [OpenAPi3](https://springdoc.org/) Swagger 标准版 ### 拓展阅读 [Oauth2.0](https://www.ruanyifeng.com/blog/2019/04/github-oauth.html) OAuth2.0 知识点 `wemirr-platform-bury` 是一个用 `shardingsphere` 做分表分库收集日志的，常见埋点日志手段(存在不完善的地方,一般也用不上) - **`记录日志文件,EFK/ELK采集日志`** - **`日志量小的话可以写到库`** - **`日志量大可以分表分库记录埋点日志，定期清理`** ### 注意事项 **下载项目后请先本地 `mvn install wemirr-platform-dependencies` 和 `mvn install wemirr-platform-framework`** **options 项目是本人用于测试一些中间件的工程、完全可以忽略** ### 环境安装 提供 `docker-compose.yml` 安装（文件在`附件/docker/docker-compose.yml`） 一般安装 `latest` 版本即可，也可以自行指定版本 `docker search` 或者自己上 `docker hub` 看版本 如果 `docker` 运行开发环境，建议先创建一个网络 `docker network create wemirr` 后面容器都走统一网络 > 具体用法: **`docker run --net wemirr --name xxx`** > 必要环境 ``` shell script docker pull redis:latest docker run -itd --name redis -p 6379:6379 redis 安装 Mysql docker pull mysql:latest docker run -itd --name mysql-test -p 3306:3306 -e MYSQL_ROOT_PASSWORD=123456 mysql 安装 Nacos docker pull nacos/nacos-server docker run --name nacos -itd -p 8848:8848 -p 9848:9848 -p 9849:9849 --restart=always -e MODE=standalone nacos/nacos-server 安装 RabbitMQ docker pull docker.io/macintoshplus/rabbitmq-management docker run -d -p 5671:5671 -p 5672:5672 -p 15672:15672 -p 15671:15671 -p 25672:25672 rabbitmq_image_id ``` > 可选环境 ``` shell script ## 非必须 => Sentinel 流量保护大部分公司是用不上的,如果为了技术而技术,当我没说 安装 Sentinel-Dashboard docker pull bladex/sentinel-dashboard docker run -i -t -d -p 8858:8858 -p 8719:8719 bladex/sentinel-dashboard ## 非必须 => 如果你没有过多的定时任务也没有对任务进行管理的要求， xxl-job 也是非必须品 安装 XXL-JOB-ADMIN(如果数据库也是docker 运行需要配置统一网络 例如： docker network create wemirr ) docker pull xuxueli/xxl-job-admin:2.3.0 docker run -e PARAMS="--spring.datasource.username=root --spring.datasource.password=123456 --spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver --spring.datasource.url=jdbc:mysql://127.0.0.1:3306/wemirr-platform?useUnicode=true&characterEncoding=UTF-8&autoReconnect=true" -p 9999:8080 -v /Users/battcn/Development:/data/applogs --name xxl-job-admin -d xuxueli/xxl-job-admin:2.3.0 ##非必须 => 安装 skywalking（如果你公司没运维，那你大概率用不上 skywalking 如不需要使用那后面的命令都可以不用看了 ） # 8.7.0 启动有问题 docker pull elasticsearch:7.9.3 docker pull apache/skywalking-oap-server:8.5.0-es7 docker pull apache/skywalking-ui:8.5.0 # 如果要后台运行 请加 -d docker network create wemirr docker run --name elasticsearch --net wemirr -p 9200:9200 -p 9300:9300 -d -e "discovery.type=single-node" elasticsearch:7.9.3 docker run --name oap --net wemirr --restart always -p 1234:1234 -p 12800:12800 -p 11800:11800 -d -e SW_STORAGE=elasticsearch7 -e SW_STORAGE_ES_CLUSTER_NODES=elasticsearch:9200 apache/skywalking-oap-server:8.5.0-es7 docker run --name oap-ui --net wemirr --restart always -p 10086:8080 -d -e TZ=Asia/Shanghai -e SW_OAP_ADDRESS=oap:12800 apache/skywalking-ui:8.5.0 # IDEA 配置 VmOption -javaagent:/Users/battcn/Desktop/apache-skywalking-apm-bin/agent/skywalking-agent.jar Environment variables SW_AGENT_NAME=wemirr-platform-gateway Environment variables SW_AGENT_NAME=wemirr-platform-authority # 启动命令 nohup java -javaagent:/opt/wemirr-platform/skywalking/agent/skywalking-agent.jar -Dskywalking.agent.service_name=wemirr-platform-gateway -Dskywalking.collector.backend_service=127.0.0.1:11800 -jar wemirr-platform-gateway.jar -d > logs/start_gateway.log & nohup java -javaagent:/opt/wemirr-platform/skywalking/agent/skywalking-agent.jar -Dskywalking.agent.service_name=wemirr-platform-authority -Dskywalking.collector.backend_service=127.0.0.1:11800 -jar wemirr-platform-authority.jar -d --spring.profiles.active=demo > logs/start_authority.log & ```