openxiangda 1.0.21 → 1.0.24

package/templates/sy-lowcode-app-workspace/examples/best-practices/src/forms/customer-profile/schema.ts

@@ -0,0 +1,83 @@
+import { createFormSchema } from "@/shared/form-schema";
+
+export default createFormSchema({
+  formMeta: {
+    formUuid: "",
+    appType: process.env.OPENXIANGDA_APP_TYPE || "APP_XXXX",
+    title: "客户档案",
+  },
+  fields: [
+    {
+      fieldId: "customerName",
+      componentName: "TextField",
+      label: "客户名称",
+      required: true,
+      placeholder: "请输入客户或组织名称",
+    },
+    {
+      fieldId: "customerLevel",
+      componentName: "SelectField",
+      label: "客户等级",
+      required: true,
+      options: [
+        { label: "重点客户", value: "key" },
+        { label: "普通客户", value: "normal" },
+        { label: "潜在客户", value: "prospect" },
+      ],
+    },
+    {
+      fieldId: "ownerUser",
+      componentName: "UserSelectField",
+      label: "负责人",
+      required: true,
+    },
+    {
+      fieldId: "ownerDept",
+      componentName: "DepartmentSelectField",
+      label: "负责部门",
+      required: true,
+    },
+    {
+      fieldId: "contactPhone",
+      componentName: "TextField",
+      label: "联系电话",
+      rules: [{ preset: "phone", message: "请输入有效手机号" }],
+    },
+    {
+      fieldId: "attachments",
+      componentName: "AttachmentField",
+      label: "附件",
+      maxCount: 5,
+    },
+    {
+      fieldId: "contacts",
+      componentName: "SubFormField",
+      label: "联系人",
+      columns: [
+        {
+          fieldId: "contactName",
+          componentName: "TextField",
+          label: "姓名",
+          required: true,
+        },
+        {
+          fieldId: "contactRole",
+          componentName: "TextField",
+          label: "角色",
+        },
+        {
+          fieldId: "contactMobile",
+          componentName: "TextField",
+          label: "手机",
+          rules: [{ preset: "phone", message: "请输入有效手机号" }],
+        },
+      ],
+    },
+    {
+      fieldId: "remark",
+      componentName: "TextAreaField",
+      label: "备注",
+      placeholder: "记录客户背景、跟进偏好或风险点",
+    },
+  ],
+});

package/templates/sy-lowcode-app-workspace/examples/best-practices/src/forms/service-ticket/page.tsx

@@ -0,0 +1 @@
+export { default } from "./schema";

package/templates/sy-lowcode-app-workspace/examples/best-practices/src/forms/service-ticket/schema.ts

@@ -0,0 +1,97 @@
+import { createFormSchema } from "@/shared/form-schema";
+
+export default createFormSchema({
+  formMeta: {
+    formUuid: "",
+    appType: process.env.OPENXIANGDA_APP_TYPE || "APP_XXXX",
+    title: "服务工单",
+  },
+  fields: [
+    {
+      fieldId: "title",
+      componentName: "TextField",
+      label: "标题",
+      required: true,
+    },
+    {
+      fieldId: "status",
+      componentName: "SelectField",
+      label: "状态",
+      required: true,
+      defaultValue: { label: "新建", value: "new" },
+      options: [
+        { label: "新建", value: "new" },
+        { label: "已受理", value: "accepted" },
+        { label: "处理中", value: "processing" },
+        { label: "挂起", value: "paused" },
+        { label: "已解决", value: "resolved" },
+        { label: "已关闭", value: "closed" },
+        { label: "已取消", value: "cancelled" },
+      ],
+    },
+    {
+      fieldId: "priority",
+      componentName: "SelectField",
+      label: "优先级",
+      defaultValue: { label: "普通", value: "normal" },
+      options: [
+        { label: "紧急", value: "urgent" },
+        { label: "高", value: "high" },
+        { label: "普通", value: "normal" },
+        { label: "低", value: "low" },
+      ],
+    },
+    {
+      fieldId: "ownerUserId",
+      componentName: "TextField",
+      label: "负责人 ID",
+      tips: "权限隔离冗余字段，服务层从人员字段同步写入。",
+    },
+    {
+      fieldId: "ownerDeptId",
+      componentName: "TextField",
+      label: "负责部门 ID",
+      tips: "权限隔离冗余字段，权限组按此字段配置条件。",
+    },
+    {
+      fieldId: "collegeId",
+      componentName: "TextField",
+      label: "学院 ID",
+      tips: "示例冗余字段，可换成业务组织维度。",
+    },
+    {
+      fieldId: "classId",
+      componentName: "TextField",
+      label: "班级 ID",
+      tips: "示例冗余字段，可换成业务组织维度。",
+    },
+    {
+      fieldId: "currentOwner",
+      componentName: "UserSelectField",
+      label: "当前处理人",
+    },
+    {
+      fieldId: "requester",
+      componentName: "UserSelectField",
+      label: "提交人",
+      required: true,
+    },
+    {
+      fieldId: "description",
+      componentName: "TextAreaField",
+      label: "问题描述",
+      required: true,
+    },
+    {
+      fieldId: "lastActionAt",
+      componentName: "DateField",
+      label: "最近操作时间",
+    },
+    {
+      fieldId: "attachments",
+      componentName: "AttachmentField",
+      label: "附件",
+      maxCount: 8,
+    },
+  ],
+});

package/templates/sy-lowcode-app-workspace/examples/best-practices/src/forms/ticket-action-log/page.tsx

@@ -0,0 +1 @@
+export { default } from "./schema";

package/templates/sy-lowcode-app-workspace/examples/best-practices/src/forms/ticket-action-log/schema.ts

@@ -0,0 +1,65 @@
+import { createFormSchema } from "@/shared/form-schema";
+
+export default createFormSchema({
+  formMeta: {
+    formUuid: "",
+    appType: process.env.OPENXIANGDA_APP_TYPE || "APP_XXXX",
+    title: "工单操作日志",
+  },
+  fields: [
+    {
+      fieldId: "ticketId",
+      componentName: "TextField",
+      label: "工单实例 ID",
+      required: true,
+    },
+    {
+      fieldId: "action",
+      componentName: "SelectField",
+      label: "动作",
+      required: true,
+      options: [
+        { label: "受理", value: "accept" },
+        { label: "开始处理", value: "start" },
+        { label: "挂起", value: "pause" },
+        { label: "恢复", value: "resume" },
+        { label: "解决", value: "resolve" },
+        { label: "关闭", value: "close" },
+        { label: "取消", value: "cancel" },
+      ],
+    },
+    {
+      fieldId: "fromStatus",
+      componentName: "TextField",
+      label: "原状态",
+    },
+    {
+      fieldId: "toStatus",
+      componentName: "TextField",
+      label: "新状态",
+      required: true,
+    },
+    {
+      fieldId: "operatorId",
+      componentName: "TextField",
+      label: "操作者 ID",
+      required: true,
+    },
+    {
+      fieldId: "operatorName",
+      componentName: "TextField",
+      label: "操作者",
+    },
+    {
+      fieldId: "comment",
+      componentName: "TextAreaField",
+      label: "说明",
+    },
+    {
+      fieldId: "operatedAt",
+      componentName: "DateField",
+      label: "操作时间",
+      required: true,
+    },
+  ],
+});

package/templates/sy-lowcode-app-workspace/examples/best-practices/src/js-code-nodes/daily_ticket_digest/index.ts

@@ -0,0 +1,44 @@
+export default async function dailyTicketDigest(ctx: any) {
+  const appType = ctx.app.appType;
+  const pageSize = 50;
+  let currentPage = 1;
+  let total = 0;
+  let riskCount = 0;
+
+  while (currentPage <= 20) {
+    const result = await ctx.methods.queryManyData(appType, "FORM_SERVICE_TICKET", {
+      currentPage,
+      pageSize,
+      filters: {
+        logic: "AND",
+        rules: [
+          {
+            key: "status",
+            componentName: "SelectField",
+            operator: "IN",
+            value: ["new", "accepted", "processing", "paused"],
+          },
+        ],
+      },
+    });
+    const rows = result?.data || result?.list || [];
+    total += rows.length;
+    riskCount += rows.filter((row: any) => row.priority?.value === "urgent").length;
+    if (rows.length < pageSize) break;
+    currentPage += 1;
+  }
+
+  if (total > 0 && ctx.operator?.userId) {
+    await ctx.notification.sendByType({
+      notificationType: "daily_ticket_digest",
+      recipientId: ctx.operator.userId,
+      payload: {
+        title: "每日工单摘要",
+        count: total,
+        riskCount,
+      },
+    });
+  }
+
+  return { total, riskCount };
+}

package/templates/sy-lowcode-app-workspace/examples/best-practices/src/js-code-nodes/sync_roles_to_platform/index.ts

@@ -0,0 +1,33 @@
+export default async function syncRolesToPlatform(ctx: any) {
+  const appType = ctx.app.appType;
+  const roles = await ctx.methods.queryManyData(appType, "FORM_APP_ROLE", {
+    currentPage: 1,
+    pageSize: 100,
+    filters: {
+      logic: "AND",
+      rules: [
+        {
+          key: "enabled",
+          componentName: "RadioField",
+          operator: "EQ",
+          value: "enabled",
+        },
+      ],
+    },
+  });
+
+  const rows = roles?.data || roles?.list || [];
+  const synced: string[] = [];
+  for (const row of rows) {
+    const roleCode = String(row.roleCode || "").trim().toLowerCase();
+    if (!roleCode) continue;
+    await ctx.platform.api.post(`/openxiangda-api/v1/apps/${appType}/roles`, {
+      code: roleCode,
+      name: row.roleName || roleCode,
+      description: "由业务角色维护表同步",
+    });
+    synced.push(roleCode);
+  }
+
+  return { synced };
+}

package/templates/sy-lowcode-app-workspace/examples/best-practices/src/pages/interactive-workbench/App.tsx

@@ -0,0 +1,7 @@
+import "./styles.css";
+
+import { WorkbenchPage } from "./WorkbenchPage";
+
+export default function App() {
+  return <WorkbenchPage />;
+}

package/templates/sy-lowcode-app-workspace/examples/best-practices/src/pages/interactive-workbench/WorkbenchPage.tsx

@@ -0,0 +1,36 @@
+import { Button, Card, Space, Typography } from "antd";
+import { useReducer } from "react";
+
+import { ConfigPanel } from "./components/ConfigPanel";
+import { PreviewPanel } from "./components/PreviewPanel";
+import { initialWorkbenchState, workbenchReducer } from "./reducer";
+
+export function WorkbenchPage() {
+  const [state, dispatch] = useReducer(workbenchReducer, initialWorkbenchState);
+  return (
+    <main className="bp-workbench">
+      <section className="bp-workbench__header">
+        <div>
+          <Typography.Title level={3}>交互工作台</Typography.Title>
+          <Typography.Text type="secondary">
+            reducer 管理交互状态，面板拆分，页面只负责组合。
+          </Typography.Text>
+        </div>
+        <Space>
+          <Button disabled={!state.dirty} onClick={() => dispatch({ type: "saved" })}>
+            保存
+          </Button>
+          <Button type="primary">发布</Button>
+        </Space>
+      </section>
+      <section className="bp-workbench__grid">
+        <Card title="配置">
+          <ConfigPanel state={state} dispatch={dispatch} />
+        </Card>
+        <Card title="预览">
+          <PreviewPanel state={state} />
+        </Card>
+      </section>
+    </main>
+  );
+}

package/templates/sy-lowcode-app-workspace/examples/best-practices/src/pages/interactive-workbench/components/ConfigPanel.tsx

@@ -0,0 +1,34 @@
+import { Input, Segmented, Space } from "antd";
+import type { Dispatch } from "react";
+
+import type { WorkbenchAction, WorkbenchState } from "../reducer";
+
+export function ConfigPanel(props: {
+  state: WorkbenchState;
+  dispatch: Dispatch<WorkbenchAction>;
+}) {
+  return (
+    <Space direction="vertical" className="bp-workbench__panel" size="middle">
+      <Input
+        value={props.state.draftName}
+        onChange={(event) =>
+          props.dispatch({ type: "rename", name: event.target.value })
+        }
+      />
+      <Segmented
+        value={props.state.selectedMode}
+        options={[
+          { label: "规划", value: "plan" },
+          { label: "预览", value: "preview" },
+          { label: "发布", value: "publish" },
+        ]}
+        onChange={(mode) =>
+          props.dispatch({
+            type: "selectMode",
+            mode: mode as WorkbenchState["selectedMode"],
+          })
+        }
+      />
+    </Space>
+  );
+}

package/templates/sy-lowcode-app-workspace/examples/best-practices/src/pages/interactive-workbench/components/PreviewPanel.tsx

@@ -0,0 +1,17 @@
+import { Descriptions, Tag } from "antd";
+
+import type { WorkbenchState } from "../reducer";
+
+export function PreviewPanel({ state }: { state: WorkbenchState }) {
+  return (
+    <Descriptions column={1} size="small">
+      <Descriptions.Item label="方案">{state.draftName}</Descriptions.Item>
+      <Descriptions.Item label="模式">{state.selectedMode}</Descriptions.Item>
+      <Descriptions.Item label="状态">
+        <Tag color={state.dirty ? "warning" : "success"}>
+          {state.dirty ? "有未保存修改" : "已保存"}
+        </Tag>
+      </Descriptions.Item>
+    </Descriptions>
+  );
+}

package/templates/sy-lowcode-app-workspace/examples/best-practices/src/pages/interactive-workbench/index.tsx

@@ -0,0 +1,10 @@
+import { createReactPage } from "openxiangda/runtime";
+
+import App from "./App";
+
+const page = createReactPage(App);
+
+export const mount = page.mount;
+export const update = page.update;
+export const unmount = page.unmount;
+export default page;

package/templates/sy-lowcode-app-workspace/examples/best-practices/src/pages/interactive-workbench/page.config.ts

@@ -0,0 +1,9 @@
+import { definePageConfig } from "@/types/app-workspace.types";
+
+export default definePageConfig({
+  code: "interactive_workbench",
+  name: "交互工作台",
+  description: "纯复杂交互页面示例",
+  route: { pathKey: "interactive_workbench" },
+  menu: { name: "交互工作台" },
+});

package/templates/sy-lowcode-app-workspace/examples/best-practices/src/pages/interactive-workbench/reducer.ts

@@ -0,0 +1,29 @@
+export interface WorkbenchState {
+  selectedMode: "plan" | "preview" | "publish";
+  draftName: string;
+  dirty: boolean;
+}
+
+export type WorkbenchAction =
+  | { type: "selectMode"; mode: WorkbenchState["selectedMode"] }
+  | { type: "rename"; name: string }
+  | { type: "saved" };
+
+export const initialWorkbenchState: WorkbenchState = {
+  selectedMode: "plan",
+  draftName: "运营方案",
+  dirty: false,
+};
+
+export function workbenchReducer(
+  state: WorkbenchState,
+  action: WorkbenchAction,
+): WorkbenchState {
+  if (action.type === "selectMode") {
+    return { ...state, selectedMode: action.mode };
+  }
+  if (action.type === "rename") {
+    return { ...state, draftName: action.name, dirty: true };
+  }
+  return { ...state, dirty: false };
+}

package/templates/sy-lowcode-app-workspace/examples/best-practices/src/pages/interactive-workbench/styles.css

@@ -0,0 +1,24 @@
+.bp-workbench {
+  display: grid;
+  gap: var(--sy-spacing-lg);
+  min-height: 100%;
+  padding: var(--sy-spacing-lg);
+  background: var(--sy-color-bg-layout);
+}
+
+.bp-workbench__header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: var(--sy-spacing-md);
+}
+
+.bp-workbench__grid {
+  display: grid;
+  grid-template-columns: minmax(280px, 360px) minmax(0, 1fr);
+  gap: var(--sy-spacing-md);
+}
+
+.bp-workbench__panel {
+  width: 100%;
+}

package/templates/sy-lowcode-app-workspace/examples/best-practices/src/pages/mobile-portal-shell/App.tsx

@@ -0,0 +1,7 @@
+import "./styles.css";
+
+import { MobilePortalShell } from "./MobilePortalShell";
+
+export default function App() {
+  return <MobilePortalShell />;
+}

package/templates/sy-lowcode-app-workspace/examples/best-practices/src/pages/mobile-portal-shell/MobilePortalShell.tsx

@@ -0,0 +1,31 @@
+import { Card, NavBar, SafeArea, TabBar } from "antd-mobile";
+import { useNavigation, usePageRoute } from "openxiangda/runtime";
+
+import { mobilePortalRoutes, parseMobilePortalRoute } from "./routes";
+import { MobileHome } from "./modules/MobileHome";
+
+export function MobilePortalShell() {
+  const route = parseMobilePortalRoute(usePageRoute().query.route as string);
+  const navigation = useNavigation();
+
+  return (
+    <main className="bp-mobile-shell">
+      <NavBar back={null}>移动工作门户</NavBar>
+      <section className="bp-mobile-shell__content">
+        {route === "home" ? (
+          <MobileHome />
+        ) : (
+          <Card title={route === "tickets" ? "工单" : "我的"}>
+            移动端仅保留高频任务，业务规则复用 PC 的 domain/service。
+          </Card>
+        )}
+      </section>
+      <TabBar activeKey={route} onChange={(key) => navigation.replaceRoute(key)}>
+        {mobilePortalRoutes.map((item) => (
+          <TabBar.Item key={item.key} title={item.label} />
+        ))}
+      </TabBar>
+      <SafeArea position="bottom" />
+    </main>
+  );
+}

package/templates/sy-lowcode-app-workspace/examples/best-practices/src/pages/mobile-portal-shell/index.tsx

@@ -0,0 +1,10 @@
+import { createReactPage } from "openxiangda/runtime";
+
+import App from "./App";
+
+const page = createReactPage(App);
+
+export const mount = page.mount;
+export const update = page.update;
+export const unmount = page.unmount;
+export default page;

package/templates/sy-lowcode-app-workspace/examples/best-practices/src/pages/mobile-portal-shell/modules/MobileHome.tsx

@@ -0,0 +1,13 @@
+import { Card, List } from "antd-mobile";
+
+export function MobileHome() {
+  return (
+    <Card title="今日概览">
+      <List>
+        <List.Item extra="18">待处理</List.Item>
+        <List.Item extra="5">超时风险</List.Item>
+        <List.Item extra="64">本周完成</List.Item>
+      </List>
+    </Card>
+  );
+}

package/templates/sy-lowcode-app-workspace/examples/best-practices/src/pages/mobile-portal-shell/page.config.ts

@@ -0,0 +1,14 @@
+import { definePageConfig } from "@/types/app-workspace.types";
+
+export default definePageConfig({
+  code: "mobile_portal_shell",
+  name: "移动工作门户",
+  description: "Mobile app-shell 入口示例",
+  route: { pathKey: "mobile_portal_shell" },
+  entry: {
+    mode: "app-shell",
+    hidePlatformNav: true,
+    defaultRoute: "home",
+  },
+  menu: { name: "移动工作门户" },
+});

package/templates/sy-lowcode-app-workspace/examples/best-practices/src/pages/mobile-portal-shell/routes.ts

@@ -0,0 +1,13 @@
+export type MobilePortalRoute = "home" | "tickets" | "mine";
+
+export const mobilePortalRoutes: Array<{ key: MobilePortalRoute; label: string }> = [
+  { key: "home", label: "首页" },
+  { key: "tickets", label: "工单" },
+  { key: "mine", label: "我的" },
+];
+
+export function parseMobilePortalRoute(value?: string): MobilePortalRoute {
+  return mobilePortalRoutes.some((item) => item.key === value)
+    ? (value as MobilePortalRoute)
+    : "home";
+}

package/templates/sy-lowcode-app-workspace/examples/best-practices/src/pages/mobile-portal-shell/styles.css

@@ -0,0 +1,11 @@
+.bp-mobile-shell {
+  display: flex;
+  min-height: 100%;
+  flex-direction: column;
+  background: var(--sy-color-bg-layout);
+}
+
+.bp-mobile-shell__content {
+  flex: 1;
+  padding: var(--sy-spacing-md);
+}

package/templates/sy-lowcode-app-workspace/examples/best-practices/src/pages/pc-portal-shell/App.tsx

@@ -0,0 +1,7 @@
+import "./styles.css";
+
+import { PcPortalShell } from "./PcPortalShell";
+
+export default function App() {
+  return <PcPortalShell />;
+}

package/templates/sy-lowcode-app-workspace/examples/best-practices/src/pages/pc-portal-shell/PcPortalShell.tsx

@@ -0,0 +1,35 @@
+import { Layout, Menu, Typography } from "antd";
+import { useNavigation, usePageRoute } from "openxiangda/runtime";
+
+import { pcPortalRoutes, parsePcPortalRoute } from "./routes";
+import { HomeModule } from "./modules/HomeModule";
+import { TicketsModule } from "./modules/TicketsModule";
+
+const { Content, Sider } = Layout;
+
+export function PcPortalShell() {
+  const route = parsePcPortalRoute(usePageRoute().query.route as string);
+  const navigation = useNavigation();
+
+  return (
+    <Layout className="bp-pc-shell">
+      <Sider width={220} className="bp-pc-shell__sider">
+        <Typography.Title level={4} className="bp-pc-shell__brand">
+          运营门户
+        </Typography.Title>
+        <Menu
+          mode="inline"
+          selectedKeys={[route]}
+          items={pcPortalRoutes.map((item) => ({
+            key: item.key,
+            label: item.label,
+          }))}
+          onClick={(item) => navigation.replaceRoute(String(item.key))}
+        />
+      </Sider>
+      <Content className="bp-pc-shell__content">
+        {route === "home" ? <HomeModule /> : <TicketsModule route={route} />}
+      </Content>
+    </Layout>
+  );
+}

package/templates/sy-lowcode-app-workspace/examples/best-practices/src/pages/pc-portal-shell/components/PortalMetric.tsx

@@ -0,0 +1,11 @@
+import { Card, Typography } from "antd";
+
+export function PortalMetric(props: { label: string; value: string; trend: string }) {
+  return (
+    <Card className="bp-portal-metric">
+      <Typography.Text type="secondary">{props.label}</Typography.Text>
+      <div className="bp-portal-metric__value">{props.value}</div>
+      <Typography.Text type="secondary">{props.trend}</Typography.Text>
+    </Card>
+  );
+}