openxiangda-cli 2.0.0-alpha.18 → 2.0.0-alpha.182

package/dist/studio-events.d.ts

@@ -0,0 +1,9 @@
+import { type StudioCliEvent, type StudioCliEventType } from "openxiangda-contracts";
+export declare class StudioCliEventStream {
+    readonly runId: string;
+    private readonly write;
+    private sequence;
+    constructor(runId: string, write?: (event: StudioCliEvent) => void);
+    emit(type: StudioCliEventType, payload: Record<string, unknown>): StudioCliEvent;
+}
+//# sourceMappingURL=studio-events.d.ts.map

package/dist/studio-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"studio-events.d.ts","sourceRoot":"","sources":["../src/studio-events.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACxB,MAAM,uBAAuB,CAAC;AAE/B,qBAAa,oBAAoB;IAI7B,QAAQ,CAAC,KAAK,EAAE,MAAM;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAJxB,OAAO,CAAC,QAAQ,CAAK;gBAGV,KAAK,EAAE,MAAM,EACL,KAAK,GAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAElD;IAUH,IAAI,CAAC,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAahE"}

package/dist/studio-events.js

@@ -0,0 +1,30 @@
+import { randomUUID } from "node:crypto";
+import { STUDIO_CLI_EVENT_SCHEMA_VERSION, } from "openxiangda-contracts";
+export class StudioCliEventStream {
+    runId;
+    write;
+    sequence = 0;
+    constructor(runId, write = event => {
+        process.stdout.write(`${JSON.stringify(event)}\n`);
+    }) {
+        this.runId = runId;
+        this.write = write;
+        if (!runId || runId.length > 256) {
+            throw Object.assign(new Error("STUDIO_RUN_ID_INVALID: runId 必须为 1 到 256 个字符"), { code: "STUDIO_RUN_ID_INVALID", retryable: false });
+        }
+    }
+    emit(type, payload) {
+        const event = {
+            schemaVersion: STUDIO_CLI_EVENT_SCHEMA_VERSION,
+            eventId: randomUUID(),
+            runId: this.runId,
+            seq: ++this.sequence,
+            type,
+            timestamp: new Date().toISOString(),
+            payload,
+        };
+        this.write(event);
+        return event;
+    }
+}
+//# sourceMappingURL=studio-events.js.map

package/dist/studio-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"studio-events.js","sourceRoot":"","sources":["../src/studio-events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,+BAA+B,GAGhC,MAAM,uBAAuB,CAAC;AAE/B,MAAM,OAAO,oBAAoB;IAIpB;IACQ;IAJX,QAAQ,GAAG,CAAC,CAAC;IAErB,YACW,KAAa,EACL,QAAyC,KAAK,CAAC,EAAE;QAChE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrD,CAAC;QAHQ,UAAK,GAAL,KAAK,CAAQ;QACL,UAAK,GAAL,KAAK,CAErB;QAED,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;YACjC,MAAM,MAAM,CAAC,MAAM,CACjB,IAAI,KAAK,CAAC,8CAA8C,CAAC,EACzD,EAAE,IAAI,EAAE,uBAAuB,EAAE,SAAS,EAAE,KAAK,EAAE,CACpD,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,CAAC,IAAwB,EAAE,OAAgC;QAC7D,MAAM,KAAK,GAAmB;YAC5B,aAAa,EAAE,+BAA+B;YAC9C,OAAO,EAAE,UAAU,EAAE;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,GAAG,EAAE,EAAE,IAAI,CAAC,QAAQ;YACpB,IAAI;YACJ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,OAAO;SACR,CAAC;QACF,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAClB,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/toolchain-capsule.d.ts

@@ -0,0 +1,4 @@
+import { type ToolchainCapsule } from "openxiangda-devkit-core";
+export declare function resolveCliToolchainCapsule(templateRoot?: string): ToolchainCapsule;
+export declare function resolveDefaultTemplate(): string;
+//# sourceMappingURL=toolchain-capsule.d.ts.map

package/dist/toolchain-capsule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolchain-capsule.d.ts","sourceRoot":"","sources":["../src/toolchain-capsule.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,gBAAgB,EACtB,MAAM,yBAAyB,CAAC;AAOjC,wBAAgB,0BAA0B,CACxC,YAAY,SAA2B,GACtC,gBAAgB,CAsBlB;AAED,wBAAgB,sBAAsB,WAIrC"}

package/dist/toolchain-capsule.js

@@ -0,0 +1,116 @@
+import { createToolchainCapsule, isOpenXiangdaPackageName, TOOLCHAIN_CAPSULE_MAX_MANIFEST_BYTES, TOOLCHAIN_CAPSULE_MAX_PACKAGE_FILES, ToolchainCapsuleScanLimitError, } from "openxiangda-devkit-core";
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { dirname, join, relative, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+export function resolveCliToolchainCapsule(templateRoot = resolveDefaultTemplate()) {
+    const localVersions = readLocalPackageVersions();
+    const versions = new Map();
+    for (const dependency of readTemplateDependencies(templateRoot)) {
+        const value = dependency.specifier.startsWith("workspace:")
+            ? localVersions.get(dependency.name)
+            : dependency.specifier;
+        if (!value || /[<>=*^~| ]/.test(value)) {
+            throw new Error(`OPENXIANGDA_TEMPLATE_CAPSULE_VERSION_UNRESOLVED: ${dependency.name}`);
+        }
+        const previous = versions.get(dependency.name);
+        if (previous && previous !== value) {
+            throw new Error(`OPENXIANGDA_TEMPLATE_CAPSULE_SPLIT: ${dependency.name}`);
+        }
+        versions.set(dependency.name, value);
+    }
+    return createToolchainCapsule(versions, "cli-template");
+}
+export function resolveDefaultTemplate() {
+    const repository = resolve(packageRoot, "../../templates/application");
+    if (existsSync(repository))
+        return repository;
+    return join(packageRoot, "template");
+}
+function readLocalPackageVersions() {
+    const packagesRoot = resolve(packageRoot, "..");
+    const versions = new Map();
+    const self = readManifest(join(packageRoot, "package.json"));
+    if (self &&
+        typeof self.name === "string" &&
+        typeof self.version === "string" &&
+        isOpenXiangdaPackageName(self.name)) {
+        versions.set(self.name, self.version);
+    }
+    for (const entry of readdirSync(packagesRoot, { withFileTypes: true }).sort((left, right) => left.name.localeCompare(right.name))) {
+        if (!entry.isDirectory())
+            continue;
+        const manifest = readManifest(join(packagesRoot, entry.name, "package.json"));
+        if (manifest &&
+            typeof manifest.name === "string" &&
+            typeof manifest.version === "string" &&
+            isOpenXiangdaPackageName(manifest.name)) {
+            versions.set(manifest.name, manifest.version);
+        }
+    }
+    return versions;
+}
+function readTemplateDependencies(root) {
+    const dependencies = [];
+    let packageFileCount = 0;
+    const visit = (directory) => {
+        for (const entry of readdirSync(directory, { withFileTypes: true }).sort((left, right) => left.name.localeCompare(right.name))) {
+            if (["node_modules", "dist", ".openxiangda"].includes(entry.name)) {
+                continue;
+            }
+            const path = join(directory, entry.name);
+            if (entry.isDirectory()) {
+                visit(path);
+                continue;
+            }
+            if (!entry.isFile() || entry.name !== "package.json")
+                continue;
+            packageFileCount += 1;
+            if (packageFileCount > TOOLCHAIN_CAPSULE_MAX_PACKAGE_FILES) {
+                throw new ToolchainCapsuleScanLimitError(`template package.json count exceeds ${TOOLCHAIN_CAPSULE_MAX_PACKAGE_FILES}`);
+            }
+            if (statSync(path).size > TOOLCHAIN_CAPSULE_MAX_MANIFEST_BYTES) {
+                throw new ToolchainCapsuleScanLimitError(`${relative(root, path)} exceeds ${TOOLCHAIN_CAPSULE_MAX_MANIFEST_BYTES} bytes`);
+            }
+            const manifest = readManifest(path);
+            if (!manifest)
+                continue;
+            for (const section of [
+                "dependencies",
+                "devDependencies",
+                "peerDependencies",
+                "optionalDependencies",
+            ]) {
+                const values = manifest[section];
+                if (!values || typeof values !== "object")
+                    continue;
+                for (const [name, specifier] of Object.entries(values)) {
+                    if (!isOpenXiangdaPackageName(name)) {
+                        continue;
+                    }
+                    dependencies.push({
+                        name,
+                        specifier: String(specifier),
+                        packageFile: relative(root, path).replaceAll("\\", "/"),
+                        section,
+                    });
+                }
+            }
+        }
+    };
+    visit(resolve(root));
+    return dependencies.sort((left, right) => left.name.localeCompare(right.name) ||
+        left.packageFile.localeCompare(right.packageFile) ||
+        left.section.localeCompare(right.section));
+}
+function readManifest(path) {
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return undefined;
+        throw error;
+    }
+}
+//# sourceMappingURL=toolchain-capsule.js.map

package/dist/toolchain-capsule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolchain-capsule.js","sourceRoot":"","sources":["../src/toolchain-capsule.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,24 +1,30 @@
 {
   "name": "openxiangda-cli",
-  "version": "2.0.0-alpha.18",
-  "description": "Thin application-level CLI for OpenXiangda 2.0.",
+  "version": "2.0.0-alpha.182",
+  "description": "OpenXiangda 2.0 应用生命周期命令、创建器与模板。",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
-  "bin": {
-    "openxiangda": "./bin/run.js"
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./run": "./bin/run.js",
+    "./package.json": "./package.json"
   },
   "files": [
     "bin/",
     "dist/",
+    "template/",
     "README.md"
   ],
   "dependencies": {
     "@oclif/core": "4.13.3",
-    "openxiangda-contracts": "2.0.0-alpha.12",
-    "openxiangda-skill-kit": "2.0.0-alpha.17",
-    "create-openxiangda": "2.0.0-alpha.16",
-    "openxiangda-devkit-core": "2.0.0-alpha.15"
+    "openxiangda-contracts": "2.0.0-alpha.91",
+    "openxiangda-devkit-core": "2.0.0-alpha.117",
+    "openxiangda-mcp": "2.0.0-alpha.117",
+    "openxiangda-skill-kit": "2.0.0-alpha.143"
   },
   "devDependencies": {
     "tsx": "4.23.12",
@@ -35,8 +41,9 @@
   },
   "license": "MIT",
   "scripts": {
-    "build": "tsc -p tsconfig.json",
+    "build": "node ../../scripts/prune-package-dist.mjs && tsc -p tsconfig.json",
+    "build:release": "node ../../scripts/prune-package-dist.mjs && pnpm build",
     "check": "tsc -p tsconfig.json --noEmit",
-    "test": "tsx --test test/*.test.ts"
+    "test": "node scripts/prepare-template.mjs && tsx --test test/*.test.ts && node ../../scripts/verify-cli-blackbox.mjs"
   }
 }

package/template/.dockerignore

@@ -0,0 +1,23 @@
+node_modules
+**/node_modules
+dist
+**/dist
+coverage
+**/coverage
+playwright-report
+**/playwright-report
+test-results
+**/test-results
+.openxiangda
+**/.openxiangda
+.turbo
+**/.turbo
+.turbopack
+**/.turbopack
+.umi
+**/.umi
+.umi-production
+**/.umi-production
+.git
+*.log
+**/*.log

package/template/.env.example

@@ -0,0 +1,3 @@
+# openxiangda dev injects these values. Do not put platform tokens in this file.
+OPENXIANGDA_APP_CODE=instrument-center
+OPENXIANGDA_DEV_HOST=127.0.0.1

package/template/AGENTS.md

@@ -0,0 +1,26 @@
+# 应用开发约定
+
+<!-- OPENXIANGDA:BEGIN -->
+## 平台约定
+
+本项目使用 OpenXiangda 2.0。进入项目后以本地精确依赖和锁文件为准，使用 `pnpm openxiangda`；先运行 `context --json` 确认版本和绑定，使用 `docs` 按任务读取当前中文资料。
+
+- 模型、页面、导航和权限由应用声明一次；编译器生成契约。业务代码不改生成结果、不创建 platform/data、不复制平台 Router、字段组件、客户端或权限状态。
+- 当前用户、角色并集、数据授权和部署状态归平台；应用不保存凭据或授权快照。普通 CRUD 走 Data API，真实业务动作才按需启用 Nest。
+- 标准业务字段使用 `openxiangda/field-kit`；PC 补充控件使用 antd，移动使用有作用域的 `openxiangda/mobile` 和 MobileSurface，不引入上游全局重置。
+- 无账号表单读取 `docs public-access`，使用 frontend.publicAccess 和专用客户端；标准审批、通知和后端均按需启用。
+- 日常使用 dev 和聚焦测试。只验证时使用 check；授权部署时直接 deploy，它已包含检查、测试和构建。生产必须指定成功测试运行并复用同一版本。
+- deploy 默认持续反馈并跟踪平台结果；观察中断用 status <运行ID> --watch 继续，保留原运行，不重新构建。平台部署成功后仍需真实角色业务验收。
+- 开发开始先同步远端默认主分支；同一工作区只有一个写者。发布前将本轮源码、生成契约与记录合入并推送主分支，从干净且同步的主分支冻结候选；任务分支已推送不等于已合入主线。不要覆盖其他会话改动或自动合并所有分支。
+- 默认读取 AppSpec 当前规格、活动变更和阶段缺口，按角色、规则、页面、数据澄清模糊需求，再评估架构、权限和性能边界。总纲保存长期规则，本轮变更关联需求、任务、源码与 AC 验收；测试发布前完成设计与计划，生产晋级前保存绑定原测试运行及包摘要的实际验收报告。更新当前规则、验证与发布结果和交接后归档；不得编造确认或通过结果。
+- 根据变化风险记录业务意图。无行为变化引用已有记录；已有授权和已确认意图不重复向用户请求机械确认。真实角色和浏览器验收与本地测试分别记录。
+- 失败保留错误码、指针和原候选；查询平台状态后使用允许的恢复操作，不自动重放未知结果。
+
+MCP 使用同一项目 CLI：`pnpm exec openxiangda --mcp-stdio --cwd <workspace>`。先读取 workspace_context，再按任务读取 docs_read 和当前契约。登录、创建及长期 dev 使用 CLI/终端。
+
+详细用法：`pnpm openxiangda docs development`、`docs frontend`、`docs data-authz`、`docs administration`、`docs testing`、`docs delivery`。按需加载，无需每次通读全部资料。
+<!-- OPENXIANGDA:END -->
+
+## 项目自有约定
+
+在此补充本项目的业务范围和团队要求；平台资料刷新保留本节内容。

package/template/README.md

@@ -0,0 +1,45 @@
+# OpenXiangda 2.0 应用
+
+本项目使用精确版本的 openxiangda 根包。默认包含 Web 和共享契约，普通 CRUD、标准审批与通知由平台执行；真实业务动作才按需启用 Nest。
+
+## 开始
+
+```bash
+pnpm install --frozen-lockfile
+pnpm openxiangda context --json
+pnpm openxiangda dev
+```
+
+依赖已安装时无需重复安装。开发连接已绑定的远端测试数据，终端和页面显示实际环境。缺少账号或绑定时按命令错误提示处理；不要调用旧版全局 CLI。
+
+## 阅读资料
+
+```bash
+pnpm openxiangda docs
+pnpm openxiangda docs development
+pnpm openxiangda docs application-foundation
+pnpm openxiangda docs frontend
+pnpm openxiangda docs data-authz
+```
+
+资料来自当前根包；长主题支持 --section <章节ID>。AGENTS.md 的平台段说明基本约定，项目自有内容保留在该段之外。AI Skill 按任务读取同源资料。
+
+## 声明与页面
+
+业务模型和页面选择保存在 modules，应用根配置负责装配。模型不隐含导航或写授权。字段与标准 CRUD 使用平台组件；PC 控件使用 antd，移动使用 openxiangda/mobile。应用负责最小文档重置和局部样式，不直接导入 antd-mobile 全局重置。
+
+apps/server 仅在启用后端时初始化。后续 check/dev 保留业务源码，普通 CRUD 不增加 controller。
+
+## 检查与发布
+
+只检查时运行 `pnpm openxiangda check`；需要发布测试环境时直接运行 `pnpm openxiangda deploy`，它已包含检查、测试和构建。纯前端无需 Docker，启用后端时才构建官方 Dockerfile 镜像。
+
+运行 status/logs 确认平台结果并完成真实角色验收。生产使用 `pnpm openxiangda deploy --environment production --from <成功测试运行ID>`；`--dry-run` 只预览。完整发布、取消、恢复和回滚说明使用 `pnpm openxiangda docs delivery`。
+
+## MCP
+
+```bash
+pnpm exec openxiangda --mcp-stdio --cwd <项目绝对路径>
+```
+
+先读 workspace_context，再按需读取 docs_read 和 contract_describe；升级包后重启连接。登录、创建与长期开发进程继续使用 CLI。

package/template/_gitignore

@@ -0,0 +1,14 @@
+node_modules/
+dist/
+coverage/
+playwright-report/
+test-results/
+.openxiangda/
+.turbo/
+.turbopack/
+.umi/
+.umi-production/
+.codegraph/
+.env
+*.log
+.DS_Store

package/template/apps/web/data-api-live.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="native-projection-app" />
+    <meta name="openxiangda-environment" content="production" />
+    <title>OpenXiangda Standard Data API Live Acceptance</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/e2e/data-api-live-fixture.tsx"></script>
+  </body>
+</html>

package/template/apps/web/e2e/client-fixture.ts

@@ -0,0 +1,5 @@
+export {
+  requestApplicationApi,
+  searchDirectory,
+  searchResource,
+} from 'openxiangda/core';

package/template/apps/web/e2e/component-defaults-fixture.css

@@ -0,0 +1,15 @@
+.component-defaults-page {
+  display: grid;
+  align-content: start;
+  gap: 16px;
+  padding: 24px;
+}
+
+.component-defaults-panel {
+  border: 1px solid var(--ant-color-border-secondary);
+  border-radius: var(--ant-border-radius);
+  background: var(--ant-color-bg-container);
+  padding: 24px;
+  color: var(--ant-color-text);
+  box-shadow: var(--ant-box-shadow-tertiary);
+}

package/template/apps/web/e2e/data-api-live-fixture.tsx

@@ -0,0 +1,162 @@
+import { Refine } from '@refinedev/core';
+import { App as AntdApp } from 'antd';
+import React from 'react';
+import ReactDOM from 'react-dom/client';
+import { MemoryRouter, Route, Routes } from 'react-router-dom';
+import {
+  OpenXiangdaUiProvider,
+  createApplicationProvider,
+  GeneratedResourcePage,
+  OpenXiangdaResourceDefinitionsProvider,
+  RuntimeBoundary,
+  type GeneratedResourceDefinition,
+} from 'openxiangda/react';
+import 'openxiangda/react/styles.css';
+
+const code = 'field-records';
+const capabilityBase = `app:native-projection-app:data:${code}`;
+const capabilities = {
+  read: `${capabilityBase}:read`,
+  create: `${capabilityBase}:create`,
+  update: `${capabilityBase}:update`,
+  delete: `${capabilityBase}:delete`,
+};
+
+function fieldCapabilities() {
+  return {
+    readCapabilities: [capabilities.read],
+    createCapabilities: [capabilities.create],
+    updateCapabilities: [capabilities.update],
+  };
+}
+
+export const liveDefinition: GeneratedResourceDefinition = {
+  code,
+  name: '字段协议记录',
+  capabilities,
+  surface: {
+    mutationOwner: 'native',
+    generated: {
+      list: true,
+      detail: true,
+      create: true,
+      update: true,
+      delete: true,
+    },
+    fields: {
+      text_short: {
+        label: '标题',
+        type: 'text.short',
+        widget: 'text',
+        requiredHint: true,
+        maxLength: 120,
+        list: true,
+        searchable: true,
+        sortable: true,
+        ...fieldCapabilities(),
+      },
+      option_single: {
+        label: '单选快照',
+        type: 'option.single',
+        widget: 'radio',
+        options: [
+          { label: 'Open', value: 'open' },
+          { label: 'Closed', value: 'closed' },
+        ],
+        list: true,
+        ...fieldCapabilities(),
+      },
+      option_multiple: {
+        label: '多选快照',
+        type: 'option.multiple',
+        widget: 'checkbox',
+        options: [
+          { label: 'Open', value: 'open' },
+          { label: 'Urgent', value: 'urgent' },
+        ],
+        list: true,
+        ...fieldCapabilities(),
+      },
+      location_value: {
+        label: '精确定位',
+        type: 'location',
+        widget: 'location',
+        list: true,
+        ...fieldCapabilities(),
+      },
+    },
+    list: {
+      defaultPageSize: 20,
+      searchableFields: ['text_short'],
+      filterFields: ['option_single'],
+      defaultSort: { field: 'text_short', order: 'asc' },
+    },
+    form: { layout: 'sections' },
+    detail: { layout: 'sections' },
+    mobile: { enabled: true },
+  },
+};
+
+const definitions = { [code]: liveDefinition };
+const provider = createApplicationProvider(definitions);
+const routeBase = `/admin/resources/${code}`;
+const routePaths = {
+  fallback: '/admin',
+  list: routeBase,
+  create: `${routeBase}/new`,
+  detail: `${routeBase}/:id`,
+  edit: `${routeBase}/:id/edit`,
+};
+const initialPath =
+  new URLSearchParams(window.location.search).get('initial') || routeBase;
+
+function resourcePage(mode: 'list' | 'create' | 'edit' | 'detail') {
+  return (
+    <GeneratedResourcePage
+      definition={liveDefinition}
+      mode={mode}
+      paths={routePaths}
+      resourceCode={code}
+    />
+  );
+}
+
+ReactDOM.createRoot(document.getElementById('root')!).render(
+  <React.StrictMode>
+    <OpenXiangdaResourceDefinitionsProvider definitions={definitions}>
+      <OpenXiangdaUiProvider>
+        <AntdApp>
+          <RuntimeBoundary>
+            <MemoryRouter initialEntries={[initialPath]}>
+            <Refine
+              dataProvider={provider}
+              resources={[
+                {
+                  name: code,
+                  list: routePaths.list,
+                  create: routePaths.create,
+                  edit: routePaths.edit,
+                  show: routePaths.detail,
+                },
+              ]}
+            >
+              <Routes>
+                <Route path={routePaths.list} element={resourcePage('list')} />
+                <Route path={routePaths.create} element={resourcePage('create')} />
+                <Route
+                  path={routePaths.detail}
+                  element={resourcePage('detail')}
+                />
+                <Route
+                  path={routePaths.edit}
+                  element={resourcePage('edit')}
+                />
+              </Routes>
+            </Refine>
+            </MemoryRouter>
+          </RuntimeBoundary>
+        </AntdApp>
+      </OpenXiangdaUiProvider>
+    </OpenXiangdaResourceDefinitionsProvider>
+  </React.StrictMode>
+);