{"id":32115404,"url":"https://github.com/macula-projects/macula-boot","last_synced_at":"2025-10-20T15:56:55.192Z","repository":{"id":41153046,"uuid":"424433296","full_name":"macula-projects/macula-boot","owner":"macula-projects","description":"基于Spring Boot、Spring Cloud Alibaba的微服务开发框架","archived":false,"fork":false,"pushed_at":"2025-09-16T07:14:25.000Z","size":2594,"stargazers_count":27,"open_issues_count":2,"forks_count":10,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-10-20T15:56:43.137Z","etag":null,"topics":["spring","spring-boot","spring-cloud"],"latest_commit_sha":null,"homepage":"https://macula.dev","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/macula-projects.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":"Roadmap.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2021-11-04T01:22:17.000Z","updated_at":"2025-09-10T14:10:03.000Z","dependencies_parsed_at":"2024-08-05T03:43:13.747Z","dependency_job_id":"3ecb6cca-23e6-4b18-be2f-052f0ac2608d","html_url":"https://github.com/macula-projects/macula-boot","commit_stats":null,"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"purl":"pkg:github/macula-projects/macula-boot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/macula-projects%2Fmacula-boot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/macula-projects%2Fmacula-boot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/macula-projects%2Fmacula-boot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/macula-projects%2Fmacula-boot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/macula-projects","download_url":"https://codeload.github.com/macula-projects/macula-boot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/macula-projects%2Fmacula-boot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":280118754,"owners_count":26275307,"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","status":"online","status_checked_at":"2025-10-20T02:00:06.978Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["spring","spring-boot","spring-cloud"],"created_at":"2025-10-20T15:56:51.617Z","updated_at":"2025-10-20T15:56:55.185Z","avatar_url":"https://github.com/macula-projects.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch2 align=\"center\"\u003eMacula Boot\u003c/h2\u003e\n\n\u003cp align=\"center\"\u003e\n\t\u003cstrong\u003e基于Spring Boot、Spring Cloud Alibaba的微服务开发框架\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://github.com/macula-projects/macula-boot/blob/main/LICENSE\" target=\"_blank\"\u003e\n        \u003cimg src=\"https://img.shields.io/github/license/macula-projects/macula-boot.svg\" \u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/macula-projects/macula-boot/actions/workflows/snapshot.yml\"\u003e\n      \u003cimg src=\"https://img.shields.io/github/actions/workflow/status/macula-projects/macula-boot/snapshot.yml?branch=main\u0026logo=github\u0026logoColor=white\" \u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://central.sonatype.com/search?q=macula\u0026smo=true\" target=\"_blank\"\u003e\n        \u003cimg src=\"https://img.shields.io/maven-central/v/dev.macula.boot/macula-boot-starters\" /\u003e\n    \u003c/a\u003e\n    \u003ca\u003e\n        \u003cimg src=\"https://img.shields.io/badge/JDK-1.8+-green.svg\" \u003e\n    \u003c/a\u003e\n    \u003ca\u003e\n        \u003cimg src=\"https://img.shields.io/badge/SpringBoot-2.7+-green.svg\" \u003e\n    \u003c/a\u003e\n    \u003ca\u003e\n        \u003cimg src=\"https://img.shields.io/badge/SpringCloud-2021.x+-green.svg\" \u003e\n    \u003c/a\u003e\n\u003c/p\u003e\n\n## 概述\n\n### 平台简介\n\nMacula是一个微服务应用开发平台，主要包括三大部分：MaculaBoot、MaculaCloud和MaculaCloudAdmin。\n\n- MaculaBoot是微服务应用开发所需要的开发框架（如SpringCloudAlibaba、SpringCloudTecent等），基于众多开源产品进行甄选后轻度封装而成。\n- MaculaCloud是一个微服务架构的通用技术服务体系，一方面可集成对接各大云厂商的微服务治理体系（如腾讯云TSF、阿里云EDAS、百度云CNAP等），\n  另一方面提供大量内置可复用的通用技术服务（如系统管理、消息推送、资源存储、ID生成、任务调度等）。\n- MaculaCloudAdmin是基于VUE的前端项目，与MaculaCloud配套，提供管理界面功能。使用Macula进行微服务架构的应用平台开发，一方面可以统一技术栈，降低管理与维护成本；另一方面可以避免重复造轮子，提升开发效率。\n\n### 整体架构\n\nMacula的整体架构如下图所示：\n\n![image](https://macula.dev/img/structure-diagram.png)\n\n## 主要功能\n\n### Macula Boot\n```\nmacula-boot-parent                                   POM父模块，所有项目的parent\nmacula-boot-commons                                  通用模块，提供返回结构体、助手类、异常封装、常量等\nmacula-boot-docs                                     文档\nmacula-boot-starter\n    01. macula-boot-starter-mapstruct                对象转换\n    02. macula-boot-starter-crypto                   加解密模块\n    03. macula-boot-starter-cache                    多级缓存\n    04. macula-boot-starter-redis                    REDIS（基于Redisson）\n    05. macula-boot-starter-lock4j                   分布式锁\n    06. macula-boot-starter-idempotent               幂等\n    07. macula-boot-starter-leaderelection           基于Redis的Leader选择器\n    08. macula-boot-starter-mybatis-plus             MyBatis Plus\n    09. macula-boot-starter-jpa                      Spring Data JPA集成\n    10. macula-boot-starter-sender                   基于本地数据库发送MQ消息（先落库再异步发MQ）\n    11. macula-boot-starter-rocketmq                 RocketMQ\n    12. macula-boot-starter-liteflow                 可编排的组件引擎\n    13. macula-boot-starter-statemachine             基于Spring StateMachine的状态机\n    14. macula-boot-starter-security                 基于Token的安全校验\n    15. macula-boot-starter-springdoc                Swagger Doc v3\n    16. macula-boot-starter-web                      WEB\n    17. macula-boot-starter-feign                    Feign定制，使用OkHTTP\n    18. macula-boot-starter-seata                    分布式事务\n    19. macula-boot-starter-oss                      资源中心(minio/aliyun/cos/aws s3/本地)\n    20. macula-boot-starter-tinyid                   ID生产\n    21. macula-boot-starter-system                   接入菜单和权限等系统服务\n    22. macula-boot-starter-task                     基于xxljob等的定时任务（类似阿里云的ScheduleX）\n    23. macula-boot-starter-retry                    重试框架\n    24. macula-boot-starter-dubbo                    基于Dubbo的RPC服务\n    25. macula-boot-starter-cloud                    基于Spring Cloud的RPC服务\n        1. macula-boot-starter-gateway               网关定制，基于Oauth2认证，权限控制也集中在网关\n        2. macula-boot-starter-alibaba               基于alibaba spring cloud体系（nacos、sentinel、seata）\n        3. macula-boot-starter-alibaba-scg           基于slibaba的gateway定制\n        4. macula-boot-starter-tencent               基于tencent的polarismesh服务治理体系\n        5. macula-boot-starter-tecent-scg            基于tencent的gateway定制\n        6. macula-boot-starter-tsf                   基于TSF的服务治理体系\n        7. macula-boot-starter-tsf-scg               基于TSF的网关定制\n```\n\n### Macula Cloud\n\n详见[Macula Cloud](https://github.com/macula-projects/macula-cloud)项目\n\n### Macula Cloud\n\n详见[Macula Cloud Admin](https://github.com/macula-projects/macula-cloud-admin)项目\n\n## 编译说明\n\n编译的时候需要指定deploy这个profile，否则revision不会处理\n\n```shell\nmvn clean install -DskipTests=true -Pdeploy\n```\n\n## 技术原理\n\nMacula整体的技术交互与应用原理如下图所示：\n\n![image](https://macula.dev/docs/00_introduce/%E6%A6%82%E8%BF%B0/images/macula-tech-diagram.png)\n\n\n\u003e 说明：Macula特别适用于多产品线（一个产品线对应一个应用平台）的研发团队。\n\n## License\n\nMacula Boot and Macula Cloud is Open Source software released under the Apache 2.0 license.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmacula-projects%2Fmacula-boot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmacula-projects%2Fmacula-boot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmacula-projects%2Fmacula-boot/lists"}