@epxing/core 5.3.0-beta.1 → 5.3.0-beta.3

package/src/navigation-context.js

@@ -0,0 +1,49 @@
+import { effectiveRouteName, findMenuPath, resolveRouteRole } from './menu-route'
+
+const fields = ['moduleId', 'pageId', 'component', 'metaId', 'flag', 'showMenu']
+
+function storageKey (route, menuId, userId) {
+  const name = effectiveRouteName(route.name)
+  if (name !== 'app1' && name !== 'hall') return ''
+  const { client, system, app } = route.params || {}
+  return 'epx_nav_context:' + JSON.stringify([name, client, system, app, resolveRouteRole(route), userId, menuId])
+}
+
+// 只保留导航所需的标识，不序列化标签里的组件实例、回调和业务数据。
+export function saveMenuContext (route, menu, context, userId = '') {
+  const key = storageKey(route, menu.ID, userId)
+  if (!key) return
+  try {
+    if (!context?.moduleId) {
+      window.sessionStorage.removeItem(key)
+      return
+    }
+    const saved = {}
+    for (const field of fields) {
+      const value = context[field]
+      if (typeof value === 'string' || typeof value === 'boolean') saved[field] = value
+    }
+    window.sessionStorage.setItem(key, JSON.stringify(saved))
+  } catch (error) {
+    // 存储被禁用时继续使用现有导航。
+  }
+}
+
+export function readMenuContext (route, menu, menus, userId = '') {
+  const key = storageKey(route, menu.ID, userId)
+  if (!key) return null
+  try {
+    const saved = JSON.parse(window.sessionStorage.getItem(key) || 'null')
+    if (!saved) return null
+    const path = findMenuPath(menus, menu.ID)
+    const root = path.find(item => item.ID === saved.moduleId)
+    // 角色权限、菜单归属或绑定页面变化后，旧上下文不再适用。
+    if (!root || (root.MAIN_PAGE || '') !== (saved.pageId || '')) {
+      window.sessionStorage.removeItem(key)
+      return null
+    }
+    return saved
+  } catch (error) {
+    return null
+  }
+}

package/src/navigation.js

@@ -1,176 +1,208 @@
-// 平台导航服务 $nav（菜单直达 + 激活的单一实现；纯函数层在 menu-route.js，此处依赖 store/router 单例）。
-//
-// 背景：应用内导航（顶部 nav → 标签页 → 模块/菜单栈）原先只活在 Vuex，URL 停在应用级，
-// 刷新即回首页。现在：点击菜单/程序跳转 → activateMenu()（原 $createPage({menuId}) 分支
-// 迁入的单一实现）→ 同步 URL 到 /app/:client/:system/:app/m/:menuKey；刷新/直达/前进后退
-// → activateFromRoute() 反查菜单树走同一条激活路径。
-// 对外经 core/src/install.js 挂 app.config.globalProperties.$nav。
-import { nextTick } from 'vue'
-import { runtimeStore as store, runtimeRouter as router } from './runtime-services'
-import { getMenuKey, findMenuByKey, roleStorage, effectiveRouteName, menuLocation } from './menu-route'
-
-export * from './menu-route'
-
-function findNavId (menus = [], menuId, parent) {
-  for (let i = 0; i < menus.length; i++) {
-    const menu = menus[i]
-    if (menu.ID === menuId) {
-      return { ...menu, parentMenu: parent }
-    } else if (menu.children) {
-      const activeMenu = findNavId(menu.children, menuId, menu)
-      if (activeMenu) return activeMenu
-    }
-  }
-}
-
-// 防「激活→URL push→route watcher→再激活」回环：记录最后一次由激活侧写入的 key
-let lastSyncedKey = null
-
-// 菜单激活的单一实现。**关键：顶级菜单和子菜单走不同的建表参数**——
-//   顶级菜单（直接在 appMenus 里，即顶部导航项）：与 AppNav.toPage 点击**完全一致**的极简
-//     参数 {moduleId, pageId, title}。这类菜单可能自带 MAIN_PAGE（如人事异动既有绑定页面又有
-//     子菜单）——极简参数让 module-index-page 走它的绑定页面；若给了 activeMenuPageId 会被
-//     误判为"下钻到子页面"→ 渲染出自己的侧边菜单 + 绑定页内的侧边菜单 = 两个侧边导航。
-//   子菜单（在某顶级项的 children 里）：需要 activeMenuId/activeMenuPageId 下钻高亮子项。
-export function activateMenu (menuId, extraProps = {}, { syncUrl = true, replaceUrl = false, query } = {}) {
-  const appMenus = store.state.config.appMenus || []
-  const topLevel = appMenus.find(m => m.ID === menuId)
-  let menuNode = null
-  let params = null
-  if (topLevel) {
-    // 顶级菜单：镜像 AppNav.toPage 的建表（不加 activeMenu*/openType，避免误触发子菜单下钻）
-    menuNode = topLevel
-    params = {
-      key: 'default-' + menuId,
-      moduleId: menuId,
-      component: 'module-index-page',
-      title: topLevel.NAME_ALIAS || topLevel.NAME || topLevel.text,
-      pageId: topLevel.MAIN_PAGE,
-      ...extraProps
-    }
-  } else {
-    // 子菜单：定位所属顶部 nav，下钻高亮
-    let navId = null
-    let pageId = ''
-    let activeMenuPageId = extraProps.pageId
-    for (let i = 0; i < appMenus.length; i++) {
-      const menu = findNavId(appMenus[i].children, menuId, appMenus[i])
-      if (menu) {
-        menuNode = menu
-        navId = menu.parent
-        if (menu.parentMenu) pageId = menu.parentMenu.MAIN_PAGE
-        if (!activeMenuPageId) activeMenuPageId = menu.MAIN_PAGE
-        break
-      }
-    }
-    if (!menuNode) return false
-    const moduleId = navId || menuId
-    const props = { ...extraProps }
-    delete props.pageId
-    params = {
-      key: 'default-' + moduleId,
-      openType: '1',
-      title: menuNode.NAME_ALIAS || menuNode.NAME || menuNode.text,
-      moduleId,
-      pageId,
-      activeMenuId: menuId,
-      activeMenuPageId,
-      ...props,
-      component: 'module-index-page'
-    }
-  }
-  store.commit('DESTORY_TAB', params.key)
-  nextTick(() => store.commit('CREATE_TAB', params))
-  if (syncUrl) syncMenuUrl(menuNode, { replace: replaceUrl, query })
-  return true
-}
-
-// 激活后把菜单键写进 URL（push——浏览器前进/后退可在菜单间穿梭；恢复场景用 replace）
-export function syncMenuUrl (menu, { replace = false, query } = {}) {
-  // URL 一律用菜单 ID(32 位 hex——路由参数正则与 app1 的 :role 段消歧的前提);
-  // 编号(MODULE_CODE)仍可作为 toMenu 入参,但不进 URL
-  const key = menu && menu.ID
-  if (!key || !/^[0-9A-Fa-f]{32}$/.test(key)) return
-  const route = router.currentRoute.value
-  const name = effectiveRouteName(route.name)
-  if (name !== 'app1' && name !== 'hall') return // 独立窗口页/manage 等场景不动 URL
-  if (route.params.menuKey === key && query === undefined) return
-  lastSyncedKey = key
-  const loc = menuLocation(route, key, query)
-  ;(replace ? router.replace(loc) : router.push(loc)).catch(() => {})
-}
-
-// 路由跳转失败（重复导航 / 守卫中断）不是业务错误，不该弹用户提示：
-// 具名成常量而不是就地写空 catch，是为了把「有意忽略」写在明面上。
-const ignoreNavFailure = () => {}
-
-// syncMenuUrl 的反向操作：回应用首页时把 URL 上的菜单直达段（/:menuKey）抹掉——
-// 菜单已不再激活，URL 不该继续指向它（刷新/分享会又回到那个菜单）。
-// URL 上本就没有 menuKey 的场景（manage / 独立窗口页 / 本就在首页）直接早退，不动 URL。
-export function clearMenuUrl ({ replace = false } = {}) {
-  const route = router.currentRoute.value
-  if (!route.params || !route.params.menuKey) return
-  const { client, system, app } = route.params
-  const loc = effectiveRouteName(route.name) === 'hall'
-    ? { name: 'hall', params: { client }, query: route.query }
-    : { name: 'app1', params: { client, system, app }, query: route.query }
-  ;(replace ? router.replace(loc) : router.push(loc)).catch(ignoreNavFailure)
-}
-
-// URL → 激活（刷新恢复 / 浏览器前进后退 / 直达链接）。AppIndex 在菜单树就绪后与
-// $route.params.menuKey 变化时调用。找不到（权限变化/编号改了）返回 false 落应用首页。
-export function activateFromRoute (route) {
-  const key = route.params && route.params.menuKey
-  if (!key) return false
-  if (key === lastSyncedKey) { // 自己刚 push 的，无需再激活
-    lastSyncedKey = null
-    return true
-  }
-  const menu = findMenuByKey(store.state.config.appMenus || [], key)
-  if (!menu) {
-    console.warn(`[nav] 菜单直达：找不到 menuKey=${key}（权限变化或编号已改），落应用首页`)
-    return false
-  }
-  return activateMenu(menu.ID, {}, { syncUrl: false })
-}
-
-// URL 上没有 menuKey 时的激活目标：应用首页（已开就选中，没开就用暂存的首页模板按需打开）。
-// activateFromRoute 的对偶——菜单直达把「有 menuKey」这一侧接住了，这一侧接的是「无 menuKey」，
-// 少了它，前进/后退落到无 menuKey 的那一格时地址栏变了、内容还停在上一个菜单上。
-export function activateHome () {
-  const home = store.getters.getTab('default-index') || store.state.tabs.homeTab
-  if (!home) return false
-  if (store.getters.getTab(home.key)) store.commit('SELECT_TAB', home.key)
-  else store.commit('CREATE_TAB', home)
-  return true
-}
-
-// ── $nav 对外表面（组件内 this.$nav.xxx；组件外可直接 import { nav }）──────────
-export const nav = {
-  /** 跳到某菜单（key=编号或 ID）。等同用户点击菜单，URL 一并更新 */
-  toMenu (keyOrId, { replace = false, query } = {}) {
-    const menu = findMenuByKey(store.state.config.appMenus || [], String(keyOrId))
-    if (!menu) {
-      console.warn(`[nav] toMenu：找不到菜单 ${keyOrId}`)
-      return false
-    }
-    return activateMenu(menu.ID, {}, { syncUrl: true, replaceUrl: replace, query })
-  },
-  /** 生成某菜单的可分享 URL（含 /m/:key，不含 role——打开者用自己的角色） */
-  menuUrl (keyOrId, query) {
-    const menu = findMenuByKey(store.state.config.appMenus || [], String(keyOrId))
-    if (!menu) return ''
-    const loc = menuLocation(router.currentRoute.value, getMenuKey(menu), query)
-    return window.location.origin + window.location.pathname + router.resolve(loc).href
-  },
-  /** 当前 URL 上的菜单键（无则 ''） */
-  currentMenuKey () {
-    return (router.currentRoute.value.params || {}).menuKey || ''
-  },
-  getMenuKey,
-  findMenuByKey,
-  /** 角色持久化读写（localStorage，客户+系统维度） */
-  role: roleStorage
-}
-
-export default nav
+// 平台导航服务 $nav（菜单直达 + 激活的单一实现；纯函数层在 menu-route.js，此处依赖 store/router 单例）。
+//
+// 背景：应用内导航（顶部 nav → 标签页 → 模块/菜单栈）原先只活在 Vuex，URL 停在应用级，
+// 刷新即回首页。现在：点击菜单/程序跳转 → activateMenu()（原 $createPage({menuId}) 分支
+// 迁入的单一实现）→ 同步 URL 到 /app/:client/:system/:app/m/:menuKey；刷新/直达/前进后退
+// → activateFromRoute() 反查菜单树走同一条激活路径。
+// 对外经 core/src/install.js 挂 app.config.globalProperties.$nav。
+import { nextTick } from 'vue'
+import { runtimeStore as store, runtimeRouter as router } from './runtime-services'
+import { getMenuKey, getRouteMenuKey, findMenuByKey, roleStorage, resolveRouteRole, effectiveRouteName, menuLocation } from './menu-route'
+import { saveMenuContext, readMenuContext } from './navigation-context'
+
+export * from './menu-route'
+
+function findNavId (menus = [], menuId, parent) {
+  for (let i = 0; i < menus.length; i++) {
+    const menu = menus[i]
+    if (menu.ID === menuId) {
+      return { ...menu, parentMenu: parent }
+    } else if (menu.children) {
+      const activeMenu = findNavId(menu.children, menuId, menu)
+      if (activeMenu) return activeMenu
+    }
+  }
+}
+
+// 防「激活→URL push→route watcher→再激活」回环：记录最后一次由激活侧写入的 key
+let lastSyncedKey = null
+
+// 登录用户在路由守卫中已就绪，详细资料异步加载，不用它作为会话存储的首选标识。
+const navigationUserId = () => store.state.user?.user?.id || store.state.user?.userInfo?.ID || ''
+
+// 菜单激活的单一实现。**关键：顶级菜单和子菜单走不同的建表参数**——
+//   顶级菜单（直接在 appMenus 里，即顶部导航项）：与 AppNav.toPage 点击**完全一致**的极简
+//     参数 {moduleId, pageId, title}。这类菜单可能自带 MAIN_PAGE（如人事异动既有绑定页面又有
+//     子菜单）——极简参数让 module-index-page 走它的绑定页面；若给了 activeMenuPageId 会被
+//     误判为"下钻到子页面"→ 渲染出自己的侧边菜单 + 绑定页内的侧边菜单 = 两个侧边导航。
+//   子菜单（在某顶级项的 children 里）：需要 activeMenuId/activeMenuPageId 下钻高亮子项。
+export function activateMenu (menuId, extraProps = {}, { syncUrl = true, replaceUrl = false, query } = {}) {
+  const appMenus = store.state.config.appMenus || []
+  // 配置中心由专用菜单模板负责导航和上下文，直达时保留原首页容器，不另建普通模块页。
+  if (effectiveRouteName(router.currentRoute.value.name) === 'system') {
+    const menu = findMenuByKey(appMenus, menuId)
+    if (!menu) return false
+    nextTick(activateHome)
+    if (syncUrl) syncMenuUrl(menu, { replace: replaceUrl, query })
+    return true
+  }
+  const topLevel = appMenus.find(m => m.ID === menuId)
+  let menuNode = null
+  let params = null
+  if (topLevel) {
+    // 顶级菜单：镜像 AppNav.toPage 的建表（不加 activeMenu*/openType，避免误触发子菜单下钻）
+    menuNode = topLevel
+    params = {
+      key: 'default-' + menuId,
+      moduleId: menuId,
+      component: 'module-index-page',
+      title: topLevel.NAME_ALIAS || topLevel.NAME || topLevel.text,
+      pageId: topLevel.MAIN_PAGE,
+      ...extraProps
+    }
+  } else {
+    // 子菜单：定位所属顶部 nav，下钻高亮
+    let navId = null
+    let pageId = ''
+    let activeMenuPageId = extraProps.pageId
+    for (let i = 0; i < appMenus.length; i++) {
+      const menu = findNavId(appMenus[i].children, menuId, appMenus[i])
+      if (menu) {
+        menuNode = menu
+        navId = menu.parent
+        if (menu.parentMenu) pageId = menu.parentMenu.MAIN_PAGE
+        if (!activeMenuPageId) activeMenuPageId = menu.MAIN_PAGE
+        break
+      }
+    }
+    if (!menuNode) return false
+    const moduleId = navId || menuId
+    const props = { ...extraProps }
+    delete props.pageId
+    params = {
+      key: 'default-' + moduleId,
+      openType: '1',
+      title: menuNode.NAME_ALIAS || menuNode.NAME || menuNode.text,
+      moduleId,
+      pageId,
+      activeMenuId: menuId,
+      activeMenuPageId,
+      ...props,
+      component: 'module-index-page'
+    }
+  }
+  store.commit('DESTORY_TAB', params.key)
+  nextTick(() => store.commit('CREATE_TAB', params))
+  if (syncUrl) syncMenuUrl(menuNode, { replace: replaceUrl, query, context: params })
+  return true
+}
+
+// 激活后把菜单键写进 URL（push——浏览器前进/后退可在菜单间穿梭；恢复场景用 replace）
+export function syncMenuUrl (menu, { replace = false, query, context } = {}) {
+  // URL 一律用菜单 ID(32 位 hex——路由参数正则与 app1 的 :role 段消歧的前提);
+  // 编号(MODULE_CODE)仍可作为 toMenu 入参,但不进 URL
+  const key = menu && menu.ID
+  if (!key || !/^[0-9A-Fa-f]{32}$/.test(key)) return
+  const route = router.currentRoute.value
+  const name = effectiveRouteName(route.name)
+  if (name !== 'app1' && name !== 'hall' && name !== 'system') return // 独立窗口页/manage 等场景不动 URL
+  saveMenuContext(route, menu, context, navigationUserId())
+  if (getRouteMenuKey(route) === key && query === undefined) return
+  lastSyncedKey = key
+  const loc = menuLocation(route, key, query)
+  ;(replace ? router.replace(loc) : router.push(loc)).catch(() => {})
+}
+
+// 路由跳转失败（重复导航 / 守卫中断）不是业务错误，不该弹用户提示：
+// 具名成常量而不是就地写空 catch，是为了把「有意忽略」写在明面上。
+const ignoreNavFailure = () => {}
+
+// syncMenuUrl 的反向操作：回首页时清除菜单路径段，并兼容配置中心旧的查询参数——
+// 菜单已不再激活，URL 不该继续指向它（刷新/分享会又回到那个菜单）。
+// URL 上本就没有 menuKey 的场景（manage / 独立窗口页 / 本就在首页）直接早退，不动 URL。
+export function clearMenuUrl ({ replace = false } = {}) {
+  const route = router.currentRoute.value
+  if (!getRouteMenuKey(route)) return
+  const { client, system, app } = route.params
+  const name = effectiveRouteName(route.name)
+  const query = { ...route.query }
+  if (name === 'system') delete query.menuKey
+  const loc = name === 'system'
+    ? { name: 'system', params: { client, system, role: resolveRouteRole(route) }, query }
+    : name === 'hall'
+      ? { name: 'hall', params: { client }, query: route.query }
+      : { name: 'app1', params: { client, system, app }, query: route.query }
+  ;(replace ? router.replace(loc) : router.push(loc)).catch(ignoreNavFailure)
+}
+
+// URL → 激活（刷新恢复 / 浏览器前进后退 / 直达链接）。AppIndex 在菜单树就绪后与
+// 当前菜单键变化时调用。找不到（权限变化/编号改了）返回 false 落应用首页。
+export function activateFromRoute (route) {
+  const key = getRouteMenuKey(route)
+  if (!key) return false
+  if (key === lastSyncedKey) { // 自己刚 push 的，无需再激活
+    lastSyncedKey = null
+    return true
+  }
+  const menu = findMenuByKey(store.state.config.appMenus || [], key)
+  if (!menu) {
+    console.warn(`[nav] 菜单直达：找不到 menuKey=${key}（权限变化或编号已改），落应用首页`)
+    return false
+  }
+  const context = readMenuContext(route, menu, store.state.config.appMenus || [], navigationUserId())
+  if (context) {
+    const params = {
+      ...context,
+      key: 'default-' + context.moduleId,
+      component: context.component || 'module-index-page',
+      title: menu.NAME_ALIAS || menu.NAME || menu.text,
+      // 来源容器与目标相同时沿用独立入口，避免额外生成一层侧栏。
+      ...(context.moduleId !== menu.ID ? { activeMenuId: menu.ID, activeMenuPageId: menu.MAIN_PAGE } : {})
+    }
+    store.commit('DESTORY_TAB', params.key)
+    nextTick(() => store.commit('CREATE_TAB', params))
+    return true
+  }
+  return activateMenu(menu.ID, {}, { syncUrl: false })
+}
+
+// URL 上没有 menuKey 时的激活目标：应用首页（已开就选中，没开就用暂存的首页模板按需打开）。
+// activateFromRoute 的对偶——菜单直达把「有 menuKey」这一侧接住了，这一侧接的是「无 menuKey」，
+// 少了它，前进/后退落到无 menuKey 的那一格时地址栏变了、内容还停在上一个菜单上。
+export function activateHome () {
+  const home = store.getters.getTab('default-index') || store.state.tabs.homeTab
+  if (!home) return false
+  if (store.getters.getTab(home.key)) store.commit('SELECT_TAB', home.key)
+  else store.commit('CREATE_TAB', home)
+  return true
+}
+
+// ── $nav 对外表面（组件内 this.$nav.xxx；组件外可直接 import { nav }）──────────
+export const nav = {
+  /** 跳到某菜单（key=编号或 ID）。等同用户点击菜单，URL 一并更新 */
+  toMenu (keyOrId, { replace = false, query } = {}) {
+    const menu = findMenuByKey(store.state.config.appMenus || [], String(keyOrId))
+    if (!menu) {
+      console.warn(`[nav] toMenu：找不到菜单 ${keyOrId}`)
+      return false
+    }
+    return activateMenu(menu.ID, {}, { syncUrl: true, replaceUrl: replace, query })
+  },
+  /** 生成包含菜单 ID 的分享地址；角色由打开者自己的登录上下文恢复。 */
+  menuUrl (keyOrId, query) {
+    const menu = findMenuByKey(store.state.config.appMenus || [], String(keyOrId))
+    if (!menu) return ''
+    const loc = menuLocation(router.currentRoute.value, menu.ID, query)
+    return window.location.origin + window.location.pathname + router.resolve(loc).href
+  },
+  /** 当前 URL 上的菜单键（无则 ''） */
+  currentMenuKey () {
+    return getRouteMenuKey(router.currentRoute.value)
+  },
+  getMenuKey,
+  findMenuByKey,
+  /** 角色持久化读写（localStorage，客户+系统维度） */
+  role: roleStorage
+}
+
+export default nav

package/src/package-install.js

@@ -13,6 +13,7 @@ import I18n from './plugins/i18n'
 import installElementPlus from './plugins/element-plus'
 import { setApp } from './app'
 import { configureRuntime } from './runtime-services'
+import routeComponents from './route-components'
 import { installGlobalMethods } from './mixins/methods-to-prototype'
 import optimizedGlobalMixin from './mixins/optimized-global'
 import loadComponentFactory from './loadComponent'
@@ -27,7 +28,7 @@ export function installCore (app, options = {}) {
   if (installed.has(app)) return installed.get(app)
   const { store, router, http = defaultHttp, plugins = [], components = {} } = options
   if (!store || !router) throw new TypeError('[epx/core] install 需要 store 和 router；可用 createFrameStore() 创建框架 store')
-  configureRuntime({ ...options, http })
+  configureRuntime({ ...options, http, routeComponents: { ...routeComponents, ...options.routeComponents } })
   setApp(app)
   // 存量运行时内部仍有 window 访问，统一在安装阶段桥接，消费方无需手工挂载。
   window.store = store