谷雨开源 SaaS 平台（G2rain）
本文档由 g2rain-manager-app 的 docs/architecture/overview.md 自动同步生成。
# 架构概览

本项目采用 g2rain frontend-app 1.0.0 (opens new window) 正式基线。中央 Profile 管理跨 App 的分层、运行、生成与安全规则；本页描述 g2rain-manager-app 的具体落地。

g2rain-manager-app 是平台管理控制台的 Vue 3 微前端子应用，承载账号与用户、机构与角色、资源权限、应用授权、身份提供方、服务注册和审计等管理用例。它负责前端交互、页面路由、权限呈现和平台运行时接入，不拥有后端领域数据。相对中央基线的当前偏差见架构偏差。

# 系统关系

flowchart LR
  User[用户浏览器] --> Shell[g2rain-main-shell]
  Shell -->|qiankun props| App[g2rain-manager-app]
  User -->|mode=alone| App
  App -->|认证接口| IAM[g2rain-iam]
  App -->|业务 API / 资源接口| Gateway[g2rain Gateway]
  Gateway --> Services[IAM / Basis / Infra / Department 等服务]
  • 集成模式由 main-shell 加载子应用并传递 Token、Client、语言和初始路由。
  • 独立模式由子应用自行发起 SSO，并在获得 Token 后加载应用资源。
  • 业务服务通过 Gateway 暴露；IAM 的认证接口走独立代理路径。
  • /basis/authority/resources 返回页面、页面元素和 API 端点，运行时据此组装路由与权限。

# 应用内部

flowchart TD
  Main[main.ts / App.vue] --> Views[views]
  Main --> Runtime[runtime]
  Main --> Platform[platform]
  Views --> Runtime
  Views --> Platform
  Views --> Components[components]
  Runtime --> Platform
  Runtime --> Components
  Platform --> Components
  Components --> Shared[shared]
  Runtime --> Shared
  Platform --> Shared

图中表示目标依赖。当前源码存在 components/platform 对上层的反向引用，以及 runtime 对 views 注册表的直接引用，详见架构偏差。

# 核心事实

  • src/main.ts 是组合根，负责双模式判断、Vue/Pinia/i18n/Element Plus 装配和 qiankun 生命周期注册。
  • src/platform/apps/adapter.qiankun.ts 当前承载 qiankun mount/update/unmount 协调。
  • src/runtime/boot 在 Token 可用后初始化 HTTP、资源、权限和路由。
  • src/views/route-map.ts 是后端页面资源 linkPath 到前端组件的静态注册表。
  • src/shared/generator 和 src/shared/config-util 是构建期工具，不参与浏览器业务运行时。

# 职责边界

本仓库负责平台管理界面、前端用例和本应用运行时，不负责：

  • main-shell 的菜单、Tab 和子应用注册管理。
  • IAM 的 Token 签发与 Gateway 的后端鉴权。
  • Basis、Infra、Department 等服务的数据所有权和后端业务校验。
  • 在本项目文档中静默修改或覆盖中央 Frontend App 公共规则。