# 架构设计总览
全平台视角请先阅读 架构设计(与 CSDN 整体架构系列文章对应);本页侧重 前端子应用 的分层与能力链路。
G2rain 前端子应用采用分层架构,将业务页面、运行时能力、平台状态与通用工具拆分为清晰的边界:
# 分层结构
# Views Layer(视图层)
- 业务页面组件
- API 接口定义
# Runtime Layer(运行时层)
- HTTP 客户端与拦截器(自动携带 Token,并在需要时构建 DPoP)
- SSO 认证能力
- 环境变量管理
qiankun集成适配(主应用传参,子应用初始化)
# Platform Layer(平台层)
- Pinia Store:统一管理应用状态
- Boot 模块:资源管理、路由生成、权限控制
- 类型定义与事件系统
# Shared Layer(共享层)
- 工具函数
- JWT 工具
- 代码生成器 / 配置生成器
# 核心能力链路(从“登录到可见页面”)
- 初始化 Token(SSO / OAuth2 回调后生成 JWT)
- 通过 HTTP 拦截器携带 Token,并对关键请求绑定 DPoP(防重放)
- 启动 Boot:从资源接口加载页面与权限资源
- 动态生成路由并注册权限插件
- 页面元素权限:
v-permission控制按钮/菜单 - API 权限:请求前校验,失败直接阻断