部署管理控制台

构建

cd apps/muer-admin-console
npm ci
npm run api:generate   # 契约单一来源：contracts/openapi/iam.yaml
npm run type-check
npm run test
npm run build          # 产出 dist/

产物 dist/ 为纯静态文件，可交给 Nginx / Apache / CDN；不需要 Docker。

后端要求

宿主应用只需要启动 muer-spring-boot-starter，并满足：

• MySQL（IAM schema 由迁移脚本管理）与 Redis；
• 宿主实现 IdentityAuthenticator 与 ResourceHierarchyProvider；
• 为控制台管理员准备一个 Profile，其 Template Version 包含所需的 iam.admin.*， Scope 覆盖管理目标。

反向代理示例

Nginx：

location / {
    try_files $uri $uri/ /index.html;   # SPA
}
location /iam/ {
    proxy_pass http://127.0.0.1:8080;
    proxy_set_header Host              $host;
    proxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

生产空库先按初始化第一个管理员完成显式授权引导；不要启用演示 Seeder 或公开匿名 Bootstrap Endpoint。

环境变量

VITE_IAM_API_BASE_URL 用于开发/跨源指向后端；生产默认同源，由上述反向代理转发 /iam/**。