feat(projects): 新增流程表达式功能

src/views/workflow/spel/index.vue

@@ -0,0 +1,221 @@
+<script setup lang="tsx">
+import { NDivider } from 'naive-ui';
+import { fetchBatchDeleteSpel, fetchGetSpelList } from '@/service/api/workflow/spel';
+import { useAppStore } from '@/store/modules/app';
+import { useAuth } from '@/hooks/business/auth';
+import { useDownload } from '@/hooks/business/download';
+import { useTable, useTableOperate } from '@/hooks/common/table';
+import { $t } from '@/locales';
+import ButtonIcon from '@/components/custom/button-icon.vue';
+import DictTag from '@/components/custom/dict-tag.vue';
+import TagGroup from '@/components/custom/tag-group.vue';
+import SpelOperateDrawer from './modules/spel-operate-drawer.vue';
+import SpelSearch from './modules/spel-search.vue';
+
+defineOptions({
+  name: 'SpelList'
+});
+
+const appStore = useAppStore();
+const { download } = useDownload();
+const { hasAuth } = useAuth();
+const {
+  columns,
+  columnChecks,
+  data,
+  getData,
+  getDataByPage,
+  loading,
+  mobilePagination,
+  searchParams,
+  resetSearchParams
+} = useTable({
+  apiFn: fetchGetSpelList,
+  apiParams: {
+    pageNum: 1,
+    pageSize: 10,
+    // if you want to use the searchParams in Form, you need to define the following properties, and the value is null
+    // the value can not be undefined, otherwise the property in Form will not be reactive
+    componentName: null,
+    methodName: null,
+    status: null,
+    params: {}
+  },
+  columns: () => [
+    {
+      type: 'selection',
+      align: 'center',
+      width: 48
+    },
+    {
+      key: 'index',
+      title: $t('common.index'),
+      align: 'center',
+      width: 64
+    },
+    {
+      key: 'componentName',
+      title: '组件名称',
+      align: 'center',
+      minWidth: 120
+    },
+    {
+      key: 'methodName',
+      title: '方法名',
+      align: 'center',
+      minWidth: 120
+    },
+    {
+      key: 'methodParams',
+      title: '参数',
+      align: 'center',
+      minWidth: 120,
+      render: row => {
+        return <TagGroup threadshold={4} value={row.methodParams} />;
+      }
+    },
+    {
+      key: 'viewSpel',
+      title: 'spel表达式',
+      align: 'center',
+      minWidth: 120
+    },
+    {
+      key: 'remark',
+      title: '备注',
+      align: 'center',
+      minWidth: 120
+    },
+    {
+      key: 'status',
+      title: '状态',
+      align: 'center',
+      minWidth: 120,
+      render: row => {
+        return <DictTag size="small" value={row.status} dict-code="sys_normal_disable" />;
+      }
+    },
+    {
+      key: 'operate',
+      title: $t('common.operate'),
+      align: 'center',
+      width: 130,
+      render: row => {
+        const divider = () => {
+          if (!hasAuth('workflow:spel:edit') || !hasAuth('workflow:spel:remove')) {
+            return null;
+          }
+          return <NDivider vertical />;
+        };
+
+        const editBtn = () => {
+          if (!hasAuth('workflow:spel:edit')) {
+            return null;
+          }
+          return (
+            <ButtonIcon
+              text
+              type="primary"
+              icon="material-symbols:drive-file-rename-outline-outline"
+              tooltipContent={$t('common.edit')}
+              onClick={() => edit(row.id!)}
+            />
+          );
+        };
+
+        const deleteBtn = () => {
+          if (!hasAuth('workflow:spel:remove')) {
+            return null;
+          }
+          return (
+            <ButtonIcon
+              text
+              type="error"
+              icon="material-symbols:delete-outline"
+              tooltipContent={$t('common.delete')}
+              popconfirmContent={$t('common.confirmDelete')}
+              onPositiveClick={() => handleDelete(row.id!)}
+            />
+          );
+        };
+
+        return (
+          <div class="flex-center gap-8px">
+            {editBtn()}
+            {divider()}
+            {deleteBtn()}
+          </div>
+        );
+      }
+    }
+  ]
+});
+
+const { drawerVisible, operateType, editingData, handleAdd, handleEdit, checkedRowKeys, onBatchDeleted, onDeleted } =
+  useTableOperate(data, getData);
+
+async function handleBatchDelete() {
+  // request
+  const { error } = await fetchBatchDeleteSpel(checkedRowKeys.value);
+  if (error) return;
+  onBatchDeleted();
+}
+
+async function handleDelete(id: CommonType.IdType) {
+  // request
+  const { error } = await fetchBatchDeleteSpel([id]);
+  if (error) return;
+  onDeleted();
+}
+
+function edit(id: CommonType.IdType) {
+  handleEdit('id', id);
+}
+
+function handleExport() {
+  download('/workflow/spel/export', searchParams, `流程spel达式定义_${new Date().getTime()}.xlsx`);
+}
+</script>
+
+<template>
+  <div class="min-h-500px flex-col-stretch gap-16px overflow-hidden lt-sm:overflow-auto">
+    <SpelSearch v-model:model="searchParams" @reset="resetSearchParams" @search="getDataByPage" />
+    <NCard title="流程表达式列表" :bordered="false" size="small" class="card-wrapper sm:flex-1-hidden">
+      <template #header-extra>
+        <TableHeaderOperation
+          v-model:columns="columnChecks"
+          :disabled-delete="checkedRowKeys.length === 0"
+          :loading="loading"
+          :show-add="hasAuth('workflow:spel:add')"
+          :show-delete="hasAuth('workflow:spel:remove')"
+          :show-export="hasAuth('workflow:spel:export')"
+          @add="handleAdd"
+          @delete="handleBatchDelete"
+          @export="handleExport"
+          @refresh="getData"
+        />
+      </template>
+      <NDataTable
+        v-model:checked-row-keys="checkedRowKeys"
+        :columns="columns"
+        :data="data"
+        size="small"
+        :flex-height="!appStore.isMobile"
+        :scroll-x="962"
+        :loading="loading"
+        remote
+        :row-key="row => row.id"
+        :pagination="mobilePagination"
+        class="sm:h-full"
+      />
+      <SpelOperateDrawer
+        v-model:visible="drawerVisible"
+        :operate-type="operateType"
+        :row-data="editingData"
+        @submitted="getDataByPage"
+      />
+    </NCard>
+  </div>
+</template>
+
+<style scoped></style>

src/views/workflow/spel/modules/spel-operate-drawer.vue

@@ -0,0 +1,179 @@
+<script setup lang="ts">
+import { computed, reactive, ref, watch } from 'vue';
+import { fetchCreateSpel, fetchUpdateSpel } from '@/service/api/workflow/spel';
+import { useFormRules, useNaiveForm } from '@/hooks/common/form';
+import { useDict } from '@/hooks/business/dict';
+import { $t } from '@/locales';
+
+defineOptions({
+  name: 'SpelOperateDrawer'
+});
+
+interface Props {
+  /** the type of operation */
+  operateType: NaiveUI.TableOperateType;
+  /** the edit row data */
+  rowData?: Api.Workflow.Spel | null;
+}
+
+const props = defineProps<Props>();
+
+interface Emits {
+  (e: 'submitted'): void;
+}
+
+const emit = defineEmits<Emits>();
+
+const visible = defineModel<boolean>('visible', {
+  default: false
+});
+
+const { options: sysNormalDisableOptions } = useDict('sys_normal_disable');
+
+const { formRef, validate, restoreValidation } = useNaiveForm();
+const { createRequiredRule } = useFormRules();
+
+const title = computed(() => {
+  const titles: Record<NaiveUI.TableOperateType, string> = {
+    add: '新增流程表达式',
+    edit: '编辑流程表达式'
+  };
+  return titles[props.operateType];
+});
+
+// 参数标签
+const methodParamTags = ref<string[]>([]);
+
+type Model = Api.Workflow.SpelOperateParams;
+
+const model: Model = reactive(createDefaultModel());
+
+function createDefaultModel(): Model {
+  return {
+    componentName: '',
+    methodName: '',
+    methodParams: '',
+    viewSpel: '',
+    remark: '',
+    status: ''
+  };
+}
+
+type RuleKey = Extract<keyof Model, 'id'>;
+
+const rules: Record<RuleKey, App.Global.FormRule> = {
+  id: createRequiredRule('主键id不能为空')
+};
+
+function handleUpdateModelWhenEdit() {
+  if (props.operateType === 'add') {
+    Object.assign(model, createDefaultModel());
+    methodParamTags.value = [];
+    return;
+  }
+
+  if (props.operateType === 'edit' && props.rowData) {
+    Object.assign(model, props.rowData);
+    // 如果有参数，将逗号分隔的字符串转为数组
+    methodParamTags.value = model.methodParams ? model.methodParams.split(',') : [];
+  }
+}
+
+// 实时更新 SPEL 表达式
+function updateSpelExpression() {
+  if (!model.componentName || !model.methodName) {
+    model.viewSpel = '';
+    return;
+  }
+
+  // 构建参数部分
+  const params = methodParamTags.value.map(param => `#${param}`).join(',');
+
+  // 生成 SPEL 表达式: #{@组件名.方法名(#参数1,#参数2,...)}
+  model.viewSpel = `#{@${model.componentName}.${model.methodName}(${params})}`;
+}
+
+// 监听组件名、方法名和参数变化
+watch(() => model.componentName, updateSpelExpression);
+watch(() => model.methodName, updateSpelExpression);
+watch(methodParamTags, updateSpelExpression, { deep: true });
+
+function closeDrawer() {
+  visible.value = false;
+}
+
+async function handleSubmit() {
+  await validate();
+
+  // 将参数标签数组转为逗号分隔的字符串
+  model.methodParams = methodParamTags.value.join(',');
+
+  const { id, componentName, methodName, methodParams, viewSpel, remark, status } = model;
+
+  // request
+  if (props.operateType === 'add') {
+    const { error } = await fetchCreateSpel({ componentName, methodName, methodParams, viewSpel, remark, status });
+    if (error) return;
+  }
+
+  if (props.operateType === 'edit') {
+    const { error } = await fetchUpdateSpel({ id, componentName, methodName, methodParams, viewSpel, remark, status });
+    if (error) return;
+  }
+
+  window.$message?.success($t('common.updateSuccess'));
+  closeDrawer();
+  emit('submitted');
+}
+
+watch(visible, () => {
+  if (visible.value) {
+    handleUpdateModelWhenEdit();
+    restoreValidation();
+  }
+});
+</script>
+
+<template>
+  <NDrawer v-model:show="visible" :title="title" display-directive="show" :width="800" class="max-w-90%">
+    <NDrawerContent :title="title" :native-scrollbar="false" closable>
+      <NForm ref="formRef" :model="model" :rules="rules">
+        <NFormItem label="组件名称" path="componentName">
+          <NInput v-model:value="model.componentName" placeholder="请输入组件名称" />
+        </NFormItem>
+        <NFormItem label="方法名" path="methodName">
+          <NInput v-model:value="model.methodName" placeholder="请输入方法名" />
+        </NFormItem>
+        <NFormItem label="参数" path="methodParams">
+          <NDynamicTags v-model:value="methodParamTags" placeholder="请输入参数后回车" />
+        </NFormItem>
+        <NFormItem label="spel表达式" path="viewSpel">
+          <NInput v-model:value="model.viewSpel" placeholder="自动生成的spel表达式" disabled />
+        </NFormItem>
+        <NFormItem label="备注" path="remark">
+          <NInput v-model:value="model.remark" placeholder="请输入备注" />
+        </NFormItem>
+        <NFormItem label="状态" path="status">
+          <NRadioGroup v-model:value="model.status">
+            <NSpace>
+              <NRadio
+                v-for="option in sysNormalDisableOptions"
+                :key="option.value"
+                :value="option.value"
+                :label="option.label"
+              />
+            </NSpace>
+          </NRadioGroup>
+        </NFormItem>
+      </NForm>
+      <template #footer>
+        <NSpace :size="16">
+          <NButton @click="closeDrawer">{{ $t('common.cancel') }}</NButton>
+          <NButton type="primary" @click="handleSubmit">{{ $t('common.confirm') }}</NButton>
+        </NSpace>
+      </template>
+    </NDrawerContent>
+  </NDrawer>
+</template>
+
+<style scoped></style>

src/views/workflow/spel/modules/spel-search.vue

@@ -0,0 +1,77 @@
+<script setup lang="ts">
+import { useNaiveForm } from '@/hooks/common/form';
+import { useDict } from '@/hooks/business/dict';
+import { $t } from '@/locales';
+defineOptions({
+  name: 'SpelSearch'
+});
+
+interface Emits {
+  (e: 'reset'): void;
+  (e: 'search'): void;
+}
+
+const emit = defineEmits<Emits>();
+
+const { formRef, validate, restoreValidation } = useNaiveForm();
+
+const model = defineModel<Api.Workflow.SpelSearchParams>('model', { required: true });
+
+const { options: sysNormalDisableOptions } = useDict('sys_normal_disable', false);
+
+async function reset() {
+  Object.assign(model.value.params!, {});
+  await restoreValidation();
+  emit('reset');
+}
+
+async function search() {
+  await validate();
+  emit('search');
+}
+</script>
+
+<template>
+  <NCard :bordered="false" size="small" class="card-wrapper">
+    <NCollapse>
+      <NCollapseItem :title="$t('common.search')" name="user-search">
+        <NForm ref="formRef" :model="model" label-placement="left" :label-width="80">
+          <NGrid responsive="screen" item-responsive>
+            <NFormItemGi span="24 s:12 m:6" label="组件名称" path="componentName" class="pr-24px">
+              <NInput v-model:value="model.componentName" placeholder="请输入组件名称" />
+            </NFormItemGi>
+            <NFormItemGi span="24 s:12 m:6" label="方法名" path="methodName" class="pr-24px">
+              <NInput v-model:value="model.methodName" placeholder="请输入方法名" />
+            </NFormItemGi>
+            <NFormItemGi span="24 s:12 m:6" label="状态" path="status" class="pr-24px">
+              <NSelect
+                v-model:value="model.status"
+                placeholder="请选择状态"
+                :options="sysNormalDisableOptions"
+                clearable
+              />
+            </NFormItemGi>
+            <NFormItemGi span="24 s:12 m:6" class="pr-24px">
+              <NSpace class="w-full" justify="end">
+                <NButton @click="reset">
+                  <template #icon>
+                    <icon-ic-round-refresh class="text-icon" />
+                  </template>
+                  {{ $t('common.reset') }}
+                </NButton>
+                <NButton type="primary" ghost @click="search">
+                  <template #icon>
+                    <icon-ic-round-search class="text-icon" />
+                  </template>
+                  {{ $t('common.search') }}
+                </NButton>
+              </NSpace>
+            </NFormItemGi>
+          </NGrid>
+        </NForm>
+      </NCollapseItem>
+    </NCollapse>
+  </NCard>
+</template>
+
+<style scoped></style>

src/views/workflow/task/all-task-waiting/index.vue

@@ -8,7 +8,7 @@ import { useAppStore } from '@/store/modules/app';
 import { useTable, useTableOperate } from '@/hooks/common/table';
 import { useDict } from '@/hooks/business/dict';
 import { loadDynamicComponent } from '@/utils/common';
-import GroupTag from '@/components/custom/group-tag.vue';
+import TagGroup from '@/components/custom/tag-group.vue';
 import DictTag from '@/components/custom/dict-tag.vue';
 import ButtonIcon from '@/components/custom/button-icon.vue';
 import { $t } from '@/locales';
@@ -72,7 +72,7 @@ const waitingColumns = ref<NaiveUI.TableColumn<Api.Workflow.Task>[]>([
     title: '办理人',
     align: 'center',
     width: 120,
-    render: row => <GroupTag value={row.assigneeNames} />
+    render: row => <TagGroup value={row.assigneeNames} />
   },
   { key: 'createTime', title: '创建时间', align: 'center', width: 120 }
 ]);

src/views/workflow/task/task-waiting/index.vue

@@ -8,7 +8,7 @@ import { useAppStore } from '@/store/modules/app';
 import { useTable, useTableOperate } from '@/hooks/common/table';
 import { useDict } from '@/hooks/business/dict';
 import { loadDynamicComponent } from '@/utils/common';
-import GroupTag from '@/components/custom/group-tag.vue';
+import TagGroup from '@/components/custom/tag-group.vue';
 import DictTag from '@/components/custom/dict-tag.vue';
 import ButtonIcon from '@/components/custom/button-icon.vue';
 import { $t } from '@/locales';
@@ -89,7 +89,7 @@ const {
       key: 'assigneeNames',
       align: 'center',
       width: 100,
-      render: row => <GroupTag value={row.assigneeNames} />
+      render: row => <TagGroup value={row.assigneeNames} />
     },
     {
       title: '流程状态',