Merge branch 'dev' of https://gitee.com/yudaocode/yudao-ui-admin-vben into dev_xx

apps/web-antd/src/utils/constants.ts

@@ -1093,6 +1093,23 @@ OPERATION_BUTTON_NAME.set(BpmTaskOperationButtonTypeEnum.ADD_SIGN, '加签');
 OPERATION_BUTTON_NAME.set(BpmTaskOperationButtonTypeEnum.RETURN, '退回');
 OPERATION_BUTTON_NAME.set(BpmTaskOperationButtonTypeEnum.COPY, '抄送');
 
+/**
+ * 流程实例的变量枚举
+ */
+export enum ProcessVariableEnum {
+  /**
+   * 流程定义名称
+   */
+  PROCESS_DEFINITION_NAME = 'PROCESS_DEFINITION_NAME',
+  /**
+   * 发起时间
+   */
+  START_TIME = 'PROCESS_START_TIME',
+  /**
+   * 发起用户 ID
+   */
+  START_USER_ID = 'PROCESS_START_USER_ID',
+}
 // ========== 【写作 UI】相关的枚举 ==========
 
 /** 写作点击示例时的数据 */

apps/web-antd/src/utils/download.ts

@@ -1,215 +0,0 @@
-/**
- * 下载工具模块
- * 提供多种文件格式的下载功能
- */
-// 请使用 @vben/utils/download 代替 packages/@core/base/shared/src/utils/download.ts
-
-/**
- * 图片下载配置接口
- */
-interface ImageDownloadOptions {
-  /** 图片 URL */
-  url: string;
-  /** 指定画布宽度 */
-  canvasWidth?: number;
-  /** 指定画布高度 */
-  canvasHeight?: number;
-  /** 将图片绘制在画布上时带上图片的宽高值，默认为 true */
-  drawWithImageSize?: boolean;
-}
-
-/**
- * 基础文件下载函数
- * @param data - 文件数据 Blob
- * @param fileName - 文件名
- * @param mimeType - MIME 类型
- */
-export const download0 = (data: Blob, fileName: string, mimeType: string) => {
-  try {
-    // 创建 blob
-    const blob = new Blob([data], { type: mimeType });
-    // 创建 href 超链接，点击进行下载
-    window.URL = window.URL || window.webkitURL;
-    const href = URL.createObjectURL(blob);
-    const downA = document.createElement('a');
-    downA.href = href;
-    downA.download = fileName;
-    downA.click();
-    // 销毁超链接
-    window.URL.revokeObjectURL(href);
-  } catch (error) {
-    console.error('文件下载失败:', error);
-    throw new Error(
-      `文件下载失败: ${error instanceof Error ? error.message : '未知错误'}`,
-    );
-  }
-};
-
-/**
- * 触发文件下载的通用方法
- * @param url - 下载链接
- * @param fileName - 文件名
- */
-const triggerDownload = (url: string, fileName: string) => {
-  const a = document.createElement('a');
-  a.href = url;
-  a.download = fileName;
-  a.click();
-};
-
-export const download = {
-  /**
-   * 下载 Excel 文件
-   * @param data - 文件数据 Blob
-   * @param fileName - 文件名
-   */
-  excel: (data: Blob, fileName: string) => {
-    download0(data, fileName, 'application/vnd.ms-excel');
-  },
-
-  /**
-   * 下载 Word 文件
-   * @param data - 文件数据 Blob
-   * @param fileName - 文件名
-   */
-  word: (data: Blob, fileName: string) => {
-    download0(data, fileName, 'application/msword');
-  },
-
-  /**
-   * 下载 Zip 文件
-   * @param data - 文件数据 Blob
-   * @param fileName - 文件名
-   */
-  zip: (data: Blob, fileName: string) => {
-    download0(data, fileName, 'application/zip');
-  },
-
-  /**
-   * 下载 HTML 文件
-   * @param data - 文件数据 Blob
-   * @param fileName - 文件名
-   */
-  html: (data: Blob, fileName: string) => {
-    download0(data, fileName, 'text/html');
-  },
-
-  /**
-   * 下载 Markdown 文件
-   * @param data - 文件数据 Blob
-   * @param fileName - 文件名
-   */
-  markdown: (data: Blob, fileName: string) => {
-    download0(data, fileName, 'text/markdown');
-  },
-
-  /**
-   * 下载 JSON 文件
-   * @param data - 文件数据 Blob
-   * @param fileName - 文件名
-   */
-  json: (data: Blob, fileName: string) => {
-    download0(data, fileName, 'application/json');
-  },
-
-  /**
-   * 下载图片（允许跨域）
-   * @param options - 图片下载配置
-   */
-  image: (options: ImageDownloadOptions) => {
-    const {
-      url,
-      canvasWidth,
-      canvasHeight,
-      drawWithImageSize = true,
-    } = options;
-
-    const image = new Image();
-    // image.setAttribute('crossOrigin', 'anonymous')
-    image.src = url;
-    image.addEventListener('load', () => {
-      try {
-        const canvas = document.createElement('canvas');
-        canvas.width = canvasWidth || image.width;
-        canvas.height = canvasHeight || image.height;
-        const ctx = canvas.getContext('2d') as CanvasRenderingContext2D;
-        ctx?.clearRect(0, 0, canvas.width, canvas.height);
-
-        if (drawWithImageSize) {
-          ctx.drawImage(image, 0, 0, image.width, image.height);
-        } else {
-          ctx.drawImage(image, 0, 0);
-        }
-
-        const dataUrl = canvas.toDataURL('image/png');
-        triggerDownload(dataUrl, 'image.png');
-      } catch (error) {
-        console.error('图片下载失败:', error);
-        throw new Error(
-          `图片下载失败: ${error instanceof Error ? error.message : '未知错误'}`,
-        );
-      }
-    });
-
-    image.addEventListener('error', () => {
-      throw new Error('图片加载失败');
-    });
-  },
-
-  /**
-   * 将 Base64 字符串转换为文件对象
-   * @param base64 - Base64 字符串
-   * @param fileName - 文件名
-   * @returns File 对象
-   */
-  base64ToFile: (base64: string, fileName: string): File => {
-    // 输入验证
-    if (!base64 || typeof base64 !== 'string') {
-      throw new Error('base64 参数必须是非空字符串');
-    }
-
-    // 将 base64 按照逗号进行分割，将前缀与后续内容分隔开
-    const data = base64.split(',');
-    if (data.length !== 2 || !data[0] || !data[1]) {
-      throw new Error('无效的 base64 格式');
-    }
-
-    // 利用正则表达式从前缀中获取类型信息（image/png、image/jpeg、image/webp等）
-    const typeMatch = data[0].match(/:(.*?);/);
-    if (!typeMatch || !typeMatch[1]) {
-      throw new Error('无法解析 base64 类型信息');
-    }
-    const type = typeMatch[1];
-
-    // 从类型信息中获取具体的文件格式后缀（png、jpeg、webp）
-    const typeParts = type.split('/');
-    if (typeParts.length !== 2 || !typeParts[1]) {
-      throw new Error('无效的 MIME 类型格式');
-    }
-    const suffix = typeParts[1];
-
-    try {
-      // 使用 atob() 对 base64 数据进行解码，结果是一个文件数据流以字符串的格式输出
-      const bstr = window.atob(data[1]);
-
-      // 获取解码结果字符串的长度
-      const n = bstr.length;
-      // 根据解码结果字符串的长度创建一个等长的整型数字数组
-      const u8arr = new Uint8Array(n);
-
-      // 优化的 Uint8Array 填充逻辑
-      for (let i = 0; i < n; i++) {
-        // 使用 charCodeAt() 获取字符对应的字节值（Base64 解码后的字符串是字节级别的）
-        // eslint-disable-next-line unicorn/prefer-code-point
-        u8arr[i] = bstr.charCodeAt(i);
-      }
-
-      // 返回 File 文件对象
-      return new File([u8arr], `${fileName}.${suffix}`, { type });
-    } catch (error) {
-      throw new Error(
-        `Base64 解码失败: ${error instanceof Error ? error.message : '未知错误'}`,
-      );
-    }
-  },
-};

apps/web-antd/src/utils/formatNumber.ts

@@ -1,186 +0,0 @@
-/**
- * 将一个整数转换为分数保留两位小数
- * @param num
- */
-export function formatToFraction(num: number | string | undefined): string {
-  if (num === undefined) return '0.00';
-  const parsedNumber = typeof num === 'string' ? Number.parseFloat(num) : num;
-  return (parsedNumber / 100).toFixed(2);
-}
-
-/**
- * 将一个数转换为 1.00 这样
- * 数据呈现的时候使用
- *
- * @param num 整数
- */
-export function floatToFixed2(num: number | string | undefined): string {
-  let str = '0.00';
-  if (num === undefined) {
-    return str;
-  }
-  const f = formatToFraction(num);
-  const decimalPart = f.toString().split('.')[1];
-  const len = decimalPart ? decimalPart.length : 0;
-  switch (len) {
-    case 0: {
-      str = `${f.toString()}.00`;
-      break;
-    }
-    case 1: {
-      str = `${f.toString()}0`;
-      break;
-    }
-    case 2: {
-      str = f.toString();
-      break;
-    }
-  }
-  return str;
-}
-
-/**
- * 将一个分数转换为整数
- * @param num
- */
-export function convertToInteger(num: number | string | undefined): number {
-  if (num === undefined) return 0;
-  const parsedNumber = typeof num === 'string' ? Number.parseFloat(num) : num;
-  return Math.round(parsedNumber * 100);
-}
-
-/**
- * 元转分
- */
-export function yuanToFen(amount: number | string): number {
-  return convertToInteger(amount);
-}
-
-/**
- * 分转元
- */
-export function fenToYuan(price: number | string): string {
-  return formatToFraction(price);
-}
-
-/**
- * 计算环比
- *
- * @param value 当前数值
- * @param reference 对比数值
- */
-export function calculateRelativeRate(
-  value?: number,
-  reference?: number,
-): number {
-  // 防止除0
-  if (!reference || reference === 0) return 0;
-
-  return Number.parseFloat(
-    ((100 * ((value || 0) - reference)) / reference).toFixed(0),
-  );
-}
-
-// ========== ERP 专属方法 ==========
-
-const ERP_COUNT_DIGIT = 3;
-const ERP_PRICE_DIGIT = 2;
-
-/**
- * 【ERP】格式化 Input 数字
- *
- * 例如说：库存数量
- *
- * @param num 数量
- * @package
- * @return 格式化后的数量
- */
-export function erpNumberFormatter(
-  num: number | string | undefined,
-  digit: number,
-) {
-  if (num === null || num === undefined) {
-    return '';
-  }
-  if (typeof num === 'string') {
-    num = Number.parseFloat(num);
-  }
-  // 如果非 number，则直接返回空串
-  if (Number.isNaN(num)) {
-    return '';
-  }
-  return num.toFixed(digit);
-}
-
-/**
- * 【ERP】格式化数量，保留三位小数
- *
- * 例如说：库存数量
- *
- * @param num 数量
- * @return 格式化后的数量
- */
-export function erpCountInputFormatter(num: number | string | undefined) {
-  return erpNumberFormatter(num, ERP_COUNT_DIGIT);
-}
-
-// noinspection JSCommentMatchesSignature
-/**
- * 【ERP】格式化数量，保留三位小数
- *
- * @param cellValue 数量
- * @return 格式化后的数量
- */
-export function erpCountTableColumnFormatter(cellValue: any) {
-  return erpNumberFormatter(cellValue, ERP_COUNT_DIGIT);
-}
-
-/**
- * 【ERP】格式化金额，保留二位小数
- *
- * 例如说：库存数量
- *
- * @param num 数量
- * @return 格式化后的数量
- */
-export function erpPriceInputFormatter(num: number | string | undefined) {
-  return erpNumberFormatter(num, ERP_PRICE_DIGIT);
-}
-
-// noinspection JSCommentMatchesSignature
-/**
- * 【ERP】格式化金额，保留二位小数
- *
- * @param cellValue 数量
- * @return 格式化后的数量
- */
-export function erpPriceTableColumnFormatter(cellValue: any) {
-  return erpNumberFormatter(cellValue, ERP_PRICE_DIGIT);
-}
-
-/**
- * 【ERP】价格计算，四舍五入保留两位小数
- *
- * @param price 价格
- * @param count 数量
- * @return 总价格。如果有任一为空，则返回 undefined
- */
-export function erpPriceMultiply(price: number, count: number) {
-  if (price === null || count === null) {
-    return undefined;
-  }
-  return Number.parseFloat((price * count).toFixed(ERP_PRICE_DIGIT));
-}
-
-/**
- * 【ERP】百分比计算，四舍五入保留两位小数
- *
- * 如果 total 为 0，则返回 0
- *
- * @param value 当前值
- * @param total 总值
- */
-export function erpCalculatePercentage(value: number, total: number) {
-  if (total === 0) return 0;
-  return ((value / total) * 100).toFixed(2);
-}

apps/web-antd/src/utils/index.ts

@@ -1,8 +1,5 @@
 export * from './constants';
 export * from './dict';
-export * from './download';
-export * from './formatNumber';
-export * from './formatTime';
 export * from './formCreate';
 export * from './rangePickerProps';
 export * from './routerHelper';

apps/web-antd/src/utils/routerHelper.ts

@@ -1,7 +1,7 @@
 import { defineAsyncComponent } from 'vue';
 
 const modules = import.meta.glob('../views/**/*.{vue,tsx}');
-// TODO @xingyu：这个要不要融合到哪个 router util 里？
+
 /**
  * 注册一个异步组件
  * @param componentPath 例:/bpm/oa/leave/detail