openxiangda-cli 2.0.0-alpha.12 → 2.0.0-alpha.120

package/template/apps/web/e2e/workflow.spec.ts

@@ -0,0 +1,576 @@
+import { expect, test, type Page } from '@playwright/test';
+import { appCode } from '../../../packages/contracts/src/generated.js';
+
+const taskId = '11111111-1111-4111-8111-111111111111';
+const instanceId = '22222222-2222-4222-8222-222222222222';
+function envelope(data: unknown, code = 200) {
+  return { code, message: code === 200 ? 'success' : 'forbidden', data };
+}
+
+function detailNavigation(custom = false) {
+  return custom
+    ? {
+        custom: true,
+        desktopPath: `/admin/operations/purchases/${instanceId}?taskId=${taskId}`,
+        mobilePath: `/m/purchases/${instanceId}?taskId=${taskId}`,
+      }
+    : {
+        custom: false,
+        desktopPath: `/admin/tasks/${taskId}`,
+        mobilePath: `/m/tasks/${taskId}`,
+      };
+}
+
+function task(completed = false, customDetail = false) {
+  return {
+    schemaVersion: 'openxiangda.workflow-task/v2',
+    engineVersion: '2.0',
+    id: taskId,
+    instanceId,
+    workflowCode: 'purchase-approval',
+    businessKey: 'PO-2026-0825',
+    nodeId: 'manager-review',
+    title: '采购申请审批',
+    status: completed ? 'completed' : 'assigned',
+    approvalMode: 'single',
+    taskKind: 'normal',
+    assignedRoleSubjectKey: 'membership:manager',
+    activeParticipantId: 'participant-1',
+    participants: [],
+    originTaskId: null,
+    returnSessionId: null,
+    version: completed ? 2 : 1,
+    dataRef: { resourceCode: 'purchase-orders', recordId: 'purchase-1' },
+    createdAt: '2026-08-25T01:00:00.000Z',
+    updatedAt: '2026-08-25T01:10:00.000Z',
+    detailNavigation: detailNavigation(customDetail),
+  };
+}
+
+function surface(completed = false, customDetail = false) {
+  return {
+    schemaVersion: 'openxiangda.workflow-surface/v2',
+    protocolVersion: 'workflow_surface_v2',
+    surfaceRevision: completed ? 'revision-2' : 'revision-1',
+    engineVersion: '2.0',
+    instanceSequence: completed ? 4 : 3,
+    detailNavigation: detailNavigation(customDetail),
+    navigationTarget: {
+      kind: 'resource_record',
+      appCode,
+      environmentKey: 'preproduction',
+      resourceCode: 'purchase-orders',
+      recordId: 'purchase-1',
+      desktopPath: '/purchase-orders/purchase-1',
+      mobilePath: '/m/purchase-orders/purchase-1',
+    },
+    instance: {
+      schemaVersion: 'openxiangda.workflow-instance/v2',
+      engineVersion: '2.0',
+      id: instanceId,
+      appCode,
+      environmentId: 'preproduction-id',
+      environmentKey: 'preproduction',
+      workflowCode: 'purchase-approval',
+      definitionVersion: 1,
+      bindingVersion: 1,
+      businessKey: 'PO-2026-0825',
+      generation: 1,
+      status: completed ? 'approved' : 'running',
+      initiatorUserId: 'applicant-user',
+      initiatorAuthorizationDigest: null,
+      dataRef: { resourceCode: 'purchase-orders', recordId: 'purchase-1' },
+      dataRevision: '8',
+      currentNodeId: completed ? null : 'manager-review',
+      outcome: completed ? 'approved' : null,
+      version: completed ? 3 : 2,
+      eventSequence: completed ? 4 : 3,
+      startedAt: '2026-08-25T01:00:00.000Z',
+      completedAt: completed ? '2026-08-25T01:12:00.000Z' : null,
+    },
+    task: completed ? null : task(false, customDetail),
+    presentation: {
+      status: { label: completed ? '已同意' : '待审批', tone: 'warning' },
+      layout: 'approval_detail',
+      businessData: {
+        申请金额: '¥28,600',
+        采购类型: '办公设备',
+        期望到货: '2026-09-05',
+        申请人: '张三',
+      },
+    },
+    fieldPolicy: { default: 'readonly', fields: {} },
+    operations: completed
+      ? []
+      : [
+          {
+            key: 'approve',
+            kind: 'workflow_command',
+            label: '同意',
+            placement: 'primary',
+            tone: 'primary',
+            visible: true,
+            enabled: true,
+            inputSchema: {
+              type: 'object',
+              properties: {
+                comment: {
+                  type: 'string',
+                  title: '审批意见',
+                  format: 'textarea',
+                  maxLength: 500,
+                },
+              },
+            },
+            uiSchema: {
+              confirmText: '确认同意',
+              confirmation: { description: '提交后流程继续流转。' },
+            },
+            execute: {
+              method: 'POST',
+              href: '/workflow/approve',
+              idempotencyRequired: true,
+            },
+            refresh: ['surface', 'timeline', 'work_center'],
+          },
+          ...['reject', 'return', 'transfer', 'add_assignee'].map(key => ({
+            key,
+            kind: 'workflow_command',
+            label: {
+              reject: '拒绝',
+              return: '退回',
+              transfer: '转交',
+              add_assignee: '加签',
+            }[key],
+            placement: 'secondary',
+            tone: key === 'reject' ? 'danger' : 'neutral',
+            visible: true,
+            enabled: true,
+            inputSchema: { type: 'object', properties: {} },
+            uiSchema: { confirmText: `确认${key}` },
+            execute: {
+              method: 'POST',
+              href: `/workflow/${key}`,
+              idempotencyRequired: true,
+            },
+            refresh: ['surface', 'timeline', 'work_center'],
+          })),
+        ],
+    extensions: {},
+  };
+}
+
+function timeline(completed = false) {
+  return {
+    engineVersion: '2.0',
+    instanceId,
+    flow: [
+      {
+        key: 'start',
+        nodeId: null,
+        kind: 'start',
+        title: '张三',
+        status: 'completed',
+        startedAt: '2026-08-25T01:00:00.000Z',
+        completedAt: '2026-08-25T01:00:00.000Z',
+        assignees: [],
+      },
+      {
+        key: 'manager',
+        nodeId: 'manager-review',
+        kind: 'approval',
+        title: '部门负责人',
+        status: completed ? 'completed' : 'active',
+        startedAt: '2026-08-25T01:01:00.000Z',
+        completedAt: completed ? '2026-08-25T01:12:00.000Z' : null,
+        assignees: [{ userId: 'acceptance-user', displayName: '李明' }],
+      },
+      {
+        key: 'finance',
+        nodeId: 'finance-review',
+        kind: 'approval',
+        title: '财务负责人',
+        status: completed ? 'completed' : 'waiting',
+        startedAt: null,
+        completedAt: null,
+        assignees: [{ userId: 'finance-user', displayName: '财务负责人' }],
+      },
+    ],
+    items: [],
+  };
+}
+
+function launchSurface() {
+  return {
+    schemaVersion: 'openxiangda.workflow-launch-surface/v2',
+    protocolVersion: 'workflow_launch_surface_v2',
+    surfaceRevision: 'launch-revision-1',
+    engineVersion: '2.0',
+    appCode,
+    environmentKey: 'preproduction',
+    environmentId: 'preproduction-id',
+    workflowCode: 'purchase-approval',
+    title: '采购审批',
+    launchMode: 'standalone',
+    inputSchema: { type: 'object', properties: {} },
+    head: {
+      workflowRevision: 4,
+      definitionVersion: 1,
+      bindingVersion: 1,
+      nativeRevision: 3,
+      contractRevisionId: 'contract-revision-1',
+    },
+    paths: {
+      desktop: '/admin/workflows/purchase-approval/new',
+      mobile: '/m/workflows/purchase-approval/start',
+    },
+    prepare: {
+      method: 'POST',
+      href: '/workflow/definitions/purchase-approval/prepare-start',
+    },
+    start: {
+      method: 'POST',
+      href: '/workflow/instances',
+      idempotencyRequired: true,
+    },
+  };
+}
+
+function todoPage() {
+  return {
+    schemaVersion: 'openxiangda.application-todo-center/v2',
+    appCode,
+    environmentKey: 'preproduction',
+    view: 'pending',
+    counts: { pending: 1, informational: 2, completed: 3, unread: 1 },
+    items: [
+      {
+        messageId: '33333333-3333-4333-8333-333333333333',
+        recipientId: '44444444-4444-4444-8444-444444444444',
+        state: 'action_required',
+        interactionState: 'unread',
+        title: '设备采购申请待审批',
+        summary: '张三提交了一笔办公设备采购申请',
+        fields: [
+          { code: 'amount', label: '申请金额', value: '¥28,600' },
+          { code: 'department', label: '申请部门', value: '理学院' },
+        ],
+        actions: [{ code: 'open', label: '去处理' }],
+        sourceKind: 'PLATFORM_EVENT',
+        sourceLabel: '流程中心',
+        occurredAt: '2026-08-28T01:00:00.000Z',
+        updatedAt: '2026-08-28T01:01:00.000Z',
+        navigation: {
+          desktopPath: `/admin/operations/purchases/${instanceId}?taskId=${taskId}`,
+          mobilePath: `/m/purchases/${instanceId}?taskId=${taskId}`,
+          external: false,
+          navigationUnavailable: false,
+        },
+      },
+    ],
+    total: 1,
+    limit: 12,
+    offset: 0,
+    nextOffset: null,
+  };
+}
+
+async function mockWorkflow(
+  page: Page,
+  options: { forbidden?: boolean; customDetail?: boolean } = {}
+) {
+  let completed = false;
+  await page.route('**/service/**', async route => {
+    const url = new URL(route.request().url());
+    const path = url.pathname;
+    if (path.endsWith('/native/authz/current')) {
+      return route.fulfill({
+        contentType: 'application/json',
+        body: JSON.stringify(
+          envelope({
+            schemaVersion: 'openxiangda.runtime-authorization/v2',
+            state: 'active',
+            environment: {
+              id: 'preproduction-id',
+              key: 'preproduction',
+              activeAppVersionId: 'version-1',
+              headRevision: 1,
+              authzRevisionId: 'authz-1',
+              authzVersion: 1,
+              scopeDataVersion: 'scope-1',
+            },
+            subjectProfile: {
+              schemaVersion: 'openxiangda.subject-profile/v2',
+              userId: 'acceptance-user',
+              displayName: '王老师',
+              avatarUrl: null,
+              jobNumber: 'T001',
+              affiliatedDepartment: { id: 'department-1', name: '理学院' },
+            },
+            roles: [
+              {
+                code: 'department_manager',
+                name: '部门管理员',
+                source: 'package',
+              },
+            ],
+            principal: {
+              type: 'user_union',
+              userId: 'acceptance-user',
+              roleCodes: ['department_manager'],
+              capabilityCodes: [],
+              isAppSuperAdmin: false,
+              identityScope:
+                'user-union:preproduction-id:acceptance-user:authz-1',
+            },
+          })
+        ),
+      });
+    }
+    if (path.includes('/directory/')) {
+      return route.fulfill({
+        contentType: 'application/json',
+        body: JSON.stringify(envelope({ items: [], nextCursor: null })),
+      });
+    }
+    if (options.forbidden && path.includes('/workflow/')) {
+      return route.fulfill({
+        status: 403,
+        contentType: 'application/json',
+        body: JSON.stringify(envelope(null, 403)),
+      });
+    }
+    if (path.endsWith('/todos') && route.request().method() === 'GET') {
+      return route.fulfill({
+        contentType: 'application/json',
+        body: JSON.stringify(envelope(todoPage())),
+      });
+    }
+    if (path.includes('/todos/') && path.endsWith('/interactions')) {
+      return route.fulfill({
+        contentType: 'application/json',
+        body: JSON.stringify(
+          envelope({
+            accepted: true,
+            duplicate: false,
+            interactionState: 'clicked',
+          })
+        ),
+      });
+    }
+    if (
+      path.endsWith(
+        '/workflow/definitions/purchase-approval/launch-surface'
+      )
+    ) {
+      return route.fulfill({
+        contentType: 'application/json',
+        body: JSON.stringify(envelope(launchSurface())),
+      });
+    }
+    if (
+      path.endsWith(
+        '/workflow/definitions/purchase-approval/prepare-start'
+      )
+    ) {
+      return route.fulfill({
+        contentType: 'application/json',
+        body: JSON.stringify(
+          envelope({
+            schemaVersion: 'openxiangda.workflow-preparation/v2',
+            preparationId: 'preparation-1',
+            status: 'ready',
+            requirements: [],
+            preparationToken: 'preparation-token-1',
+            preview: { nodes: [] },
+            expiresAt: '2026-08-28T02:00:00.000Z',
+            definitionVersion: 1,
+            bindingVersion: 1,
+            inputHash: 'input-hash-1',
+          })
+        ),
+      });
+    }
+    if (
+      path.endsWith('/workflow/instances') &&
+      route.request().method() === 'POST'
+    ) {
+      return route.fulfill({
+        contentType: 'application/json',
+        body: JSON.stringify(
+          envelope({
+            ...surface(false, options.customDetail).instance,
+            id: instanceId,
+          })
+        ),
+      });
+    }
+    if (path.endsWith('/workflow/work-center/items')) {
+      return route.fulfill({
+        contentType: 'application/json',
+        body: JSON.stringify(
+          envelope({
+            engineVersion: '2.0',
+            authorizationMode: 'current_user_role_union',
+            authorizationDigest: 'digest-1',
+            status: 'pending',
+            total: 1,
+            limit: 20,
+            offset: 0,
+            items: [task(completed, options.customDetail)],
+          })
+        ),
+      });
+    }
+    if (path.endsWith(`/workflow/tasks/${taskId}/surface`)) {
+      return route.fulfill({
+        contentType: 'application/json',
+        body: JSON.stringify(
+          envelope(surface(completed, options.customDetail))
+        ),
+      });
+    }
+    if (path.endsWith(`/workflow/instances/${instanceId}/surface`)) {
+      return route.fulfill({
+        contentType: 'application/json',
+        body: JSON.stringify(
+          envelope(surface(completed, options.customDetail))
+        ),
+      });
+    }
+    if (path.endsWith(`/workflow/instances/${instanceId}/timeline`)) {
+      return route.fulfill({
+        contentType: 'application/json',
+        body: JSON.stringify(envelope(timeline(completed))),
+      });
+    }
+    if (path.endsWith(`/workflow/tasks/${taskId}/commands/approve`)) {
+      completed = true;
+      return route.fulfill({
+        contentType: 'application/json',
+        body: JSON.stringify(envelope({ status: 'completed' })),
+      });
+    }
+    return route.fulfill({
+      status: 404,
+      contentType: 'application/json',
+      body: JSON.stringify(envelope(null, 404)),
+    });
+  });
+}
+
+test('renders a paged desktop work center from the current-user role union', async ({
+  page,
+}) => {
+  await mockWorkflow(page);
+  await page.goto('/workflow-experience.e2e.html?initial=/admin/work-center');
+  await expect(page.getByRole('heading', { name: '审批工作台' })).toBeVisible();
+  await expect(page.getByRole('link', { name: '采购申请审批' })).toBeVisible();
+  await expect(page.getByText('PO-2026-0825')).toBeVisible();
+});
+
+test('renders the generic desktop and mobile application todo center without a second router', async ({
+  page,
+}) => {
+  await mockWorkflow(page);
+  await page.goto('/workflow-experience.e2e.html?initial=/admin/todos');
+  await expect(page.getByRole('heading', { name: '待办中心' })).toBeVisible();
+  await expect(page.getByText('设备采购申请待审批').first()).toBeVisible();
+  await expect(page.getByText('¥28,600').first()).toBeVisible();
+
+  await page.setViewportSize({ width: 390, height: 844 });
+  await page.goto('/workflow-experience.e2e.html?initial=/m/todos');
+  await expect(page.locator('.oxa-todo-center-mobile')).toBeVisible();
+  await page.getByRole('button', { name: '去处理' }).click();
+  await expect(page.getByTestId('custom-workflow-detail')).toContainText(
+    `${instanceId} / ${taskId}`
+  );
+});
+
+test('launches the same workflow from the canonical mobile Surface and follows custom detail routing', async ({
+  page,
+}) => {
+  await mockWorkflow(page, { customDetail: true });
+  await page.setViewportSize({ width: 390, height: 844 });
+  await page.goto(
+    '/workflow-experience.e2e.html?initial=/m/workflows/purchase-approval/start'
+  );
+  await expect(page.locator('.oxa-workflow-submission-mobile')).toBeVisible();
+  await expect(page.getByRole('heading', { name: '采购审批' })).toBeVisible();
+  await page.getByRole('button', { name: '保存业务数据并预检' }).click();
+  await expect(page.getByRole('button', { name: '提交审批' })).toBeVisible();
+  await page.getByRole('button', { name: '提交审批' }).click();
+  await expect(page.getByTestId('custom-workflow-detail')).toContainText(
+    `${instanceId} / ${taskId}`
+  );
+  await expect(page).toHaveURL(
+    new RegExp(`/m/purchases/${instanceId}\\?taskId=${taskId}$`)
+  );
+});
+
+test('routes desktop and mobile work-center entries to the declared custom detail pages', async ({
+  page,
+}) => {
+  await mockWorkflow(page, { customDetail: true });
+  await page.goto('/workflow-experience.e2e.html?initial=/admin/work-center');
+  await page.getByRole('link', { name: '采购申请审批' }).click();
+  await expect(page.getByTestId('custom-workflow-detail')).toContainText(
+    `${instanceId} / ${taskId}`
+  );
+  await expect(page).toHaveURL(
+    new RegExp(`/admin/operations/purchases/${instanceId}\\?taskId=${taskId}$`)
+  );
+
+  await page.setViewportSize({ width: 390, height: 844 });
+  await page.goto('/workflow-experience.e2e.html?initial=/m/work-center');
+  await page.getByText('采购申请审批').click();
+  await expect(page.getByTestId('custom-workflow-detail')).toContainText(
+    `${instanceId} / ${taskId}`
+  );
+  await expect(page).toHaveURL(
+    new RegExp(`/m/purchases/${instanceId}\\?taskId=${taskId}$`)
+  );
+});
+
+test('redirects a direct standard task URL to the declared custom detail page', async ({
+  page,
+}) => {
+  await mockWorkflow(page, { customDetail: true });
+  await page.goto(
+    `/workflow-experience.e2e.html?initial=/admin/tasks/${taskId}`
+  );
+  await expect(page.getByTestId('custom-workflow-detail')).toContainText(
+    `${instanceId} / ${taskId}`
+  );
+});
+
+test('renders the independent mobile task and executes only a Surface operation', async ({
+  page,
+}) => {
+  await mockWorkflow(page);
+  await page.setViewportSize({ width: 390, height: 844 });
+  await page.goto(`/workflow-experience.e2e.html?initial=/m/tasks/${taskId}`);
+  await expect(page.locator('.oxa-workflow-mobile-page')).toBeVisible();
+  await expect(page.getByText('¥28,600')).toBeVisible();
+  await expect(page.getByText('财务负责人').first()).toBeVisible();
+  await expect(page.getByRole('button', { name: /同\s*意/ })).toBeVisible();
+  await page.getByRole('button', { name: /同\s*意/ }).click();
+  await page.getByLabel('审批意见').fill('同意采购');
+  await page.getByRole('button', { name: '确认同意' }).click();
+  await expect(page.getByText('同意已提交')).toBeVisible();
+  await expect(page.getByRole('button', { name: /同\s*意/ })).toHaveCount(0);
+});
+
+test('shows an explicit authorization error instead of an empty work center', async ({
+  page,
+}) => {
+  test.setTimeout(45_000);
+  await mockWorkflow(page, { forbidden: true });
+  await page.goto('/workflow-experience.e2e.html?initial=/admin/work-center', {
+    waitUntil: 'domcontentloaded',
+  });
+  await expect(page.getByRole('alert')).toContainText('HTTP_403: forbidden', {
+    timeout: 30_000,
+  });
+  await expect(page.getByRole('link', { name: '采购申请审批' })).toHaveCount(0);
+});

package/template/apps/web/field-protocol.e2e.html

@@ -0,0 +1,15 @@
+<!doctype html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta name="openxiangda-runtime-base" content="/" />
+    <meta name="openxiangda-app-code" content="field-protocol-fixture" />
+    <meta name="openxiangda-environment" content="preproduction" />
+    <title>Field protocol acceptance</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/e2e/field-protocol-fixture.tsx"></script>
+  </body>
+</html>

package/template/apps/web/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>OpenXiangda 应用</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/template/apps/web/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@app/web",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "check": "tsc -p tsconfig.json --noEmit && node scripts/check.mjs",
+    "test": "tsx --test test/*.test.ts",
+    "test:e2e": "playwright test",
+    "build": "tsc -p tsconfig.json --noEmit && vite build && node scripts/verify-build.mjs"
+  },
+  "dependencies": {
+    "@ant-design/icons": "6.2.3",
+    "@refinedev/core": "5.0.12",
+    "antd": "6.4.3",
+    "openxiangda": "2.0.0-alpha.34",
+    "react": "19.2.8",
+    "react-dom": "19.2.8",
+    "react-router-dom": "7.8.2"
+  },
+  "devDependencies": {
+    "@playwright/test": "1.62.1",
+    "@types/node": "24.13.3",
+    "@types/react": "19.2.14",
+    "@types/react-dom": "19.2.3",
+    "@vitejs/plugin-react": "4.7.0",
+    "tsx": "4.23.12",
+    "typescript": "5.9.3",
+    "vite": "7.1.3"
+  }
+}

package/template/apps/web/playwright.config.ts

@@ -0,0 +1,47 @@
+import { defineConfig } from '@playwright/test';
+
+const e2ePort = resolveE2ePort();
+const baseURL =
+  process.env.OPENXIANGDA_E2E_BASE_URL || `http://127.0.0.1:${e2ePort}`;
+
+export default defineConfig({
+  testDir: './e2e',
+  // The development server owns one mutable dependency-optimizer generation.
+  // Serial browser entrypoints prevent a second HTML graph from invalidating
+  // an in-flight transformed module during release acceptance.
+  workers: 1,
+  use: { baseURL, trace: 'retain-on-failure' },
+  webServer: process.env.OPENXIANGDA_E2E_BASE_URL
+    ? undefined
+    : {
+        command: 'pnpm dev',
+        url: baseURL,
+        reuseExistingServer: false,
+        env: {
+          OPENXIANGDA_WEB_PORT: String(e2ePort),
+          OPENXIANGDA_ENVIRONMENT_KEY: 'production',
+          OPENXIANGDA_DEV_PROXY:
+            process.env.OPENXIANGDA_E2E_PLATFORM_URL ||
+            'http://127.0.0.1:7001',
+        },
+      },
+});
+
+function resolveE2ePort() {
+  const configured = process.env.OPENXIANGDA_E2E_PORT;
+  if (configured !== undefined) {
+    const port = Number(configured);
+    if (!Number.isInteger(port) || port < 1024 || port > 65535) {
+      throw new Error(
+        'OPENXIANGDA_E2E_PORT must be an integer between 1024 and 65535'
+      );
+    }
+    return port;
+  }
+
+  let hash = 2166136261;
+  for (const character of process.cwd()) {
+    hash = Math.imul(hash ^ character.charCodeAt(0), 16777619);
+  }
+  return 30_000 + ((hash >>> 0) % 30_000);
+}