openxiangda 1.0.22 → 1.0.25

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

@@ -0,0 +1,23 @@
+import type { TicketOperator, TicketRecord } from "./types";
+import { getAvailableTicketActions } from "./state-machine";
+
+export function canViewTicket(ticket: TicketRecord, operator: TicketOperator) {
+  if (operator.roleCodes.includes("app_admin")) return true;
+  if (ticket.ownerUserId === operator.userId) return true;
+  if (ticket.collegeId && operator.collegeIds?.includes(ticket.collegeId)) return true;
+  if (ticket.classId && operator.classIds?.includes(ticket.classId)) return true;
+  if (
+    ticket.ownerDeptId &&
+    operator.departmentIds?.includes(ticket.ownerDeptId)
+  ) {
+    return true;
+  }
+  return false;
+}
+
+export function getTicketUiPermissions(ticket: TicketRecord, operator: TicketOperator) {
+  return {
+    canView: canViewTicket(ticket, operator),
+    actions: getAvailableTicketActions(ticket, operator),
+  };
+}

package/templates/sy-lowcode-app-workspace/examples/best-practices/src/domain/service-ticket/state-machine.test.ts

@@ -0,0 +1,63 @@
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+
+import {
+  assertTicketTransition,
+  getAvailableTicketActions,
+  getNextTicketStatus,
+} from "./state-machine";
+import type { TicketOperator, TicketRecord } from "./types";
+
+const operator: TicketOperator = {
+  userId: "u_001",
+  roleCodes: ["ticket_operator"],
+  departmentIds: ["dept_lab"],
+};
+
+const ticket: TicketRecord = {
+  formInstanceId: "ticket_001",
+  title: "设备故障",
+  status: "new",
+  ownerDeptId: "dept_lab",
+};
+
+describe("service-ticket state machine", () => {
+  it("returns deterministic next status", () => {
+    assert.equal(getNextTicketStatus("new", "accept"), "accepted");
+    assert.equal(getNextTicketStatus("resolved", "close"), "closed");
+    assert.equal(getNextTicketStatus("closed", "start"), null);
+  });
+
+  it("filters available actions by status and operator permission", () => {
+    assert.deepEqual(getAvailableTicketActions(ticket, operator), [
+      "accept",
+      "cancel",
+    ]);
+
+    assert.deepEqual(
+      getAvailableTicketActions(ticket, {
+        userId: "u_002",
+        roleCodes: ["student"],
+        departmentIds: ["dept_other"],
+      }),
+      [],
+    );
+  });
+
+  it("throws clear errors for unauthorized or invalid transitions", () => {
+    assert.throws(
+      () =>
+        assertTicketTransition(ticket, "accept", {
+          userId: "u_002",
+          roleCodes: [],
+          departmentIds: [],
+        }),
+      /无权操作/,
+    );
+
+    assert.throws(
+      () => assertTicketTransition({ ...ticket, status: "closed" }, "start", operator),
+      /不允许执行动作/,
+    );
+  });
+});

package/templates/sy-lowcode-app-workspace/examples/best-practices/src/domain/service-ticket/state-machine.ts

@@ -0,0 +1,73 @@
+import type { TicketAction, TicketOperator, TicketRecord, TicketStatus } from "./types";
+
+export const ticketStatusLabels: Record<TicketStatus, string> = {
+  new: "新建",
+  accepted: "已受理",
+  processing: "处理中",
+  paused: "挂起",
+  resolved: "已解决",
+  closed: "已关闭",
+  cancelled: "已取消",
+};
+
+export const ticketActionLabels: Record<TicketAction, string> = {
+  accept: "受理",
+  start: "开始处理",
+  pause: "挂起",
+  resume: "恢复",
+  resolve: "解决",
+  close: "关闭",
+  cancel: "取消",
+};
+
+const transitionTable: Record<TicketStatus, Partial<Record<TicketAction, TicketStatus>>> = {
+  new: { accept: "accepted", cancel: "cancelled" },
+  accepted: { start: "processing", cancel: "cancelled" },
+  processing: { pause: "paused", resolve: "resolved" },
+  paused: { resume: "processing", cancel: "cancelled" },
+  resolved: { close: "closed" },
+  closed: {},
+  cancelled: {},
+};
+
+export function getNextTicketStatus(
+  status: TicketStatus,
+  action: TicketAction,
+): TicketStatus | null {
+  return transitionTable[status]?.[action] || null;
+}
+
+export function canOperateTicket(ticket: TicketRecord, operator: TicketOperator) {
+  if (operator.roleCodes.includes("app_admin")) return true;
+  if (ticket.ownerUserId && ticket.ownerUserId === operator.userId) return true;
+  if (
+    ticket.ownerDeptId &&
+    operator.departmentIds?.includes(ticket.ownerDeptId)
+  ) {
+    return true;
+  }
+  return false;
+}
+
+export function getAvailableTicketActions(
+  ticket: TicketRecord,
+  operator: TicketOperator,
+): TicketAction[] {
+  if (!canOperateTicket(ticket, operator)) return [];
+  return Object.keys(transitionTable[ticket.status] || {}) as TicketAction[];
+}
+
+export function assertTicketTransition(
+  ticket: TicketRecord,
+  action: TicketAction,
+  operator: TicketOperator,
+) {
+  if (!canOperateTicket(ticket, operator)) {
+    throw new Error("当前用户无权操作该工单");
+  }
+  const nextStatus = getNextTicketStatus(ticket.status, action);
+  if (!nextStatus) {
+    throw new Error(`状态 ${ticket.status} 不允许执行动作 ${action}`);
+  }
+  return nextStatus;
+}

package/templates/sy-lowcode-app-workspace/examples/best-practices/src/domain/service-ticket/ticket-query.test.ts

@@ -0,0 +1,34 @@
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+
+import { buildTicketFilterGroup } from "./ticket-query";
+
+describe("service-ticket query builder", () => {
+  it("builds structured filters instead of browser-side filtering", () => {
+    const group = buildTicketFilterGroup({
+      keyword: "离心机",
+      statuses: ["new", "processing"],
+      priorities: ["urgent"],
+      collegeId: "college_science",
+    });
+
+    assert.equal(group.logic, "AND");
+    assert.deepEqual(
+      group.rules.map((item) => item.key),
+      ["status", "priority", "collegeId"],
+    );
+    assert.equal(group.conditions.length, 1);
+    assert.equal(group.conditions[0]?.logic, "OR");
+    assert.deepEqual(
+      group.conditions[0]?.rules.map((item) => item.key),
+      ["title", "description"],
+    );
+  });
+
+  it("omits empty search fields", () => {
+    const group = buildTicketFilterGroup({ keyword: "   " });
+
+    assert.deepEqual(group.rules, []);
+    assert.deepEqual(group.conditions, []);
+  });
+});

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

@@ -0,0 +1,73 @@
+import type { TicketSearchState } from "./types";
+
+export type FilterLogic = "AND" | "OR";
+
+export interface FilterRule {
+  id: string;
+  key: string;
+  componentName: string;
+  operator: string;
+  value: unknown;
+}
+
+export interface FilterGroup {
+  id: string;
+  logic: FilterLogic;
+  rules: FilterRule[];
+  conditions: FilterGroup[];
+}
+
+const rule = (
+  key: string,
+  componentName: string,
+  operator: string,
+  value: unknown,
+): FilterRule => ({
+  id: `${key}_${operator}`,
+  key,
+  componentName,
+  operator,
+  value,
+});
+
+export function buildTicketFilterGroup(search: TicketSearchState): FilterGroup {
+  const group: FilterGroup = {
+    id: "ticket_filters",
+    logic: "AND",
+    rules: [],
+    conditions: [],
+  };
+
+  if (search.statuses?.length) {
+    group.rules.push(rule("status", "SelectField", "IN", search.statuses));
+  }
+  if (search.priorities?.length) {
+    group.rules.push(rule("priority", "SelectField", "IN", search.priorities));
+  }
+  if (search.ownerUserId) {
+    group.rules.push(rule("ownerUserId", "TextField", "EQ", search.ownerUserId));
+  }
+  if (search.ownerDeptId) {
+    group.rules.push(rule("ownerDeptId", "TextField", "EQ", search.ownerDeptId));
+  }
+  if (search.collegeId) {
+    group.rules.push(rule("collegeId", "TextField", "EQ", search.collegeId));
+  }
+  if (search.classId) {
+    group.rules.push(rule("classId", "TextField", "EQ", search.classId));
+  }
+  if (search.keyword?.trim()) {
+    const keyword = search.keyword.trim();
+    group.conditions.push({
+      id: "keyword_or",
+      logic: "OR",
+      rules: [
+        rule("title", "TextField", "CONTAINS", keyword),
+        rule("description", "TextAreaField", "CONTAINS", keyword),
+      ],
+      conditions: [],
+    });
+  }
+
+  return group;
+}

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

@@ -0,0 +1,64 @@
+export type TicketStatus =
+  | "new"
+  | "accepted"
+  | "processing"
+  | "paused"
+  | "resolved"
+  | "closed"
+  | "cancelled";
+
+export type TicketAction =
+  | "accept"
+  | "start"
+  | "pause"
+  | "resume"
+  | "resolve"
+  | "close"
+  | "cancel";
+
+export type TicketPriority = "urgent" | "high" | "normal" | "low";
+
+export interface TicketRecord {
+  formInstanceId: string;
+  title: string;
+  status: TicketStatus;
+  priority?: TicketPriority;
+  ownerUserId?: string;
+  ownerDeptId?: string;
+  collegeId?: string;
+  classId?: string;
+  requester?: { label: string; value: string };
+  currentOwner?: { label: string; value: string };
+  description?: string;
+  lastActionAt?: string;
+}
+
+export interface TicketActionLog {
+  ticketId: string;
+  action: TicketAction;
+  fromStatus?: TicketStatus;
+  toStatus: TicketStatus;
+  operatorId: string;
+  operatorName?: string;
+  comment?: string;
+  operatedAt: string;
+}
+
+export interface TicketOperator {
+  userId: string;
+  userName?: string;
+  roleCodes: string[];
+  collegeIds?: string[];
+  classIds?: string[];
+  departmentIds?: string[];
+}
+
+export interface TicketSearchState {
+  keyword?: string;
+  statuses?: TicketStatus[];
+  priorities?: TicketPriority[];
+  ownerUserId?: string;
+  ownerDeptId?: string;
+  collegeId?: string;
+  classId?: string;
+}

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

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

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

@@ -0,0 +1,57 @@
+import { createFormSchema } from "@/shared/form-schema";
+
+export default createFormSchema({
+  formMeta: {
+    formUuid: "",
+    appType: process.env.OPENXIANGDA_APP_TYPE || "APP_XXXX",
+    title: "应用角色维护",
+  },
+  fields: [
+    {
+      fieldId: "roleCode",
+      componentName: "TextField",
+      label: "角色编码",
+      required: true,
+      placeholder: "如 college_admin",
+    },
+    {
+      fieldId: "roleName",
+      componentName: "TextField",
+      label: "角色名称",
+      required: true,
+    },
+    {
+      fieldId: "members",
+      componentName: "UserSelectField",
+      label: "成员",
+      multiple: true,
+    },
+    {
+      fieldId: "collegeId",
+      componentName: "TextField",
+      label: "学院 ID",
+      tips: "与业务表冗余字段配合，用于条件式数据权限。",
+    },
+    {
+      fieldId: "classId",
+      componentName: "TextField",
+      label: "班级 ID",
+      tips: "与业务表冗余字段配合，用于条件式数据权限。",
+    },
+    {
+      fieldId: "enabled",
+      componentName: "RadioField",
+      label: "启用状态",
+      defaultValue: { label: "启用", value: "enabled" },
+      options: [
+        { label: "启用", value: "enabled" },
+        { label: "停用", value: "disabled" },
+      ],
+    },
+    {
+      fieldId: "lastSyncedAt",
+      componentName: "DateField",
+      label: "最近同步时间",
+    },
+  ],
+});

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

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

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 };
+}