@baishuyun/chat-sdk 0.0.9 → 0.0.10

package/src/plugins/report-query-plugin/utils/get-field-group.ts

@@ -0,0 +1,691 @@
+/**
+ * 字段分组工具函数 - 基于 FX.LimitFields 配置
+ * 用于确定字段在仪表盘/图表中的分组归属
+ */
+
+import { IDashWidgetType, IQueryResultXField } from '@baishuyun/types';
+
+// ==================== 全局类型扩展 ====================
+
+declare global {
+  interface Window {
+    FX?: {
+      LimitFields: LimitFieldsConfig;
+      [key: string]: unknown;
+    };
+  }
+}
+
+// ==================== 类型定义 ====================
+
+/** 字段原始类型 */
+type RawFieldType =
+  | '_id'
+  | 'text'
+  | 'textarea'
+  | 'number'
+  | 'datetime'
+  | 'radiogroup'
+  | 'checkboxgroup'
+  | 'combo'
+  | 'combocheck'
+  | 'address'
+  | 'location'
+  | 'user'
+  | 'usergroup'
+  | 'dept'
+  | 'deptgroup'
+  | 'image'
+  | 'upload'
+  | 'signature'
+  | 'subform'
+  | 'linkdata'
+  | 'linkquery'
+  | 'linkfield'
+  | 'sn'
+  | 'phone'
+  | 'button'
+  | 'dataload'
+  | 'separator'
+  | 'formula'
+  | 'formula_rank'
+  | 'formula_cumulative'
+  | 'flowState'
+  | 'flowstate'
+  | 'flowdecision'
+  | 'flownode'
+  | 'chargers'
+  | 'ext'
+  | 'creator'
+  | 'createTime'
+  | 'updateTime'
+  | 'flow_chargers'
+  | 'flow_signature'
+  | 'flow_comment'
+  | 'innerlink_qr'
+  | 'publiclink_qr'
+  | 'qrcode'
+  | 'print_operator'
+  | 'print_time'
+  | 'form_publink_qr'
+  | 'assist_flowid'
+  | 'assist_prostatus'
+  | 'tabs'
+  | 'flow'
+  | 'string'
+  | 'id'
+  | 'region'
+  | 'currency'
+  | 'percentage'
+  | 'text_filter'
+  | 'textarea_filter'
+  | 'combocheck_filter'
+  | 'user_filter'
+  | 'usergroup_filter'
+  | 'number_filter'
+  | 'address_filter'
+  | 'date_filter'
+  | 'datetime_filter'
+  | 'datemonth_filter'
+  | 'dateyear_filter'
+  | 'dept_filter'
+  | 'deptgroup_filter'
+  | 'flowstate_filter'
+  | 'flowdecision_filter'
+  | 'phone_filter'
+  | 'filelist_filter'
+  | 'address_city_filter'
+  | 'address_district_filter'
+  | 'address_province_filter'
+  | 'assist_prostatus_filter'
+  | 'assist_flowid_filter'
+  | 'metric_table'
+  | 'newMap'
+  | 'card'
+  | 'webPage'
+  | 'gauge_chart'
+  | 'data_table'
+  | 'rili'
+  | 'pivot_table'
+  | 'line_chart'
+  | 'column_chart'
+  | 'bar_chart'
+  | 'funnel_chart'
+  | 'area_chart'
+  | 'pie_chart'
+  | 'radar_chart'
+  | 'calendar_manage'
+  | 'data_manage'
+  | 'multi_axes_chart'
+  | 'map_chart'
+  | 'description'
+  | 'real_time'
+  | 'filte_quick'
+  | 'embedded_iframe'
+  | 'base_layout_container'
+  | 'background_table'
+  | 'gantt'
+  | 'gauge_imageMore';
+
+/** 字段值类型（由业务逻辑计算得出） */
+type FieldValueType = RawFieldType | string;
+
+/** 字段对象 */
+interface Field {
+  type: RawFieldType;
+  name: string;
+  [key: string]: unknown;
+}
+
+/** 限制字段配置（FX.LimitFields 的完整类型） */
+interface LimitFieldsConfig {
+  // 基础限制
+  noSingleDataRepeat: RawFieldType[];
+  noSaveValue: RawFieldType[];
+  subform: RawFieldType[];
+  systemFields: RawFieldType[];
+  dataManage: RawFieldType[];
+
+  // 排序和查询
+  dashCustomSort: RawFieldType[];
+  queryFilter: RawFieldType[];
+  sort: RawFieldType[];
+  flowQueryPaneFilter: RawFieldType[];
+  parameter: RawFieldType[];
+
+  // 筛选器相关
+  filter: RawFieldType[];
+  Notifyfilter: RawFieldType[];
+  Notifyfield: RawFieldType[];
+  FlowNotifyfield: RawFieldType[];
+
+  // 列表和分组
+  list: RawFieldType[];
+  listJoin: RawFieldType[];
+  group: RawFieldType[];
+  subGroup: RawFieldType[];
+  dataLabel: RawFieldType[];
+  groupJoin: RawFieldType[];
+  subGroupJoin: RawFieldType[];
+
+  // 验证和依赖
+  validate: RawFieldType[];
+  rely: RawFieldType[];
+  link: RawFieldType[];
+  brief: RawFieldType[];
+  import: RawFieldType[];
+  combodata: RawFieldType[];
+  linkData: RawFieldType[];
+  linkKey: RawFieldType[];
+  subLinkData: RawFieldType[];
+  aggregate: RawFieldType[];
+  batchEdit: RawFieldType[];
+
+  // 文件和导出
+  fileExport: RawFieldType[];
+  itemLink: RawFieldType[];
+  fieldQrcode: RawFieldType[];
+  printTemplate: RawFieldType[];
+  printTemplateCellEditField: RawFieldType[];
+  excelExport: RawFieldType[];
+  noCache: RawFieldType[];
+
+  // 扩展字段
+  ext: RawFieldType[];
+  userDept: RawFieldType[];
+  triggerWrite: RawFieldType[];
+
+  // ETL 相关
+  etlInput: RawFieldType[];
+  etlMapFormula: RawFieldType[];
+  etlDimension: RawFieldType[];
+  etlQuota: RawFieldType[];
+  etlPivot: RawFieldType[];
+
+  // 仪表盘公式和排序
+  dashTableFormula: RawFieldType[];
+  dashSort: RawFieldType[];
+
+  // 仪表盘显示
+  dashWatermark: RawFieldType[];
+  dashTextAlignment: RawFieldType[];
+
+  // 核心：维度相关
+  dashDimension: RawFieldType[];
+  dashDimensions: RawFieldType[];
+  dashDimensionTime: RawFieldType[];
+  dashDimensionLAL: RawFieldType[];
+
+  // 核心：指标相关
+  dashQuota: RawFieldType[];
+
+  // 核心：筛选器相关
+  dashFilter: RawFieldType[];
+  dashFilters: RawFieldType[];
+
+  // 核心：字段相关
+  dashField: RawFieldType[];
+  dashGanttField: RawFieldType[];
+  dashFields: RawFieldType[];
+  datahelperFields: RawFieldType[];
+  dashTableField: RawFieldType[];
+
+  // 多选字段
+  multipleField: RawFieldType[];
+  multipleFields: RawFieldType[];
+
+  // 卡片相关
+  dashCardShowField: RawFieldType[];
+  dashCardTitleField: RawFieldType[];
+  dashTableFilter: RawFieldType[];
+
+  // 触发器
+  triggerQuery: RawFieldType[];
+  triggerCond: RawFieldType[];
+  datahelpnews: RawFieldType[];
+  disable: RawFieldType[];
+
+  // 组件和图表类型
+  dashCompFilter: string[];
+  dashCompChart: string[];
+  dashRowOrderChart: string[];
+  dashTopDataChart: string[];
+  dashCustomAxisLabelChart: string[];
+  dashCustomAxisRangeChart: string[];
+  dashAxisChart: string[];
+  dashThresholds: string[];
+  dashGuideline: string[];
+  dashColors: string[];
+  dashChartLabel: string[];
+  dashLegend: string[];
+  dashChangedColors: string[];
+  dashMobileLayout: string[];
+
+  // 可见性
+  invisibleFieldFilter: RawFieldType[];
+  fieldVisibleFilter: RawFieldType[];
+}
+
+/** 图表类型 */
+type ChartType =
+  | 'newMap'
+  | 'gantt'
+  | 'table'
+  | 'metric_table'
+  | 'gauge_chart'
+  | 'data_table'
+  | 'pivot_table'
+  | 'line_chart'
+  | 'column_chart'
+  | 'bar_chart'
+  | 'funnel_chart'
+  | 'area_chart'
+  | 'pie_chart'
+  | 'radar_chart'
+  | 'multi_axes_chart'
+  | 'map_chart'
+  | 'card'
+  | 'webPage'
+  | 'rili'
+  | string;
+
+/** 字段分组标签 */
+type FieldGroup =
+  | 'dimension' // 普通维度
+  | 'quota' // 指标/度量
+  | 'LALDimension' // LAL维度（地理位置/文本/地址）
+  | '$dimension' // 表格维度
+  | 'filter' // 筛选器
+  | 'ganttshowfield' // 甘特图显示字段
+  | 'n-dimension' // 数字维度（甘特图）
+  | 't-dimension'; // 时间维度（甘特图）
+
+/** 函数选项 */
+interface GetFieldGroupOptions {
+  /** 图表类型 */
+  chartType: ChartType;
+  /** FX.LimitFields 配置 */
+  limitFields: LimitFieldsConfig;
+  /**
+   * 是否为隐藏模式（控制 quota、LALDimension、$dimension 的添加）
+   * @default false
+   */
+  isHidden?: boolean;
+}
+
+/** 获取字段值类型的函数 */
+type GetFieldValueType = (field: Field) => FieldValueType;
+
+// ==================== 常量定义 ====================
+
+/**
+ * 甘特图中不适合做维度的字段类型黑名单
+ * 这些类型会被移除 dimension 和 $dimension 分组
+ */
+const GANTT_DIMENSION_BLACKLIST: Set<RawFieldType> = new Set([
+  'textarea',
+  'subform',
+  'checkboxgroup',
+  'combocheck',
+  'address',
+  'user',
+  'usergroup',
+  'deptgroup',
+  'location',
+  'linkdata',
+  'image',
+  'upload',
+  'signature',
+  'chargers',
+  'button',
+  'dataload',
+  'separator',
+  'linkquery',
+]);
+
+// ==================== 核心函数 ====================
+
+/**
+ * 获取字段所属的分组标签列表
+ *
+ * 基于 FX.LimitFields 配置和图表类型，确定字段在仪表盘中的分组归属
+ *
+ * @param field - 字段对象，包含 type 和 name
+ * @param getValueType - 获取字段值类型的函数（对应原 _getFieldValueType）
+ * @param options - 配置选项，包含 chartType、limitFields 和 isHidden
+ * @returns 分组标签数组，表示该字段可用于哪些功能区域
+ *
+ * @example
+ * ```typescript
+ * // 基础用法
+ * const groups = getFieldGroup(
+ *   { type: 'number', name: 'sales_amount' },
+ *   (f) => f.type, // 简化示例，实际可能更复杂
+ *   {
+ *     chartType: 'gantt',
+ *     limitFields: fxLimitFields,
+ *     isHidden: false
+ *   }
+ * );
+ * // 返回: ['dimension', '$dimension', 'quota', 'filter', 'ganttshowfield', 'n-dimension']
+ *
+ * // newMap 模式
+ * const mapGroups = getFieldGroup(
+ *   { type: 'text', name: 'province' },
+ *   (f) => f.type,
+ *   { chartType: 'newMap', limitFields: fxLimitFields, isHidden: false }
+ * );
+ * // 返回: ['dimension', 'filter']（注意 newMap 使用 dashTableField 判断 dimension）
+ * ```
+ */
+export function getFieldGroup(
+  field: Field,
+  getValueType: GetFieldValueType,
+  options: GetFieldGroupOptions
+): FieldGroup[] {
+  const { chartType, limitFields, isHidden = false } = options;
+  const groups: FieldGroup[] = [];
+
+  const valueType = getValueType(field);
+  const rawType = field.type;
+
+  // 1. 维度判断（核心逻辑，区分 newMap 和其他图表）
+  addDimensionGroups(groups, chartType, valueType, isHidden, limitFields);
+
+  // 2. 指标判断（需要 !isHidden）
+  if (!isHidden && limitFields.dashQuota.includes(valueType as RawFieldType)) {
+    groups.push('quota');
+  }
+
+  // 3. LAL维度判断（需要 !isHidden 且排除 _id 字段）
+  if (
+    !isHidden &&
+    limitFields.dashDimensionLAL.includes(valueType as RawFieldType) &&
+    field.name !== '_id'
+  ) {
+    groups.push('LALDimension');
+  }
+
+  // 4. 表格维度判断（需要 !isHidden）
+  if (!isHidden && limitFields.dashTableField.includes(valueType as RawFieldType)) {
+    groups.push('$dimension');
+  }
+
+  // 5. 筛选器判断（不依赖 isHidden，使用 rawType）
+  addFilterGroup(groups, chartType, rawType, limitFields);
+
+  // 6. 甘特图特殊处理
+  if (chartType === 'gantt') {
+    return processGanttSpecific(rawType, groups);
+  }
+
+  return groups;
+}
+
+// ==================== 辅助函数 ====================
+
+/**
+ * 添加维度分组标签
+ *
+ * 规则：
+ * - newMap 图表：使用 dashTableField 判断，且需要 !isHidden
+ * - 其他图表：使用 dashDimension 判断，不需要检查 isHidden
+ */
+function addDimensionGroups(
+  groups: FieldGroup[],
+  chartType: ChartType,
+  valueType: FieldValueType,
+  isHidden: boolean,
+  limitFields: LimitFieldsConfig
+): void {
+  if (chartType === 'newMap') {
+    // newMap 特殊逻辑：使用 dashTableField 作为维度依据，且受 isHidden 控制
+    if (!isHidden && limitFields.dashTableField.includes(valueType as RawFieldType)) {
+      groups.push('dimension');
+    }
+  } else {
+    // 标准逻辑：使用 dashDimension，不受 isHidden 影响
+    if (limitFields.dashDimension.includes(valueType as RawFieldType)) {
+      groups.push('dimension');
+    }
+  }
+}
+
+/**
+ * 添加筛选器分组标签
+ *
+ * 规则：
+ * - newMap 图表：使用 dashFilters（复数）
+ * - 其他图表：使用 dashFilter（单数）
+ * - 注意：筛选器判断不依赖 isHidden，使用 rawType 而非 valueType
+ */
+function addFilterGroup(
+  groups: FieldGroup[],
+  chartType: ChartType,
+  rawType: RawFieldType,
+  limitFields: LimitFieldsConfig
+): void {
+  const filterList = chartType === 'newMap' ? limitFields.dashFilters : limitFields.dashFilter;
+
+  if (filterList.includes(rawType)) {
+    groups.push('filter');
+  }
+}
+
+/**
+ * 处理甘特图特定的分组逻辑
+ *
+ * 特殊处理：
+ * 1. 所有字段添加 'ganttshowfield'
+ * 2. number 类型添加 'n-dimension'
+ * 3. datetime 类型添加 't-dimension'
+ * 4. 黑名单类型移除 'dimension' 和 '$dimension'
+ */
+function processGanttSpecific(rawType: RawFieldType, currentGroups: FieldGroup[]): FieldGroup[] {
+  const groups = [...currentGroups];
+
+  // 所有甘特图字段默认可显示
+  groups.push('ganttshowfield');
+
+  // 根据原始类型添加特定维度标签
+  if (rawType === 'number') {
+    groups.push('n-dimension');
+  } else if (rawType === 'datetime') {
+    groups.push('t-dimension');
+  }
+
+  // 黑名单类型：移除不适合做维度的标签
+  if (GANTT_DIMENSION_BLACKLIST.has(rawType)) {
+    return groups.filter((group) => group !== 'dimension' && group !== '$dimension');
+  }
+
+  return groups;
+}
+
+// ==================== 工厂函数 ====================
+
+/**
+ * 创建预配置的字段分组获取器
+ *
+ * 适用于在特定业务场景下复用相同的配置
+ *
+ * @param getValueType - 获取字段值类型的函数
+ * @param limitFields - FX.LimitFields 配置对象
+ * @param defaultChartType - 默认图表类型
+ * @returns 预配置的 getFieldGroup 函数
+ *
+ * @example
+ * ```typescript
+ * // 创建专用于甘特图的分组器
+ * const ganttFieldGrouper = createFieldGroupGetter(
+ *   getFieldValueType,
+ *   fxLimitFields,
+ *   'gantt'
+ * );
+ *
+ * // 使用（无需重复传入 chartType）
+ * const groups1 = ganttFieldGrouper({ type: 'number', name: 'progress' });
+ * const groups2 = ganttFieldGrouper({ type: 'datetime', name: 'start_date' });
+ *
+ * // 临时切换图表类型
+ * const tableGroups = ganttFieldGrouper(
+ *   { type: 'combo', name: 'status' },
+ *   'table',
+ *   false
+ * );
+ * ```
+ */
+export function createFieldGroupGetter(
+  getValueType: GetFieldValueType,
+  limitFields: LimitFieldsConfig,
+  defaultChartType: ChartType = 'table'
+) {
+  return (
+    field: Field,
+    chartType: ChartType = defaultChartType,
+    isHidden?: boolean
+  ): FieldGroup[] => {
+    return getFieldGroup(field, getValueType, {
+      chartType,
+      limitFields,
+      isHidden,
+    });
+  };
+}
+
+// ==================== 类型守卫 ====================
+
+/**
+ * 检查是否为有效的字段类型
+ */
+export function isValidFieldType(type: string): type is RawFieldType {
+  // 基础类型检查，实际项目中可能需要更完整的列表
+  const validTypes: string[] = [
+    '_id',
+    'text',
+    'textarea',
+    'number',
+    'datetime',
+    'radiogroup',
+    'checkboxgroup',
+    'combo',
+    'combocheck',
+    'address',
+    'location',
+    'user',
+    'usergroup',
+    'dept',
+    'deptgroup',
+    'image',
+    'upload',
+    'signature',
+    'subform',
+    'linkdata',
+    'linkquery',
+    'sn',
+    'phone',
+    'button',
+    'dataload',
+    'separator',
+    'formula',
+  ];
+  return validTypes.includes(type);
+}
+
+/**
+ * 检查字段是否在指定分组中
+ */
+export function fieldHasGroup(groups: FieldGroup[], targetGroup: FieldGroup): boolean {
+  return groups.includes(targetGroup);
+}
+
+// ==================== 使用示例 ====================
+
+// 示例：模拟 FX.LimitFields 的部分配置
+const exampleLimitFields: Partial<LimitFieldsConfig> = {
+  dashDimension: [
+    '_id',
+    'text',
+    'radiogroup',
+    'combo',
+    'datetime',
+    'address',
+    'user',
+    'dept',
+    'sn',
+  ],
+  dashTableField: [
+    '_id',
+    'text',
+    'textarea',
+    'number',
+    'combo',
+    'datetime',
+    'address',
+    'user',
+    'dept',
+  ],
+  dashQuota: ['_id', 'text', 'combo', 'number', 'sn', 'formula'],
+  dashDimensionLAL: ['location', 'text', 'address'],
+  dashFilter: [
+    '_id',
+    'text',
+    'radiogroup',
+    'combo',
+    'datetime',
+    'address',
+    'user',
+    'dept',
+    'number',
+  ],
+  dashFilters: [
+    '_id',
+    'text',
+    'textarea',
+    'radiogroup',
+    'combo',
+    'datetime',
+    'address',
+    'user',
+    'dept',
+    'number',
+  ],
+};
+
+// // 示例字段值类型获取函数
+// const exampleGetValueType: GetFieldValueType = (field) => {
+//   // 实际业务中可能更复杂，例如根据字段配置映射到标准类型
+//   return field.type;
+// };
+
+// 使用示例
+// const exampleField: Field = { type: 'number', name: 'amount' };
+// const groups = getFieldGroup(exampleField, exampleGetValueType, {
+//   chartType: 'gantt',
+//   limitFields: exampleLimitFields as LimitFieldsConfig,
+//   isHidden: false,
+// });
+
+export const GetXFieldGroupStr = (
+  chartType: IDashWidgetType,
+  field: {
+    type: string;
+    name: string;
+  }
+) => {
+  return getFieldGroup(
+    {
+      type: field.type as RawFieldType,
+      name: field.name,
+    },
+    (f) => f.type,
+    {
+      chartType,
+      limitFields: window.FX?.LimitFields as LimitFieldsConfig,
+      isHidden: false,
+    }
+  ).join(',');
+};
+
+// console.log('Field groups:', groups);
+// 预期输出: ['dimension', '$dimension', 'quota', 'filter', 'ganttshowfield', 'n-dimension']

package/src/plugins/report-query-plugin/utils/get-field-icon.ts

@@ -0,0 +1,26 @@
+import { FieldType } from '@baishuyun/types';
+
+/** 获取字段图标 */
+export const getFieldIcon = (type: FieldType): string => {
+  const iconMap: Record<string, string> = {
+    text: 'icon-widget-text',
+    textarea: 'icon-widget-textarea',
+    number: 'icon-widget-number',
+    datetime: 'icon-widget-datetime',
+    date: 'icon-widget-date',
+    time: 'icon-widget-time',
+    radiogroup: 'icon-widget-radiogroup',
+    checkboxgroup: 'icon-widget-checkboxgroup',
+    user: 'icon-widget-user',
+    usergroup: 'icon-widget-usergroup',
+    dept: 'icon-widget-dept',
+    deptgroup: 'icon-widget-deptgroup',
+    upload: 'icon-widget-upload',
+    image: 'icon-widget-image',
+    location: 'icon-widget-location',
+    select: 'icon-widget-select',
+    combo: 'icon-widget-combo',
+    signature: 'icon-widget-signature',
+  };
+  return iconMap[type] || 'icon-widget-text';
+};