openxiangda-cli 2.0.0-alpha.68 → 2.0.0-alpha.70

package/template/apps/web/src/platform-client.ts

@@ -8,6 +8,9 @@ import {
   type DataQuery,
   type DataRecord,
   type DataResourceSurface,
+  type DataTransactionOperation,
+  type DataTransactionRequest,
+  type DataTransactionResult,
   type DirectoryEntryPage,
   type DirectoryResolveRequest,
 } from 'openxiangda-contracts/browser';
@@ -15,7 +18,7 @@ import { applicationCode, runtimeMount } from './runtime-meta';
 import { useSyncExternalStore } from 'react';
 
 interface PlatformEnvelope<T> {
-  code: number;
+  code: number | string;
   message?: string;
   errorCode?: string;
   requestId?: string;
@@ -27,22 +30,22 @@ const globalRequestListeners = new Set<() => void>();
 
 function beginGlobalRequest() {
   globalRequestCount += 1;
-  globalRequestListeners.forEach(listener => listener());
+  globalRequestListeners.forEach((listener) => listener());
 }
 
 function endGlobalRequest() {
   globalRequestCount = Math.max(0, globalRequestCount - 1);
-  globalRequestListeners.forEach(listener => listener());
+  globalRequestListeners.forEach((listener) => listener());
 }
 
 export function useGlobalRequestLoading() {
   return useSyncExternalStore(
-    listener => {
+    (listener) => {
       globalRequestListeners.add(listener);
       return () => globalRequestListeners.delete(listener);
     },
     () => globalRequestCount > 0,
-    () => false,
+    () => false
   );
 }
 
@@ -59,12 +62,19 @@ async function request<T>(path: string, init?: RequestInit): Promise<T> {
       },
     });
     const payload = (await response.json().catch(() => null)) as PlatformEnvelope<T> | T | null;
-    const envelope = payload && typeof payload === 'object' && 'code' in payload ? payload as PlatformEnvelope<T> : null;
+    const envelope = payload && typeof payload === 'object' && 'code' in payload ? (payload as PlatformEnvelope<T>) : null;
     if (!response.ok || (envelope && envelope.code !== 200)) {
       const requestId = envelope?.requestId ? ` (requestId: ${envelope.requestId})` : '';
-      throw new Error(`${envelope?.errorCode || `HTTP_${response.status}`}: ${envelope?.message || '平台请求失败'}${requestId}`);
+      throw Object.assign(
+        new Error(`${envelope?.errorCode || `HTTP_${response.status}`}: ${envelope?.message || '平台请求失败'}${requestId}`),
+        {
+          code: envelope?.errorCode || `HTTP_${response.status}`,
+          status: response.status,
+          data: envelope?.data ?? null,
+        }
+      );
     }
-    return envelope ? envelope.data : payload as T;
+    return envelope ? envelope.data : (payload as T);
   } finally {
     endGlobalRequest();
   }
@@ -103,8 +113,15 @@ let activeIdentity: RuntimeIdentity | undefined;
 export async function loadCurrentIdentity(): Promise<RuntimeIdentity> {
   const mount = runtimeMount();
   if (mount) {
-    const current = await request<DeployedCurrent>(`${nativeBase()}/current-user?environmentKey=${encodeURIComponent(mount.environmentKey)}`);
-    if (current.schemaVersion !== 'openxiangda.current-user/v2' || current.appCode !== mount.appCode || current.environment.key !== mount.environmentKey || current.principal.type !== 'user') {
+    const current = await request<DeployedCurrent>(
+      `${nativeBase()}/current-user?environmentKey=${encodeURIComponent(mount.environmentKey)}`
+    );
+    if (
+      current.schemaVersion !== 'openxiangda.current-user/v2' ||
+      current.appCode !== mount.appCode ||
+      current.environment.key !== mount.environmentKey ||
+      current.principal.type !== 'user'
+    ) {
       throw new Error('OPENXIANGDA_DEPLOYED_CURRENT_USER_INVALID');
     }
     activeIdentity = { ...current.principal, environment: current.environment };
@@ -131,29 +148,49 @@ function currentEnvironmentKey() {
 export type DirectoryKind = 'user' | 'department';
 
 export async function searchDirectory(kind: DirectoryKind, options: { keyword: string; cursor?: string }) {
-  const params = new URLSearchParams({ environmentKey: currentEnvironmentKey(), keyword: options.keyword.trim(), limit: '20' });
+  const params = new URLSearchParams({
+    environmentKey: currentEnvironmentKey(),
+    keyword: options.keyword.trim(),
+    limit: '20',
+  });
   if (options.cursor) params.set('cursor', options.cursor);
   return request<DirectoryEntryPage>(`${nativeBase().replace(/\/native$/, '')}/directory/${kind}s?${params}`);
 }
 
 export async function browseDepartmentTree(options: { parentId?: string; cursor?: string }) {
-  const params = new URLSearchParams({ environmentKey: currentEnvironmentKey(), limit: '100' });
+  const params = new URLSearchParams({
+    environmentKey: currentEnvironmentKey(),
+    limit: '100',
+  });
   if (options.parentId) params.set('parentId', options.parentId);
   if (options.cursor) params.set('offset', options.cursor);
   return request<DirectoryEntryPage>(`${nativeBase().replace(/\/native$/, '')}/directory/departments/tree?${params}`);
 }
 
 export async function browseDepartmentUsers(departmentId: string, page = 1) {
-  const params = new URLSearchParams({ environmentKey: currentEnvironmentKey(), page: String(page), limit: '20' });
-  return request<DirectoryEntryPage>(`${nativeBase().replace(/\/native$/, '')}/directory/departments/${encodeURIComponent(departmentId)}/users?${params}`);
+  const params = new URLSearchParams({
+    environmentKey: currentEnvironmentKey(),
+    page: String(page),
+    limit: '20',
+  });
+  return request<DirectoryEntryPage>(
+    `${nativeBase().replace(/\/native$/, '')}/directory/departments/${encodeURIComponent(departmentId)}/users?${params}`
+  );
 }
 
 export async function resolveDirectory(kind: DirectoryKind, ids: string[]) {
   const uniqueIds = [...new Set(ids)];
   if (uniqueIds.length === 0) throw new Error('OPENXIANGDA_DIRECTORY_RESOLVE_IDS_REQUIRED');
   if (uniqueIds.length > 50) throw new Error('OPENXIANGDA_DIRECTORY_RESOLVE_IDS_EXCEEDED');
-  const body: DirectoryResolveRequest = { schemaVersion: SCHEMA_VERSIONS.directoryResolveRequest, kind, ids: uniqueIds };
-  return request<DirectoryEntryPage>(`${nativeBase().replace(/\/native$/, '')}/directory/resolve?environmentKey=${encodeURIComponent(currentEnvironmentKey())}`, { method: 'POST', body: JSON.stringify(body) });
+  const body: DirectoryResolveRequest = {
+    schemaVersion: SCHEMA_VERSIONS.directoryResolveRequest,
+    kind,
+    ids: uniqueIds,
+  };
+  return request<DirectoryEntryPage>(
+    `${nativeBase().replace(/\/native$/, '')}/directory/resolve?environmentKey=${encodeURIComponent(currentEnvironmentKey())}`,
+    { method: 'POST', body: JSON.stringify(body) }
+  );
 }
 
 export async function searchResource(resourceCode: string, labelField: string, options: { keyword: string; cursor?: string }) {
@@ -161,14 +198,32 @@ export async function searchResource(resourceCode: string, labelField: string, o
   const offset = options.cursor ? Number(options.cursor) : 0;
   const query: DataQuery = {
     schemaVersion: SCHEMA_VERSIONS.dataQuery,
-    filters: options.keyword.trim() ? [{ field: labelField, operator: 'ilike', value: `%${options.keyword.trim()}%` }] : [],
+    filters: options.keyword.trim()
+      ? [
+          {
+            field: labelField,
+            operator: 'ilike',
+            value: `%${options.keyword.trim()}%`,
+          },
+        ]
+      : [],
     order: [{ field: labelField, direction: 'asc' }],
     limit: pageSize,
     offset: Number.isSafeInteger(offset) && offset >= 0 ? offset : 0,
   };
-  const page = await request<DataPage<Record<string, unknown>>>(`${dataBase(resourceCode)}/query`, { method: 'POST', body: JSON.stringify({ ...query, environmentKey: currentEnvironmentKey() }) });
+  const page = await request<DataPage<Record<string, unknown>>>(`${dataBase(resourceCode)}/query`, {
+    method: 'POST',
+    body: JSON.stringify({
+      ...query,
+      environmentKey: currentEnvironmentKey(),
+    }),
+  });
   return {
-    items: page.items.map(item => ({ id: String(item.id), label: String(item[labelField] ?? item.id), selectable: true })),
+    items: page.items.map((item) => ({
+      id: String(item.id),
+      label: String(item[labelField] ?? item.id),
+      selectable: true,
+    })),
     nextCursor: page.items.length >= pageSize ? String(page.offset + page.items.length) : null,
   };
 }
@@ -176,10 +231,18 @@ export async function searchResource(resourceCode: string, labelField: string, o
 export async function resolveResource(resourceCode: string, ids: string[], labelField: string) {
   if (ids.length === 0) throw new Error('OPENXIANGDA_RESOURCE_RESOLVE_IDS_REQUIRED');
   if (ids.length > 50) throw new Error('OPENXIANGDA_RESOURCE_RESOLVE_IDS_EXCEEDED');
-  const items = await Promise.all(ids.map(async id => {
-    const record = await request<DataRecord<Record<string, unknown>>>(`${dataBase(resourceCode)}/records/${encodeURIComponent(id)}?environmentKey=${encodeURIComponent(currentEnvironmentKey())}`);
-    return { id, label: String(record.data[labelField] ?? id), selectable: true };
-  }));
+  const items = await Promise.all(
+    ids.map(async (id) => {
+      const record = await request<DataRecord<Record<string, unknown>>>(
+        `${dataBase(resourceCode)}/records/${encodeURIComponent(id)}?environmentKey=${encodeURIComponent(currentEnvironmentKey())}`
+      );
+      return {
+        id,
+        label: String(record.data[labelField] ?? id),
+        selectable: true,
+      };
+    })
+  );
   return { items, nextCursor: null };
 }
 
@@ -204,7 +267,12 @@ export function createNativeResourceClient(code: string, surface: DataResourceSu
     if (query.keyword?.trim()) {
       const searchable = surface.list?.searchableFields || [];
       const field = searchable.includes(query.searchField || '') ? query.searchField! : searchable[0];
-      if (field) filters.push({ field: assertField(field), operator: 'ilike', value: `%${query.keyword.trim()}%` });
+      if (field)
+        filters.push({
+          field: assertField(field),
+          operator: 'ilike',
+          value: `%${query.keyword.trim()}%`,
+        });
     }
     for (const [fieldCode, value] of Object.entries(query.filters || {})) {
       if (value === undefined || value === null || value === '') continue;
@@ -214,8 +282,10 @@ export function createNativeResourceClient(code: string, surface: DataResourceSu
       if (!declaredFields.has(fieldCode)) continue;
       const field = surface.fields[fieldCode];
       if (Array.isArray(value) && value.length === 2 && ['date', 'datetime', 'number', 'money', 'percent'].includes(field?.widget || '')) {
-        if (value[0] !== undefined && value[0] !== null && value[0] !== '') filters.push({ field: fieldCode, operator: 'gte', value: value[0] });
-        if (value[1] !== undefined && value[1] !== null && value[1] !== '') filters.push({ field: fieldCode, operator: 'lte', value: value[1] });
+        if (value[0] !== undefined && value[0] !== null && value[0] !== '')
+          filters.push({ field: fieldCode, operator: 'gte', value: value[0] });
+        if (value[1] !== undefined && value[1] !== null && value[1] !== '')
+          filters.push({ field: fieldCode, operator: 'lte', value: value[1] });
       } else if (Array.isArray(value) && ['multi', 'directory-user', 'directory-department', 'resource'].includes(field?.widget || '')) {
         filters.push({ field: fieldCode, operator: 'cs', value });
       } else {
@@ -226,42 +296,112 @@ export function createNativeResourceClient(code: string, surface: DataResourceSu
   };
   return {
     async list(query: GenericResourceQuery) {
-      const fallbackSort = surface.list?.defaultSort || { field: Object.keys(surface.fields)[0] || 'id', order: 'asc' as const };
+      const fallbackSort = surface.list?.defaultSort || {
+        field: Object.keys(surface.fields)[0] || 'id',
+        order: 'asc' as const,
+      };
       const requestedSort = query.sort || fallbackSort;
       const sort = declaredFields.has(requestedSort.field) ? requestedSort : fallbackSort;
-      const body: DataQuery = { schemaVersion: SCHEMA_VERSIONS.dataQuery, filters: filtersFor(query), order: [{ field: sort.field, direction: sort.order || 'asc' }], limit: query.pageSize, offset: (query.page - 1) * query.pageSize };
-      const page = await request<DataPage<Record<string, unknown>>>(`${base}/query`, { method: 'POST', body: JSON.stringify({ ...body, environmentKey: currentEnvironmentKey() }) });
+      const body: DataQuery = {
+        schemaVersion: SCHEMA_VERSIONS.dataQuery,
+        filters: filtersFor(query),
+        order: [{ field: sort.field, direction: sort.order || 'asc' }],
+        limit: query.pageSize,
+        offset: (query.page - 1) * query.pageSize,
+      };
+      const page = await request<DataPage<Record<string, unknown>>>(`${base}/query`, {
+        method: 'POST',
+        body: JSON.stringify({
+          ...body,
+          environmentKey: currentEnvironmentKey(),
+        }),
+      });
       return { rows: page.items, total: page.total };
     },
     async get(id: string) {
-      const record = await request<DataRecord<Record<string, unknown>>>(`${base}/records/${encodeURIComponent(id)}?environmentKey=${encodeURIComponent(currentEnvironmentKey())}`);
+      const record = await request<DataRecord<Record<string, unknown>>>(
+        `${base}/records/${encodeURIComponent(id)}?environmentKey=${encodeURIComponent(currentEnvironmentKey())}`
+      );
       return record.data;
     },
     async audit(id: string) {
-      return request<DataAuditPage>(`${base}/records/${encodeURIComponent(id)}/audit?limit=10&offset=0&environmentKey=${encodeURIComponent(currentEnvironmentKey())}`);
+      return request<DataAuditPage>(
+        `${base}/records/${encodeURIComponent(id)}/audit?limit=10&offset=0&environmentKey=${encodeURIComponent(currentEnvironmentKey())}`
+      );
     },
     async create(data: Record<string, unknown>) {
-      const record = await request<DataRecord<Record<string, unknown>>>(`${base}/records`, { method: 'POST', body: JSON.stringify({ environmentKey: currentEnvironmentKey(), data }) });
+      const record = await request<DataRecord<Record<string, unknown>>>(`${base}/records`, {
+        method: 'POST',
+        body: JSON.stringify({
+          environmentKey: currentEnvironmentKey(),
+          data,
+        }),
+      });
       return record.data;
     },
     async update(id: string, expectedRevision: number, data: Record<string, unknown>) {
-      const record = await request<DataRecord<Record<string, unknown>>>(`${base}/records/${encodeURIComponent(id)}/update`, { method: 'POST', body: JSON.stringify({ environmentKey: currentEnvironmentKey(), expectedRevision, data }) });
+      const record = await request<DataRecord<Record<string, unknown>>>(`${base}/records/${encodeURIComponent(id)}/update`, {
+        method: 'POST',
+        body: JSON.stringify({
+          environmentKey: currentEnvironmentKey(),
+          expectedRevision,
+          data,
+        }),
+      });
       return record.data;
     },
     async remove(id: string, expectedRevision: number) {
-      const record = await request<DataRecord<Record<string, unknown>>>(`${base}/records/${encodeURIComponent(id)}/delete`, { method: 'POST', body: JSON.stringify({ environmentKey: currentEnvironmentKey(), expectedRevision }) });
+      const record = await request<DataRecord<Record<string, unknown>>>(`${base}/records/${encodeURIComponent(id)}/delete`, {
+        method: 'POST',
+        body: JSON.stringify({
+          environmentKey: currentEnvironmentKey(),
+          expectedRevision,
+        }),
+      });
       return record.data;
     },
     async upload(fieldCode: string, file: File, recordId?: string) {
       assertField(fieldCode);
-      const plan = await request<DataFileUploadPlan>(`${base}/files/uploads/initiate`, { method: 'POST', body: JSON.stringify({ environmentKey: currentEnvironmentKey(), fieldCode, fileName: file.name, fileSize: file.size, contentType: file.type || 'application/octet-stream', ...(recordId ? { recordId } : {}) }) });
-      const uploaded = await fetch(plan.uploadUrl, { method: plan.uploadMethod, headers: plan.headers, body: file });
+      const plan = await request<DataFileUploadPlan>(`${base}/files/uploads/initiate`, {
+        method: 'POST',
+        body: JSON.stringify({
+          environmentKey: currentEnvironmentKey(),
+          fieldCode,
+          fileName: file.name,
+          fileSize: file.size,
+          contentType: file.type || 'application/octet-stream',
+          ...(recordId ? { recordId } : {}),
+        }),
+      });
+      const uploaded = await fetch(plan.uploadUrl, {
+        method: plan.uploadMethod,
+        headers: plan.headers,
+        body: file,
+      });
       if (!uploaded.ok) throw new Error(`FILE_UPLOAD_FAILED: HTTP_${uploaded.status}`);
-      return request<DataFileRef>(`${base}/files/${encodeURIComponent(plan.file.id)}/complete`, { method: 'POST', body: JSON.stringify({ environmentKey: currentEnvironmentKey() }) });
+      return request<DataFileRef>(`${base}/files/${encodeURIComponent(plan.file.id)}/complete`, {
+        method: 'POST',
+        body: JSON.stringify({ environmentKey: currentEnvironmentKey() }),
+      });
     },
   };
 }
 
+export async function transactNativeData(operations: DataTransactionOperation[], idempotencyKey: string = crypto.randomUUID()) {
+  const transaction: DataTransactionRequest = {
+    schemaVersion: SCHEMA_VERSIONS.dataTransactionRequest,
+    idempotencyKey,
+    operations,
+  };
+  return request<DataTransactionResult>(`${nativeBase()}/data/transactions`, {
+    method: 'POST',
+    body: JSON.stringify({
+      ...transaction,
+      environmentKey: currentEnvironmentKey(),
+    }),
+  });
+}
+
 function nativeBase() {
   return `/service/openxiangda-api/v2/applications/${applicationCode()}/native`;
 }
@@ -271,16 +411,24 @@ function dataBase(code: string) {
 }
 
 export function dataFileContentUrl(resource: string, fileId: string, disposition: 'attachment' | 'inline' = 'attachment') {
-  const query = new URLSearchParams({ environmentKey: currentEnvironmentKey(), disposition });
+  const query = new URLSearchParams({
+    environmentKey: currentEnvironmentKey(),
+    disposition,
+  });
   return `${dataBase(resource)}/files/${encodeURIComponent(fileId)}/content?${query}`;
 }
 
 export async function loadDataFilePreview(resource: string, fileId: string) {
-  return request<DataFilePreview>(`${dataBase(resource)}/files/${encodeURIComponent(fileId)}/preview?environmentKey=${encodeURIComponent(currentEnvironmentKey())}`);
+  return request<DataFilePreview>(
+    `${dataBase(resource)}/files/${encodeURIComponent(fileId)}/preview?environmentKey=${encodeURIComponent(currentEnvironmentKey())}`
+  );
 }
 
 export async function fetchDataFileBlob(resource: string, fileId: string) {
-  const response = await fetch(dataFileContentUrl(resource, fileId, 'inline'), { credentials: 'include', headers: { accept: 'application/octet-stream,*/*' } });
+  const response = await fetch(dataFileContentUrl(resource, fileId, 'inline'), {
+    credentials: 'include',
+    headers: { accept: 'application/octet-stream,*/*' },
+  });
   if (!response.ok) throw new Error(`FILE_CONTENT_READ_FAILED: HTTP_${response.status}`);
   return response.blob();
 }

package/template/apps/web/src/styles.css

@@ -8,9 +8,9 @@ body,
 
 body {
   color: var(--oxa-shell-text, #1f1f1f);
-  font-family:
-    -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue",
-    Arial, "Noto Sans", "PingFang SC", "Microsoft YaHei", sans-serif;
+  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto,
+    "Helvetica Neue", Arial, "Noto Sans", "PingFang SC", "Microsoft YaHei",
+    sans-serif;
 }
 
 * {
@@ -386,7 +386,8 @@ body {
 
 .oxa-mobile-input:focus {
   border-color: var(--oxa-shell-primary, #1677ff);
-  outline: 2px solid color-mix(in srgb, var(--oxa-shell-primary, #1677ff) 15%, transparent);
+  outline: 2px solid
+    color-mix(in srgb, var(--oxa-shell-primary, #1677ff) 15%, transparent);
 }
 
 .oxa-mobile-filter,
@@ -541,6 +542,24 @@ body {
   color: var(--oxa-shell-text-secondary, #595959);
 }
 
+.oxa-batch-bar {
+  display: flex;
+  min-height: 52px;
+  align-items: center;
+  justify-content: space-between;
+  gap: 12px;
+  border-bottom: 1px solid var(--oxa-shell-border, #f0f0f0);
+  background: var(--ant-color-primary-bg, #e6f4ff);
+  padding: 8px 16px;
+}
+
+.oxa-import-errors {
+  max-height: 180px;
+  margin: 8px 0 0;
+  overflow: auto;
+  padding-left: 20px;
+}
+
 .oxa-list-card .ant-table-wrapper {
   border: 0;
   border-radius: 0;
@@ -594,7 +613,11 @@ body {
   justify-content: flex-end;
   gap: 10px;
   border-top: 1px solid var(--oxa-shell-border, #f0f0f0);
-  background: color-mix(in srgb, var(--oxa-shell-surface, #fff) 96%, transparent);
+  background: color-mix(
+    in srgb,
+    var(--oxa-shell-surface, #fff) 96%,
+    transparent
+  );
   padding: 14px 0;
   backdrop-filter: blur(8px);
 }
@@ -716,7 +739,8 @@ body {
 .oxa-directory-trigger:hover,
 .oxa-directory-trigger:focus-visible {
   border-color: var(--oxa-shell-primary, #1677ff);
-  box-shadow: 0 0 0 2px color-mix(in srgb, var(--oxa-shell-primary, #1677ff) 10%, transparent);
+  box-shadow: 0 0 0 2px
+    color-mix(in srgb, var(--oxa-shell-primary, #1677ff) 10%, transparent);
   outline: 0;
 }
 
@@ -1047,7 +1071,11 @@ body {
   justify-content: space-between;
   gap: 20px;
   border-bottom: 1px solid var(--oxa-shell-border, #f0f0f0);
-  background: color-mix(in srgb, var(--oxa-shell-surface, #fff) 96%, transparent);
+  background: color-mix(
+    in srgb,
+    var(--oxa-shell-surface, #fff) 96%,
+    transparent
+  );
   padding: 10px 20px;
   box-shadow: var(--oxa-shell-shadow, 0 1px 6px rgb(0 0 0 / 8%));
   backdrop-filter: blur(12px);
@@ -1597,7 +1625,8 @@ body {
   }
 
   .oxa-filter-actions,
-  .oxa-list-toolbar {
+  .oxa-list-toolbar,
+  .oxa-batch-bar {
     align-items: stretch;
     flex-direction: column;
   }

package/template/apps/web/test/contracts.test.ts

@@ -40,7 +40,7 @@ test('standard surfaces keep authoritative directory/resource selectors and mobi
   const client = readFileSync(new URL('../src/platform-client.ts', import.meta.url), 'utf8');
   assert.match(client, /declaredFields\.has\(requestedSort\.field\)/);
   assert.match(client, /if \(!declaredFields\.has\(fieldCode\)\) continue/);
-  assert.match(client, /'\/api\/auth\/logout'/);
+  assert.match(client, /\/api\/auth\/logout/);
 });
 
 test('admin appearance is a bounded Ant Design theme with compact route chrome', () => {
@@ -74,16 +74,26 @@ test('standard desktop CRUD exposes compact filters, table tools, and lazy audit
   assert.match(crud, /densityMenu/);
   assert.match(crud, /列设置/);
   assert.match(crud, /密度/);
+  assert.match(crud, /ResourceImportButton/);
+  assert.match(crud, /ResourceBatchActions/);
+  const batch = readFileSync(new URL('../src/components/resource/ResourceBatchActions.tsx', import.meta.url), 'utf8');
+  assert.match(batch, /transactNativeData/);
+  assert.match(batch, /批量修改/);
+  assert.match(batch, /批量删除/);
+  assert.match(batch, /确认导入/);
   assert.match(crud, /!auditExpanded/);
   assert.match(crud, /<Collapse/);
   assert.match(crud, /查看创建、更新和删除的字段变化/);
 });
 
 test('runtime metadata stays mount-scoped', () => {
-  const mount = readRuntimeMount(name => ({
-    'openxiangda-runtime-base': '/view/example-app/',
-    'openxiangda-app-code': 'example-app',
-    'openxiangda-environment': 'preproduction',
-  }[name]));
+  const mount = readRuntimeMount(
+    (name) =>
+      ({
+        'openxiangda-runtime-base': '/view/example-app/',
+        'openxiangda-app-code': 'example-app',
+        'openxiangda-environment': 'preproduction',
+      }[name])
+  );
   assert.equal(resolveApplicationBasename(mount), '/view/example-app');
 });

package/template/apps/web/test/resource-import.test.ts

@@ -0,0 +1,142 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import type { DataResourceSurface } from 'openxiangda-contracts/browser';
+import { parseResourceImportMatrix } from '../src/components/resource/resource-import';
+
+const surface = {
+  generated: true,
+  fields: {
+    visitorName: { label: '访客姓名', widget: 'text', requiredHint: true },
+    visitorCount: { label: '来访人数', widget: 'number' },
+    approved: { label: '是否通过', widget: 'boolean' },
+    status: {
+      label: '状态',
+      widget: 'select',
+      options: [
+        { label: '待审核', value: 'pending' },
+        { label: '已通过', value: 'approved' },
+      ],
+    },
+    visitDate: { label: '来访日期', widget: 'date' },
+    attachments: { label: '附件', widget: 'file' },
+  },
+} as unknown as DataResourceSurface;
+
+test('maps exact labels and codes into one canonical create transaction', () => {
+  const preview = parseResourceImportMatrix(
+    '访客.xlsx',
+    [
+      ['访客姓名', 'visitorCount', '是否通过', '状态'],
+      ['张三', 2, '是', '待审核'],
+      ['李四', '3', '否', 'approved'],
+    ],
+    'visitor-reservations',
+    surface,
+    ['visitorName', 'visitorCount', 'approved', 'status']
+  );
+
+  assert.deepEqual(preview.errors, []);
+  assert.deepEqual(preview.operations, [
+    {
+      operation: 'create',
+      resourceCode: 'visitor-reservations',
+      data: {
+        visitorName: '张三',
+        visitorCount: 2,
+        approved: true,
+        status: 'pending',
+      },
+    },
+    {
+      operation: 'create',
+      resourceCode: 'visitor-reservations',
+      data: {
+        visitorName: '李四',
+        visitorCount: 3,
+        approved: false,
+        status: 'approved',
+      },
+    },
+  ]);
+});
+
+test('preserves exact dates and rejects impossible calendar dates', () => {
+  const valid = parseResourceImportMatrix(
+    '日期.csv',
+    [
+      ['访客姓名', '来访日期'],
+      ['张三', '2026-08-23'],
+    ],
+    'visitor-reservations',
+    surface,
+    ['visitorName', 'visitDate']
+  );
+  assert.deepEqual(valid.errors, []);
+  assert.deepEqual(valid.operations[0], {
+    operation: 'create',
+    resourceCode: 'visitor-reservations',
+    data: { visitorName: '张三', visitDate: '2026-08-23' },
+  });
+
+  const invalid = parseResourceImportMatrix(
+    '错误日期.csv',
+    [
+      ['访客姓名', '来访日期'],
+      ['张三', '2026-02-30'],
+    ],
+    'visitor-reservations',
+    surface,
+    ['visitorName', 'visitDate']
+  );
+  assert.equal(invalid.operations.length, 0);
+  assert.ok(invalid.errors.some((error) => error.includes('日期格式无效')));
+});
+
+test('rejects values in a column without a header', () => {
+  const preview = parseResourceImportMatrix(
+    '空表头.csv',
+    [
+      ['访客姓名', ''],
+      ['张三', '未声明的数据'],
+    ],
+    'visitor-reservations',
+    surface,
+    ['visitorName']
+  );
+
+  assert.equal(preview.operations.length, 0);
+  assert.ok(preview.errors.some((error) => error.includes('缺少表头')));
+});
+
+test('rejects unknown, managed-file and invalid cells before submission', () => {
+  const preview = parseResourceImportMatrix(
+    '错误.csv',
+    [
+      ['访客姓名', '是否通过', '附件', '任意列'],
+      ['', '不确定', 'https://untrusted.example/file', 'value'],
+    ],
+    'visitor-reservations',
+    surface,
+    ['visitorName', 'approved', 'attachments']
+  );
+
+  assert.equal(preview.operations.length, 0);
+  assert.ok(preview.errors.some((error) => error.includes('不是已声明字段')));
+  assert.ok(preview.errors.some((error) => error.includes('必须通过平台上传组件')));
+  assert.ok(preview.errors.some((error) => error.includes('请填写是或否')));
+  assert.ok(preview.errors.some((error) => error.includes('访客姓名为必填项')));
+});
+
+test('keeps the atomic import boundary at one hundred rows', () => {
+  const preview = parseResourceImportMatrix(
+    '过大.csv',
+    [['访客姓名'], ...Array.from({ length: 101 }, (_, index) => [`访客 ${index + 1}`])],
+    'visitor-reservations',
+    surface,
+    ['visitorName']
+  );
+
+  assert.equal(preview.rows.length, 100);
+  assert.equal(preview.operations.length, 0);
+  assert.ok(preview.errors.some((error) => error.includes('单次最多导入 100 行')));
+});

package/template/openxiangda.config.ts

@@ -10,7 +10,8 @@ export default defineOpenXiangdaApp({
     runtime: 'node',
     framework: 'nestjs',
     enabled: false,
-    runMode: 'shared',
+    isolation: 'shared',
+    resourceProfile: 'light',
     secrets: [],
     operations: [],
   },