# 架构设计总览

全平台视角请先阅读 架构设计(与 CSDN 整体架构系列文章对应);本页侧重 前端子应用 的分层与能力链路。

G2rain 前端子应用采用分层架构,将业务页面、运行时能力、平台状态与通用工具拆分为清晰的边界:

# 分层结构

# Views Layer(视图层)

  • 业务页面组件
  • API 接口定义

# Runtime Layer(运行时层)

  • HTTP 客户端与拦截器(自动携带 Token,并在需要时构建 DPoP)
  • SSO 认证能力
  • 环境变量管理
  • qiankun 集成适配(主应用传参,子应用初始化)

# Platform Layer(平台层)

  • Pinia Store:统一管理应用状态
  • Boot 模块:资源管理、路由生成、权限控制
  • 类型定义与事件系统

# Shared Layer(共享层)

  • 工具函数
  • JWT 工具
  • 代码生成器 / 配置生成器

# 核心能力链路(从“登录到可见页面”)

  1. 初始化 Token(SSO / OAuth2 回调后生成 JWT)
  2. 通过 HTTP 拦截器携带 Token,并对关键请求绑定 DPoP(防重放)
  3. 启动 Boot:从资源接口加载页面与权限资源
  4. 动态生成路由并注册权限插件
  5. 页面元素权限:v-permission 控制按钮/菜单
  6. API 权限:请求前校验,失败直接阻断

# 下一步