本文档由 g2rain-app-template 的 docs/architecture/runtime-flows.md 自动同步生成。

# 运行时流程

模式判断

• URL ?mode=alone 优先，其次读取 VITE_RUN_MODE=alone。
• 只有 alone 被视为独立运行；空值或其他值都是集成意图。
• 集成意图但未处于 qiankun 时，直链会被包装为 main-shell 网关地址并执行 location.replace。

独立运行

sequenceDiagram
  participant Browser
  participant Main as main.ts
  participant SSO
  participant Boot as runtime/boot
  participant Basis

  Browser->>Main: mode=alone
  Main->>Main: 创建 Vue / Pinia / i18n
  Main->>Boot: 初始化 HTTP 与 Token 过期监听
  Boot->>Basis: GET /basis/authority/resources
  alt 未登录
    Boot->>SSO: redirectToSSO()
  else 已登录
    Basis-->>Boot: pages / elements / endpoints
    Boot->>Main: 生成 Router 并挂载
  end

SSO 回调路径会先使用系统路由挂载回调组件，完成资源初始化后再跳回保存的 return URL。

qiankun 集成运行

sequenceDiagram
  participant Shell as main-shell
  participant Adapter as adapter.qiankun
  participant Main as main.ts
  participant Bridge as shared-auth-bridge
  participant Sub as platform/sub
  participant Token as token.store

  Shell->>Adapter: mount(props)
  Adapter->>Main: handlers.mount(props)
  Main->>Main: resolveSubHostProps（含 initialRoute）
  Main->>Bridge: requestSharedAuth(REQUEST_TOKEN)
  Shell-->>Bridge: TOKEN_RESPONSE(token,tokenKid,client)
  Bridge->>Token: initTokenFromProps（仅内存）
  Main->>Sub: definition.mount(instanceId, context, container)
  Sub->>Sub: initApplicationResources + 资源路由
  Sub->>Sub: settleInitialRoute(initialRoute) 再 Vue mount（避免先闪 /）
  Shell->>Adapter: update(props)
  Main->>Sub: definition.update(locale / initialRoute)
  Shell->>Adapter: unmount(props)
  Main->>Sub: definition.unmount(instanceId)
  Main->>Main: 引用计数减一，最后一个实例才停 Token 监听

实例键必须用 instanceId；appKey 仅作迁移期别名且须等于 instanceId。不要用应用编码当实例键。公开 Context 不含 Token。集成模式在 initApplicationResources 之前必须已有有效认证态（Auth Bridge）；认证失败须抛错，禁止静默空路由。unmount 只释放该实例的 Vue、Router 和 afterEach，不销毁共享 HTTP Client，也不从全局 props 猜测实例。

资源与路由

1. resourceManager 调用 /basis/authority/resources。
2. 页面资源通过 linkPath 在 views/route-map.ts 查找静态组件。
3. 找不到静态映射时，代码会尝试构造动态组件路径；Vite 对任意运行时路径的打包能力有限，因此正式页面应注册到 route-map。
4. 页面元素资源注册到 permission provider，用于 v-permission。
5. hasApiPermission 当前直接返回 true；不能把 API 前端判断当作后端授权。

国际化

• VITE_I18N_TAGS 以逗号分隔，公共 Tag 在前、应用 Tag 在后。
• 独立模式由本地 locale Store 管理并持久化选择。
• 集成模式使用 main-shell 的 locale props，mount/update 时加载对应文案。
• HTTP 请求通过平台 locale 能力附加 Accept-Language。