{"id":13607960,"url":"https://github.com/matevip/matecloud","last_synced_at":"2025-05-14T21:06:40.282Z","repository":{"id":40995482,"uuid":"218435426","full_name":"matevip/matecloud","owner":"matevip","description":"🔥MateCloud是一款基于Spring Cloud Alibaba的微服务架构。目前已经整合Spring Boot 2.7.0、 Spring Cloud 2021、Spring Cloud Alibaba 2021、Spring Security Oauth2、Feign、Dubbo、JetCache、RocketMQ等，支持多租户的低代码平台，Saas平台开发套件","archived":false,"fork":false,"pushed_at":"2024-07-28T13:37:54.000Z","size":14230,"stargazers_count":1551,"open_issues_count":16,"forks_count":415,"subscribers_count":37,"default_branch":"dev","last_synced_at":"2025-04-10T09:59:14.964Z","etag":null,"topics":["alibabacloud","cloudspring","jetcache","microservice","microservices-architecture","nacos","nacos-spring-cloud","rbac","rocketmq","saas","spring-boot","spring-cloud","spring-cloud-alibaba","spring-security-oauth2","springboot-admin","springboot-springcloud","springcloud","springcloudalibaba","tenant","vue3"],"latest_commit_sha":null,"homepage":"http://www.mate.vip","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/matevip.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-10-30T03:25:43.000Z","updated_at":"2025-04-03T08:57:38.000Z","dependencies_parsed_at":"2023-02-16T17:00:40.384Z","dependency_job_id":"f8d2dc64-0f7b-4e67-af21-43faed793d6f","html_url":"https://github.com/matevip/matecloud","commit_stats":{"total_commits":802,"total_committers":16,"mean_commits":50.125,"dds":"0.16334164588528677","last_synced_commit":"7f0e533960e894b6822065ffab041e1a4417dc0a"},"previous_names":[],"tags_count":29,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matevip%2Fmatecloud","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matevip%2Fmatecloud/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matevip%2Fmatecloud/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matevip%2Fmatecloud/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/matevip","download_url":"https://codeload.github.com/matevip/matecloud/tar.gz/refs/heads/dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254227612,"owners_count":22035669,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["alibabacloud","cloudspring","jetcache","microservice","microservices-architecture","nacos","nacos-spring-cloud","rbac","rocketmq","saas","spring-boot","spring-cloud","spring-cloud-alibaba","spring-security-oauth2","springboot-admin","springboot-springcloud","springcloud","springcloudalibaba","tenant","vue3"],"created_at":"2024-08-01T19:01:23.127Z","updated_at":"2025-05-14T21:06:35.263Z","avatar_url":"https://github.com/matevip.png","language":"Java","readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://gitee.com/matevip/matecloud/raw/dev/doc/images/matecloud.svg\" width=\"260\"\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003cimg src='https://img.shields.io/github/license/matevip/matecloud' alt='License'/\u003e\n  \u003cimg src=\"https://img.shields.io/github/stars/matevip/matecloud\" alt=\"Stars\"/\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Spring%20Boot-2.7.14-green\" alt=\"SpringBoot\"/\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Spring%20Cloud-2021.0.8-blue\" alt=\"SpringCloud\"/\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Spring%20Cloud%20Alibaba-2021.0.5.0-brightgreen\" alt=\"Spring Cloud Alibaba\"/\u003e\n\u003c/p\u003e\n\n## 🍟 如果您觉得有帮助，请点右上角 \"Star\" 支持一下谢谢\n\nMateCloud是一款基于Spring Cloud Alibaba的微服务架构。旨在为大家提供技术框架的基础能力的封装，减少开发工作，让您只关注业务。\n\n## 🎨 系统演示\n### 👉 单体版演示地址：https://demo.mate.vip/boot\n\n账号 | 密码| 项目地址\n---|---|---\nadmin | matecloud| https://gitee.com/matevip/mateboot\n\n### 👉 微服务版演示地址：https://demo.mate.vip/cloud\n\n账号 | 密码| 操作权限\n---|---|---\nadmin | matecloud| mate-system模块不能执行增删改请求\n\n### 🍯 商业版：https://plus.mate.vip\n管理员类型 | 账号| 密码 | 用途\n---|---|---|---  \n超级管理员 | admin | matecloud123 | 超级用户\n租户管理员 | tenant | matecloud123 | 此处模拟商城系统\n\n`注意`：租户管理员的菜单完全自定义，可用于扩展开发商城系统、CRM系统、OA系统等任意系统需求。\n\n[商业版与开源版对比](https://doc.dabu.vip/vip/product/business/)\n\n## 📌 版本演进\n核心中间件 | 2.5.8及以下 | 当前:4.4.9+\n---|---|---\nSpring Boot | 2.3.*.RELEASE | \u003cimg src=\"https://img.shields.io/badge/Spring%20Boot-2.7.14-blue\" alt=\"SpringBoot\"/\u003e\nSpring Cloud | Hoxton SR* | \u003cimg src=\"https://img.shields.io/badge/Spring%20Cloud-2021.0.8-blue\" alt=\"SpringCloud\"/\u003e\nSpring Cloud Alibaba | 2.2.*.RELEASE | \u003cimg src=\"https://img.shields.io/badge/Spring%20Cloud%20Alibaba-2021.0.8.0-blue\" alt=\"SpringCloudAlibaba\"/\u003e\nNacos | 1.4.*及以下 | \u003cimg src=\"https://img.shields.io/badge/Nacos-2.2.0-blue\" alt=\"nacos\"/\u003e\nSentinel | 1.8.1 | \u003cimg src=\"https://img.shields.io/badge/Sentinel-1.8.6-blue\" alt=\"sentinel\"/\u003e\n\n## 📖 官方文档\n### 👉 文档：[http://doc.dabu.vip](http://doc.dabu.vip)\n\n## 👷 技术交流\n\u003cp align=\"center\"\u003e \n    \u003cimg src=\"https://gitee.com/matevip/matecloud/raw/dev/doc/images/qr_group.jpg\" /\u003e\n\u003c/p\u003e\n👉 QQ群：2003638\n\n## 🍪 技术架构\n\u003cp align=\"center\"\u003e \n    \u003cimg src=\"https://cdn.mate.vip/matecloud-framework.jpg\" /\u003e\n\u003c/p\u003e\n\n## ❓ 部分截图\n\u003ctable\u003e\n    \u003ctr\u003e\n        \u003ctd\u003e\u003cimg src=\"https://gitee.com/matevip/matecloud/raw/master/doc/images/artemis_page1.png\"/\u003e\u003c/td\u003e\n        \u003ctd\u003e\u003cimg src=\"https://gitee.com/matevip/matecloud/raw/master/doc/images/artemis_page2.png\"/\u003e\u003c/td\u003e\n        \u003ctd\u003e\u003cimg src=\"https://gitee.com/matevip/matecloud/raw/master/doc/images/artemis_page3.png\"/\u003e\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n        \u003ctd\u003e\u003cimg src=\"https://gitee.com/matevip/matecloud/raw/master/doc/images/artemis_page4.png\"/\u003e\u003c/td\u003e\n        \u003ctd\u003e\u003cimg src=\"https://gitee.com/matevip/matecloud/raw/master/doc/images/artemis_page5.png\"/\u003e\u003c/td\u003e\n        \u003ctd\u003e\u003cimg src=\"https://gitee.com/matevip/matecloud/raw/master/doc/images/artemis_page6.png\"/\u003e\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n        \u003ctd\u003e\u003cimg src=\"https://gitee.com/matevip/matecloud/raw/master/doc/images/7.png\"/\u003e\u003c/td\u003e\n        \u003ctd\u003e\u003cimg src=\"https://gitee.com/matevip/matecloud/raw/master/doc/images/8.png\"/\u003e\u003c/td\u003e\n        \u003ctd\u003e\u003cimg src=\"https://gitee.com/matevip/matecloud/raw/master/doc/images/9.png\"/\u003e\u003c/td\u003e\n    \u003c/tr\u003e\n\u003c/table\u003e\n\n## 🔧 功能特点\n- 主体框架：采用最新的`Spring Cloud 2021.0.8`, `Spring Boot 2.7.14`, `Spring Cloud Alibaba 2021.0.8.0`版本进行系统设计；\n\n- 统一注册：支持`Nacos`作为注册中心，实现多配置、分群组、分命名空间、多业务模块的注册和发现功能；\n\n- 统一认证：统一`Oauth2`认证协议，采用jwt的方式，实现统一认证，并支持自定义grant_type实现手机号码登录，第三方登录集成JustAuth实现微信、支付宝等多种登录模式；\n\n- 业务监控：利用`Spring Boot Admin`来监控各个独立Service的运行状态。\n\n- 内部调用：集成了`Feign`和`Dubbo`两种模式支持内部调用，并且可以实现无缝切换，适合新老程序员，快速熟悉项目；\n\n- 业务熔断：采用`Sentinel`实现业务熔断处理，避免服务之间出现雪崩;\n\n- 身份注入：通过注解的方式，实现用户登录信息的快速注入；\n\n- 在线文档：通过接入`Knife4j`，实现在线API文档的查看与调试;\n\n- 代码生成：基于`Mybatis-plus-generator`自动生成代码，提升开发效率，生成模式不断优化中，暂不支持前端代码生成；\n\n- 消息中心：集成消息中间件`RocketMQ`和`Kafka`，对业务进行异步处理;\n\n- 业务分离：采用前后端分离的框架设计，前端采用`vue-element-admin`,商业版采用`antd-pro-vue`\n  \n- 链路追踪：自定义traceId的方式，实现简单的链路追踪功能\n\n- 多租户功能：集成`Mybatis Plus`,实现SAAS多租户功能\n\n## 🗿 文件结构\n```lua\nmatecloud -- 父项目,各模块分离，方便集成和微服务\n│  ├─mate-core -- 核心通用模块，主模块\n│  │  ├─mate-starter-common -- 封装通用模块\n│  │  ├─mate-starter-cloud -- 封装微服务模块\n│  │  ├─mate-starter-auth -- 封装token验证模块\n│  │  ├─mate-starter-security -- 封装OAuth2基础模块\n│  │  ├─mate-starter-web -- 封装WEB服务基础模块\n│  │  ├─mate-starter-database -- 封装Mybatis及数据库基础模块\n│  │  ├─mate-starter-dependencies -- 封装所有依赖模块，可作为父项目独立引用\n│  │  ├─mate-starter-dubbo -- 封装dubbo基础模块\n│  │  ├─mate-starter-feign -- 封装feign基础模块\n│  │  ├─mate-starter-jetcache -- 封装JetCache阿里缓存基础模块\n│  │  ├─mate-starter-rocketmq -- 封装RocketMQ基础模块\n│  │  ├─mate-starter-gray -- 封装灰度发布基础模块\n│  │  ├─mate-starter-elasticsearch -- 封装ElasticSearch模块\n│  │  ├─mate-starter-oss -- 封装oss存储基础模块,支持阿里云、七牛云、minio等\n│  │  ├─mate-starter-log -- 封装日志基础模块\n│  │  ├─mate-starter-sharding -- 封装多数据库基础模块\n│  │  ├─mate-starter-sms -- 封装短信基础模块\n│  │  ├─mate-starter-mail -- 封装邮件模块\n│  │  ├─mate-starter-kafka -- 封装kafka基础模块\n│  │  ├─mate-starter-rule -- 封装黑名单基础模块\n│  │  ├─mate-starter-idempotent -- 封装幂等基础模块\n│  │  ├─mate-starter-lock -- 封装分布式锁基础模块\n│  │  ├─mate-starter-encrypt -- 封装报文加密模块，支持AES和RSA\n│  │  ├─mate-starter-mongodb -- 封装mongodb数据库模块\n│  │  ├─mate-starter-strategy -- 封装策略模块\n│  │  ├─mate-starter-job -- 封装定时任务基础模块\n│  │  ├─mate-starter-validator -- 封装统一检验基础模块\n│  │─mate-gateway -- 统一网关模块 [10001]\n│  │─mate-uaa -- 统一认证中心模块 [20001]\n│  │─mate-platform -- 平台模块项目，目前包含系统子模块\n│  │  ├─mate-system-api -- 系统模块的通用模块，供其他模块引用\n│  │  ├─mate-system -- 系统模块核心功能 [20002]\n│  │  ├─mate-component-api -- 组件模块核心功能，供其他模块引用\n│  │  ├─mate-component -- 组件模块核心功能 [20003]\n│  │─mate-support -- 支持中心项目，目前包括代码生成、admin模块\n│  │  ├─mate-code -- 封装代码生成逻辑 [30002]\n│  │  ├─mate-admin -- 封装spring-boot-admin逻辑 [30001]\n│  │  ├─mate-job -- xxl-jog定时任务模块\n│  │  ├─mate-job-admin -- 定时任务管理平台模块\n│  │─mate-mq -- 消息中心项目，支持kafka、RocketMQ等多种消息中间件\n│  │  ├─mate-log-producer -- 日志消息生产者，集成kafka [40001]\n│  │  ├─mate-message-consumer -- 消息服务消费者 [40002]\n│  │  ├─mate-message-producer -- 消息服务生产者 [40003] \n```\n## 🎨 核心模块提交至中央仓库\n如何引入依赖\n```xml\n\u003cdependencyManagement\u003e\n    \u003cdependencies\u003e\n        \u003cdependency\u003e\n            \u003cgroupId\u003evip.mate\u003c/groupId\u003e\n            \u003cartifactId\u003emate-starter-dependencies\u003c/artifactId\u003e\n            \u003cversion\u003e4.6.8\u003c/version\u003e\n            \u003ctype\u003epom\u003c/type\u003e\n            \u003cscope\u003eimport\u003c/scope\u003e\n        \u003c/dependency\u003e\n    \u003c/dependencies\u003e\n\u003c/dependencyManagement\u003e\n```\n然后在 dependencies 中添加自己所需使用的依赖即可使用。\n\n## 🔥 前端重大更新\n前端采用`Vue 3.2.12`、`Vite 2.5.8`、 `Ant-Design-Vue 2.2.8`、`TypeScript` 的大型中后台解决方案。\n### 👉 技术栈\n- Vue 3.2.45\n- Pinia 2.0.28\n- Vue-i18n 9.1.8\n- Ant-design-vue 2.2.6\n- Axios 1.2.1\n- Vue-router 4.3.8\n- Vite 3.2.5\n### 👉 版本发布\n`4.6.8`版本已经发布，完善了系统管理的基础功能，主要包括菜单管理、用户管理、角色管理、部门管理、日志管理、客户端管理等功能。后续功能正在加紧开发中，欢迎体验。\n\n\n## 🌭 项目源码\n|  项目   |   GITHUB  |   码云   |\n|---  |--- | --- |\n|  MateCloud后端源码   |  https://github.com/matevip/matecloud   |  https://gitee.com/matevip/matecloud   |\n|  Artemis前端源码   |  https://github.com/matevip/artemis   |  https://gitee.com/matevip/artemis   |\n|  MateBoot后端源码   |  https://github.com/matevip/mateboot   |  https://gitee.com/matevip/mateboot   |\n\n## 🥥 微服务项目示例\n\n- 🥥 [https://gitee.com/matevip/mate-demo](https://gitee.com/matevip/mate-demo)\n\n## 🌭 Swagger2 - OpenAPI3\n|  Swagger2      |  OpenAPI3  | 注解位置                         |\n|  ----  | ----  |------------------------------|\n| `@Api`  | @Tag(name = \"接口类描述\") | Controller 类上                |\n| `@ApiOperation`  | @Operation(summary =\"接口方法描述\") | Controller 方法上               |\n| `@ApiImplicitParam`  | @Parameter(description=\"参数描述\") | Controller 方法上 @Parameters 里 |\n| `@ApiImplicitParams`  | @Parameters | Controller 方法上               |\n| `@ApiParam`  | @Parameter(description=\"参数描述\") | Controller 方法的参数上            |\n| `@ApiIgnore`  | @Parameter(hidden = true) 或 @Operation(hidden = true) 或 @Hidden | ----                         |\n| `@ApiModel`  | @Schema\t | Entity类上                     |\n| `@ApiModelProperty`  | @Schema\t | Entity属性上                    |\n## 🍻 贡献者名单\n欢迎提交[PR](https://gitee.com/matevip/matecloud/pulls)一起完善项目，以下为开源项目贡献的战友（排名不分先后）：\n\n@L.cm、@Z先生、@苏慕彦、@简、@madi、@yunfei08、[@hackerdom](https://github.com/aaronuu)\n\n## ✨ 特别鸣谢\n特别感谢卢神对`MateCloud`项目提供的技术支持！\n- 卢春梦: [mica](https://gitee.com/596392912/mica)  \n- anncwb: [vue-vben-admin](https://github.com/anncwb/vue-vben-admin)\n## 📚 开源项目推荐\n- [SpringBoot脚手架](https://gitee.com/bdj/SpringBoot_v2)\n\n","funding_links":[],"categories":["快速开发","Projects Using MyBatis-Plus"],"sub_categories":["SpringCloud","Tutorials"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatevip%2Fmatecloud","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmatevip%2Fmatecloud","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatevip%2Fmatecloud/lists"}