@axewo/fin-micro 2.0.0 → 2.0.1

package/scaffold/vue/src/layout/StandaloneLayout.vue

@@ -0,0 +1,34 @@
+<script setup lang="ts">
+import { computed } from 'vue'
+import { FinWatermark } from '@axewo/fin-micro/watermark'
+import { watermarkConfig } from '../utils/watermarkConfig'
+import { useRoute, useRouter } from 'vue-router'
+import { createStandaloneMenus, standaloneActiveMenu } from '../router/menu'
+import Header from './Header.vue'
+import Sidebar from './Sidebar.vue'
+
+// 使用 router 实际声明树保留父子关系，不用 getRoutes 的扁平记录重复生成菜单。
+const router = useRouter()
+const route = useRoute()
+const menus = computed(() => createStandaloneMenus(router.options.routes))
+const activeMenu = computed(() => standaloneActiveMenu(route))
+</script>
+
+<template>
+  <div class="standalone-layout">
+    <Header :title="route.meta.title ?? '业务应用'" />
+    <Sidebar :menus="menus" :active-menu="activeMenu" />
+    <!-- App 仅在独立运行时挂载此布局；嵌入时使用基座水印，避免重复。 -->
+    <div class="standalone-viewport">
+      <main class="standalone-content"><slot /></main>
+      <FinWatermark :config="watermarkConfig" />
+    </div>
+  </div>
+</template>
+
+<style scoped>
+.standalone-layout { display: grid; grid-template: 64px minmax(0, 1fr) / 220px minmax(0, 1fr); height: 100vh; height: 100dvh; overflow: hidden; }
+.standalone-viewport { position: relative; isolation: isolate; display: flex; min-width: 0; min-height: 0; overflow: hidden; }
+.standalone-content { flex: 1 1 auto; min-width: 0; min-height: 0; overflow: auto; }
+@media (max-width: 760px) { .standalone-layout { grid-template-columns: 160px minmax(0, 1fr); } }
+</style>

package/scaffold/vue/src/router/index.ts

@@ -1,16 +1,19 @@
 import { createMemoryHistory, createRouter, createWebHashHistory } from 'vue-router'
 import { demoRoutes } from './demo'
+import { List, Tickets } from '@element-plus/icons-vue'
+import './menu'
 
 /** 嵌入模式使用 memory history 不争用宿主 URL；独立模式使用 hash 路由便于静态部署。 */
 export function createMicroRouter(embedded: boolean) {
   return createRouter({
     history: embedded ? createMemoryHistory() : createWebHashHistory(),
     routes: [
-      { path: '/', redirect: '/list' },
-      { path: '/list', component: () => import('../views/ListView.vue') },
-      { path: '/detail', component: () => import('../views/DetailView.vue') },
-      ...demoRoutes,
-      { path: '/:pathMatch(.*)*', component: () => import('../views/NotFoundView.vue') },
+      { path: '/', redirect: '/list', meta: { hidden: true } },
+      { path: '/list', component: () => import('../views/demo/index.vue'), meta: { title: '业务列表', icon: List, order: 10 } },
+      // 详情保留同一业务页面与 SDK，只隐藏菜单入口并高亮所属列表。
+      { path: '/detail', component: () => import('../views/demo/modules/detail/index.vue'), meta: { title: '业务详情', hidden: true, activeMenu: '/list' } },
+      ...demoRoutes.map(route => ({ ...route, meta: { ...route.meta, title: '基础示例', icon: Tickets, order: 20 } })),
+      { path: '/:pathMatch(.*)*', component: () => import('../views/not-found/index.vue'), meta: { title: '页面不存在', hidden: true } },
     ],
   })
 }

package/scaffold/vue/src/router/menu.ts

@@ -0,0 +1,38 @@
+import type { Component } from 'vue'
+import type { RouteLocationNormalizedLoaded, RouteRecordRaw } from 'vue-router'
+
+/** 独立导航只消费本地路由元信息，不表示宿主授权或后台接口权限。 */
+declare module 'vue-router' {
+  interface RouteMeta {
+    title?: string
+    icon?: Component
+    order?: number
+    hidden?: boolean
+    activeMenu?: string
+  }
+}
+
+export interface StandaloneMenu {
+  path: string
+  title: string
+  icon?: Component
+  children: StandaloneMenu[]
+}
+
+/** 按声明层级生成菜单；隐藏父级隐藏整棵子树，无标题分组提升子项。 */
+export function createStandaloneMenus(routes: readonly RouteRecordRaw[], parent = ''): StandaloneMenu[] {
+  return [...routes].sort((left, right) => (left.meta?.order ?? 0) - (right.meta?.order ?? 0)).flatMap(route => {
+    if (route.meta?.hidden || route.path.includes(':')) return []
+    const path = route.path.startsWith('/') ? route.path : `${parent}/${route.path}`.replace(/\/+/g, '/')
+    const children = createStandaloneMenus(route.children ?? [], path)
+    const title = route.meta?.title
+    // 重定向仅在有可见子菜单时充当分组，默认跳转和别名不额外生成入口。
+    if (!title || (route.redirect && children.length === 0)) return children
+    return [{ path, title, icon: route.meta?.icon, children }]
+  })
+}
+
+/** 详情可通过 activeMenu 指向列表；查询和片段不参与菜单身份。 */
+export function standaloneActiveMenu(route: Pick<RouteLocationNormalizedLoaded, 'path' | 'meta'>): string {
+  return route.meta.activeMenu ?? route.path
+}

package/scaffold/vue/src/views/demo/configs/table.ts

@@ -0,0 +1,24 @@
+import type { TableConfig } from '@axewo/fin-ui'
+import type { RecordRow } from '../types'
+
+/** 业务列表的 fin-ui 列、表单和 CRUD 配置；不复制弹窗、删除确认或分页状态机。 */
+export function createRecordTableConfig(onSuccess: () => void): TableConfig {
+  // 内存适配仅用于展示组件 API；每次进入页面独立实例，刷新重置，不能充当业务接口。
+  let rows: RecordRow[] = [{ id: 1, name: '示例记录' }]
+  let nextId = 2
+  return {
+    rowKey: 'id', title: '示例记录', pagination: false,
+    columns: [
+      { field: 'id', label: '编号', width: 100 },
+      { field: 'name', label: '名称', formItem: { component: 'FInput', required: true, componentProps: { maxlength: 80 } } },
+    ],
+    requestConfig: { api: async () => ({ list: rows.map(row => ({ ...row })), total: rows.length }) },
+    crudConfig: {
+      // FCrudTable 统一生成新增/编辑弹框、校验、删除确认及刷新，模板不重复实现。
+      createApi: async data => { rows.push({ id: nextId++, name: String(data.name) }) },
+      updateApi: async data => { rows = rows.map(row => row.id === data.id ? { ...row, name: String(data.name) } : row) },
+      deleteApi: async data => { rows = rows.filter(row => row.id !== data.id) },
+      onSuccess,
+    },
+  }
+}

package/scaffold/vue/src/views/demo/hooks/useRecordNavigation.ts

@@ -0,0 +1,32 @@
+import { ref } from 'vue'
+import { useRouter } from 'vue-router'
+import { useMicroPage, useMicroTab, usePermission } from '@axewo/fin-micro'
+import { useBridgeSession } from '../../../bridge/session'
+import { toSafeError } from '../../../utils/errorUtils'
+
+/**
+ * 统一列表权限、宿主页签 SDK 与独立路由导航，页面只装配业务动作。
+ * 必须在列表组件 setup 内调用，SDK 绑定当前 tab.key；异步返回不能误操作另一页。
+ */
+export function useRecordNavigation() {
+  const { bridge, identity } = useBridgeSession()
+  const canRead = usePermission(identity).can('demo:read')
+  const router = useRouter()
+  const tab = bridge ? useMicroTab() : undefined
+  const sdk = bridge && tab ? useMicroPage(bridge, tab) : undefined
+  const message = ref('')
+
+  /** 错误只展示安全分类文案，不泄漏异常对象、请求体或 Token。 */
+  function reportError(error: unknown): void { message.value = toSafeError(error).message }
+
+  /** 嵌入模式经授权打开同应用详情页签；独立模式由本应用 router 打开。 */
+  async function openDetail(): Promise<void> {
+    try {
+      if (bridge && !canRead.value) { message.value = '403：无权访问详情'; return }
+      if (sdk && bridge) await sdk.openTab({ appId: bridge.appId, tabId: `${bridge.appId}:detail:1`, title: '示例详情 1', route: '/detail?id=1' })
+      else await router.push('/detail?id=1')
+    } catch (error) { reportError(error) }
+  }
+
+  return { bridge, canRead, message, openDetail, reportError }
+}

package/scaffold/vue/src/views/demo/index.vue

@@ -0,0 +1,17 @@
+<script setup lang="ts">
+import { FCrudTable } from '@axewo/fin-ui'
+import { createRecordTableConfig } from './configs/table'
+import { useRecordNavigation } from './hooks/useRecordNavigation'
+
+const { bridge, canRead, message, openDetail, reportError } = useRecordNavigation()
+const tableConfig = createRecordTableConfig(() => { message.value = '演示内存数据已更新（刷新后重置）' })
+</script>
+<template>
+  <section class="panel">
+    <h1>__PROJECT_NAME__</h1>
+    <p>以下 CRUD 为内存示例，非生产业务接口；新增、编辑和删除均使用 fin-ui 内置流程。</p>
+    <div class="actions"><el-button :disabled="Boolean(bridge) && !canRead" @click="openDetail">打开详情页</el-button></div>
+    <p v-if="message" role="status">{{ message }}</p>
+    <FCrudTable :table-config="tableConfig" @error="reportError" />
+  </section>
+</template>

package/scaffold/vue/src/views/{DetailView.vue → demo/modules/detail/index.vue}

@@ -2,8 +2,8 @@
 import { ref } from 'vue'
 import { useRoute, useRouter } from 'vue-router'
 import { useMicroPage, useMicroTab, usePermission } from '@axewo/fin-micro'
-import { useBridgeSession } from '../bridge/session'
-import { toSafeError } from '../utils/errorUtils'
+import { useBridgeSession } from '../../../../bridge/session'
+import { toSafeError } from '../../../../utils/errorUtils'
 const { bridge, identity } = useBridgeSession()
 const permission = usePermission(identity)
 const canRead = permission.can('demo:read')

package/scaffold/vue/src/views/demo/types.ts

@@ -0,0 +1,5 @@
+/** 示例 CRUD 功能私有的内存行类型；生产请求类型优先复用 src/api/{domain}。 */
+export interface RecordRow {
+  id: number
+  name: string
+}

package/scaffold/vue/src/views/ListView.vue

@@ -1,55 +0,0 @@
-<script setup lang="ts">
-import { ref } from 'vue'
-import { useRouter } from 'vue-router'
-import { FCrudTable, type TableConfig } from '@axewo/fin-ui'
-import { useMicroPage, useMicroTab, usePermission } from '@axewo/fin-micro'
-import { useBridgeSession } from '../bridge/session'
-import { toSafeError } from '../utils/errorUtils'
-const { bridge, identity } = useBridgeSession()
-const permission = usePermission(identity)
-const canRead = permission.can('demo:read')
-const router = useRouter()
-// SDK 在 setup 中绑定缓存边界的固定 tab.key；后续异步操作不会误操作另一个活动页。
-const tab = bridge ? useMicroTab() : undefined
-const sdk = bridge && tab ? useMicroPage(bridge, tab) : undefined
-const message = ref('')
-/** 组件异常只展示文本，兼容公开版本未提供强类型事件声明的情况。 */
-function reportError(error: unknown): void { message.value = toSafeError(error).message }
-interface RecordRow { id: number; name: string }
-// 最小内存适配器仅演示组件 API；每个页面独立数据，刷新会重置，生产请替换为真实业务请求。
-let rows: RecordRow[] = [{ id: 1, name: '示例记录' }]
-let nextId = 2
-const tableConfig: TableConfig = {
-  rowKey: 'id', title: '示例记录', pagination: false,
-  columns: [
-    { field: 'id', label: '编号', width: 100 },
-    { field: 'name', label: '名称', formItem: { component: 'FInput', required: true, componentProps: { maxlength: 80 } } },
-  ],
-  requestConfig: { api: async () => ({ list: rows.map(row => ({ ...row })), total: rows.length }) },
-  crudConfig: {
-    // 由 FCrudTable 统一生成新增/编辑弹框及删除确认，不另造重复表单。
-    createApi: async data => { rows.push({ id: nextId++, name: String(data.name) }) },
-    updateApi: async data => { rows = rows.map(row => row.id === data.id ? { ...row, name: String(data.name) } : row) },
-    deleteApi: async data => { rows = rows.filter(row => row.id !== data.id) },
-    onSuccess: () => { message.value = '演示内存数据已更新（刷新后重置）' },
-  },
-}
-
-/** 同应用详情用页面 SDK 打开宿主页签；独立模式才使用普通 router，错误留在原页面。 */
-async function openDetail(): Promise<void> {
-  try {
-    if (bridge && !canRead.value) { message.value = '403：无权访问详情'; return }
-    if (sdk && bridge) await sdk.openTab({ appId: bridge.appId, tabId: `${bridge.appId}:detail:1`, title: '示例详情 1', route: '/detail?id=1' })
-    else await router.push('/detail?id=1')
-  } catch (error) { message.value = toSafeError(error).message }
-}
-</script>
-<template>
-  <section class="panel">
-    <h1>__PROJECT_NAME__</h1>
-    <p>以下 CRUD 为内存示例，非生产业务接口；新增、编辑和删除均使用 fin-ui 内置流程。</p>
-    <div class="actions"><el-button :disabled="Boolean(bridge) && !canRead" @click="openDetail">打开详情页</el-button></div>
-    <p v-if="message" role="status">{{ message }}</p>
-    <FCrudTable :table-config="tableConfig" @error="reportError" />
-  </section>
-</template>