vome-core 0.0.1

package/src/admin/lib/module.ts

@@ -0,0 +1,112 @@
+import type { ViewLoader, ViewsTreeNode } from '../../../typings/admin/vome/module'
+
+/** 视图重扫事件：保存 views 触发 HMR 后派发，选择器监听刷新 */
+export const VIEWS_RESCAN_EVENT = 'vome:views-rescan'
+
+const viewMap = new Map<string, ViewLoader>()
+
+
+function rebuildViewMap(files: Record<string, ViewLoader>) {
+  viewMap.clear()
+  for (const [file, loader] of Object.entries(files)) {
+    if (file.includes('/components/')) continue
+    const m = file.match(/modules\/.+\.vue$/)
+    if (!m) continue
+    const rel = m[0].replace(/\.vue$/, '').replace(/\/index$/, '')
+    viewMap.set(rel, loader)
+  }
+}
+
+/** 宿主注册业务视图 glob（包内无法扫描宿主 modules） */
+export function registerViews(
+  files: Record<string, () => Promise<{ default: import('vue').Component }>>,
+) {
+  rebuildViewMap(files)
+  if (typeof window !== 'undefined') {
+    window.dispatchEvent(new CustomEvent(VIEWS_RESCAN_EVENT))
+  }
+}
+
+/** 解析菜单 viewPath，如 modules/base/views/menu */
+export function resolveView(viewPath: string | null | undefined): ViewLoader | undefined {
+  if (!viewPath) return undefined
+  const normalized = viewPath
+    .replace(/^\/+/, '')
+    .replace(/\.vue$/, '')
+    .replace(/\/index$/, '')
+  return (
+    viewMap.get(normalized) ||
+    viewMap.get(`modules/${normalized.replace(/^modules\//, '')}`)
+  )
+}
+
+/**
+ * viewPath → 页面组件 name
+ * modules/base/views/role → base-role
+ * modules/user/views/info → user-info
+ */
+export function viewPathToName(viewPath: string | null | undefined): string | undefined {
+  if (!viewPath) return undefined
+  const normalized = viewPath
+    .replace(/^\/+/, '')
+    .replace(/\.vue$/, '')
+    .replace(/\/index$/, '')
+  const m = normalized.match(/^(?:modules\/)?([^/]+)\/views\/(.+)$/)
+  if (m) return `${m[1]}-${m[2]!.replace(/\//g, '-')}`
+  return undefined
+}
+
+export function listViews() {
+  return [...viewMap.keys()].sort()
+}
+
+/**
+ * 将扁平 viewPath 建成多列树（展示从 modules/ 后分段）
+ * modules/base/views/menu → base > views > menu
+ */
+export function listViewsTree(): ViewsTreeNode[] {
+  const root: ViewsTreeNode[] = []
+
+  for (const full of listViews()) {
+    const parts = full.replace(/^modules\//, '').split('/').filter(Boolean)
+    if (!parts.length) continue
+
+    let level = root
+    let acc = 'modules'
+    for (let i = 0; i < parts.length; i++) {
+      const label = parts[i]!
+      acc += `/${label}`
+      const isLeaf = i === parts.length - 1
+      let node = level.find((n) => n.label === label)
+      if (!node) {
+        node = {
+          label,
+          value: isLeaf ? full : acc,
+          isLeaf,
+          children: isLeaf ? undefined : [],
+        }
+        level.push(node)
+      } else if (isLeaf) {
+        node.isLeaf = true
+        node.value = full
+        node.children = undefined
+      }
+      if (!isLeaf) {
+        if (!node.children) node.children = []
+        level = node.children
+      }
+    }
+  }
+
+  const sortTree = (nodes: ViewsTreeNode[]) => {
+    nodes.sort((a, b) => {
+      if (!!a.isLeaf !== !!b.isLeaf) return a.isLeaf ? 1 : -1
+      return a.label.localeCompare(b.label)
+    })
+    for (const n of nodes) {
+      if (n.children?.length) sortTree(n.children)
+    }
+  }
+  sortTree(root)
+  return root
+}

package/src/admin/lib/tree.ts

@@ -0,0 +1,2 @@
+/** 树工具：同构实现见 @vome-core */
+export { deepTree, flattenTree } from '../../shared/tree'

package/src/admin/lib/upload.ts

@@ -0,0 +1,102 @@
+import type { UploadFileType, UploadRule } from '../../../typings/admin/comm/upload'
+
+/** 默认上传规则 */
+export const DEFAULT_UPLOAD_RULES: UploadRule[] = [
+  {
+    name: '图片',
+    type: 'image',
+    color: '#67C23A',
+    exts: ['bmp', 'jpg', 'jpeg', 'png', 'tif', 'gif', 'svg', 'webp'],
+  },
+  {
+    name: '视频',
+    type: 'video',
+    color: '#826aec',
+    exts: ['avi', 'wmv', 'mpg', 'mpeg', 'mov', 'rm', 'ram', 'swf', 'flv', 'mp4', '3gp'],
+  },
+  {
+    name: '音频',
+    type: 'audio',
+    color: '#826aec',
+    exts: ['mp3', 'wav', 'wma', 'mp2', 'flac', 'midi', 'ra', 'ape', 'aac', 'cda'],
+  },
+  {
+    name: '文档',
+    type: 'word',
+    color: '#53B7F4',
+    exts: ['doc', 'docx', 'docm', 'dot', 'dotx', 'dotm'],
+  },
+  {
+    name: '表格',
+    type: 'excel',
+    color: '#53D39C',
+    exts: ['xls', 'xlsx', 'xlsm', 'xlt', 'xltx', 'xltm'],
+  },
+  {
+    name: '演示',
+    type: 'ppt',
+    color: '#F56C6C',
+    exts: ['ppt', 'pptx', 'pptm', 'ppsx', 'ppsm', 'pps', 'potx', 'potm', 'dpt', 'dps'],
+  },
+  {
+    name: 'PDF',
+    type: 'pdf',
+    color: '#8f3500',
+    exts: ['pdf'],
+  },
+  {
+    name: '压缩包',
+    type: 'rar',
+    color: '#FFC757',
+    exts: ['rar', 'zip', '7z', 'tar', 'gz'],
+  },
+  {
+    name: '文件',
+    type: 'file',
+    color: '#909399',
+    exts: [],
+  },
+]
+
+export function extname(path = '') {
+  const m = String(path).split('?')[0]?.match(/\.([^.]+)$/)
+  return m ? m[1].toLowerCase() : ''
+}
+
+export function filename(path = '') {
+  const base = String(path).split('?')[0]?.split('/').pop() || ''
+  const ext = extname(base)
+  return ext ? base.slice(0, -(ext.length + 1)) : base
+}
+
+export function fileRule(path?: string, rules = DEFAULT_UPLOAD_RULES) {
+  if (path?.includes('data:image/')) {
+    return rules.find((r) => r.type === 'image')!
+  }
+  const ext = extname(path || '')
+  const hit = rules.find((r) => r.exts.includes(ext))
+  return hit || rules.find((r) => r.type === 'file')!
+}
+
+export function getFileType(path: string, rules = DEFAULT_UPLOAD_RULES): UploadFileType {
+  return fileRule(path, rules).type
+}
+
+export function getUploadRule(type: string, rules = DEFAULT_UPLOAD_RULES) {
+  return rules.find((r) => r.type === type) || rules[rules.length - 1]!
+}
+
+export function getUrls(list: Array<{ url?: string }>) {
+  return list.map((e) => String(e.url || '').replace(/,/g, encodeURIComponent(',')))
+}
+
+export function pathJoin(...parts: string[]) {
+  return parts
+    .map((p) => p.replace(/(^\/+|\/+$)/g, ''))
+    .filter(Boolean)
+    .join('/')
+}
+
+export function uploadUid() {
+  return `${Date.now()}_${Math.random().toString(36).slice(2, 9)}`
+}

package/src/admin/router/index.ts

@@ -0,0 +1,61 @@
+import { createRouter, createWebHistory } from 'vue-router'
+import { api, clearTokens, getAccessToken, getRefreshToken } from '../api/client'
+import { clearMenuRoutesFlag, ensureMenuRoutes } from './menu-routes'
+import Home from '#vome-host/pages/home/index.vue'
+import Layout from '#vome-host/pages/layout/index.vue'
+import Login from '#vome-host/pages/login/index.vue'
+
+export const router = createRouter({
+  history: createWebHistory(),
+  routes: [
+    {
+      path: '/login',
+      name: 'login',
+      component: Login,
+      meta: { public: true },
+    },
+    {
+      path: '/',
+      name: 'layout',
+      component: Layout,
+      children: [
+        {
+          path: '',
+          name: 'home',
+          component: Home,
+          meta: { title: '首页' },
+        },
+      ],
+    },
+  ],
+})
+
+let menusReady = false
+
+router.beforeEach(async (to) => {
+  if (to.meta.public) return true
+  // 无 access 时若仍有 refresh，交给 perms 请求内自动续期
+  if (!getAccessToken() && !getRefreshToken()) {
+    return { name: 'login', query: { redirect: to.fullPath } }
+  }
+  if (!menusReady) {
+    try {
+      const authz = await api.perms({ toast: false })
+      await ensureMenuRoutes(router, authz.menus)
+      menusReady = true
+      if (to.matched.length <= 1 && to.path !== '/') {
+        return { ...to, replace: true }
+      }
+    } catch {
+      menusReady = false
+      clearTokens()
+      return { name: 'login', query: { redirect: to.fullPath } }
+    }
+  }
+  return true
+})
+
+export function resetMenuRoutesFlag() {
+  menusReady = false
+  clearMenuRoutesFlag()
+}

package/src/admin/router/menu-routes.ts

@@ -0,0 +1,126 @@
+import type { Router, RouteRecordRaw } from 'vue-router'
+import { defineComponent, h } from 'vue'
+import { resolveView, viewPathToName } from '../lib/module'
+import MissingView from '#vome-host/pages/missing/index.vue'
+import MicroAppView from '#vome-host/pages/micro/index.vue'
+
+/** 已挂载的动态菜单路由名 menu-${id} */
+const addedNames = new Set<string>()
+
+function isMicroMenu(m: MenuTreeNode) {
+  return Boolean(m.appKey && m.router)
+}
+
+function walk(nodes: MenuTreeNode[], out: MenuTreeNode[]) {
+  for (const n of nodes) {
+    if (n.type === 1 && n.router) out.push(n)
+    if (n.children?.length) walk(n.children, out)
+  }
+}
+
+function missingView(viewPath: string) {
+  return defineComponent({
+    name: 'MissingViewPage',
+    setup() {
+      return () => h(MissingView, { path: viewPath })
+    },
+  })
+}
+
+function routeNameOf(id: number | string) {
+  return `menu-${id}`
+}
+
+function buildRoute(item: MenuTreeNode): RouteRecordRaw {
+  const full = item.router!
+  const childPath = full.replace(/^\//, '')
+  let component: RouteRecordRaw['component']
+  const componentName = viewPathToName(item.viewPath)
+  const meta: Record<string, unknown> = {
+    title: item.name,
+    keepAlive: item.keepAlive !== false,
+    viewPath: item.viewPath,
+    perms: item.perms,
+    componentName,
+  }
+
+  if (isMicroMenu(item)) {
+    component = MicroAppView
+    meta.appKey = item.appKey
+    meta.componentName = `micro-${item.appKey}`
+    meta.keepAlive = false
+  } else if (item.viewPath) {
+    const loader = resolveView(item.viewPath)
+    component = loader || missingView(item.viewPath)
+  } else {
+    component = missingView(full)
+  }
+
+  return {
+    path: childPath,
+    name: routeNameOf(item.id),
+    component,
+    meta,
+  }
+}
+
+/** 根据权限菜单动态挂载：viewPath 本地模块 / appKey 微应用（仅补新增） */
+export async function ensureMenuRoutes(router: Router, menus: MenuTreeNode[]) {
+  const items: MenuTreeNode[] = []
+  walk(menus, items)
+
+  for (const item of items) {
+    const name = routeNameOf(item.id)
+    if (addedNames.has(name)) continue
+    addedNames.add(name)
+    router.addRoute('layout', buildRoute(item))
+  }
+}
+
+/** 全量同步：删旧补新，菜单改名/改路由/显隐后侧栏与路由一致 */
+export async function syncMenuRoutes(router: Router, menus: MenuTreeNode[]) {
+  const items: MenuTreeNode[] = []
+  walk(menus, items)
+  const nextNames = new Set(items.map((i) => routeNameOf(i.id)))
+
+  for (const name of [...addedNames]) {
+    if (!nextNames.has(name)) {
+      if (router.hasRoute(name)) router.removeRoute(name)
+      addedNames.delete(name)
+    }
+  }
+
+  for (const item of items) {
+    const name = routeNameOf(item.id)
+    const childPath = item.router!.replace(/^\//, '')
+    if (addedNames.has(name) && router.hasRoute(name)) {
+      const existing = router.getRoutes().find((r) => r.name === name)
+      if (existing && existing.path.replace(/^\//, '') !== childPath) {
+        router.removeRoute(name)
+        addedNames.delete(name)
+      } else if (existing?.meta) {
+        existing.meta.title = item.name
+        existing.meta.keepAlive = item.keepAlive !== false
+        existing.meta.viewPath = item.viewPath
+        existing.meta.perms = item.perms
+        if (item.appKey) existing.meta.appKey = item.appKey
+        continue
+      }
+    }
+    if (!addedNames.has(name)) {
+      addedNames.add(name)
+      router.addRoute('layout', buildRoute(item))
+    }
+  }
+}
+
+export function clearMenuRoutesFlag() {
+  addedNames.clear()
+}
+
+export function removeAllMenuRoutes(router: Router) {
+  for (const name of [...addedNames]) {
+    if (router.hasRoute(name)) router.removeRoute(name)
+  }
+  addedNames.clear()
+}

package/src/admin/service/base.ts

@@ -0,0 +1,96 @@
+import { request } from '../api/client'
+/** 系统时间由后端维护；所有方法请求体都不传 */
+function stripTimeMeta(data: unknown): unknown {
+  if (Array.isArray(data)) return data.map((item) => stripTimeMeta(item))
+  if (data && typeof data === 'object') {
+    const out = { ...(data as Record<string, unknown>) }
+    delete out.createTime
+    delete out.updateTime
+    return out
+  }
+  return data
+}
+
+/** BaseService：namespace + request + 标准 CRUD */
+export class BaseService {
+  namespace?: string
+
+  constructor(namespace?: string) {
+    if (namespace) this.namespace = namespace.replace(/^\//, '')
+  }
+
+  async request(options: ServiceRequestOptions = {}) {
+    let url = options.url || ''
+
+    if (url && !/^https?:\/\//.test(url)) {
+      if (this.namespace) {
+        const ns = this.namespace.startsWith('/')
+          ? this.namespace
+          : `/${this.namespace}`
+        url = url.startsWith('/') ? `${ns}${url}` : `${ns}/${url}`
+      }
+      if (!url.startsWith('/')) url = `/${url}`
+    }
+
+    const method = (options.method || 'GET').toUpperCase()
+    if (method === 'GET') {
+      const params = options.params || {}
+      const q = new URLSearchParams()
+      for (const [k, v] of Object.entries(params)) {
+        if (v == null) continue
+        q.set(k, String(v))
+      }
+      const qs = q.toString()
+      return request(qs ? `${url}?${qs}` : url)
+    }
+
+    return request(url, {
+      method,
+      body: JSON.stringify(stripTimeMeta(options.data ?? {})),
+    })
+  }
+
+  page(data: Record<string, unknown> = {}) {
+    return this.request({ url: '/page', method: 'POST', data }) as Promise<{
+      list: Record<string, unknown>[]
+      pagination: { page: number; size: number; total: number }
+    }>
+  }
+
+  list(data: Record<string, unknown> = {}) {
+    return this.request({
+      url: '/list',
+      method: 'POST',
+      data,
+    }) as Promise<Record<string, unknown>[]>
+  }
+
+  info(params: { id: number | string }) {
+    return this.request({
+      url: '/info',
+      method: 'GET',
+      params: params as Record<string, unknown>,
+    }) as Promise<Record<string, unknown>>
+  }
+
+  add(data: Record<string, unknown> | Record<string, unknown>[]) {
+    return this.request({ url: '/add', method: 'POST', data })
+  }
+
+  update(data: Record<string, unknown> | Record<string, unknown>[]) {
+    return this.request({ url: '/update', method: 'POST', data })
+  }
+
+  delete(
+    data:
+      | { ids: Array<number | string>; force?: boolean }
+      | Array<number | string>
+      | Array<Record<string, unknown>>,
+  ) {
+    return this.request({ url: '/delete', method: 'POST', data })
+  }
+
+  restore(data: { ids: Array<number | string> }) {
+    return this.request({ url: '/restore', method: 'POST', data })
+  }
+}