refactor(common): 替换分页服务方法及代码生成模块重构

- 将分页服务中方法名由get_page_obj统一替换为paginate
- 注意相关controller均调整调用方式，保证统一接口调用
- 代码生成模块数据库模型统一替换为GenTableModel和GenTableColumnModel
- 更改数据库类型及分页相关配置为settings.DATABASE_TYPE统一管理
- 重构代码生成模块查询参数，新增GenTableQueryParam和GenTableColumnQueryParam类支持更灵活查询
- 数据模型中Pydantic Schema类型统一调整为Schema后缀
- 优化异常处理，增加请求参数验证错误的友好提示映射
- 调整中间件及依赖以支持更严格的类型检查及更健壮的用户权限认证逻辑
- 微调日志打印格式，改进请求日志信息输出风格

frontend/src/views/workflow/operator/index.vue

@@ -0,0 +1,576 @@
+<!-- 演示示例 -->
+<template>
+    <div class="app-container">
+        <!-- 搜索区域 -->
+        <div class="search-container">
+            <el-form ref="queryFormRef" :model="queryFormData" :inline="true" label-suffix=":">
+                <el-form-item prop="name" label="名称">
+                    <el-input v-model="queryFormData.name" placeholder="请输入名称" clearable />
+                </el-form-item>
+                <el-form-item prop="status" label="状态">
+                    <el-select v-model="queryFormData.status" placeholder="请选择状态" style="width: 167.5px" clearable>
+                        <el-option value="true" label="启用" />
+                        <el-option value="false" label="停用" />
+                    </el-select>
+                </el-form-item>
+                <!-- 时间范围，收起状态下隐藏 -->
+                <el-form-item v-if="isExpand" prop="start_time" label="创建时间">
+                    <DatePicker
+                        v-model="dateRange"
+                        @update:model-value="handleDateRangeChange"
+                    />
+                </el-form-item>
+                <!-- 查询、重置、展开/收起按钮 -->
+                <el-form-item class="search-buttons">
+                    <el-button type="primary" icon="search" @click="handleQuery">
+                        查询
+                    </el-button>
+                    <el-button icon="refresh" @click="handleResetQuery">
+                        重置
+                    </el-button>
+                    <!-- 展开/收起 -->
+                    <template v-if="isExpandable">
+                        <el-link class="ml-3" type="primary" underline="never" @click="isExpand = !isExpand">
+                            {{ isExpand ? "收起" : "展开" }}
+                            <el-icon>
+                                <template v-if="isExpand">
+                                    <ArrowUp />
+                                </template>
+                                <template v-else>
+                                    <ArrowDown />
+                                </template>
+                            </el-icon>
+                        </el-link>
+                    </template>
+                </el-form-item>
+            </el-form>
+        </div>
+
+        <!-- 内容区域 -->
+        <el-card shadow="hover" class="data-table">
+            <template #header>
+                <div class="card-header">
+                    <span>
+                        <el-tooltip content="流程列表">
+                            <QuestionFilled class="w-4 h-4 mx-1" />
+                        </el-tooltip>
+                        演示示例列表
+                    </span>
+                </div>
+            </template>
+
+            <!-- 功能区域 -->
+            <div class="data-table__toolbar">
+                <div class="data-table__toolbar--actions">
+                    <el-button type="success" icon="plus" @click="handleOpenDialog('create')">新增</el-button>
+                    <el-button type="danger" icon="delete" :disabled="selectIds.length === 0"
+                        @click="handleDelete(selectIds)">批量删除</el-button>
+                    <el-dropdown trigger="click">
+                        <el-button type="default" :disabled="selectIds.length === 0" icon="ArrowDown">更多</el-button>
+                        <template #dropdown>
+                            <el-dropdown-menu>
+                                <el-dropdown-item icon="Check" @click="handleMoreClick(true)">批量启用</el-dropdown-item>
+                                <el-dropdown-item icon="CircleClose"
+                                    @click="handleMoreClick(false)">批量停用</el-dropdown-item>
+                            </el-dropdown-menu>
+                        </template>
+                    </el-dropdown>
+                </div>
+                <div class="data-table__toolbar--tools">
+                    <el-tooltip content="导入">
+                        <el-button type="info" icon="upload" circle @click="handleOpenImportDialog" />
+                    </el-tooltip>
+                    <el-tooltip content="导出">
+                        <el-button type="warning" icon="download" circle @click="handleExport" />
+                    </el-tooltip>
+                    <el-tooltip content="刷新">
+                        <el-button type="primary" icon="refresh" circle @click="handleRefresh" />
+                    </el-tooltip>
+                    <el-tooltip content="列表筛选">
+                        <el-dropdown trigger="click">
+                            <el-button type="default" icon="operation" circle />
+                            <template #dropdown>
+                                <el-dropdown-menu>
+                                    <el-dropdown-item v-for="column in tableColumns" :key="column.prop"
+                                        :command="column">
+                                        <el-checkbox v-model="column.show">
+                                            {{ column.label }}
+                                        </el-checkbox>
+                                    </el-dropdown-item>
+                                </el-dropdown-menu>
+                            </template>
+                        </el-dropdown>
+                    </el-tooltip>
+                </div>
+            </div>
+
+            <!-- 表格区域：系统配置列表 -->
+            <el-table ref="dataTableRef" v-loading="loading" :data="pageTableData" highlight-current-row
+                class="data-table__content" height="450" border stripe @selection-change="handleSelectionChange">
+                <template #empty>
+                    <el-empty :image-size="80" description="暂无数据" />
+                </template>
+                <el-table-column v-if="tableColumns.find(col => col.prop === 'selection')?.show" type="selection"
+                    min-width="55" align="center" />
+                <el-table-column v-if="tableColumns.find(col => col.prop === 'index')?.show" fixed label="序号"
+                    min-width="60">
+                    <template #default="scope">
+                        {{ (queryFormData.page_no - 1) * queryFormData.page_size + scope.$index + 1 }}
+                    </template>
+                </el-table-column>
+                <el-table-column v-if="tableColumns.find(col => col.prop === 'name')?.show" label="名称"
+                    prop="name" min-width="140" />
+                <el-table-column v-if="tableColumns.find(col => col.prop === 'status')?.show" label="状态" prop="status"
+                    min-width="80">
+                    <template #default="scope">
+                        <el-tag :type="scope.row.status === true ? 'success' : 'danger'">
+                            {{ scope.row.status === true ? "启用" : "停用" }}
+                        </el-tag>
+                    </template>
+                </el-table-column>
+                <el-table-column v-if="tableColumns.find(col => col.prop === 'description')?.show" label="描述"
+                    prop="description" min-width="140" />
+                <el-table-column v-if="tableColumns.find(col => col.prop === 'created_at')?.show" label="创建时间"
+                    prop="created_at" min-width="180" sortable />
+                <el-table-column v-if="tableColumns.find(col => col.prop === 'updated_at')?.show" label="更新时间"
+                    prop="updated_at" min-width="180" sortable />
+                <el-table-column v-if="tableColumns.find(col => col.prop === 'creator')?.show" key="creator" label="创建人"
+                    min-width="100">
+                    <template #default="scope">
+                        {{ scope.row.creator?.name }}
+                    </template>
+                </el-table-column>
+
+                <el-table-column v-if="tableColumns.find(col => col.prop === 'operation')?.show" fixed="right"
+                    label="操作" align="center" min-width="200">
+                    <template #default="scope">
+                        <el-button type="info" size="small" link icon="document"
+                            @click="handleOpenDialog('detail', scope.row.id)">详情</el-button>
+                        <el-button type="primary" size="small" link icon="edit"
+                            @click="handleOpenDialog('update', scope.row.id)">编辑</el-button>
+                        <el-button type="danger" size="small" link icon="delete"
+                            @click="handleDelete([scope.row.id])">删除</el-button>
+                    </template>
+                </el-table-column>
+            </el-table>
+
+            <!-- 分页区域 -->
+            <template #footer>
+                <pagination v-model:total="total" v-model:page="queryFormData.page_no"
+                    v-model:limit="queryFormData.page_size" @pagination="loadingData" />
+            </template>
+        </el-card>
+
+        <!-- 弹窗区域 -->
+        <el-dialog v-model="dialogVisible.visible" :title="dialogVisible.title" @close="handleCloseDialog">
+            <!-- 详情 -->
+            <template v-if="dialogVisible.type === 'detail'">
+                <el-descriptions :column="4" border>
+                    <el-descriptions-item label="名称" :span="2">
+                        {{ detailFormData.name }}
+                    </el-descriptions-item>
+                    <el-descriptions-item label="状态" :span="2">
+                        <el-tag :type="detailFormData.status ? 'success' : 'danger'">
+                            {{ detailFormData.status ? '启用' : '停用' }}
+                        </el-tag>
+                    </el-descriptions-item>
+                    <el-descriptions-item label="描述" :span="2">
+                        {{ detailFormData.description }}
+                    </el-descriptions-item>
+                    <el-descriptions-item label="创建人" :span="2">
+                        {{ detailFormData.creator?.name }}
+                    </el-descriptions-item>
+                    <el-descriptions-item label="创建时间" :span="2">
+                        {{ detailFormData.created_at }}
+                    </el-descriptions-item>
+                    <el-descriptions-item label="更新时间" :span="2">
+                        {{ detailFormData.updated_at }}
+                    </el-descriptions-item>
+                </el-descriptions>
+            </template>
+            <!-- 新增、编辑表单 -->
+            <template v-else>
+                <el-form ref="dataFormRef" :model="formData" :rules="rules" label-suffix=":" label-width="auto"
+                    label-position="right">
+                    <el-form-item label="名称" prop="name">
+                        <el-input v-model="formData.name" placeholder="请输入名称" :maxlength="50" />
+                    </el-form-item>
+                    <el-form-item label="状态" prop="status">
+                        <el-radio-group v-model="formData.status">
+                            <el-radio :value="true">
+                                启用
+                            </el-radio>
+                            <el-radio :value="false">
+                                停用
+                            </el-radio>
+                        </el-radio-group>
+                    </el-form-item>
+                    <el-form-item label="描述" prop="description">
+                        <el-input v-model="formData.description" :rows="4" :maxlength="100" show-word-limit
+                            type="textarea" placeholder="请输入描述" />
+                    </el-form-item>
+                </el-form>
+            </template>
+
+            <template #footer>
+                <div class="dialog-footer">
+                    <!-- 详情弹窗不需要确定按钮的提交逻辑 -->
+                    <el-button @click="handleCloseDialog">取消</el-button>
+                    <el-button v-if="dialogVisible.type !== 'detail'" type="primary"
+                        @click="handleSubmit">确定</el-button>
+                    <el-button v-else type="primary" @click="handleCloseDialog">确定</el-button>
+                </div>
+            </template>
+        </el-dialog>
+
+        <!-- 用户导入 -->
+        <ImportModal v-model="importDialogVisible" title="导入数据" @import-success="handleQuery()" @download-template="handleDownloadTemplate" @upload="handleUpload" />
+
+    </div>
+</template>
+
+<script setup lang="ts">
+defineOptions({
+    name: "Example",
+    inheritAttrs: false,
+});
+
+import { ref, reactive, onMounted } from "vue";
+import { ElMessage } from "element-plus";
+import { ResultEnum } from "@/enums/api/result.enum";
+import ExampleAPI, { ExampleTable, ExampleForm, ExamplePageQuery } from "@/api/demo/example";
+import ImportModal from "@/components/Upload/ImportModal.vue";
+import DatePicker from "@/components/DatePicker/index.vue";
+
+const emit = defineEmits(['import-success']);
+
+const queryFormRef = ref();
+const dataFormRef = ref();
+const total = ref(0);
+const selectIds = ref<number[]>([]);
+const loading = ref(false);
+const isExpand = ref(false);
+const isExpandable = ref(true);
+
+// 分页表单
+const pageTableData = ref<ExampleTable[]>([]);
+
+// 表格列配置
+const tableColumns = ref([
+    { prop: 'selection', label: '选择框', show: true },
+    { prop: 'index', label: '序号', show: true },
+    { prop: 'name', label: '名称', show: true },
+    { prop: 'status', label: '状态', show: true },
+    { prop: 'description', label: '描述', show: true },
+    { prop: 'created_at', label: '创建时间', show: true },
+    { prop: 'updated_at', label: '更新时间', show: true },
+    { prop: 'creator', label: '创建人', show: true },
+    { prop: 'operation', label: '操作', show: true }
+])
+
+// 详情表单
+const detailFormData = ref<ExampleTable>({});
+
+// 日期范围临时变量
+const dateRange = ref<[Date, Date] | []>([]);
+
+// 处理日期范围变化
+function handleDateRangeChange(range: [Date, Date]) {
+  dateRange.value = range;
+  if (range && range.length === 2) {
+    queryFormData.start_time = range[0].toISOString();
+    queryFormData.end_time = range[1].toISOString();
+  } else {
+    queryFormData.start_time = undefined;
+    queryFormData.end_time = undefined;
+  }
+}
+
+// 分页查询参数
+const queryFormData = reactive<ExamplePageQuery>({
+    page_no: 1,
+    page_size: 10,
+    name: undefined,
+    status: undefined,
+    start_time: undefined,
+    end_time: undefined,
+});
+
+// 编辑表单
+const formData = reactive<ExampleForm>({
+    id: undefined,
+    name: '',
+    status: true,
+    description: undefined,
+})
+
+// 弹窗状态
+const dialogVisible = reactive({
+    title: "",
+    visible: false,
+    type: 'create' as 'create' | 'update' | 'detail',
+});
+
+// 表单验证规则
+const rules = reactive({
+    name: [{ required: true, message: "请输入名称", trigger: "blur" }],
+    status: [{ required: true, message: "请选择状态", trigger: "blur" }],
+});
+
+// 导入弹窗显示状态
+const importDialogVisible = ref(false);
+
+// 列表刷新
+async function handleRefresh() {
+    await loadingData();
+};
+
+// 加载表格数据
+async function loadingData() {
+    loading.value = true;
+    try {
+        const response = await ExampleAPI.getExampleList(queryFormData);
+        pageTableData.value = response.data.data.items;
+        total.value = response.data.data.total;
+    }
+    catch (error: any) {
+        console.error(error);
+    }
+    finally {
+        loading.value = false;
+    }
+}
+
+// 查询（重置页码后获取数据）
+async function handleQuery() {
+    queryFormData.page_no = 1;
+    loadingData();
+}
+
+// 重置查询
+async function handleResetQuery() {
+    queryFormRef.value.resetFields();
+    queryFormData.page_no = 1;
+    // 重置日期范围选择器
+    dateRange.value = [];
+    queryFormData.start_time = undefined;
+    queryFormData.end_time = undefined;
+    loadingData();
+}
+
+// 定义初始表单数据常量
+const initialFormData: ExampleForm = {
+    id: undefined,
+    name: '',
+    status: true,
+    description: '',
+}
+
+// 重置表单
+async function resetForm() {
+    if (dataFormRef.value) {
+        dataFormRef.value.resetFields();
+        dataFormRef.value.clearValidate();
+    }
+    // 完全重置 formData 为初始状态
+    Object.assign(formData, initialFormData);
+}
+
+// 行复选框选中项变化
+async function handleSelectionChange(selection: any) {
+    selectIds.value = selection.map((item: any) => item.id);
+}
+
+// 关闭弹窗
+async function handleCloseDialog() {
+    dialogVisible.visible = false;
+    resetForm();
+}
+
+// 打开弹窗
+async function handleOpenDialog(type: 'create' | 'update' | 'detail', id?: number) {
+    dialogVisible.type = type;
+    if (id) {
+        const response = await ExampleAPI.getExampleDetail(id);
+        if (type === 'detail') {
+            dialogVisible.title = "详情";
+            Object.assign(detailFormData.value, response.data.data);
+        } else if (type === 'update') {
+            dialogVisible.title = "修改";
+            Object.assign(formData, response.data.data);
+        }
+    } else {
+        dialogVisible.title = "新增公告通知";
+        formData.id = undefined;
+    }
+    dialogVisible.visible = true;
+}
+
+// 提交表单（防抖）
+async function handleSubmit() {
+    // 表单校验
+    dataFormRef.value.validate(async (valid: any) => {
+        if (valid) {
+            loading.value = true;
+            // 根据弹窗传入的参数(deatil\create\update)判断走什么逻辑
+            const id = formData.id;
+            if (id) {
+                try {
+                    await ExampleAPI.updateExample(id, { id, ...formData })
+                    dialogVisible.visible = false;
+                    resetForm();
+                    handleCloseDialog();
+                    handleResetQuery();
+                } catch (error: any) {
+                    console.error(error);
+                } finally {
+                    loading.value = false;
+                }
+            } else {
+                try {
+                    await ExampleAPI.createExample(formData)
+                    dialogVisible.visible = false;
+                    resetForm();
+                    handleCloseDialog();
+                    handleResetQuery();
+                } catch (error: any) {
+                    console.error(error);
+                } finally {
+                    loading.value = false;
+                }
+            }
+        }
+    });
+}
+
+// 删除、批量删除
+async function handleDelete(ids: number[]) {
+    ElMessageBox.confirm("确认删除该项数据?", "警告", {
+        confirmButtonText: "确定",
+        cancelButtonText: "取消",
+        type: "warning",
+    }).then(async () => {
+        try {
+            loading.value = true;
+            await ExampleAPI.deleteExample(ids);
+            handleResetQuery();
+        } catch (error: any) {
+            console.error(error);
+        } finally {
+            loading.value = false;
+        }
+    }).catch(() => {
+        ElMessageBox.close();
+    });
+}
+
+// 导出
+async function handleExport() {
+    ElMessageBox.confirm('是否确认导出当前系统配置?', '警告', {
+        confirmButtonText: '确定',
+        cancelButtonText: '取消',
+        type: 'warning'
+    }).then(async () => {
+        let downloadUrl = '';
+        try {
+            loading.value = true;
+
+            const response = await ExampleAPI.exportExample(queryFormData);
+            const fileData = response.data;
+            const fileName = decodeURI(response.headers["content-disposition"].split(";")[1].split("=")[1]);
+            const fileType = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet;charset=utf-8";
+
+            const blob = new Blob([fileData], { type: fileType });
+            downloadUrl = window.URL.createObjectURL(blob);
+
+            const downloadLink = document.createElement("a");
+            downloadLink.href = downloadUrl;
+            downloadLink.download = fileName;
+
+            document.body.appendChild(downloadLink);
+            downloadLink.click();
+
+            document.body.removeChild(downloadLink);
+        } catch (error: any) {
+            // 错误信息已经在响应拦截器中处理并显示
+            console.error('导出失败:', error);
+        } finally {
+            if (downloadUrl) {
+                window.URL.revokeObjectURL(downloadUrl);
+            }
+            loading.value = false;
+        }
+    }).catch(() => {
+        ElMessageBox.close();
+    });
+}
+
+// 处理上传
+const handleUpload = async (formData: FormData, file: File) => {
+  try {
+    const response = await ExampleAPI.importExample(formData);
+    if (response.data.code === ResultEnum.SUCCESS) {
+      ElMessage.success(`${response.data.msg}，${response.data.data}`);
+      emit('import-success');
+    }
+  } catch (error: any) {
+    console.error(error);
+  }
+};
+
+// 下载导入模板
+const handleDownloadTemplate = () => {
+  ExampleAPI.downloadTemplate().then((response: any) => {
+    const fileData = response.data;
+    const fileName = decodeURI(response.headers['content-disposition'].split('; ')[1].split('=')[1]);
+    const fileType = 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet;charset=utf-8';
+
+    const blob = new Blob([fileData], { type: fileType });
+    const downloadUrl = window.URL.createObjectURL(blob);
+
+    const downloadLink = document.createElement('a');
+    downloadLink.href = downloadUrl;
+    downloadLink.download = fileName;
+
+    document.body.appendChild(downloadLink);
+    downloadLink.click();
+
+    document.body.removeChild(downloadLink);
+    window.URL.revokeObjectURL(downloadUrl);
+  });
+};
+
+// 打开导入弹窗
+function handleOpenImportDialog() {
+    importDialogVisible.value = true;
+}
+
+// 批量启用/停用
+async function handleMoreClick(status: boolean) {
+    if (selectIds.value.length) {
+        ElMessageBox.confirm(`确认${status ? '启用' : '停用'}该项数据?`, "警告", {
+            confirmButtonText: "确定",
+            cancelButtonText: "取消",
+            type: "warning",
+        }).then(async () => {
+            try {
+                loading.value = true;
+                await ExampleAPI.batchAvailableExample({ ids: selectIds.value, status });
+                handleResetQuery();
+            } catch (error: any) {
+                console.error(error);
+            } finally {
+                loading.value = false;
+            }
+        }).catch(() => {
+            ElMessageBox.close();
+        });
+    }
+}
+
+onMounted(() => {
+    loadingData();
+});
+</script>
+
+<style lang="scss" scoped></style>