快速开始

准备好 Git 和 Docker Compose v2，按下面两步启动平台与 Alibaba 示例链路。

1. 下载并启动 Macula Cloud

git clone https://github.com/macula-projects/macula-cloud.git
cd macula-cloud
cp deploy/.env.example deploy/.env
./deploy/scripts/compose.sh up-apps

启动完成后，访问管理端 http://127.0.0.1:5900/。平台提供 IAM 登录认证、用户、菜单和权限管理；本机端口等配置可在 deploy/.env 中调整。

2. 下载 Macula Boot，启动 Examples

回到上一级目录，下载框架并启动示例：

cd ..
git clone https://github.com/macula-projects/macula-boot.git
cd macula-boot/macula-boot-examples/docker
cp .env.example .env
./scripts/compose.sh up-apps alibaba

该命令启动示例所需的中间件，并依次启动 Provider、Consumer、Gateway。示例网关通过 .env 中的 MACULA_CLOUD_IAM_URL 连接第一步的 IAM，默认适用于同机部署。

通过网关调用回声接口，验证整条链路：

curl "http://127.0.0.1:5000/consumer/api/v1/consumer/echo/demo?str=hello"

这个演示接口已配置免认证，用于先验证服务调用是否连通。

三个关键模块

请求 → Gateway → Consumer（BFF）→ Provider（Service）

模块	职责与关键配置
Gateway（`alibaba-gateway`）	统一路由入口，验证 IAM Token，并向下游传递内部 JWT；配置 IAM introspection 地址。
Consumer（`alibaba-consumer`，BFF）	聚合前端接口，通过 Feign 调用 Provider；获取平台菜单、用户信息时，配置指向 Macula Cloud 网关的 `macula.cloud.endpoint` 和应用凭据。
Provider（`alibaba-provider1`，Service）	提供业务接口，实现具体业务逻辑。Consumer 与 Provider 均通过 `jwk-set-uri` 配置示例网关的 `/oauth2/jwks`，验证内部 JWT。

模块目录均位于 macula-boot-examples/ 下，完整名称以 macula-example- 开头。需要 IDE 启动或更多示例时，参考 Examples README；认证配置见安全架构，正式业务开发见开发指引。