文档范围:项目技术说明。项目是否发布、架构采用登记和具体环境验收分别维护;本页中的计划、偏差、测试数及未完成项仅适用于其明确记录的事项和版本,不应概括为整个平台尚未实现。当前组件版本见版本与依赖,业务发布范围见业务模块目录。未提供关闭证据的问题仍需按责任项目跟踪。
本文档由 g2rain-admin-shell 的 docs/architecture/overview.md 自动同步生成。
# 架构概览

g2rain-admin-shell(模板源仓名 g2rain-admin-shell)是 G2rain 浏览器统一入口的脚手架基线。它启动 Vue 主应用,初始化主题、状态、路由与会话扩展点,再用 Header / Sidebar / TabBar / Workspace / Footer 承载 Shell 本地页,并为可信微应用目录预留 qiankun RuntimeAdapter。

# 核心责任

  • Shell UI:Header、Sidebar、TabBar、Workspace、Footer。
  • 平台状态:Workspace Tab、RuntimeInstance、Session 摘要、主题。
  • 生命周期扩展点:注册、挂载、更新、卸载、销毁及 per-instanceId 操作队列。
  • 协议扩展点:公开 props、定向消息、Token / Locale 协调(经 @g2rain/platform/main)。
  • 边缘运行:Vite Context Path、Nginx 示例配置。

# 非职责

  • 不实现 Manager / Member 等子应用业务规则。
  • 不替代 IAM Token 签发与 Gateway / 领域服务最终鉴权。
  • 模板默认不注册任何业务微应用 entry;业务入口必须来自可信目录。

生成后的主应用可参考 g2rain-main-shell 补齐 SSO、菜单服务与生产 Nginx/Lua。

Last Updated: 2026-11-04T23:05:57.304Z