create-lumal-admin 0.0.3-beta → 0.0.5-beta

package/templates/base/tests/session.test.ts.template

@@ -0,0 +1,34 @@
+import { describe, expect, it } from 'vitest'
+import { createApplicationSession } from '../src/services/session-runtime'
+
+describe('应用会话', () => {
+  it('统一清理认证、权限、菜单与标签', () => {
+    const values = new Map<string, string>()
+    const storage = {
+      getItem: (key: string) => values.get(key) ?? null,
+      setItem: (key: string, value: string) => { values.set(key, value) },
+      removeItem: (key: string) => { values.delete(key) },
+      clear: () => values.clear(),
+      key: (index: number) => [...values.keys()][index] ?? null,
+      get length() { return values.size },
+    }
+    const app = createApplicationSession(() => ({
+      login: async () => ({ accessToken: 'test-only' }),
+      getUser: async () => ({ id: '1', username: 'test', name: 'Test' }),
+      getAccess: async () => ({ roles: ['admin'], permissions: ['read'] }),
+      getMenus: async () => [],
+      logout: async () => {},
+      clearCache: () => {},
+      list: async () => ({ items: [], total: 0 }),
+      save: async () => {},
+      remove: async () => {},
+    }), storage, storage)
+    app.session.setSession({ accessToken: 'test-only' })
+    app.permissionStore.setPermissions(['read'])
+    storage.setItem(app.tabStorageKey, 'old-tabs')
+    app.reset()
+    expect(app.isAuthenticated()).toBe(false)
+    expect(app.permissionStore.permissions).toEqual([])
+    expect(storage.getItem(app.tabStorageKey)).toBeNull()
+  })
+})

package/templates/base/tsconfig.json

@@ -0,0 +1,22 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "jsx": "preserve",
+    "useDefineForClassFields": true,
+    "baseUrl": ".",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "paths": { "@/*": ["src/*"] },
+    "resolveJsonModule": true,
+    "ignoreDeprecations": "6.0",
+    "types": ["vite/client", "node"],
+    "strict": true,
+    "isolatedModules": true,
+    "skipLibCheck": true
+  },
+  "include": [
+    "src/**/*.ts",
+    "src/**/*.vue",
+    "vite.config.ts"
+  ]
+}

package/templates/base/vite.config.ts

@@ -0,0 +1,54 @@
+import { fileURLToPath, URL } from 'node:url'
+import vue from '@vitejs/plugin-vue'
+import { defineConfig } from 'vite'
+
+/***********************应用开发配置*********************/
+export default defineConfig({
+  plugins: [vue()],
+  // manifest 用于核对路由懒加载和初始资源体积。
+  build: {
+    manifest: true,
+    chunkSizeWarningLimit: 500,
+    rolldownOptions: {
+      output: {
+        codeSplitting: {
+          groups: [
+            {
+              entriesAware: true,
+              maxSize: 420 * 1024,
+              name: 'vendor-element-plus',
+              priority: 40,
+              test: /node_modules[\\/]element-plus[\\/]/,
+            },
+            {
+              entriesAware: true,
+              maxSize: 420 * 1024,
+              name: 'vendor-vue',
+              priority: 30,
+              test: /node_modules[\\/](?:@vue|vue|vue-router)[\\/]/,
+            },
+            {
+              entriesAware: true,
+              maxSize: 420 * 1024,
+              name: 'vendor-lumal',
+              priority: 20,
+              test: /node_modules[\\/]@lumal[\\/]/,
+            },
+            {
+              entriesAware: true,
+              maxSize: 420 * 1024,
+              name: 'vendor',
+              priority: 10,
+              test: /node_modules[\\/]/,
+            },
+          ],
+        },
+      },
+    },
+  },
+  resolve: {
+    alias: {
+      '@': fileURLToPath(new URL('./src', import.meta.url)),
+    },
+  },
+})

package/templates/base/vitest.config.ts

@@ -0,0 +1,3 @@
+import { defineConfig } from 'vitest/config'
+
+export default defineConfig({ test: { environment: 'node' } })

package/templates/features/examples/src/modules/examples.ts

@@ -0,0 +1,10 @@
+import type { FeatureModule } from '../router/views'
+
+export const menus: FeatureModule['menus'] = [
+  { path: '/examples/form', name: 'SchemaFormExample', component: 'examples/form', meta: { title: 'Schema 表单', keepAlive: true } },
+  { path: '/examples/crud', name: 'CrudExample', component: 'examples/crud', meta: { title: 'CRUD 示例', keepAlive: true } },
+]
+export const views: FeatureModule['views'] = {
+  'examples/form': () => import('../views/examples/FormExampleView.vue'),
+  'examples/crud': () => import('../views/examples/CrudExampleView.vue'),
+}

package/templates/features/examples/src/views/examples/CrudExampleView.vue

@@ -0,0 +1,30 @@
+<script setup lang="ts">
+import type { CrudDataSource, SchemaTableRow } from '@lumal/core/components'
+import { LumalCrudTable } from '@lumal/core/components'
+
+/***********************隔离的 CRUD 示例数据*********************/
+let rows: SchemaTableRow[] = [{ id: 'example', name: '示例记录', status: 'enabled' }]
+const columns = [{ field: 'name', label: '名称' }, { field: 'status', label: '状态' }]
+const dataSource: CrudDataSource = {
+  fetch: async ({ page, pageSize, query }) => {
+    const filtered = rows.filter(row => String(row.name).includes(String(query.keyword ?? '')))
+    return { items: filtered.slice((page - 1) * pageSize, page * pageSize), total: filtered.length }
+  },
+  create: async (model) => { rows = [...rows, { ...model, id: crypto.randomUUID() }] },
+  update: async (row, model) => { rows = rows.map(item => item.id === row.id ? { ...model, id: row.id } : item) },
+  remove: async (row) => { rows = rows.filter(item => item.id !== row.id) },
+}
+</script>
+
+<template>
+  <main class="lumal-admin-page">
+    <LumalCrudTable
+      title="CRUD 示例"
+      :data-source="dataSource"
+      :table="{ columns, rowKey: 'id', showColumnSettings: true, selection: true }"
+      :query="{ schemas: [{ field: 'keyword', label: '关键词', component: 'input' }] }"
+      :form-schemas="[{ field: 'name', label: '名称', component: 'input', required: true }, { field: 'status', label: '状态', component: 'select', options: [{ label: '启用', value: 'enabled' }, { label: '停用', value: 'disabled' }], defaultValue: 'enabled' }]"
+      :toolbar="{ export: true, refresh: true }"
+    />
+  </main>
+</template>

package/templates/features/examples/src/views/examples/FormExampleView.vue

@@ -0,0 +1,25 @@
+<script setup lang="ts">
+import type { SchemaFormItem, SchemaFormModel } from '@lumal/core/components'
+import { LumalSchemaForm } from '@lumal/core/components'
+import { ElMessage } from 'element-plus'
+import { shallowRef } from 'vue'
+
+/***********************Schema 与联动*********************/
+const model = shallowRef<SchemaFormModel>({})
+const schemas: SchemaFormItem[] = [
+  { field: 'name', label: '名称', required: true, component: 'input' },
+  { field: 'date', label: '日期', component: 'date', componentProps: { valueFormat: 'YYYY-MM-DD' } },
+  { field: 'notify', label: '邮件通知', component: 'switch' },
+  { field: 'email', label: '邮箱', component: 'input', hidden: ({ model }) => !model.notify, required: ({ model }) => Boolean(model.notify), rules: [{ type: 'email', message: '请输入有效邮箱' }] },
+]
+function submit(): void {
+  ElMessage.success('保存成功')
+}
+</script>
+
+<template>
+  <main class="lumal-admin-page">
+    <h1>Schema 表单</h1>
+    <LumalSchemaForm v-model="model" :schemas="schemas" :columns="2" show-actions show-reset @submit="submit" />
+  </main>
+</template>

package/templates/features/system/src/business/system/entities.ts

@@ -0,0 +1,93 @@
+import type { SchemaFormItem, SchemaTableColumn } from '@lumal/core/components'
+import { localMenus } from '../../router/views'
+
+export interface EntityDefinition {
+  title: string
+  resource: string
+  permission: string
+  schemas: SchemaFormItem[]
+  columns: SchemaTableColumn[]
+  create?: boolean
+  remove?: boolean
+}
+const status: SchemaFormItem = {
+  field: 'status',
+  label: '状态',
+  component: 'select',
+  defaultValue: 'enabled',
+  options: [{ label: '启用', value: 'enabled' }, { label: '停用', value: 'disabled' }],
+}
+function input(field: string, label: string, required = true): SchemaFormItem {
+  return { field, label, required, component: 'input' }
+}
+function define(resource: string, permission: string, title: string, schemas: SchemaFormItem[]): EntityDefinition {
+  return {
+    title,
+    resource,
+    permission,
+    schemas,
+    columns: schemas.map(schema => ({
+      field: schema.field,
+      label: schema.label,
+      options: schema.component === 'select' && Array.isArray(schema.options) ? schema.options : undefined,
+    })),
+  }
+}
+
+// 保持应用侧字段契约；页面与 HTTP adapter 都不依赖演示应用源码。
+export const entities: EntityDefinition[] = [
+  define('users', 'system:user', '用户管理', [
+    { ...input('username', '用户名'), editDisabled: true },
+    input('nickname', '昵称'),
+    input('phone', '手机号', false),
+    input('organizationId', '机构 ID', false),
+    { field: 'roles', label: '角色', component: 'select', componentProps: { multiple: true }, defaultValue: ['guest'], options: [{ label: '管理员', value: 'admin' }, { label: '运营', value: 'operator' }, { label: '访客', value: 'guest' }] },
+    status,
+  ]),
+  define('roles', 'system:role', '角色管理', [
+    input('name', '角色名称'),
+    { ...input('code', '角色编码'), editDisabled: true },
+    input('description', '说明', false),
+    status,
+    {
+      field: 'permissions',
+      label: '授权权限',
+      component: 'checkbox',
+      defaultValue: [],
+      options: [...new Set(localMenus.flatMap((menu) => {
+        const prefix = String(menu.meta?.permissionPrefix ?? '')
+        return prefix ? ['list', 'view', 'create', 'update', 'delete', 'authorize'].map(action => `${prefix}:${action}`) : []
+      }))].map(value => ({ label: value, value })),
+    },
+  ]),
+  define('menus', 'system:menu', '菜单管理', [
+    input('title', '标题'),
+    input('path', '路径'),
+    input('name', '路由名'),
+    { ...input('component', '组件白名单键'), required: ({ model }) => model.type === 'menu', hidden: ({ model }) => model.type !== 'menu' },
+    input('parentId', '父节点 ID', false),
+    input('permission', '权限标识', false),
+    { field: 'type', label: '类型', component: 'select', defaultValue: 'menu', options: [{ label: '目录', value: 'directory' }, { label: '页面', value: 'menu' }, { label: '按钮', value: 'button' }] },
+    { field: 'order', label: '排序', component: 'number', defaultValue: 0 },
+    { field: 'hidden', label: '隐藏菜单', component: 'switch', defaultValue: false },
+  ]),
+  define('organizations', 'system:organization', '机构管理', [input('name', '机构名称'), input('code', '机构编码'), input('parentId', '父机构 ID', false), input('leader', '负责人', false), status]),
+  define('dictionaries/types', 'system:dict', '字典管理', [input('name', '字典名称'), input('code', '字典编码'), input('description', '说明', false), status]),
+  define('dictionaries/items', 'system:dict', '字典项管理', [
+    input('typeCode', '字典编码'),
+    input('label', '显示名称'),
+    input('value', '值'),
+    input('color', '颜色', false),
+    { field: 'order', label: '排序', component: 'number', defaultValue: 0 },
+    status,
+  ]),
+  {
+    ...define('config', 'system:config', '系统配置', [
+      { ...input('key', '配置键'), disabled: true },
+      input('value', '配置值'),
+      input('description', '说明', false),
+    ]),
+    create: false,
+    remove: false,
+  },
+]

package/templates/features/system/src/modules/system.ts

@@ -0,0 +1,28 @@
+import type { LumalMenuRecord } from '@lumal/core/router'
+import type { FeatureModule } from '../router/views'
+
+const definitions = [
+  ['users', 'user', '用户管理'],
+  ['roles', 'role', '角色管理'],
+  ['menus', 'menu', '菜单管理'],
+  ['organizations', 'organization', '机构管理'],
+  ['dictionaries/types', 'dict', '字典管理'],
+  ['dictionaries/items', 'dict', '字典项管理'],
+  ['config', 'config', '系统配置'],
+]
+export const menus: LumalMenuRecord[] = definitions.map(([resource, code, title]) => ({
+  component: `system/${resource}`,
+  name: `System-${resource!.replaceAll('/', '-')}`,
+  path: `/system/${resource}`,
+  meta: {
+    title,
+    resource,
+    permissionPrefix: `system:${code}`,
+    authority: [`system:${code}:${code === 'config' ? 'view' : 'list'}`],
+    keepAlive: true,
+  },
+}))
+export const views: FeatureModule['views'] = Object.fromEntries(definitions.map(([resource]) => [
+  `system/${resource}`,
+  () => import('../views/system/SystemEntityView.vue'),
+]))

package/templates/features/system/src/views/system/SystemEntityView.vue

@@ -0,0 +1,85 @@
+<script setup lang="ts">
+import type { CrudDataSource, SchemaFormItem, SchemaFormOption, SchemaTableRow } from '@lumal/core/components'
+import { LumalCrudTable } from '@lumal/core/components'
+import { ElAlert } from 'element-plus'
+import { computed, shallowRef, useTemplateRef, watch } from 'vue'
+import { useRoute } from 'vue-router'
+import { entities } from '../../business/system/entities'
+import { permissionStore, service } from '../../services/session'
+
+/***********************业务模块配置*********************/
+const route = useRoute()
+// RouterView 按路径缓存实例；离开页面后不能读取新路由并切换本实例的数据源。
+const entity = entities.find(item => `/system/${item.resource}` === route.path)
+if (!entity)
+  throw new Error('未注册的系统模块')
+const tableRef = useTemplateRef<InstanceType<typeof LumalCrudTable>>('tableRef')
+const can = (action: string) => permissionStore.hasPermission(`${entity.permission}:${action}`)
+const table = computed(() => ({ columns: entity.columns, showColumnSettings: true, rowKey: 'id', selection: true }))
+const actions = computed(() => ({ view: true, edit: can('update'), remove: entity.remove !== false && can('delete') }))
+const toolbar = computed(() => ({ create: entity.create !== false && can('create'), batchDelete: false, refresh: true, export: true }))
+const querySchemas = computed(() => [
+  { field: 'keyword', label: '关键词', component: 'input' as const },
+  ...(entity.resource === 'dictionaries/items' ? [{ field: 'typeCode', label: '字典编码', component: 'input' as const }] : []),
+])
+const operationError = shallowRef('')
+function handleOperationError(error: unknown): void {
+  operationError.value = error instanceof Error ? error.message : String(error)
+}
+
+/***********************业务引用数据*********************/
+const roleOptions = shallowRef<SchemaFormOption[]>()
+const schemas = computed<SchemaFormItem[]>(() => entity.schemas.map(schema =>
+  schema.field === 'roles' && roleOptions.value ? { ...schema, options: roleOptions.value } : schema))
+watch(() => entity.resource, async (resource, _previous, onCleanup) => {
+  let active = true
+  onCleanup(() => {
+    active = false
+  })
+  if (resource !== 'users' || !permissionStore.hasPermission('system:role:list'))
+    return
+  try {
+    const result = await service.list('roles', { page: 1, pageSize: 1000, query: {} })
+    if (active)
+      roleOptions.value = result.items.filter(row => row.status !== 'disabled').map(row => ({ label: String(row.name ?? row.code), value: String(row.code) }))
+  }
+  catch (error) {
+    // 引用数据失败应进入应用错误边界，不能把加载失败伪装成空角色。
+    if (active)
+      throw error
+  }
+}, { immediate: true })
+
+/***********************真实应用数据源*********************/
+function id(row: SchemaTableRow): string {
+  if (typeof row.id !== 'string' && typeof row.id !== 'number')
+    throw new Error('业务记录缺少主键 id')
+  return String(row.id)
+}
+const dataSource: CrudDataSource = {
+  fetch: input => service.list(entity.resource, input),
+  create: model => service.save(entity.resource, model),
+  update: (row, model) => service.save(entity.resource, model, id(row)),
+  remove: row => service.remove(entity.resource, id(row)),
+}
+defineExpose({ reload: () => tableRef.value?.reload() })
+</script>
+
+<template>
+  <main class="lumal-admin-page">
+    <ElAlert v-if="operationError" :title="operationError" type="error" role="alert" closable @close="operationError = ''" />
+    <LumalCrudTable
+      ref="tableRef"
+      :key="entity.resource"
+      :title="entity.title"
+      :table="table"
+      :form-schemas="schemas"
+      :data-source="dataSource"
+      :query="{ schemas: querySchemas, columns: 3 }"
+      :actions="actions"
+      :toolbar="toolbar"
+      :editor="{ type: 'dialog', columns: 2 }"
+      @operation-error="handleOperationError"
+    />
+  </main>
+</template>

package/templates/modes/http/src/services/data-source.ts

@@ -0,0 +1,120 @@
+import type { ApplicationService, ServiceContext } from './contracts'
+import { createRequestClient, RequestError } from '@lumal/core/request'
+import { createHttpAdapter } from './http-adapter'
+
+export const demoAccount: { username: string, password: string } | null = null
+
+export function createHttpBackend(context: ServiceContext, baseURL: string, adapterName = 'standard'): ApplicationService {
+  const adapter = createHttpAdapter(adapterName)
+  const publicRequest = createRequestClient({
+    baseURL,
+    onRequest() {
+      if (!baseURL.trim())
+        throw new Error('未配置 VITE_API_BASE_URL，请先接入真实后端')
+    },
+    onResponse: <T>({ data, init }: { data: unknown, init: RequestInit }) => {
+      init.signal?.throwIfAborted()
+      return adapter.parseResponse(data) as T
+    },
+  })
+  const request = createRequestClient({
+    baseURL,
+    duplicateSubmit: true,
+    getToken: () => context.getSession()?.accessToken,
+    onRequest({ init }) {
+      if (!baseURL.trim())
+        throw new Error('未配置 VITE_API_BASE_URL，请先接入真实后端')
+      init.signal = init.signal ? AbortSignal.any([init.signal, context.getSignal()]) : context.getSignal()
+      const token = context.getSession()?.accessToken
+      if (!token || new Headers(init.headers).get('Authorization') !== `Bearer ${token}`)
+        throw new RequestError('会话已切换', { kind: 'cancelled' })
+    },
+    onResponse: <T>({ data, init }: { data: unknown, init: RequestInit }) => {
+      init.signal?.throwIfAborted()
+      return adapter.parseResponse(data) as T
+    },
+    authRefresh: {
+      async refresh({ init }) {
+        const refreshToken = context.getSession()?.refreshToken
+        if (!refreshToken)
+          throw new Error('缺少刷新凭据')
+        const result = await publicRequest.post('/auth/refresh', { body: { refreshToken }, signal: init.signal ?? undefined })
+        init.signal?.throwIfAborted()
+        if (context.getSession()?.refreshToken !== refreshToken)
+          throw new DOMException('会话已切换', 'AbortError')
+        context.setSession(adapter.parseSession(result))
+      },
+    },
+    onSessionExpired: context.expire,
+  })
+  return {
+    login: async (input, signal) => adapter.parseSession(await publicRequest.post('/auth/login', { body: { ...input }, signal })),
+    getUser: async signal => adapter.parseUser(await request.get('/session/me', { signal })),
+    getAccess: async signal => adapter.parseAccess(await request.get('/session/access', { signal })),
+    getMenus: async signal => adapter.parseMenus(await request.get(adapter.menusPath, { signal })),
+    logout: async (accessToken) => {
+      await publicRequest.post('/auth/logout', { headers: { Authorization: `Bearer ${accessToken}` } })
+    },
+    clearCache() {
+      publicRequest.clearCache()
+      request.clearCache()
+    },
+    async list(resource, input) {
+      const result = await request.get(`/system/${resource}`, {
+        query: { page: input.page, pageSize: input.pageSize, ...input.query } as Record<string, string | number>,
+      })
+      if (resource === 'config' && adapter.configMode === 'object') {
+        if (!result || typeof result !== 'object' || Array.isArray(result))
+          throw new Error('系统配置响应必须是对象')
+        const items = Object.entries(result).map(([key, value]) => ({ id: key, key, value: String(value) }))
+        return { items, total: items.length }
+      }
+      // Mock 的树形 / 字典接口不分页，显式在应用 adapter 边界转换。
+      if (adapterName === 'lumal-mock' && Array.isArray(result)) {
+        const flatten = (rows: Record<string, unknown>[]): Record<string, unknown>[] => rows.flatMap(row => [
+          { ...row, children: undefined },
+          ...(Array.isArray(row.children) ? flatten(row.children) : []),
+        ])
+        const items = flatten(result)
+        const keyword = String(input.query.keyword ?? '').trim()
+        const filtered = items.filter(row => !keyword || Object.values(row).some(value => String(value).includes(keyword)))
+        return { items: filtered.slice((input.page - 1) * input.pageSize, input.page * input.pageSize), total: filtered.length }
+      }
+      const page = adapter.parsePage(result)
+      if (resource === 'roles' && adapterName === 'lumal-mock') {
+        page.items = await Promise.all(page.items.map(async row => ({
+          ...row,
+          permissions: await request.get(`/system/roles/${encodeURIComponent(String(row.code))}/permissions`),
+        })))
+      }
+      return page
+    },
+    async save(resource, model, id) {
+      if (resource === 'config' && adapter.configMode === 'object') {
+        if (!id)
+          throw new Error('系统配置只允许更新已存在的配置键')
+        const current = await request.get<Record<string, unknown>>('/system/config')
+        if (!(id in current))
+          throw new Error('配置键不存在')
+        const original = current[id]
+        const value = typeof original === 'boolean'
+          ? String(model.value) === 'true'
+          : typeof original === 'number' ? Number(model.value) : String(model.value ?? '')
+        return request.put('/system/config', { body: { [id]: value } })
+      }
+      const saved = id
+        ? await request.put(`/system/${resource}/${encodeURIComponent(id)}`, { body: model })
+        : await request.post(`/system/${resource}`, { body: model })
+      if (resource === 'roles' && adapterName === 'lumal-mock' && Array.isArray(model.permissions))
+        await request.put(`/system/roles/${encodeURIComponent(String(model.code))}/permissions`, { body: { permissions: model.permissions } })
+      return saved
+    },
+    remove: async (resource, id) => {
+      await request.delete(`/system/${resource}/${encodeURIComponent(id)}`)
+    },
+  }
+}
+
+export function createBackend(context: ServiceContext): ApplicationService {
+  return createHttpBackend(context, import.meta.env.VITE_API_BASE_URL ?? '', import.meta.env.VITE_API_ADAPTER || 'standard')
+}

package/templates/modes/http/src/services/http-adapter.ts

@@ -0,0 +1,124 @@
+import type { AuthSessionData } from '@lumal/core/auth'
+import type { LumalMenuRecord } from '@lumal/core/router'
+import type { AccessSnapshot, CurrentUser, PageResult } from './contracts'
+import { parseAuthSession } from '@lumal/core/auth'
+import { createStandardResponseParser, parsePageResult } from '@lumal/core/request'
+import { localMenus, viewComponents } from '../router/views'
+
+export interface HttpAdapter {
+  parseResponse: (data: unknown) => unknown
+  parseSession: (data: unknown) => AuthSessionData
+  parseUser: (data: unknown) => CurrentUser
+  parseAccess: (data: unknown) => AccessSnapshot
+  parseMenus: (data: unknown) => LumalMenuRecord[]
+  parsePage: (data: unknown) => PageResult
+  menusPath: string
+  configMode?: 'object'
+}
+
+function record(value: unknown): Record<string, unknown> {
+  if (!value || typeof value !== 'object' || Array.isArray(value))
+    throw new Error('后端返回了无效对象')
+  return value as Record<string, unknown>
+}
+function strings(value: unknown): string[] {
+  if (!Array.isArray(value) || value.some(item => typeof item !== 'string'))
+    throw new Error('角色和权限必须是字符串数组')
+  return value
+}
+function parseUser(value: unknown): CurrentUser {
+  const raw = record(value)
+  if (!['id', 'name', 'username'].every(key => typeof raw[key] === 'string' && raw[key]))
+    throw new Error('当前用户缺少 id/name/username')
+  return { id: String(raw.id), name: String(raw.name), username: String(raw.username) }
+}
+function parseAccess(value: unknown): AccessSnapshot {
+  const raw = record(value)
+  return { roles: strings(raw.roles), permissions: strings(raw.permissions) }
+}
+function parseMenus(value: unknown): LumalMenuRecord[] {
+  if (!Array.isArray(value))
+    throw new Error('菜单响应必须是数组')
+  const visit = (items: unknown[]): LumalMenuRecord[] => items.map((item) => {
+    const raw = record(item)
+    if (typeof raw.path !== 'string' || !raw.path.startsWith('/'))
+      throw new Error('菜单 path 必须是站内绝对路径')
+    if (raw.component && (typeof raw.component !== 'string' || !viewComponents[raw.component]))
+      throw new Error(`菜单组件不在白名单中：${String(raw.component)}`)
+    return {
+      path: raw.path,
+      name: typeof raw.name === 'string' ? raw.name : undefined,
+      component: typeof raw.component === 'string' ? raw.component : undefined,
+      redirect: typeof raw.redirect === 'string' ? raw.redirect : undefined,
+      meta: raw.meta ? record(raw.meta) : undefined,
+      children: Array.isArray(raw.children) ? visit(raw.children) : undefined,
+    }
+  })
+  return visit(value)
+}
+
+// 默认直接消费标准 JSON。特定后端包装仅在显式选择的应用 adapter 中处理。
+export function createHttpAdapter(name = 'standard'): HttpAdapter {
+  const standard: HttpAdapter = {
+    parseResponse: value => value,
+    parseSession: parseAuthSession,
+    parseUser,
+    parseAccess,
+    parseMenus,
+    parsePage: value => Array.isArray(value) ? { items: value, total: value.length } : parsePageResult(value),
+    menusPath: '/menus',
+  }
+  if (name === 'standard')
+    return standard
+  if (name !== 'lumal-mock')
+    throw new Error(`未知 HTTP adapter：${name}`)
+  const unwrap = createStandardResponseParser({
+    fieldNames: { code: 'statusCode', data: 'result', message: 'resultMsg' },
+    successCodes: ['0000'],
+    sessionExpiredCodes: ['AUTH_EXPIRED'],
+  })
+  return {
+    ...standard,
+    // Lumal Mock 是显式接入示例，不能影响标准模式的协议。
+    parseResponse: data => unwrap({ data } as Parameters<typeof unwrap>[0]),
+    parseSession: value => parseAuthSession(value, { fieldNames: { accessToken: 'access_token', refreshToken: 'refresh_token', expiresAt: 'expire_time' } }),
+    parsePage: value => Array.isArray(value) ? { items: value, total: value.length } : parsePageResult(value, { fieldNames: { items: 'records', total: 'totalNum' } }),
+    menusPath: '/menu',
+    configMode: 'object',
+    parseAccess(value) {
+      const access = parseAccess(value)
+      // 此后端以 view 权限管理配置更新；只在显式 adapter 中映射应用权限。
+      return {
+        ...access,
+        permissions: access.permissions.includes('system:config:view')
+          ? [...new Set([...access.permissions, 'system:config:update'])]
+          : access.permissions,
+      }
+    },
+    parseMenus(value) {
+      // 参考 Mock 包含图表等额外演示页面，只映射当前预设声明的页面。
+      if (!Array.isArray(value))
+        throw new Error('Mock 菜单响应必须是数组')
+      const supported = new Map(localMenus.map(menu => [menu.component, menu]))
+      const visit = (items: unknown[]): LumalMenuRecord[] => items.flatMap((item) => {
+        const raw = record(item)
+        const component = raw.viewPath === 'system/dict' ? 'system/dictionaries/types' : String(raw.viewPath ?? '')
+        const selected = supported.get(component)
+        return [
+          ...(selected
+            ? [{
+                ...selected,
+                meta: {
+                  ...selected.meta,
+                  title: String(raw.menuName ?? selected.meta?.title),
+                  authority: strings(raw.authCode ?? []),
+                },
+              }]
+            : []),
+          ...(Array.isArray(raw.nodes) ? visit(raw.nodes) : []),
+        ]
+      })
+      return visit(value)
+    },
+  }
+}