openxiangda 1.0.42 → 1.0.43

package/README.md

@@ -93,6 +93,54 @@ Create a new publishable app workspace with `openxiangda workspace init <dir>`.
 
 New OpenXiangda code pages and form custom pages publish with `cssIsolation: "none"` by default, so Tailwind utilities and normal Ant Design styles apply without a `.sy-app-workspace` prefix. Explicit `namespace` and `shadow` settings are kept only for legacy compatibility.
 
+OpenXiangda workspaces include a lightweight runtime preview for new user pages. `/view` remains the user-facing URL prefix, but local development does not enter the legacy `sy-lowcode-view` workbench checks; the Vite dev host mounts `src/pages/*` directly and sends SDK requests through the configured service proxy.
+
+```env
+OPENXIANGDA_BASE_URL=https://dev-lowcode.example.com
+OPENXIANGDA_APP_TYPE=APP_XXXX
+OPENXIANGDA_DEV_HOST=myapp.local
+OPENXIANGDA_DEV_PORT=5174
+APP_SERVICE_PREFIX=/service
+```
+
+```bash
+npm run dev
+```
+
+When `OPENXIANGDA_BASE_URL` or `APP_PLATFORM_URL` is set, the workspace Vite server proxies `/service/*` to the platform backend with `changeOrigin`, `cookieDomainRewrite: ""`, and `cookiePathRewrite: "/"`. This keeps local browser requests same-origin and lets HttpOnly `access_token` / `refresh_token` cookies be saved on the local dev domain.
+
+The dev host also calls the backend runtime route resolver for the current `/view/...` URL. Workbench code-page routes select and mount the matching local `src/pages/<page>/index.tsx`; built-in routes such as form submit, detail, process detail, data list, and file preview render the SDK default pages directly instead of accidentally mounting the first local page.
+
+Built-in route defaults come from the `openxiangda` SDK: `StandardFormPage`, `FormSubmitTemplate`, `FormDetailTemplate`, `ProcessDetailTemplate`, and `DataManagementList`. Workspaces can override whole built-in pages from `src/runtime/builtin-overrides.tsx`; exact `formUuid` entries win before the `*` fallback.
+
+```tsx
+import type { BuiltinRouteOverrides } from "openxiangda/runtime"
+
+export const runtimeRouteOverrides: BuiltinRouteOverrides = {
+  "form-submit": {
+    customer: CustomerSubmitPage,
+    "*": SubmitShell,
+  },
+  "form-detail": {},
+  "process-detail": {},
+  "data-manage-list": {},
+}
+```
+
+AI / Playwright verification should use real user identity, not a bypass mode. The backend exposes `POST /openxiangda-api/v1/apps/:appType/verification-login-links` for platform admins to create a short-lived, single-use `loginUrl` for a target user and redirect URI. Playwright can open the returned URL directly; the backend writes cookies and redirects back to the local or tenant `/view/...` page. Test users can be created with `POST /openxiangda-api/v1/apps/:appType/test-users`; they use the `__ox_ai_test__:<appType>:<key>` ID prefix and are intended to be used through verification login links.
+
+An independent production user shell can call `resolveBrowserRuntimeRoute()` from `openxiangda/runtime` first. It posts the current `/view/...` path to `/openxiangda-api/v1/apps/:appType/runtime/routes/resolve`; the backend classifies the route as `custom-page`, `builtin-route`, `legacy-fallback`, or `not-found`. Code pages return backend-authorized bootstrap data directly, so the shell can pass that to `mountBrowserPageRuntime()` or mount with `createBrowserPageContext()` without reusing the legacy view workbench logic. Built-in routes can be rendered with `BuiltinRouteRenderer`, which loads form schema through the same `/service` proxy and keeps backend permission checks authoritative.
+
+```ts
+import { resolveBrowserRuntimeRoute } from "openxiangda/runtime"
+
+const route = await resolveBrowserRuntimeRoute({
+  appType: "APP_XXXX",
+  path: window.location.pathname,
+  search: window.location.search,
+})
+```
+
 Local workspace state is authoritative. If the current folder has no `.openxiangda/state.json` app binding, create a new app instead of searching the platform for a similar app name:
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openxiangda",
-  "version": "1.0.42",
+  "version": "1.0.43",
   "description": "OpenXiangda CLI, workspace build tools, runtime SDK, and form components.",
   "private": false,
   "bin": {

package/packages/sdk/dist/components/index.cjs

@@ -48407,6 +48407,7 @@ var DataManagementList = ({
                 appType,
                 formUuid,
                 formInstanceId: String(getRecordId(activeRecord)),
+                api,
                 inDrawer: true
               }
             ) : /* @__PURE__ */ (0, import_jsx_runtime101.jsx)(import_antd39.Empty, { description: "\u8BF7\u901A\u8FC7 detailRenderer \u63A5\u5165\u8BE6\u60C5\u6A21\u677F" })
@@ -48435,6 +48436,7 @@ var DataManagementList = ({
                 mode: "submit",
                 appType,
                 formUuid,
+                api,
                 inDrawer: true,
                 onSubmitSuccess: () => {
                   setSubmitOpen(false);